napalm-srlinux

Community NAPALM driver for the Nokia SR Linux network OS, built on the JSON-RPC management interface; the only runtime dependencies are napalm and httpx.

Documentation: https://napalm.srlinux.dev

Development

The project is managed with uv:

uv sync                  # create the venv and install all dependencies
uv run pytest test/unit  # unit tests (mocked JSON-RPC fixtures)
uv run ruff check napalm_srlinux test tools examples

Testing against a real node

make deploy-clab-ci      # single-node containerlab topology
make run-tests           # runs all test/ci tests against it
make destroy-clab-ci

All test/ci tests are pytest modules, so make run-tests runs them in a single session with a clean, per-test summary. To run one file (or a single test) against the running topology:

uv run pytest test/ci/compare_config.py                          # one file
uv run pytest test/ci/compare_config.py::test_cli_candidate_diff # one test
uv run pytest test/ci/compare_config.py --log-cli-level=DEBUG    # verbose JSON-RPC logs

Logs (including the httpx/httpcore request traffic) are hidden by default and only shown on failure or when you pass --log-cli-level. Each file also runs as a plain script (uv run test/ci/compare_config.py).

Re-recording the unit-test fixtures

The mocked-data fixtures under test/unit/mocked_data/ are verbatim JSON-RPC responses recorded from a real two-node lab (BGP, LLDP, ARP, mac-vrf, NTP, ...):

make deploy-clab-record  # two-node recording topology
make record-fixtures     # configure the lab + record all fixtures
make destroy-clab-record

Review the resulting git diff before committing re-recorded fixtures.

License

Apache 2.0 - see LICENSE.