[client] Document the proxy-vs-mixin rule (weather stays, streaming deferred) #175
Loading…
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Decided during the #151 architecture audit.
Current state: weather is the only namespaced proxy (
client.weather.forecast,_weather.py), every other domain is a flat mixin (client.get_*). The split looks arbitrary but follows an implicit rule worth writing down:Applying the rule:
/api(_weather.py:7, vs_core.py:56), while reusing the client's_requesttransport via absolute-URL support (_core.py:94). Keep as proxy.wss://frontage.energy.comwatt.com/ws,_streaming.py:12) is the only other transport-divergent domain, but it is authenticated, session-coupled, and exposes a single flat method (stream_measurements) documented in the README. Do not convert now; revisit only if a second streaming method lands (conversion would need a deprecation path).Done when: