Arista Network Test Automation (ANTA) Framework¶
Code | |
---|---|
License | |
GitHub | |
PyPi |
ANTA is Python framework that automates tests for Arista devices.
- ANTA provides a set of tests to validate the state of your network
- ANTA can be used to:
- Automate NRFU (Network Ready For Use) test on a preproduction network
- Automate tests on a live network (periodically or on demand)
- ANTA can be used with:
- As a Python library in your own application
- The ANTA CLI
Install ANTA library¶
The library will NOT install the necessary dependencies for the CLI.
# Install ANTA as a library
pip install anta
Install ANTA CLI¶
If you plan to use ANTA only as a CLI tool you can use pipx
to install it.
pipx
is a tool to install and run python applications in isolated environments. Refer to pipx
instructions to install on your system.
pipx
installs ANTA in an isolated python environment and makes it available globally.
This is not recommended if you plan to contribute to ANTA
# Install ANTA CLI with pipx
$ pipx install anta[cli]
# Run ANTA CLI
$ anta --help
Usage: anta [OPTIONS] COMMAND [ARGS]...
Arista Network Test Automation (ANTA) CLI
Options:
--version Show the version and exit.
--log-file FILE Send the logs to a file. If logging level is
DEBUG, only INFO or higher will be sent to
stdout. [env var: ANTA_LOG_FILE]
-l, --log-level [CRITICAL|ERROR|WARNING|INFO|DEBUG]
ANTA logging level [env var:
ANTA_LOG_LEVEL; default: INFO]
--help Show this message and exit.
Commands:
check Commands to validate configuration files
debug Commands to execute EOS commands on remote devices
exec Commands to execute various scripts on EOS devices
get Commands to get information from or generate inventories
nrfu Run ANTA tests on devices
You can also still choose to install it with directly with pip
:
pip install anta[cli]
Documentation¶
The documentation is published on ANTA package website.
Contribution guide¶
Contributions are welcome. Please refer to the contribution guide
Credits¶
Thank you to Jeremy Schulman for aio-eapi.
Thank you to Angélique Phillipps, Colin MacGiollaEáin, Khelil Sator, Matthieu Tache, Onur Gashi, Paul Lavelle, Guillaume Mulocher and Thomas Grimonet for their contributions and guidances.