1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
|
# Installation
## Standard Installation
As outlined in the quick start, you should be able to pip install scrapli "normally":
```
pip install scrapli
```
## Installing current main branch
To install from the source repositories master branch:
```
pip install git+https://github.com/carlmontanari/scrapli
```
## Installing a different branch
To install from a different branch of the source repository, for example from a branch named `develop`:
```
pip install -e git+https://github.com/carlmontanari/scrapli.git@develop#egg=scrapli
```
## Installation from Source
To install from source:
```
git clone https://github.com/carlmontanari/scrapli
cd scrapli
python setup.py install
```
## Optional Extras
scrapli has made an effort to have as few dependencies as possible -- in fact to have ZERO dependencies! The "core" of
scrapli can run with nothing other than standard library! If for any reason you wish to use paramiko, ssh2-python,
or asyncssh as a transport, however, you of course need to install those. These "extras" can be installed via pip:
```
pip install scrapli[paramiko]
```
The available optional installation extras options are:
- paramiko
- ssh2
- asyncssh
- textfsm (textfsm and ntc-templates)
- ttp (ttp template parser)
- genie (genie/pyats)
- netconf (scrapli_netconf)
- community (scrapli_community)
If you would like to install all optional extras, you can do so with the `full` option:
```
pip install scrapli[full]
```
## Supported Platforms
As for platforms to *run* scrapli on -- it has and will be tested on MacOS and Ubuntu regularly and should work on any
POSIX system. Windows at one point was being tested very minimally via GitHub Actions builds, however this is no
longer the case as it is just not worth the effort. While scrapli should work on Windows when using the paramiko or
ssh2-python transport drivers, it is not "officially" supported. It is *strongly* recommended/preferred for folks
to use WSL/Cygwin instead of Windows.
|
