dbus/__init__.py

   1 """\
   2 Implements the public API for a D-Bus client. See the dbus.service module
   3 to export objects or claim well-known names.
   4
   5 ..
   6   for epydoc's benefit
   7
   8 :NewField SupportedUsage: Supported usage
   9 :NewField Constructor: Constructor
  10 """
  11
  12 # Copyright (C) 2003, 2004, 2005, 2006 Red Hat Inc. <http://www.redhat.com/>
  13 # Copyright (C) 2003 David Zeuthen
  14 # Copyright (C) 2004 Rob Taylor
  15 # Copyright (C) 2005, 2006 Collabora Ltd. <http://www.collabora.co.uk/>
  16 #
  17 # Licensed under the Academic Free License version 2.1
  18 #
  19 # This program is free software; you can redistribute it and/or modify
  20 # it under the terms of the GNU General Public License as published by
  21 # the Free Software Foundation; either version 2 of the License, or
  22 # (at your option) any later version.
  23 #
  24 # This program is distributed in the hope that it will be useful,
  25 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  26 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  27 # GNU General Public License for more details.
  28 #
  29 # You should have received a copy of the GNU General Public License
  30 # along with this program; if not, write to the Free Software
  31 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  32
  33 import os
  34
  35 __all__ = (
  36            # from _dbus
  37            'Bus', 'SystemBus', 'SessionBus', 'StarterBus',
  38            'Interface',
  39
  40            # from _dbus_bindings
  41            'get_default_main_loop', 'set_default_main_loop',
  42
  43            'validate_interface_name', 'validate_member_name',
  44            'validate_bus_name', 'validate_object_path',
  45            'validate_error_name',
  46
  47            'DBusException',
  48
  49            'ObjectPath', 'ByteArray', 'Signature', 'Byte', 'Boolean',
  50            'Int16', 'UInt16', 'Int32', 'UInt32', 'Int64', 'UInt64',
  51            'Double', 'String', 'Array', 'Struct', 'Dictionary', 'UTF8String',
  52
  53            # from exceptions
  54            'MissingErrorHandlerException', 'MissingReplyHandlerException',
  55            'ValidationException', 'IntrospectionParserException',
  56            'UnknownMethodException', 'NameExistsException',
  57
  58            # submodules
  59            'service', 'mainloop', 'lowlevel'
  60            )
  61 __docformat__ = 'restructuredtext'
  62
  63 try:
  64     from dbus._version import version, __version__
  65 except ImportError:
  66     pass
  67
  68 # OLPC Sugar compatibility
  69 import dbus.exceptions as exceptions
  70 import dbus.types as types
  71
  72 from _dbus_bindings import get_default_main_loop, set_default_main_loop,\
  73                            validate_interface_name, validate_member_name,\
  74                            validate_bus_name, validate_object_path,\
  75                            validate_error_name
  76 from _dbus_bindings import DBusException
  77 from dbus.exceptions import MissingErrorHandlerException, \
  78                             MissingReplyHandlerException, \
  79                             ValidationException, \
  80                             IntrospectionParserException, \
  81                             UnknownMethodException, \
  82                             NameExistsException
  83 from _dbus_bindings import ObjectPath, ByteArray, Signature, Byte, Boolean,\
  84                            Int16, UInt16, Int32, UInt32, Int64, UInt64,\
  85                            Double, String, Array, Struct, Dictionary, \
  86                            UTF8String
  87 from dbus._dbus import Bus, SystemBus, SessionBus, StarterBus, Interface
  88
  89
  90 if 'DBUS_PYTHON_NO_DEPRECATED' not in os.environ:
  91     from dbus._dbus import dbus_bindings    # for backwards compat