genie-trafficgen

26.3 verified Mon Apr 27 auth: no python

Genie Library for traffic generator connection support. Version 26.3 provides abstractions for controlling traffic generators (e.g., Ixia, Spirent) via Genie's unified API. Part of Cisco's pyATS/Genie ecosystem. Release cadence is irregular.

pip install genie-trafficgen

Common errors

error ModuleNotFoundError: No module named 'genie.trafficgen' ↓

cause Missing or outdated installation; package renamed or not installed.

fix

Run 'pip install genie-trafficgen' to install or upgrade.

error AttributeError: module 'genie' has no attribute 'trafficgen' ↓

cause Importing 'genie' directly instead of 'genie.trafficgen'.

fix

Change import to 'from genie.trafficgen import TrafficGen'.

error genie.trafficgen.exceptions.ConnectionError: Could not connect to host ↓

cause Incorrect host/port or protocol not supported.

fix

Verify device IP, port, and supported protocol (ssh/telnet). Check credentials if required.

Warnings

breaking API changes in version 26.x: TrafficGen class replaced abstract base, breaking old subclass patterns. ↓

fix Use TrafficGen directly instead of subclassing; migrate custom device support to new plugin system.

deprecated Direct import from `genie.libs.trafficgen` is deprecated; use `genie.trafficgen` instead. ↓

fix Change import to `from genie.trafficgen import TrafficGen`.

gotcha TrafficGen.connect() may hang indefinitely if device is unreachable; no timeout by default. ↓

fix Wrap in timeout or use async version with custom timeout param if available.

Imports

TrafficGen
wrong
```
from genie.libs.trafficgen import TrafficGen
```
correct
```
from genie.trafficgen import TrafficGen
```
Subpackage path changed in older versions; use genie.trafficgen directly
Ixia
```
from genie.trafficgen.ixia import Ixia
```
Ixia device class available under genie.trafficgen.ixia

Quickstart

Basic connection to a traffic generator using default SSH protocol.

from genie.trafficgen import TrafficGen
from genie.conf import Genie

tg = TrafficGen()
tg.connect(host='10.1.1.1', port=1234, protocol='ssh')
print('Connected to traffic generator:', tg.host)
tg.disconnect()