feat: Create Port from USB path

Add static method which creates Path object from given USB path.

Signed-off-by: Nicolai Buchwitz <nb@tipi-net.de>

Author: nbuchwitz

tests/test_port.py

@@ -50,3 +50,14 @@ def test_port_status(mock_hub: MockHub, fp: pytest_subprocess.FakeProcess):
 
         mock_hub.cmd(fp, port.port_number)
         assert port.status is False
+
+
+def test_port_from_path():
+    mock_data = [("1", 2), ("2-1", 1), ("1-2.3.1", 5)]
+    for element in mock_data:
+        path, port_number = element
+
+        port = Port.from_path(f"{path}.{port_number}")
+
+        assert port.hub.path == path
+        assert port.port_number == port_number

uhubctl/usb.py

@@ -157,5 +157,23 @@ def status(self, status: bool) -> None:
 
         _uhubctl(args)
 
+    @staticmethod
+    def from_path(path: str):
+        """
+        Create new port instance from USB path
+
+        Arguments:
+            path: USB path
+
+        Returns:
+            Port
+        """
+        hub_path, port_id = path.rsplit(".", maxsplit=1)
+
+        hub = Hub(hub_path, enumerate_ports=False)
+        port = hub.add_port(port_id)
+
+        return port
+
     def __str__(self) -> str:
         return f"USB Port {self.hub.path}.{self.port_number}"