genie

Genie - THE pyATS Standard Library

Genie is both a library framework and a test harness that facilitates rapid development, encourage re-usable and simplify writing test automation. Genie bundled with the modular architecture of pyATS framework accelerates and simplifies test automation leveraging all the perks of the Python programming language in an object-orienting fashion.

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.

Genie was initially developed internally in Cisco, and is now available to the general public starting early 2018 through Cisco DevNet_. Visit the Genie home page at

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

.. _Cisco DevNet: https://developer.cisco.com/

Component Breakdown

Conf Sub-component of Genie that Configures topology through Python object attributes, featuring a common object structure. These object's structures means that they are compatible with all operating systems and Management Interfaces (such as CLI/Yang/REST, etc.)

Ops Sub-component of Genie that Represents the operational state of the feature through object attributes. These object's structures means that they are compatible with all operating systems and Management Interfaces (such as CLI/Yang/REST, etc).

Harness Sub-component of Genie which bring the concept of event driven testing into the pyATS framework. With event driven testing, script and testcases are derived dynamically based on selected triggers and verification from the Genie SDK pool.

Utils as its name suggests - various utilities used throughout the infrastructure.

Requirements

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

Quick Start

.. code-block:: console

# install genie as a whole
$ pip install genie

# to upgrade this package manually
$ pip install --upgrade genie

# to install alpha/beta versions, add --pre
$ pip install --pre genie

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.

.. _Virtual Environment and Packages: https://docs.python.org/3/tutorial/venv.html

Example

Examples showcasing various features & idioms of coding can be found here: https://github.com/CiscoTestAutomation/examples