Installation
From PyPI:
pip install nornir_salt[prodmax]
From GitHub master branch:
python3 -m pip install git+https://github.com/dmulyalin/nornir-salt
Warning
Python 3.6 support deprecated starting with Nornir-Salt version 0.12.0
Installation extras
Nornir-Salt comes with these installation extras.
Name |
Description |
---|---|
|
Installs libraries required for development e.g. pytest, black, pre-commit etc. |
|
Production ready minimum set. Installs Netmiko, Ncclient and requests libraries to provide support for managing devices over SSH, NETCONF and RESTCONF. In addition, installs libraries to extended Salt-Nornir functionality such as Tabulate, Rich, TTP etc. All libraries have versions fixed to produce tested and working environment. |
|
Production ready maximum set. Installs all |
|
Installs netmiko, nornir-netmiko |
|
Installs napalm, nornir-napalm |
|
Installs scrapli, scrapli-community |
|
Installs genie, pyats |
|
Installs ncclient, scrapli-netconf |
|
Installs pygnmi |
|
Installs requests |
|
Installs cerberus, jmespath, ntc-templates, pyyaml, tabulate, ttp, ttp-templates, xmltodict, lxml |
To install Nornir-Salt with its core dependencies (Nornir and Pydantic) only, without any additional libraries:
pip install salt-nornir
To install minimum production set:
pip install salt-nornir[prodmin]
To install maximum production set:
pip install salt-nornir[prodmax]
Why different extras? - to simplify dependency installation for different requirements. It might make sense to start testing Nornir-Salt using prodmax set, but later on narrow down to using Netmiko and Ncclient only, in that case prodmin set would make sense as it helps to save some hard drive space and improve installation speed.
Alternatively to using extras, individual libraries of desired version can be installed, provided extras only use version that were tested together making it safer choice for less experienced users.