Python 3 for Nokia Service Router Operating System (pySROS)
Overview
The pySROS libraries provide a model-driven management interface for Python developers to integrate with supported Nokia routers running the Service Router Operating System (SR OS).
The libraries provide an Application Programming Interface (API) for developers to create applications that can interact with Nokia SR OS devices, whether those applications are executed from a development machine or directly on the router.
When a developer uses only libraries and constructs supported on SR OS, a single application may be executed from a development machine or ported directly to an SR OS node where the application is executed.
Pre-requisites
In order to use the pySROS library the following pre-requisites must be met:
- One or more SR OS node
- Running in model-driven mode
- Running SR OS 21.7.R1 or greater (to execute applications on the SR OS device)
- With NETCONF enabled and accessible by an authorized user (to execute applications remotely)
- A Python 3 interpreter of version 3.10 or newer when using the pySROS library to execute applications remotely
License
Copyright 2021-2024 Nokia.
The license is located here.
Reporting issues
Issues, suggestions, and enhancements are welcome. Please use the Nokia support process. Issues raised in GitHub may be considered for inclusion into the project by Nokia. Pull requests are not accepted.
Installation
Multiple installation methods are available:
Note: It is recommended to use Python virtual environments where appropriate.
PyPi
The preferred method of installation of the pySROS libraries is to install
directly from the Python Package index (PyPi) using the pip tool.
The pySROS project is located on PyPi.org.
The libraries can be downloaded and installed by using the following:
pip install pysros
To upgrade to the latest release use:
pip install --upgrade pysros
Nokia support portal
The pySROS libraries are available for download from the portal for registered customers.
The obtained file can be unzipped and subsequently installed using:
python3 -m pip install .
GitHub
The pySROS libraries are available for download from GitHub.
The obtained file can be installed using:
git clone https://github.com/nokia/pysros
python3 -m pip install .
Documentation and examples
Guidance documentation is available in the SR OS System Management Guide.
API documentation is provided in this repository and may be compiled from source using:
cd docs
pip3 install -r requirements.txt
make html
The built documentation will be available in the docs/build/html directory.
Alternative formats may be selected after the make command instead of the html attribute. Some of
these include:
- singlehtml
- man
- text
Further reading and assistance
Release files for pysros 26.10.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| pysros-26.10.1.tar.gz | 88.3 kB | Without provenance | Details for pysros-26.10.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| pysros-26.10.1-py3-none-any.whl | Python 3 | none | any | Details for pysros-26.10.1-py3-none-any.whl |
Total release size: 181.5 kB
Release files / pysros-26.10.1.tar.gz
| Download URL | pysros-26.10.1.tar.gz |
|---|---|
| Size | 88.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2150e055abc4ffb57e3a552f13381e704faf21dd268e3b5cc6a23b429bbbdd9d
|
|
BLAKE2b-256 checksum How to use checksums |
0f6fc5f4b0ea56dc13d234f3b61c8945a222586fe3bd233ef39c28795f21708d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Release files / pysros-26.10.1-py3-none-any.whl
| Download URL | pysros-26.10.1-py3-none-any.whl |
|---|---|
| Size | 93.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
95a32e79f18e5927033b2a4de7a7ad6ab6a5b0feae1d9e84ccb1c04dc387e82c
|
|
BLAKE2b-256 checksum How to use checksums |
d703e96ede951679a8310e019b6587f64a6a46a9b1f3d4d0e21821930cd2d2b9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Security for pysros 26.10.1
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
