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

Download files

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

Source Distribution

nwa_stdlib-1.12.2.tar.gz (28.0 kB view details)

Uploaded Aug 17, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

nwa_stdlib-1.12.2-py3-none-any.whl (29.7 kB view details)

Uploaded Aug 17, 2026 Python 3

File details

Details for the file nwa_stdlib-1.12.2.tar.gz.

File metadata

Download URL: nwa_stdlib-1.12.2.tar.gz
Upload date: Aug 17, 2026
Size: 28.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for nwa_stdlib-1.12.2.tar.gz
Algorithm	Hash digest
SHA256	`c2dcf98a40d36d3bd7cb8aa7db2e60ba9cd679c736691f9ad14cb48eeefc2ad3`
MD5	`510d5e89fcc02fdb1d8165ad3c19316c`
BLAKE2b-256	`8593ab7e6bee87ffd16fa488a6c509a378492cd8efb76a5ed84ac2f0c1302e3a`

See more details on using hashes here.

Provenance

The following attestation bundles were made for nwa_stdlib-1.12.2.tar.gz:

Publisher: publish-release.yaml on workfloworchestrator/nwa-stdlib

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: nwa_stdlib-1.12.2.tar.gz
- Subject digest: c2dcf98a40d36d3bd7cb8aa7db2e60ba9cd679c736691f9ad14cb48eeefc2ad3
- Sigstore transparency entry: 2498389195
- Sigstore integration time: Aug 17, 2026
Source repository:
- Permalink: workfloworchestrator/nwa-stdlib@bd7491ea65b61f1791bffc4501c4d706c85a8cd4
- Branch / Tag: refs/tags/1.12.2
- Owner: https://github.com/workfloworchestrator
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-release.yaml@bd7491ea65b61f1791bffc4501c4d706c85a8cd4
- Trigger Event: release