Skip to content

Arista Network Test Automation (ANTA) Framework

Code Ruff Numpy Quality Gate Status
License License
GitHub CI Coverage Commit GitHub commit activity (branch) Github release Contributors
PyPi PyPi Version Python Versions Python format PyPI - Downloads

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

anta nrfu

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.