Skip to main content

Abstracton and Python API for Ansible Networking

Project description


Network-Runner is a python library that abstracts management and interaction with switching hardware to Ansible Networking. This library is not tested with all the modules included with Ansible Networking. In theory it should work with any switch that has compatible modules included with Ansible Networking if the provider tasks are added to this library’s Ansible role. See the contributor documentation for more information about adding support for an Ansible Networking module to this library.


The Network-Runner library consists of the following components:

Python API
Imported directly by python.
Ansible Role
Used by Ansible during Ansible invocation.

Use Cases

Python API

Any python application could need the ability to communicate with a switch to perform a task that network-runner is able to complete. The interaction with ansible is designed in a library style that will allow direct import and invocation in python independent of a running OpenStack deployment.

API Features

The following matrix indicates which features have been implmented.

  openvswitch junos nxos eos enos cumulus dellos10
Create VLAN N/A Y Y Y Y Y Y
Delete VLAN N/A Y Y Y Y Y Y
Delete Port Y Y Y Y Y Y Y
Config Access Port Y Y Y Y Y Y Y
Config Trunk Port N Y N Y Y Y N
List VLANs N N N N N N N
Add Trunk VLAN N N N N N N N
Delete Trunk VLAN N N N N N N N

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

network-runner-0.3.6.tar.gz (37.2 kB view hashes)

Uploaded source

Built Distribution

network_runner-0.3.6-py3-none-any.whl (72.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page