driver / lint (pull_request) Successful in 15s
driver / standard (pull_request) Successful in 17s
driver / types (pull_request) Successful in 1m0s
driver / test (3.13) (pull_request) Successful in 4m13s
driver / test (3.12) (pull_request) Successful in 4m15s
driver / lowest (pull_request) Successful in 3m42s
driver / build (pull_request) Successful in 27s
driver / security (pull_request) Successful in 1m8s
CI / driver (pull_request) Successful in 5m38s
driver / publish (pull_request) Skipped
get_config() overrode NAPALM's stub with `return {}` and took no
arguments, so get_config(retrieve="running") raised TypeError, which a
caller reports as a failed configuration backup on every poll. The
other getters a speaker has nothing for (environment, optics, routing,
ARP, MAC table, LLDP, NTP, SNMP, BGP, probes, users, network instances,
firewall policies) had the same shape: an empty answer reads as
"implemented, nothing there", and get_route_to() required an argument
NAPALM defaults.
All of them are gone; NAPALM's stubs raise NotImplementedError.
Closes #13
4.2 KiB
4.2 KiB
Changelog
All notable changes to this driver. The format follows Keep a Changelog, versions follow Semantic Versioning.
[Unreleased]
Changed
- Breaking:
get_playback_state()andget_zone_info()return the shapes of napalm-device-types' media contract.get_playback_state()is{"state": "playing"|"paused"|"stopped"|"transitioning", "source": "radio"|…}instead of SoCo's transport string ("PAUSED_PLAYBACK"); a speaker with nothing queued isstopped, and a state outside the four raisesCommandErrorException.get_zone_info()is a list with one{"name", "coordinator", "members"}entry for the speaker's group instead of the speaker's details, which stay inget_facts()(#11). - Python 3.12 is the floor (
requires-python = ">=3.12"): netOrk runs every driver on 3.12, so 3.10 and 3.11 are no longer tested (NAPALM/driver-standard#6). - The floor on napalm is 5.1: older releases import
pkg_resources, which a Python 3.12 venv no longer has. - Breaking: the NAPALM getters a speaker has nothing for are no longer overridden:
get_config(),get_environment(),get_optics(), the routing, ARP, MAC table, LLDP, NTP, SNMP, BGP, probe, user, network-instance and firewall-policy getters raise NAPALM'sNotImplementedErrorinstead of answering{}or[]. An empty answer read as "implemented, nothing there", andget_config()andget_route_to()did not even take NAPALM's arguments:get_config(retrieve="running")raisedTypeError, which a caller reported as a failed configuration backup on every poll (#13).
Fixed
play(),pause(),stop(),next_track(),previous_track(),set_volume()andset_mute()raiseConnectionClosedExceptionwhen the driver is not connected, instead of returning as if the speaker had done it (#2).get_arp_table()takes NAPALM'svrfargument (#2).- The driver module carries its docstring again (
__doc__wasNone) (#2). get_facts(),get_interfaces()andget_interfaces_ip()no longer guess whether the speaker is wired: SoCo offers no reading for it, and the check looked for an attribute SoCo does not have, so it never foundeth0anyway. The speaker reports one interface,wlan0, described as "Network (wired or wireless unknown)" (#2).get_group_info()andget_zone_info()raise instead of answering{}when the driver is not connected (ConnectionClosedException) or the read fails (ConnectionException,CommandErrorException);{}/[]now only means the speaker is in no group (#11).get_playback_state()reports the speaker's real transport state (PLAYING,PAUSED_PLAYBACK,STOPPED,TRANSITIONING); it called a method SoCo does not have and answeredSTOPPEDfor every speaker (#9).get_volume(),get_mute(),get_playback_state()andget_current_track()raise instead of answering0,False,STOPPEDor{}:ConnectionClosedExceptionwhen the driver is not connected,ConnectionExceptionwhen the speaker cannot be reached,CommandErrorExceptionwhen it refuses the request. An unreachable speaker no longer reads as a silent, stopped one (#9).
[0.3.0] - 2026-10-23
The first release on PyPI.
Changed
- The driver follows the NAPALM driver standard
(https://git.netork.io/NAPALM/driver-standard): CI on Gitea runs ruff, mypy, the
tests on Python 3.10–3.13 and at the lowest declared versions, bandit, pip-audit and
a build check, and a release tag publishes to PyPI. The package now ships
py.typed, a README and a LICENSE file. Python 3.9 is no longer supported; napalm-device-types never ran on it. - napalm-device-types (4.21.1 or later, from PyPI) is now a declared dependency; the driver always imported it.
- A failure to read the speaker's device properties (wired or wireless) is now logged at debug level.
[0.2.0] - 2026-10-17
Removed
- Breaking:
run_device_action(). The media controls it dispatched by string (play,pause,stop, next/previous track, volume, mute) are the typed methodsplay(),set_volume()and the others.
[0.1.0] - 2026-06-13
Added
sonosdriver: facts, interfaces and media controls for Sonos speakers through SoCo.