blakme / debinterface

A simple Python library for dealing with the /etc/network/interfaces file in most Debian based distributions.

#Debinterface

This is a simple Python library for dealing with the /etc/network/interfaces file in most Debian based distributions.

Changelog:

2.0-beta - September 2014 : refactoring which breaks retrocompatibility 1.0 - Dec 15 2012

Read, writing, and editing supported.

Specify file locations in constants.py

May thanks to yan12125 (https://github.com/yan12125/debinterface)

Example usage:

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()