semvec/pypi-packages huggingface dataset:
debinterface 3.5.0
A simple Python library for dealing with the /etc/network/interfaces file in most Debian based distributions.
License: BSD
Keywords: debian,network,system,configuration

============
Debinterface
============

.. image:: https://travis-ci.org/nMustaki/debinterface.svg?branch=master
    :target: https://travis-ci.org/nMustaki/debinterface


This is a simple Python library for dealing with the /etc/network/interfaces file in most Debian based distributions.
This is forked from https://github.com/dggreenbaum/debinterface to refactor it and maybe extends it with wpa_supplicant handling

Complete documentation is on  `Read the docs <http://debinterface.readthedocs.io/en/latest/index.html>`_


Example usage
-------------

You'll find way `more examples here <http://debinterface.readthedocs.io/en/latest/quickstart.html>`_


.. sourcecode:: python

    import debinterface

    # Get a collection of objects representing the network adapters.
    adapters = debinterface.Interfaces().adapters

    # You get a list you can iterare over.
    # Each adapter has an 'export()' method that returns a dictionary of its options.
    # You can print the name of each adapter as follows:
    for adapter in adapters:
    	item = adapter.export()
    	print(item['name'])

    # Write your new interfaces file as follows:
    # Any changes made with setter methods will be reflected with the new write.
    interfaces = debinterface.Interfaces()
    interfaces.writeInterfaces()

    # A backup of your old interfaces file will be generated when writing over the previous interfaces file
    # By defaults these paths are used :
    # INTERFACES_PATH='/etc/network/interfaces'
    # BACKUP_PATH='/etc/network/interfaces.old'
    # Paths can be customized when instanciating the Interfaces class:
    interfaces = debinterface.Interfaces(interfaces_path='/home/interfaces', backup_path='/another/custom/path')

    # By defaults, interfaces file is read when instanciating the Interfaces class, to do it lazyly:
    interfaces = debinterface.Interfaces(update_adapters=False)
    interfaces.updateAdapters()


Run the tests
-------------

.. sourcecode:: shell

    pip install -r requirements_dev.txt
    py.test --cov=debinterface test