Network Automation Standard Library
This library contains the functions and utilities that are shared by most Network Automation projects built at SURF.
Installation
To install the package from PyPI:
pip install nwa-stdlib
Development
Virtual Environment
Steps to setup a virtual environment.
Install uv and create the development environment:
uv sync --locked --group test --group dev
Run project commands through that environment with uv run, for example:
uv run pytest
Unit tests
Run the unit tests through the uv-managed environment:
uv run pytest
Pre-commit
This project uses pre-commit to automatically run a number of checks before making a git commit. The same checks will be performed in the CI pipeline so this can save you some time.
First ensure you have pre-commit installed. It is recommended to install it outside the virtualenv. On Linux and Mac, pre-commit is available in most package managers. Alternatively you can install it globally with pipx.
Once pre-commit is installed, go into the project root and enable it:
pre-commit install
This should output pre-commit installed at .git/hooks/pre-commit. The next time you run git commit the pre-commit hooks will validate your changes.
Set the package version
When a release version has been assigned, update the package metadata on a clean branch with uv version:
uv version 1.12.2
Specify the full version explicitly so release candidates can be represented, for example uv version 1.12.2rc1.
Supported Python versions
nwa-stdlib must support the same python versions as orchestrator-core.
Exceptions to this rule are:
- A new python version is released: nwa-stdlib should support the new version before orchestrator-core does
- Support for an old python version is dropped: nwa-stdlib should drop the python version after orchestrator-core does
Metadata
Release files for nwa-stdlib 1.13.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nwa_stdlib-1.13.0.tar.gz | 30.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nwa_stdlib-1.13.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 62.5 kB
Release files / nwa_stdlib-1.13.0.tar.gz
| Download URL | nwa_stdlib-1.13.0.tar.gz |
|---|---|
| Size | 30.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
94d76ec312bb57ccdd1c25be14069e11a2a6950b9cae2f001f9a07dfcf1feaaa
|
|
BLAKE2b-256 checksum How to use checksums |
6f57236c2c59a0364fa3185ce380bb48a9ba0b7be666f7a47f34feb92221afa4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 1, 2026.
Transparency logRelease files / nwa_stdlib-1.13.0-py3-none-any.whl
| Download URL | nwa_stdlib-1.13.0-py3-none-any.whl |
|---|---|
| Size | 31.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f75bea3172342e0eb861b0cb3e1b652f1a588a781ea8119c5a9e3bdc37a23c35
|
|
BLAKE2b-256 checksum How to use checksums |
cc4069e50718fb1d2507b78e5367e32e32bd6512478581670355066e1731a17e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 1, 2026.
Transparency log