pynmcli

Simple python interface to Network Manager CLI


Keywords
debian, networking, networkmanager, python, ubuntu
License
MIT
Install
pip install pynmcli==1.0.5

Documentation

PyNmcli

Travis CI build status

Simple python interface to Network Manager CLI

PyNmcli provides a easy to use python (2.7+ or 3+) interface to Network Manager CLI. Official documentation of nmcli under: https://developer.gnome.org/NetworkManager/stable/nmcli.html

Dependencies

This project has no dependencies and works with python 2.7+ (python 3 as well)

This package directly uses Network-Manager.

Your can install it running the following command from shell:

sudo apt-get install network-manager

Installation

You may install this package in two ways:

  • Compile from code

    git clone https://github.com/fbarresi/PyNmcli.git
    cd PyNmcli
    python setup.py install
    
  • Pypi

    pip install pynmcli
    

Usage

Just import the package:

import pynmcli

and call Network Manager function just like:

result = pynmcli.NetworkManager('--version').execute()

or

result = pynmcli.NetworkManager.Device().wifi('list').execute()

you can also use some built-in help methods in order to convert output tables in more handy python dictionaries:

wifi_dict = pynmcli.get_data(pynmcli.NetworkManager.Device().wifi().execute())

Contribute

Whould you like to contribute to this project? YES, PLEASE!

Just fork this repository and submit your pull request.

Change log

  • Version 1.0.4 - Fixed localization issues in the use of nmcli
  • Version 1.0.3 - Enhanced usability
  • Version 1.0.2 - Added utils for converting cli outputs into python dicts
  • Version 1.0.1 - First working release
  • Version 1.0.0 - Test release