68 lines
4.4 KiB
Markdown
Executable file
68 lines
4.4 KiB
Markdown
Executable file
<!--
|
|
~ Copyright (c) 2023-2024 Arista Networks, Inc.
|
|
~ Use of this source code is governed by the Apache License 2.0
|
|
~ that can be found in the LICENSE file.
|
|
-->
|
|
|
|
# Arista Network Test Automation (ANTA) Framework
|
|
|
|
| **Code** | [](https://github.com/astral-sh/ruff) [](https://numpydoc.readthedocs.io/en/latest/format.html) |
|
|
| :------------: | :-------|
|
|
| **License** | [](https://github.com/arista-netdevops-community/anta/blob/main/LICENSE) |
|
|
| **GitHub** | [](https://github.com/arista-netdevops-community/anta/actions/workflows/code-testing.yml)    [](https://github.com/arista-netdevops-community/anta/releases/) [](https://github.com/arista-netdevops-community/anta/graphs/contributors) |
|
|
| **PyPi** |     |
|
|
|
|
ANTA is Python framework that automates tests for Arista devices.
|
|
|
|
- ANTA provides a [set of tests](api/tests.md) 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:
|
|
- The [ANTA CLI](cli/overview.md)
|
|
- As a [Python library](advanced_usages/as-python-lib.md) in your own application
|
|
|
|
|
|
|
|
```bash
|
|
# Install ANTA CLI
|
|
$ pip install anta
|
|
|
|
# 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
|
|
```
|
|
|
|
> [!WARNING]
|
|
> The ANTA CLI options have changed after version 0.11 and have moved away from the top level `anta` and are now required at their respective commands (e.g. `anta nrfu`). This breaking change occurs after users feedback on making the CLI more intuitive. This change should not affect user experience when using environment variables.
|
|
|
|
## Documentation
|
|
|
|
The documentation is published on [ANTA package website](https://www.anta.ninja). Also, a [demo repository](https://github.com/titom73/atd-anta-demo) is available to facilitate your journey with ANTA.
|
|
|
|
## Contribution guide
|
|
|
|
Contributions are welcome. Please refer to the [contribution guide](contribution.md)
|
|
|
|
## Credits
|
|
|
|
Thank you to [Angélique Phillipps](https://github.com/aphillipps), [Colin MacGiollaEáin](https://github.com/colinmacgiolla), [Khelil Sator](https://github.com/ksator), [Matthieu Tache](https://github.com/mtache), [Onur Gashi](https://github.com/onurgashi), [Paul Lavelle](https://github.com/paullavelle), [Guillaume Mulocher](https://github.com/gmuloc) and [Thomas Grimonet](https://github.com/titom73) for their contributions and guidances.
|