# 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](LICENSE.md).
## 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:
* [PyPi](#pypi)
* [Nokia support portal](#nokia-support-portal)
* [GitHub](#github)
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](https://pypi.org/project/pysros).
The libraries can be downloaded and installed by using the following:
```shell
pip install pysros
```
To upgrade to the latest release use:
```shell
pip install --upgrade pysros
```
### Nokia support portal ###
The pySROS libraries are available for [download from the portal](https://customer.nokia.com/support) for registered
customers.
The obtained file can be unzipped and subsequently installed using:
```shell
python3 setup.py install
```
### GitHub ###
The pySROS libraries are available for
[download from GitHub](https://github.com/jgcumming/pysros-examples).
The obtained file can be installed using:
```shell
git clone https://github.com/nokia/pysros
python3 setup.py 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:
```shell
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 ##
- [Nokia product documentation](https://documentation.nokia.com)
- [Technical support](https://customer.nokia.com/support/s/)
Raw data
{
"_id": null,
"home_page": "https://www.nokia.com",
"name": "pysros",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Nokia",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/07/bf/5327cf0f9ae5000f805e99d495e12908f63b578f144b26efad1dbcde35cd/pysros-24.10.2.tar.gz",
"platform": null,
"description": "# Python 3 for Nokia Service Router Operating System (pySROS) #\n\n## Overview ##\n\nThe pySROS libraries provide a model-driven management interface for\nPython developers to integrate with supported Nokia routers\nrunning the Service Router Operating System (SR OS).\n\nThe libraries provide an Application Programming Interface (API) for developers\nto create applications that can interact with Nokia SR OS devices, whether those\napplications are executed from a development machine or directly on the router.\n\nWhen a developer uses only libraries and constructs supported on SR OS, a\nsingle application may be executed from a development machine or ported\ndirectly to an SR OS node where the application is executed.\n\n## Pre-requisites ##\n\nIn order to use the pySROS library the following pre-requisites must be met:\n\n- One or more SR OS node\n - Running in model-driven mode\n - Running SR OS 21.7.R1 or greater (to execute applications on the SR OS device)\n - With NETCONF enabled and accessible by an authorized user (to execute applications\n remotely)\n- A Python 3 interpreter of version 3.10 or newer when using the pySROS library to\n execute applications remotely\n\n## License ##\n\nCopyright 2021-2024 Nokia.\n\nThe license is located [here](LICENSE.md).\n\n## Reporting issues ##\n\nIssues, suggestions, and enhancements are welcome. Please use the Nokia support\nprocess. Issues raised in GitHub may be considered for inclusion into the project \nby Nokia. Pull requests are not accepted.\n\n## Installation ##\n\nMultiple installation methods are available:\n\n* [PyPi](#pypi)\n* [Nokia support portal](#nokia-support-portal)\n* [GitHub](#github)\n\nNote: It is recommended to use Python virtual environments where appropriate.\n\n### PyPi ###\n\nThe preferred method of installation of the pySROS libraries is to install\ndirectly from the Python Package index (PyPi) using the ``pip`` tool.\n\nThe pySROS project is [located on PyPi.org](https://pypi.org/project/pysros).\n\nThe libraries can be downloaded and installed by using the following:\n\n```shell\npip install pysros\n```\n\nTo upgrade to the latest release use:\n\n```shell\npip install --upgrade pysros\n```\n\n### Nokia support portal ###\n\n\nThe pySROS libraries are available for [download from the portal](https://customer.nokia.com/support) for registered\ncustomers.\n\nThe obtained file can be unzipped and subsequently installed using:\n\n```shell\npython3 setup.py install\n```\n\n\n\n### GitHub ###\n\n\nThe pySROS libraries are available for\n[download from GitHub](https://github.com/jgcumming/pysros-examples).\n\nThe obtained file can be installed using:\n\n```shell\ngit clone https://github.com/nokia/pysros\npython3 setup.py install\n```\n\n## Documentation and examples ##\n\nGuidance documentation is available in the SR OS System Management Guide.\n\nAPI documentation is provided in this repository and may be compiled from source\nusing:\n\n```shell\ncd docs\npip3 install -r requirements.txt\nmake html\n```\n\nThe built documentation will be available in the docs/build/html directory.\n\nAlternative formats may be selected after the ``make`` command instead of the ``html`` attribute. Some of\nthese include:\n\n- singlehtml\n- man\n- text\n\n\n## Further reading and assistance ##\n\n- [Nokia product documentation](https://documentation.nokia.com)\n- [Technical support](https://customer.nokia.com/support/s/)\n\n",
"bugtrack_url": null,
"license": "Copyright 2021-2024 Nokia. License available in the LICENSE.md file.",
"summary": "Python for the Nokia Service Router Operating Systems (pySROS)",
"version": "24.10.2",
"project_urls": {
"Documentation": "https://network.developer.nokia.com/static/sr/learn/pysros/latest/",
"Homepage": "https://www.nokia.com",
"Source": "https://github.com/nokia/pysros"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e0e276020c2635bfc19439b39c72b0c1fd26254db2ee88d6ca3261ebc36f6349",
"md5": "45da61ad40a0b6c8d9776ccb88a46ff4",
"sha256": "7328fa61311b1ff4d37dcb081ba7dec1716d35acbf943a81262fc48ab764d263"
},
"downloads": -1,
"filename": "pysros-24.10.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "45da61ad40a0b6c8d9776ccb88a46ff4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 85729,
"upload_time": "2024-12-20T01:46:30",
"upload_time_iso_8601": "2024-12-20T01:46:30.122673Z",
"url": "https://files.pythonhosted.org/packages/e0/e2/76020c2635bfc19439b39c72b0c1fd26254db2ee88d6ca3261ebc36f6349/pysros-24.10.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "07bf5327cf0f9ae5000f805e99d495e12908f63b578f144b26efad1dbcde35cd",
"md5": "217a5e7fd205a605d4ed4bf885d2c44e",
"sha256": "6b03777e0296adc50029f7661929e70f0e6f2950533b50aea16b8d5fdbbb61de"
},
"downloads": -1,
"filename": "pysros-24.10.2.tar.gz",
"has_sig": false,
"md5_digest": "217a5e7fd205a605d4ed4bf885d2c44e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 81048,
"upload_time": "2024-12-20T01:46:32",
"upload_time_iso_8601": "2024-12-20T01:46:32.421051Z",
"url": "https://files.pythonhosted.org/packages/07/bf/5327cf0f9ae5000f805e99d495e12908f63b578f144b26efad1dbcde35cd/pysros-24.10.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-20 01:46:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "nokia",
"github_project": "pysros",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "ncclient",
"specs": [
[
"~=",
"0.6.12"
]
]
},
{
"name": "lxml",
"specs": [
[
"~=",
"4.9.2"
]
]
}
],
"lcname": "pysros"
}
JSON
