pyats.topology 26.6

pyATS Topology: Topology Objects and Testbed YAMLs

pyATS is an end-to-end testing ecosystem, specializing in data-driven and reusable testing, and engineered to be suitable for Agile, rapid development iterations. Extensible by design, pyATS enables developers start with small, simple and linear test cases, and scale towards large, complex and asynchronous test suites.

pyATS is initially developed internally in Cisco, and is now available to the general public starting late 2017 through Cisco DevNet. Visit the pyATS home page at

https://developer.cisco.com/site/pyats/

Topology Package

This is a sub-component of pyATS that models devices, testbeds and their interfaces in a Python object oriented fashion.

Topology objects include testbeds, devices, interfaces, links and segments. Links and segments are associated with interfaces, and can be accessed from their connected devices. An interface may reference either a link or a segment, but not both:

device.links
device.segments
testbed.links
testbed.segments

Segments may be declared in the testbed YAML topology section, and referenced from interface definitions:

topology:
    segments:
        segment-1:
            type: QINQ
    device-a:
        interfaces:
            Ethernet1:
                type: ethernet
                segment: segment-1

Requirements

pyATS currently supports Python 3.4+ on Linux & Mac systems. Windows platforms are not yet supported.

Quick Start

# install pyats as a whole
$ pip install pyats

# to upgrade this package manually
$ pip install --upgrade pyats.topology

# to install alpha/beta versions, add --pre
$ pip install --pre pyats.topology

For more information on setting up your Python development environment, such as creating virtual environment and installing pip on your system, please refer to Virtual Environment and Packages in Python tutorials.