pyATS Contrib

26.3 verified Mon Apr 27 auth: no python

A collection of community-contributed extensions for the Cisco pyATS framework, including additional libraries, parsers, triggers, and utilities for network testing and automation. Current version: 26.3. Released monthly alongside pyATS core.

pip install pyats-contrib

Common errors

error ImportError: cannot import name 'EIGRP' from 'pyats.contrib' ↓

cause The EIGRP parser is in a submodule pyats.contrib.eigrp, not directly in pyats.contrib.

fix

Use 'from pyats.contrib.eigrp import EIGRP' instead of 'from pyats.contrib import EIGRP'

error AttributeError: module 'pyats.contrib' has no attribute 'triggers' ↓

cause Triggers are not automatically imported; you must import the specific trigger submodule.

fix

Import triggers explicitly: 'from pyats.contrib.triggers import some_trigger'

Warnings

breaking pyATS 26.x requires pyats-contrib 26.x. Mixing major versions will cause import errors or runtime crashes. ↓

fix Ensure pyats and pyats-contrib versions match: pip install 'pyats==26.3' 'pyats-contrib==26.3'

gotcha Many contrib modules (e.g., parsers, triggers) depend on pyats.aetest. Failing to import aetest first may cause cryptic AttributeErrors. ↓

fix Always import pyats.aetest before using contrib modules: from pyats import aetest

deprecated The 'contrib_utils' module is deprecated in 26.3 and will be removed in a future release. Use 'pyats.utils' instead. ↓

fix Replace 'from pyats.contrib import contrib_utils' with 'from pyats import utils'

Imports

contrib_library
wrong
```
from contrib import <module>
```
correct
```
from pyats.contrib import <module>
```
pyats-contrib is installed as pyats.contrib package; importing directly from 'contrib' is incorrect.
eigrp_lib
wrong
```
from pyats.eigrp import EIGRP
```
correct
```
from pyats.contrib.eigrp import EIGRP
```
EIGRP parser is under pyats.contrib.eigrp, not pyats.eigrp.

Quickstart

Parse EIGRP neighbors using the contrib library.

from pyats.contrib.eigrp import EIGRP

eigrp = EIGRP()
result = eigrp.parse('show ip eigrp neighbors')
print(result)