Skip to main content

Python Netgear Switch Interface Library

Query and control all your Netgear switches — SNMP (managed), NSDP and HTTP web-UI (Plus) — behind one model-driven Python API and the ngsw CLI.

Status: early development. See docs/superpowers/specs/ for the design and docs/superpowers/plans/ for the implementation plans.

Installation

pip / uv (PyPI)

pip install python-netgear-switch-library
# or: uv add python-netgear-switch-library

Optional extras: [async] (pysnmp), [http] (httpx). The synchronous SNMP transport shells out to the net-snmp command-line tools, a system package (not a Python dependency):

sudo apt install snmp   # provides snmpget/snmpbulkwalk/snmpset

Debian / Ubuntu (apt)

Signed .deb packages for Debian trixie and sid are published to a GitHub Pages apt repository. Pick the line matching your suite:

sudo install -d -m0755 /etc/apt/keyrings
curl -fsSL https://mithro.github.io/python-netgear-switch-library/netgear-switch.gpg \
  | sudo tee /etc/apt/keyrings/netgear-switch.gpg > /dev/null

# trixie:
echo "deb [signed-by=/etc/apt/keyrings/netgear-switch.gpg] https://mithro.github.io/python-netgear-switch-library/trixie/ ./" \
  | sudo tee /etc/apt/sources.list.d/netgear-switch.list
# sid:
echo "deb [signed-by=/etc/apt/keyrings/netgear-switch.gpg] https://mithro.github.io/python-netgear-switch-library/sid/ ./" \
  | sudo tee /etc/apt/sources.list.d/netgear-switch.list

sudo apt update
sudo apt install python3-netgear-switch-library

This installs the netgear_switch library and the ngsw CLI, and pulls in the snmp net-snmp CLI tools automatically.

Either way, once installed run ngsw --help to see available commands.

Versioning

This project is a rolling release: the version is derived from git (0.0.postN / X.Y.postN), and every merge to main publishes a new version to PyPI and the apt repo. There are no tags or manual version bumps.

Development

uv sync --all-extras
uv run pytest
uv run ruff check

License

Apache-2.0.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python_netgear_switch_library-0.0.post154.tar.gz (445.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file python_netgear_switch_library-0.0.post154.tar.gz.

File metadata

File hashes

Hashes for python_netgear_switch_library-0.0.post154.tar.gz
Algorithm Hash digest
SHA256 9d8b63982ad3719ae6a87a68c86093f7180c77216e2cc4e4bcdd981e6ffc988e
MD5 2e42c7fd9d63c030d8844b5a6a622344
BLAKE2b-256 6b1451af9504c53ab98a9a54ba32dd1efb5a41cd96e932b194d0b7336abbac4b

See more details on using hashes here.

Provenance

The following attestation bundles were made for python_netgear_switch_library-0.0.post154.tar.gz:

Publisher: publish-pypi.yml on mithro/python-netgear-switch-library

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file python_netgear_switch_library-0.0.post154-py3-none-any.whl.

File metadata

File hashes

Hashes for python_netgear_switch_library-0.0.post154-py3-none-any.whl
Algorithm Hash digest
SHA256 c72c302b080d4902b6c95706e3c872219fde9073102c850163825d3e0ca2c38a
MD5 435e8b45e0e9e4415c5b50cb0cdb529f
BLAKE2b-256 7feb44f8553a090c3fadc183b46bc501b57aa2eb25062d13a42b1f23130b9987

See more details on using hashes here.

Provenance

The following attestation bundles were made for python_netgear_switch_library-0.0.post154-py3-none-any.whl:

Publisher: publish-pypi.yml on mithro/python-netgear-switch-library

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page