networkmanager/networkmanager.py

   1 # -*- coding: utf-8 -*-
   2
   3 import dbus
   4 from dbusclient import DBusClient, object_path
   5 from dbusclient.func import *
   6 from device import Device
   7 from activeconnection import ActiveConnection
   8 from base import Base
   9 from util import Enum
  10
  11 # gratuitous convertor to test writable properties
  12 def english_to_bool(v):
  13     if v == "yes":
  14         return True
  15     elif v == "no":
  16         return False
  17     return v
  18
  19 class NetworkManager(Base):
  20     """networkmanager
  21
  22     The NM client library
  23
  24      Methods:
  25     GetDevices ( ) → ao
  26     ActivateConnection ( s: service_name, o: connection, o: device, o: specific_object ) → o
  27     DeactivateConnection ( o: active_connection ) → nothing
  28     Sleep ( b: sleep ) → nothing
  29
  30      Signals:
  31     StateChanged ( u: state )
  32     PropertiesChanged ( a{sv}: properties )
  33     DeviceAdded ( o: device_path )
  34     DeviceRemoved ( o: device_path )
  35
  36      Properties:
  37     WirelessEnabled - b - (readwrite)
  38     WirelessHardwareEnabled - b - (read)
  39     ActiveConnections - ao - (read)
  40     State - u - (read) (NM_STATE)
  41
  42      Enumerated types:
  43     NM_STATE
  44     """
  45
  46     SERVICE = "org.freedesktop.NetworkManager"
  47     OPATH = "/org/freedesktop/NetworkManager"
  48     IFACE = "org.freedesktop.NetworkManager"
  49
  50     def __init__(self):
  51         super(NetworkManager, self).__init__(self.SERVICE, self.OPATH, default_interface=self.IFACE)
  52
  53
  54     class State(Enum):
  55         UNKNOWN = 0
  56         ASLEEP = 1
  57         CONNECTING = 2
  58         CONNECTED = 3
  59         DISCONNECTED = 4
  60
  61     "TODO find a good term for 'adaptor'"
  62
  63 #from dbusclient.adaptors import *
  64
  65 NetworkManager._add_adaptors(
  66     GetDevices = MA(seq_adaptor(Device._create)),
  67     ActivateConnection = MA(ActiveConnection, identity, object_path, object_path, object_path),
  68     DeactivateConnection = MA(void, object_path),
  69
  70     State = PA(NetworkManager.State),
  71     WirelessEnabled = PA(bool, english_to_bool),
  72     WirelessHardwareEnabled = PA(bool),
  73     ActiveConnections = PA(seq_adaptor(ActiveConnection)),
  74
  75     StateChanged = SA(NetworkManager.State),
  76     )
  77