chore: add some docs and a basic test

Author: Lash-L

roborock/devices/traits/v1/status.py

@@ -9,7 +9,19 @@
 
 
 class StatusTrait(StatusV2, common.V1TraitMixin):
-    """Trait for managing the status of Roborock devices."""
+    """Trait for managing the status of Roborock devices.
+
+    The StatusTrait gives you the access to the state of a Roborock vacuum.
+    The various attribute options on state change per each device.
+    Values like fan speed, mop mode, etc. have different options for every device
+    and are dynamically determined.
+
+    Usage:
+        Before accessing status properties, you should call `refresh()` to fetch
+        the latest data from the device. You must pass in the device feature trait
+        to this trait so that the dynamic attributes can be pre-determined.
+
+    """
 
     command = RoborockCommand.GET_STATUS
 

tests/data/v1/test_v1_containers.py

@@ -1,6 +1,9 @@
 """Test cases for the containers module."""
 
-from syrupy import SnapshotAssertion
+import copy
+
+import pytest
+from syrupy.assertion import SnapshotAssertion
 
 from roborock.data.v1 import (
     MultiMapsList,
@@ -102,6 +105,26 @@ def test_status():
     assert s.dock_cool_fan_status == 0
 
 
+@pytest.mark.parametrize(
+    "dss_val, expected_clean_box_status, expected_dirty_box_status",
+    [
+        (None, None, None),
+        (169, ClearWaterBoxStatus.okay, DirtyWaterBoxStatus.okay),
+        (149, ClearWaterBoxStatus.out_of_water, DirtyWaterBoxStatus.full_not_installed),
+        (153, ClearWaterBoxStatus.okay, DirtyWaterBoxStatus.full_not_installed),
+    ],
+)
+def test_dss_status(
+    dss_val: int | None, expected_clean_box_status: ClearWaterBoxStatus, expected_dirty_box_status: DirtyWaterBoxStatus
+):
+    """Test dss status properly setting child values."""
+    status = copy.deepcopy(STATUS)
+    status["dss"] = dss_val
+    s = StatusV2.from_dict(status)
+    assert s.clear_water_box_status == expected_clean_box_status
+    assert s.dirty_water_box_status == expected_dirty_box_status
+
+
 def test_current_map() -> None:
     """Test the current map logic based on map status."""
     s = S7MaxVStatus.from_dict(STATUS)