matter-python-client 1.3.3__py3-none-any.whl → 1.4.0a0.dev20260731__py3-none-any.whl

{matter_python_client-1.3.3.dist-info → matter_python_client-1.4.0a0.dev20260731.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: matter-python-client
-Version: 1.3.3
+Version: 1.4.0a0.dev20260731
 Summary: Python Client for the OHF Matter Server
 Author-email: Open Home Foundation <hello@openhomefoundation.io>
 License-Expression: Apache-2.0

{matter_python_client-1.3.3.dist-info → matter_python_client-1.4.0a0.dev20260731.dist-info}/RECORD

@@ -155,7 +155,7 @@ chip/tlv/tlvlist.py,sha256=ZpT6Hr6t3qDHiUZWkY4WnioVP2icv5i5LIKNUIgOOps,2469
 matter_server/__init__.py,sha256=lJ6xyVLSMGtiHvq36VPSDb75ksxfNKYmKEEE-ZwJdhQ,47
 matter_server/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 matter_server/client/__init__.py,sha256=pZzjJp-7C5BmYGZJjIo5SpyjGLU0FcqBa2nJ558y-Is,97
-matter_server/client/client.py,sha256=ACyJ0JjEiM7brGa18RBeF-6iJRzp1QKcGZuPEo3r5Ak,36917
+matter_server/client/client.py,sha256=YMi7f6zBOjaU-nVsWnuyeulPr1h6rLAaDpOC6DJly5o,38113
 matter_server/client/connection.py,sha256=oMZ3Ia8Z5GxnYawBJDkBKJX-icTwd0vX1vgfvouFaTk,6246
 matter_server/client/exceptions.py,sha256=741JkGMBQFJYZ70zX80B-Dn_NtgHffb6jDHC83tCL2U,1901
 matter_server/client/models/__init__.py,sha256=pT16UC2evZVw2trjun2xJZpaOR55ky7i_8znlA3Mreo,63
@@ -165,12 +165,12 @@ matter_server/common/__init__.py,sha256=y4EeCH05sUYifS2b624oweA6omnY5k-rLNHHv4t4
 matter_server/common/const.py,sha256=hTu0siAgpQvAz6oYavTGuqgkXaQH2glQxUQuGyPnn1o,256
 matter_server/common/custom_clusters.py,sha256=Zr9zLdijaMbPGZ0879oB1NxwYj_oXNM6xKtZB_dcTug,1227
 matter_server/common/errors.py,sha256=idK30d48jZPm6zw9TJjHbBccz3oOgpB_W3SJaGNsj5g,3461
-matter_server/common/models.py,sha256=hpR30aXn8ON2rpCjsPCo6eicifImdEr3pSj0KcyluWg,9635
+matter_server/common/models.py,sha256=cveUE4r_O7IbmojGV8sYHZeVnCbH1saw_Trv202M2SU,11869
 matter_server/common/helpers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 matter_server/common/helpers/api.py,sha256=9maToXRnef6SLGnecaTSBlWU7wDSG3elil-HtffQ2TA,1993
 matter_server/common/helpers/json.py,sha256=FktcqarAhmdI0AdiBwo7gCdJp6rA-uVdeNUglQv6HhA,1307
 matter_server/common/helpers/util.py,sha256=6vi945T2X14XQndhWW03Snj3yHbKALJHGU2qXCLvVFk,12948
-matter_python_client-1.3.3.dist-info/METADATA,sha256=EnflUtVjs6GPQPw7fOZAIGIXfbHGwGqThZ80Sx7Yje4,4398
-matter_python_client-1.3.3.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
-matter_python_client-1.3.3.dist-info/top_level.txt,sha256=qqEVT8dTHhSn15gf6otxpB5dYM48Sqsucdx9W2Lq-So,19
-matter_python_client-1.3.3.dist-info/RECORD,,
+matter_python_client-1.4.0a0.dev20260731.dist-info/METADATA,sha256=UyALcIexuGdYV2izeKUKO_MIIxgwbn85zUoSewqBfzE,4412
+matter_python_client-1.4.0a0.dev20260731.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+matter_python_client-1.4.0a0.dev20260731.dist-info/top_level.txt,sha256=qqEVT8dTHhSn15gf6otxpB5dYM48Sqsucdx9W2Lq-So,19
+matter_python_client-1.4.0a0.dev20260731.dist-info/RECORD,,

matter_server/client/client.py

@@ -30,6 +30,7 @@ from matter_server.common.models import (
     MatterNodeEvent,
     MatterSoftwareVersion,
     MessageType,
+    NetworkTopology,
     NodePingResult,
     ResultMessageBase,
     ServerDiagnostics,
@@ -308,6 +309,26 @@ class MatterClient:
         """
         await self.send_command(APICommand.RESYNC_ICD, require_schema=12, node_id=node_id)
 
+    async def get_network_topology(self, refresh: bool = False) -> NetworkTopology:
+        """Return the derived network topology graph (Thread mesh + Wi-Fi).
+
+        Issuing this command also subscribes the connection to
+        EventType.NETWORK_TOPOLOGY_UPDATED pushes. With refresh=True the server
+        re-reads the Thread/Wi-Fi diagnostics from every online node before
+        building the snapshot (slower - seconds); otherwise it builds from the
+        current attribute cache.
+
+        refresh=True costs real radio traffic on every online node, so it is a
+        user-initiated action - never poll it. The push event is the intended
+        source for keeping a graph current.
+
+        Requires schema 13 (OHF Matter Server).
+        """
+        data = await self.send_command(
+            APICommand.GET_NETWORK_TOPOLOGY, require_schema=13, refresh=refresh
+        )
+        return dataclass_from_dict(NetworkTopology, data)
+
     async def open_commissioning_window(
         self,
         node_id: int,
@@ -869,6 +890,10 @@ class MatterClient:
                 node_id=node_event.node_id,
             )
             return
+        if msg.event == EventType.NETWORK_TOPOLOGY_UPDATED:
+            topology = dataclass_from_dict(NetworkTopology, msg.data)
+            self._signal_event(EventType.NETWORK_TOPOLOGY_UPDATED, data=topology)
+            return
         # An event type unknown to this (older) client is passed through by parse_value as a raw
         # string; forwarding it would crash on `event.value` in _signal_event. Drop it instead so a
         # newer server emitting a new event type can never disconnect the client.

matter_server/common/models.py

@@ -25,6 +25,7 @@ class EventType(Enum):
     ENDPOINT_REMOVED = "endpoint_removed"
     WEBRTC_CALLBACK = "webrtc_callback"
     THREAD_DIAGNOSTICS_UPDATED = "thread_diagnostics_updated"  # schema 12+
+    NETWORK_TOPOLOGY_UPDATED = "network_topology_updated"  # schema 13+
 
 
 class APICommand(str, Enum):
@@ -66,6 +67,7 @@ class APICommand(str, Enum):
     REGISTER_ICD = "register_icd"
     RESYNC_ICD = "resync_icd"
     UNREGISTER_ICD = "unregister_icd"
+    GET_NETWORK_TOPOLOGY = "get_network_topology"
 
 
 EventCallBackType = Callable[[EventType, Any], None]
@@ -270,6 +272,78 @@ class IcdStateData:
     next_expected_checkin: int | None
 
 
+@dataclass
+class TopologyDirectionInfo:
+    """One direction's observed link quality on a topology connection.
+
+    Note: Only available with OHF Matter Server (schema 13+).
+    """
+
+    strength: str
+    lqi: int | None = None
+    rssi: int | None = None
+
+
+@dataclass
+class NetworkTopologyNode:
+    """A node in the network topology graph.
+
+    `kind`/`role` values are open string sets so a newer server can
+    introduce values without breaking older clients.
+    Note: Only available with OHF Matter Server (schema 13+).
+    """
+
+    # pylint: disable=too-many-instance-attributes
+
+    id: str
+    kind: str  # matter | border_router | thread_unknown | wifi_ap
+    network_type: str  # thread | wifi | ethernet | unknown
+    node_id: int | None = None
+    role: str | None = None
+    available: bool | None = None
+    is_bridge: bool | None = None
+    ext_address: str | None = None
+    rloc16: int | None = None
+    ext_pan_id: str | None = None
+    network_name: str | None = None
+    vendor_name: str | None = None
+    model_name: str | None = None
+    last_seen: int | None = None
+
+
+@dataclass
+class NetworkTopologyConnection:
+    """An edge between two topology nodes.
+
+    Thread links may be asymmetric: `source_to_target`/`target_to_source` carry
+    each observed direction; the top-level `strength` is the strongest of them.
+    Note: Only available with OHF Matter Server (schema 13+).
+    """
+
+    source: str
+    target: str
+    network: str  # thread | wifi
+    strength: str  # strong | medium | weak | none
+    source_to_target: TopologyDirectionInfo | None = None
+    target_to_source: TopologyDirectionInfo | None = None
+    via_route_table: bool | None = None
+    path_cost: int | None = None
+
+
+@dataclass
+class NetworkTopology:
+    """Snapshot of the Matter network topology (Thread mesh + Wi-Fi).
+
+    Returned by the 'get_network_topology' command and pushed via the
+    'network_topology_updated' event.
+    Note: Only available with OHF Matter Server (schema 13+).
+    """
+
+    collected_at: int
+    nodes: list[NetworkTopologyNode]
+    connections: list[NetworkTopologyConnection]
+
+
 class UpdateSource(Enum):
     """Enum with possible sources for a software update."""