NetworkManager provides a detailed and capable D-Bus interface on the system bus. You can use this interface to query NetworkManager about the overall state of the network and details of network devices like current IP addresses or DHCP options, and to activate and deactivate network connections.
python-networkmanager takes this D-Bus interface and wraps D-Bus interfaces in classes and D-Bus properties in python properties. It also provides a command-line utility to inspect the configuration and (de-)activate connections.
All the code is contained in one module: NetworkManager. Using it is as simple as you think it is:
>>> import NetworkManager >>> NetworkManager.NetworkManager.Version '1.0.4'
NetworkManager exposes a lot of information via D-Bus and also allows full control of network settings. The full D-Bus API can be found on NetworkManager project website. All interfaces listed there have been wrapped in classes as listed below. With a few exceptions, they behave exactly like the D-Bus methods. These exceptions are for convenience and limited to this list:
This is the base class for all interface wrappers. It adds a few useful features to standard D-Bus interfaces:
Many of NetworkManagers D-Bus methods expect or return numeric constants, for which there are enums in the C source code. These constants, such as NM_STATE_CONNECTED_GLOBAL, can all be found in the NetworkManager module as well. The const() function can help you translate them to text. For example:
>>> NetworkManager.const('state', 40) 'connecting' >>> NetworkManager.const('device_type', 2) 'wifi'
This class represents the org.freedesktop.NetworkManager interface. Note that NetworkManager.NetworkManager actually is the singleton instance of this class.
This class represents the org.freedesktop.NetworkManager.Settings interface. Note that NetworkManager.Settings actually is the singleton instance of this class.
This class represents the org.freedesktop.NetworkManager.Settings.Connection interface.
This class represents the org.freedesktop.NetworkManager.Connection.Active interface.
This class represents the org.freedesktop.NetworkManager.AccessPoint interface.
These classes represent D-Bus interfaces for various types of hardware. Note that methods such as NetworkManager.GetDevices() will only return Device instances. To get the hardware-specific class, you can call the Device.SpecificDevice() method.
>>> [(dev.Interface, dev.SpecificDevice().__class__.__name__) ... for dev in NetworkManager.NetworkManager.GetDevices()] [('eth0', 'Wired'), ('wlan0', 'Wireless'), ('wwan0', 'Modem')]
These classes represent the various IP configuration interfaces.
Classes that can be used to handle and store secrets. Note that these are not for querying NetworkManager’s exisiting secret stores. For that the GetSecrets() method of the Connection class can be used.
This class represents the org.freedesktop.NetworkManager.VPN.Connection interface.
A class that can be used to query VPN plugins.