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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file python_netgear_switch_library-0.0.post156.tar.gz.
File metadata
- Download URL: python_netgear_switch_library-0.0.post156.tar.gz
- Upload date:
- Size: 445.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
74382f834ae6269e4176341f7ad2887eda2b7ad32491a9cb1cb50caa4110c9bb
|
|
| MD5 |
f16b0ce254b605a56bab15426c9e194c
|
|
| BLAKE2b-256 |
2b1b86d7545a17e70da4f0d6bdc40728fb6e15fa49e5c03fc25f64904e976053
|
Provenance
The following attestation bundles were made for python_netgear_switch_library-0.0.post156.tar.gz:
Publisher:
publish-pypi.yml on mithro/python-netgear-switch-library
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
python_netgear_switch_library-0.0.post156.tar.gz -
Subject digest:
74382f834ae6269e4176341f7ad2887eda2b7ad32491a9cb1cb50caa4110c9bb - Sigstore transparency entry: 2204780897
- Sigstore integration time:
-
Permalink:
mithro/python-netgear-switch-library@418312da41ce2f257f5763bc2443131b908f1af0 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/mithro
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@418312da41ce2f257f5763bc2443131b908f1af0 -
Trigger Event:
push
-
Statement type:
File details
Details for the file python_netgear_switch_library-0.0.post156-py3-none-any.whl.
File metadata
- Download URL: python_netgear_switch_library-0.0.post156-py3-none-any.whl
- Upload date:
- Size: 137.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
173e80961f3e50fa74623315b980a0b26235fd9a9d0f8d3548a49ff5f8ae885e
|
|
| MD5 |
d64c975d32a6dfcc2dea6037075d983f
|
|
| BLAKE2b-256 |
86117e4da814d9d3a39f33dc53d6e8a3afd2ba3623295e0d2ed3b20af28d1720
|
Provenance
The following attestation bundles were made for python_netgear_switch_library-0.0.post156-py3-none-any.whl:
Publisher:
publish-pypi.yml on mithro/python-netgear-switch-library
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
python_netgear_switch_library-0.0.post156-py3-none-any.whl -
Subject digest:
173e80961f3e50fa74623315b980a0b26235fd9a9d0f8d3548a49ff5f8ae885e - Sigstore transparency entry: 2204780906
- Sigstore integration time:
-
Permalink:
mithro/python-netgear-switch-library@418312da41ce2f257f5763bc2443131b908f1af0 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/mithro
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@418312da41ce2f257f5763bc2443131b908f1af0 -
Trigger Event:
push
-
Statement type:
