feat: Add property for accessing the current map from the status object

Author: allenporter

roborock/containers.py

@@ -425,6 +425,13 @@ def get_mop_mode_code(self, mop_mode: str) -> int:
             raise RoborockException("Attempted to get mop_mode before status has been updated.")
         return self.mop_mode.as_dict().get(mop_mode)
 
+    @property
+    def current_map(self) -> int | None:
+        """Returns the current map ID if the map is present."""
+        if self.map_status is not None:
+            return (self.map_status - 3) // 4
+        return None
+
 
 @dataclass
 class S4MaxStatus(Status):

tests/test_containers.py

@@ -234,6 +234,7 @@ def test_status():
     assert s.fan_power == 102
     assert s.dnd_enabled == 0
     assert s.map_status == 3
+    assert s.current_map == 0
     assert s.is_locating == 0
     assert s.lock_status == 0
     assert s.water_box_mode == 203
@@ -262,6 +263,19 @@ def test_status():
     assert s.water_box_mode == RoborockMopIntensityS7.intense
 
 
+def test_current_map() -> None:
+    """Test the current map logic based on map status."""
+    s = S7MaxVStatus.from_dict(STATUS)
+    assert s.map_status == 3
+    assert s.current_map == 0
+
+    s.map_status = 7
+    assert s.current_map == 1
+
+    s.map_status = 11
+    assert s.current_map == 2
+
+
 def test_dnd_timer():
     dnd = DnDTimer.from_dict(DND_TIMER)
     assert dnd.start_hour == 22