2026-06-02 05:14 @216.73.216.198 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
Markdown Format | JSON API | MCP Server Tool
Help on package dbus: NAME dbus DESCRIPTION Implements the public API for a D-Bus client. See the dbus.service module to export objects or claim well-known names. PACKAGE CONTENTS _compat _dbus _expat_introspect_parser bus connection decorators exceptions gi_service glib lowlevel mainloop (package) proxies server service types CLASSES _dbus_bindings._BytesBase(builtins.bytes) ByteArray _dbus_bindings._FloatBase(builtins.float) Double _dbus_bindings._LongBase(builtins.int) Boolean Byte Int16 Int32 Int64 UInt16 UInt32 UInt64 _dbus_bindings._StrBase(builtins.str) ObjectPath Signature builtins.Exception(builtins.BaseException) dbus.exceptions.DBusException dbus.exceptions.IntrospectionParserException dbus.exceptions.MissingErrorHandlerException dbus.exceptions.MissingReplyHandlerException dbus.exceptions.NameExistsException dbus.exceptions.UnknownMethodException dbus.exceptions.ValidationException builtins.dict(builtins.object) Dictionary builtins.list(builtins.object) Array builtins.object dbus.proxies.Interface builtins.str(builtins.object) String builtins.tuple(builtins.object) Struct dbus.bus.BusConnection(dbus.connection.Connection) dbus._dbus.Bus dbus._dbus.SessionBus dbus._dbus.StarterBus dbus._dbus.SystemBus class Array(builtins.list) | Array(iterable=(), /) | | dbus.Array([iterable][, signature][, variant_level]) | | An array of similar items, implemented as a subtype of list. | | As currently implemented, an Array behaves just like a list, but | with the addition of a ``signature`` property set by the constructor; | conversion of its items to D-Bus types is only done when it's sent in | a Message. This might change in future so validation is done earlier. | | :py:attr:`variant_level` must be non-negative; the default is 0. | | ``signature`` is the D-Bus signature string for a single element of the | array, or None. If not None it must represent a single complete type, the | type of a single array item; the signature of the whole Array may be | obtained by prepending ``a`` to the given signature. | | If None (the default), when the Array is sent over | D-Bus, the item signature will be guessed from the first element. | | Method resolution order: | Array | builtins.list | builtins.object | | Methods defined here: | | __init__(self, /, *args, **kwargs) | Initialize self. See help(type(self)) for accurate signature. | | __repr__(self, /) | Return repr(self). | | ---------------------------------------------------------------------- | Static methods defined here: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Data descriptors defined here: | | signature | The D-Bus signature of each element of this Array (a Signature instance) | | variant_level | Indicates how many nested Variant containers this object | is contained in: if a message's wire format has a variant containing a | variant containing an array, this is represented in Python by an | Array with variant_level==2. | | ---------------------------------------------------------------------- | Methods inherited from builtins.list: | | __add__(self, value, /) | Return self+value. | | __contains__(self, key, /) | Return key in self. | | __delitem__(self, key, /) | Delete self[key]. | | __eq__(self, value, /) | Return self==value. | | __ge__(self, value, /) | Return self>=value. | | __getattribute__(self, name, /) | Return getattr(self, name). | | __getitem__(...) | x.__getitem__(y) <==> x[y] | | __gt__(self, value, /) | Return self>value. | | __iadd__(self, value, /) | Implement self+=value. | | __imul__(self, value, /) | Implement self*=value. | | __iter__(self, /) | Implement iter(self). | | __le__(self, value, /) | Return self<=value. | | __len__(self, /) | Return len(self). | | __lt__(self, value, /) | Return self<value. | | __mul__(self, value, /) | Return self*value. | | __ne__(self, value, /) | Return self!=value. | | __reversed__(self, /) | Return a reverse iterator over the list. | | __rmul__(self, value, /) | Return value*self. | | __setitem__(self, key, value, /) | Set self[key] to value. | | __sizeof__(self, /) | Return the size of the list in memory, in bytes. | | append(self, object, /) | Append object to the end of the list. | | clear(self, /) | Remove all items from list. | | copy(self, /) | Return a shallow copy of the list. | | count(self, value, /) | Return number of occurrences of value. | | extend(self, iterable, /) | Extend list by appending elements from the iterable. | | index(self, value, start=0, stop=9223372036854775807, /) | Return first index of value. | | Raises ValueError if the value is not present. | | insert(self, index, object, /) | Insert object before index. | | pop(self, index=-1, /) | Remove and return item at index (default last). | | Raises IndexError if list is empty or index is out of range. | | remove(self, value, /) | Remove first occurrence of value. | | Raises ValueError if the value is not present. | | reverse(self, /) | Reverse *IN PLACE*. | | sort(self, /, *, key=None, reverse=False) | Sort the list in ascending order and return None. | | The sort is in-place (i.e. the list itself is modified) and stable (i.e. the | order of two equal elements is maintained). | | If a key function is given, apply it once to each list item and sort them, | ascending or descending, according to their function values. | | The reverse flag can be set to sort in descending order. | | ---------------------------------------------------------------------- | Class methods inherited from builtins.list: | | __class_getitem__(...) from builtins.type | See PEP 585 | | ---------------------------------------------------------------------- | Data and other attributes inherited from builtins.list: | | __hash__ = None class Boolean(_dbus_bindings._LongBase) | dbus.Boolean(value: bool[, variant_level: int]) | | A boolean, represented as a subtype of ``int`` (not ``bool``, because ``bool`` | cannot be subclassed). | | ``value`` is converted to 0 or 1 as if by ``int(bool(value))``. | | :py:attr:`variant_level` must be non-negative; the default is 0. | | .. py:attribute:: variant_level | | Indicates how many nested Variant containers this object | is contained in: if a message's wire format has a variant containing a | variant containing a boolean, this is represented in Python by a | Boolean with variant_level==2. | | Method resolution order: | Boolean | _dbus_bindings._LongBase | builtins.int | builtins.object | | Methods defined here: | | __repr__(self, /) | Return repr(self). | | __str__(self, /) | Return str(self). | | ---------------------------------------------------------------------- | Static methods defined here: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Methods inherited from _dbus_bindings._LongBase: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | ---------------------------------------------------------------------- | Methods inherited from builtins.int: | | __abs__(self, /) | abs(self) | | __add__(self, value, /) | Return self+value. | | __and__(self, value, /) | Return self&value. | | __bool__(self, /) | True if self else False | | __ceil__(...) | Ceiling of an Integral returns itself. | | __divmod__(self, value, /) | Return divmod(self, value). | | __eq__(self, value, /) | Return self==value. | | __float__(self, /) | float(self) | | __floor__(...) | Flooring an Integral returns itself. | | __floordiv__(self, value, /) | Return self//value. | | __format__(self, format_spec, /) | Default object formatter. | | __ge__(self, value, /) | Return self>=value. | | __getnewargs__(self, /) | | __gt__(self, value, /) | Return self>value. | | __hash__(self, /) | Return hash(self). | | __index__(self, /) | Return self converted to an integer, if self is suitable for use as an index into a list. | | __int__(self, /) | int(self) | | __invert__(self, /) | ~self | | __le__(self, value, /) | Return self<=value. | | __lshift__(self, value, /) | Return self<<value. | | __lt__(self, value, /) | Return self<value. | | __mod__(self, value, /) | Return self%value. | | __mul__(self, value, /) | Return self*value. | | __ne__(self, value, /) | Return self!=value. | | __neg__(self, /) | -self | | __or__(self, value, /) | Return self|value. | | __pos__(self, /) | +self | | __pow__(self, value, mod=None, /) | Return pow(self, value, mod). | | __radd__(self, value, /) | Return value+self. | | __rand__(self, value, /) | Return value&self. | | __rdivmod__(self, value, /) | Return divmod(value, self). | | __rfloordiv__(self, value, /) | Return value//self. | | __rlshift__(self, value, /) | Return value<<self. | | __rmod__(self, value, /) | Return value%self. | | __rmul__(self, value, /) | Return value*self. | | __ror__(self, value, /) | Return value|self. | | __round__(...) | Rounding an Integral returns itself. | | Rounding with an ndigits argument also returns an integer. | | __rpow__(self, value, mod=None, /) | Return pow(value, self, mod). | | __rrshift__(self, value, /) | Return value>>self. | | __rshift__(self, value, /) | Return self>>value. | | __rsub__(self, value, /) | Return value-self. | | __rtruediv__(self, value, /) | Return value/self. | | __rxor__(self, value, /) | Return value^self. | | __sizeof__(self, /) | Returns size in memory, in bytes. | | __sub__(self, value, /) | Return self-value. | | __truediv__(self, value, /) | Return self/value. | | __trunc__(...) | Truncating an Integral returns itself. | | __xor__(self, value, /) | Return self^value. | | as_integer_ratio(self, /) | Return integer ratio. | | Return a pair of integers, whose ratio is exactly equal to the original int | and with a positive denominator. | | >>> (10).as_integer_ratio() | (10, 1) | >>> (-10).as_integer_ratio() | (-10, 1) | >>> (0).as_integer_ratio() | (0, 1) | | bit_count(self, /) | Number of ones in the binary representation of the absolute value of self. | | Also known as the population count. | | >>> bin(13) | '0b1101' | >>> (13).bit_count() | 3 | | bit_length(self, /) | Number of bits necessary to represent self in binary. | | >>> bin(37) | '0b100101' | >>> (37).bit_length() | 6 | | conjugate(...) | Returns self, the complex conjugate of any int. | | to_bytes(self, /, length, byteorder, *, signed=False) | Return an array of bytes representing an integer. | | length | Length of bytes object to use. An OverflowError is raised if the | integer is not representable with the given number of bytes. | byteorder | The byte order used to represent the integer. If byteorder is 'big', | the most significant byte is at the beginning of the byte array. If | byteorder is 'little', the most significant byte is at the end of the | byte array. To request the native byte order of the host system, use | `sys.byteorder' as the byte order value. | signed | Determines whether two's complement is used to represent the integer. | If signed is False and a negative integer is given, an OverflowError | is raised. | | ---------------------------------------------------------------------- | Class methods inherited from builtins.int: | | from_bytes(bytes, byteorder, *, signed=False) from builtins.type | Return the integer represented by the given array of bytes. | | bytes | Holds the array of bytes to convert. The argument must either | support the buffer protocol or be an iterable object producing bytes. | Bytes and bytearray are examples of built-in objects that support the | buffer protocol. | byteorder | The byte order used to represent the integer. If byteorder is 'big', | the most significant byte is at the beginning of the byte array. If | byteorder is 'little', the most significant byte is at the end of the | byte array. To request the native byte order of the host system, use | `sys.byteorder' as the byte order value. | signed | Indicates whether two's complement is used to represent the integer. | | ---------------------------------------------------------------------- | Data descriptors inherited from builtins.int: | | denominator | the denominator of a rational number in lowest terms | | imag | the imaginary part of a complex number | | numerator | the numerator of a rational number in lowest terms | | real | the real part of a complex number class Bus(dbus.bus.BusConnection) | Bus(bus_type=0, private=False, mainloop=None) | | A connection to one of three possible standard buses, the SESSION, | SYSTEM, or STARTER bus. This class manages shared connections to those | buses. | | If you're trying to subclass `Bus`, you may be better off subclassing | `BusConnection`, which doesn't have all this magic. | | Method resolution order: | Bus | dbus.bus.BusConnection | dbus.connection.Connection | _dbus_bindings.Connection | builtins.object | | Methods defined here: | | __repr__(self) | Return repr(self). | | __str__ = __repr__(self) | | close(self) | close() | | Close the connection. | | get_connection(self) | Return self, for backwards compatibility with earlier dbus-python | versions where Bus was not a subclass of Connection. | | :Deprecated: since 0.80.0 | | ---------------------------------------------------------------------- | Static methods defined here: | | __new__(cls, bus_type=0, private=False, mainloop=None) | Constructor, returning an existing instance where appropriate. | | The returned instance is actually always an instance of `SessionBus`, | `SystemBus` or `StarterBus`. | | :Parameters: | `bus_type` : cls.TYPE_SESSION, cls.TYPE_SYSTEM or cls.TYPE_STARTER | Connect to the appropriate bus | `private` : bool | If true, never return an existing shared instance, but instead | return a private connection. | | :Deprecated: since 0.82.3. Use dbus.bus.BusConnection for | private connections. | | `mainloop` : dbus.mainloop.NativeMainLoop | The main loop to use. The default is to use the default | main loop if one has been set up, or raise an exception | if none has been. | :Changed: in dbus-python 0.80: | converted from a wrapper around a Connection to a Connection | subclass. | | get_session(private=False) | Static method that returns a connection to the session bus. | | :Parameters: | `private` : bool | If true, do not return a shared connection. | | get_starter(private=False) | Static method that returns a connection to the starter bus. | | :Parameters: | `private` : bool | If true, do not return a shared connection. | | get_system(private=False) | Static method that returns a connection to the system bus. | | :Parameters: | `private` : bool | If true, do not return a shared connection. | | ---------------------------------------------------------------------- | Methods inherited from dbus.bus.BusConnection: | | activate_name_owner(self, bus_name) | Return the unique name for the given bus name, activating it | if necessary and possible. | | If the name is already unique or this connection is not to a | bus daemon, just return it. | | :Returns: a bus name. If the given `bus_name` exists, the returned | name identifies its current owner; otherwise the returned name | does not exist. | :Raises DBusException: if the implementation has failed | to activate the given bus name. | :Since: 0.81.0 | | add_match_string(self, rule) | Arrange for this application to receive messages on the bus that | match the given rule. This version will block. | | :Parameters: | `rule` : str | The match rule | :Raises `DBusException`: on error. | :Since: 0.80.0 | | add_match_string_non_blocking(self, rule) | Arrange for this application to receive messages on the bus that | match the given rule. This version will not block, but any errors | will be ignored. | | | :Parameters: | `rule` : str | The match rule | :Raises `DBusException`: on error. | :Since: 0.80.0 | | add_signal_receiver(self, handler_function, signal_name=None, dbus_interface=None, bus_name=None, path=None, **keywords) | Arrange for the given function to be called when a signal matching | the parameters is received. | | :Parameters: | `handler_function` : callable | The function to be called. Its positional arguments will | be the arguments of the signal. By default it will receive | no keyword arguments, but see the description of | the optional keyword arguments below. | `signal_name` : str | The signal name; None (the default) matches all names | `dbus_interface` : str | The D-Bus interface name with which to qualify the signal; | None (the default) matches all interface names | `bus_name` : str | A bus name for the sender, which will be resolved to a | unique name if it is not already; None (the default) matches | any sender. | `path` : str | The object path of the object which must have emitted the | signal; None (the default) matches any object path | :Keywords: | `utf8_strings` : bool | If True, the handler function will receive any string | arguments as dbus.UTF8String objects (a subclass of str | guaranteed to be UTF-8). If False (default) it will receive | any string arguments as dbus.String objects (a subclass of | unicode). | `byte_arrays` : bool | If True, the handler function will receive any byte-array | arguments as dbus.ByteArray objects (a subclass of str). | If False (default) it will receive any byte-array | arguments as a dbus.Array of dbus.Byte (subclasses of: | a list of ints). | `sender_keyword` : str | If not None (the default), the handler function will receive | the unique name of the sending endpoint as a keyword | argument with this name. | `destination_keyword` : str | If not None (the default), the handler function will receive | the bus name of the destination (or None if the signal is a | broadcast, as is usual) as a keyword argument with this name. | `interface_keyword` : str | If not None (the default), the handler function will receive | the signal interface as a keyword argument with this name. | `member_keyword` : str | If not None (the default), the handler function will receive | the signal name as a keyword argument with this name. | `path_keyword` : str | If not None (the default), the handler function will receive | the object-path of the sending object as a keyword argument | with this name. | `message_keyword` : str | If not None (the default), the handler function will receive | the `dbus.lowlevel.SignalMessage` as a keyword argument with | this name. | `arg...` : unicode or UTF-8 str | If there are additional keyword parameters of the form | ``arg``\ *n*, match only signals where the *n*\ th argument | is the value given for that keyword parameter. As of this | time only string arguments can be matched (in particular, | object paths and signatures can't). | `named_service` : str | A deprecated alias for `bus_name`. | | get_name_owner(self, bus_name) | Return the unique connection name of the primary owner of the | given name. | | :Raises `DBusException`: if the `bus_name` has no owner | :Since: 0.81.0 | | get_object(self, bus_name, object_path, introspect=True, follow_name_owner_changes=False, **kwargs) | Return a local proxy for the given remote object. | | Method calls on the proxy are translated into method calls on the | remote object. | | :Parameters: | `bus_name` : str | A bus name (either the unique name or a well-known name) | of the application owning the object. The keyword argument | named_service is a deprecated alias for this. | `object_path` : str | The object path of the desired object | `introspect` : bool | If true (default), attempt to introspect the remote | object to find out supported methods and their signatures | `follow_name_owner_changes` : bool | If the object path is a well-known name and this parameter | is false (default), resolve the well-known name to the unique | name of its current owner and bind to that instead; if the | ownership of the well-known name changes in future, | keep communicating with the original owner. | This is necessary if the D-Bus API used is stateful. | | If the object path is a well-known name and this parameter | is true, whenever the well-known name changes ownership in | future, bind to the new owner, if any. | | If the given object path is a unique name, this parameter | has no effect. | | :Returns: a `dbus.proxies.ProxyObject` | :Raises `DBusException`: if resolving the well-known name to a | unique name fails | | get_unix_user(self, bus_name) | Get the numeric uid of the process owning the given bus name. | | :Parameters: | `bus_name` : str | A bus name, either unique or well-known | :Returns: a `dbus.UInt32` | :Since: 0.80.0 | | list_activatable_names(self) | Return a list of all names that can be activated on the bus. | | :Returns: a dbus.Array of dbus.UTF8String | :Since: 0.81.0 | | list_names(self) | Return a list of all currently-owned names on the bus. | | :Returns: a dbus.Array of dbus.UTF8String | :Since: 0.81.0 | | name_has_owner(self, bus_name) | Return True iff the given bus name has an owner on this bus. | | :Parameters: | `bus_name` : str | The bus name to look up | :Returns: a `bool` | | release_name(self, name) | Release a bus name. | | :Parameters: | `name` : str | The well-known name to be released | :Returns: `RELEASE_NAME_REPLY_RELEASED`, | `RELEASE_NAME_REPLY_NON_EXISTENT` | or `RELEASE_NAME_REPLY_NOT_OWNER` | :Raises `DBusException`: if the bus daemon cannot be contacted or | returns an error. | | remove_match_string(self, rule) | Arrange for this application to receive messages on the bus that | match the given rule. This version will block. | | :Parameters: | `rule` : str | The match rule | :Raises `DBusException`: on error. | :Since: 0.80.0 | | remove_match_string_non_blocking(self, rule) | Arrange for this application to receive messages on the bus that | match the given rule. This version will not block, but any errors | will be ignored. | | | :Parameters: | `rule` : str | The match rule | :Raises `DBusException`: on error. | :Since: 0.80.0 | | request_name(self, name, flags=0) | Request a bus name. | | :Parameters: | `name` : str | The well-known name to be requested | `flags` : dbus.UInt32 | A bitwise-OR of 0 or more of the flags | `NAME_FLAG_ALLOW_REPLACEMENT`, | `NAME_FLAG_REPLACE_EXISTING` | and `NAME_FLAG_DO_NOT_QUEUE` | :Returns: `REQUEST_NAME_REPLY_PRIMARY_OWNER`, | `REQUEST_NAME_REPLY_IN_QUEUE`, | `REQUEST_NAME_REPLY_EXISTS` or | `REQUEST_NAME_REPLY_ALREADY_OWNER` | :Raises `DBusException`: if the bus daemon cannot be contacted or | returns an error. | | start_service_by_name(self, bus_name, flags=0) | Start a service which will implement the given bus name on this Bus. | | :Parameters: | `bus_name` : str | The well-known bus name to be activated. | `flags` : dbus.UInt32 | Flags to pass to StartServiceByName (currently none are | defined) | | :Returns: A tuple of 2 elements. The first is always True, the | second is either START_REPLY_SUCCESS or | START_REPLY_ALREADY_RUNNING. | | :Raises `DBusException`: if the service could not be started. | :Since: 0.80.0 | | watch_name_owner(self, bus_name, callback) | Watch the unique connection name of the primary owner of the | given name. | | `callback` will be called with one argument, which is either the | unique connection name, or the empty string (meaning the name is | not owned). | | :Since: 0.81.0 | | ---------------------------------------------------------------------- | Data and other attributes inherited from dbus.bus.BusConnection: | | START_REPLY_ALREADY_RUNNING = 2 | | START_REPLY_SUCCESS = 1 | | TYPE_SESSION = 0 | | TYPE_STARTER = 2 | | TYPE_SYSTEM = 1 | | ---------------------------------------------------------------------- | Methods inherited from dbus.connection.Connection: | | __init__(self, *args, **kwargs) | Initialize self. See help(type(self)) for accurate signature. | | call_async(self, bus_name, object_path, dbus_interface, method, signature, args, reply_handler, error_handler, timeout=-1.0, byte_arrays=False, require_main_loop=True, **kwargs) | Call the given method, asynchronously. | | If the reply_handler is None, successful replies will be ignored. | If the error_handler is None, failures will be ignored. If both | are None, the implementation may request that no reply is sent. | | :Returns: The dbus.lowlevel.PendingCall. | :Since: 0.81.0 | | call_blocking(self, bus_name, object_path, dbus_interface, method, signature, args, timeout=-1.0, byte_arrays=False, **kwargs) | Call the given method, synchronously. | :Since: 0.81.0 | | call_on_disconnection(self, callable) | Arrange for `callable` to be called with one argument (this | Connection object) when the Connection becomes | disconnected. | | :Since: 0.83.0 | | remove_signal_receiver(self, handler_or_match, signal_name=None, dbus_interface=None, bus_name=None, path=None, **keywords) | | ---------------------------------------------------------------------- | Data descriptors inherited from dbus.connection.Connection: | | __dict__ | dictionary for instance variables (if defined) | | ---------------------------------------------------------------------- | Data and other attributes inherited from dbus.connection.Connection: | | ProxyObjectClass = <class 'dbus.proxies.ProxyObject'> | A proxy to the remote Object. | | A ProxyObject is provided by the Bus. ProxyObjects | have member functions, and can be called like normal Python objects. | | | ---------------------------------------------------------------------- | Methods inherited from _dbus_bindings.Connection: | | add_message_filter(...) | add_message_filter(callable) | | Add the given message filter to the internal list. | | Filters are handlers that are run on all incoming messages, prior to the | objects registered to handle object paths. | | Filters are run in the order that they were added. The same handler can | be added as a filter more than once, in which case it will be run more | than once. Filters added during a filter callback won't be run on the | message being processed. | | flush(...) | flush() | | Block until the outgoing message queue is empty. | | get_is_authenticated(...) | get_is_authenticated() -> bool | | Return true if this Connection was ever authenticated. | | get_is_connected(...) | get_is_connected() -> bool | | Return true if this Connection is connected. | | get_peer_unix_process_id(...) | get_peer_unix_process_id() -> long or None | | Get the UNIX process ID at the other end of the connection, if it has been | authenticated. Return None if this is a non-UNIX platform or the | connection has not been authenticated. | | get_peer_unix_user(...) | get_peer_unix_user() -> long or None | | Get the UNIX user ID at the other end of the connection, if it has been | authenticated. Return None if this is a non-UNIX platform or the | connection has not been authenticated. | | get_unique_name(...) | get_unique_name() -> str | | Return this application's unique name on this bus. | | :Raises DBusException: if the connection has no unique name yet | (for Bus objects this can't happen, for peer-to-peer connections | this means you haven't called `set_unique_name`) | | get_unix_fd(...) | get_unix_fd() -> int or None | | Get the connection's UNIX file descriptor, if any. | | This can be used for SELinux access control checks with ``getpeercon()`` | for example. **Do not** read or write to the file descriptor, or try to | ``select()`` on it. | | list_exported_child_objects(...) | list_exported_child_objects(path: str) -> list of str | | Return a list of the names of objects exported on this Connection as | direct children of the given object path. | | Each name returned may be converted to a valid object path using | ``dbus.ObjectPath('%s%s%s' % (path, (path != '/' and '/' or ''), name))``. | For the purposes of this function, every parent or ancestor of an exported | object is considered to be an exported object, even if it's only an object | synthesized by the library to support introspection. | | remove_message_filter(...) | remove_message_filter(callable) | | Remove the given message filter (see `add_message_filter` for details). | | :Raises LookupError: | The given callable is not among the registered filters | | send_message(...) | send_message(msg) -> long | | Queue the given message for sending, and return the message serial number. | | :Parameters: | `msg` : dbus.lowlevel.Message | The message to be sent. | | send_message_with_reply(...) | send_message_with_reply(msg, reply_handler, timeout_s=-1, require_main_loop=False) -> dbus.lowlevel.PendingCall | | Queue the message for sending; expect a reply via the returned PendingCall, | which can also be used to cancel the pending call. | | :Parameters: | `msg` : dbus.lowlevel.Message | The message to be sent | `reply_handler` : callable | Asynchronous reply handler: will be called with one positional | parameter, a Message instance representing the reply. | `timeout_s` : float | If the reply takes more than this many seconds, a timeout error | will be created locally and raised instead. If this timeout is | negative (default), a sane default (supplied by libdbus) is used. | `require_main_loop` : bool | If True, raise RuntimeError if this Connection does not have a main | loop configured. If False (default) and there is no main loop, you are | responsible for calling block() on the PendingCall. | | send_message_with_reply_and_block(...) | send_message_with_reply_and_block(msg, timeout_s=-1) -> dbus.lowlevel.Message | | Send the message and block while waiting for a reply. | | This does not re-enter the main loop, so it can lead to a deadlock, if | the called method tries to make a synchronous call to a method in this | application. As such, it's probably a bad idea. | | :Parameters: | `msg` : dbus.lowlevel.Message | The message to be sent | `timeout_s` : float | If the reply takes more than this many seconds, a timeout error | will be created locally and raised instead. If this timeout is | negative (default), a sane default (supplied by libdbus) is used. | :Returns: | A `dbus.lowlevel.Message` instance (probably a `dbus.lowlevel.MethodReturnMessage`) on success | :Raises dbus.DBusException: | On error (including if the reply arrives but is an | error message) | | set_allow_anonymous(...) | set_allow_anonymous(bool) | | Allows anonymous clients. Call this on the server side of a connection in a on_connection_added callback | | set_exit_on_disconnect(...) | set_exit_on_disconnect(bool) | | Set whether the C function ``_exit`` will be called when this Connection | becomes disconnected. This will cause the program to exit without calling | any cleanup code or exit handlers. | | The default is for this feature to be disabled for Connections and enabled | for Buses. | | set_unique_name(...) | set_unique_name(str) | | Set this application's unique name on this bus. Raise ValueError if it has | already been set. class Byte(_dbus_bindings._LongBase) | dbus.Byte(integer or bytes of length 1[, variant_level]) | | An unsigned byte: a subtype of int, with range restricted to [0, 255]. | | A Byte `b` may be converted to a ``str`` of length 1 via | ``str(b) == chr(b)`` (Python 2) or to a ``bytes`` of length 1 | via ``bytes([b])`` (Python 3). | | Most of the time you don't want to use this class - it mainly exists | for symmetry with the other D-Bus types. See `dbus.ByteArray` for a | better way to handle arrays of Byte. | | :py:attr:`variant_level` must be non-negative; the default is 0. | | .. py:attribute:: variant_level | | Indicates how many nested Variant containers this object | is contained in: if a message's wire format has a variant containing a | variant containing a byte, this is represented in Python by a | Byte with variant_level==2. | | Method resolution order: | Byte | _dbus_bindings._LongBase | builtins.int | builtins.object | | Methods defined here: | | __str__(self, /) | Return str(self). | | ---------------------------------------------------------------------- | Static methods defined here: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Methods inherited from _dbus_bindings._LongBase: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __repr__(self, /) | Return repr(self). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | ---------------------------------------------------------------------- | Methods inherited from builtins.int: | | __abs__(self, /) | abs(self) | | __add__(self, value, /) | Return self+value. | | __and__(self, value, /) | Return self&value. | | __bool__(self, /) | True if self else False | | __ceil__(...) | Ceiling of an Integral returns itself. | | __divmod__(self, value, /) | Return divmod(self, value). | | __eq__(self, value, /) | Return self==value. | | __float__(self, /) | float(self) | | __floor__(...) | Flooring an Integral returns itself. | | __floordiv__(self, value, /) | Return self//value. | | __format__(self, format_spec, /) | Default object formatter. | | __ge__(self, value, /) | Return self>=value. | | __getnewargs__(self, /) | | __gt__(self, value, /) | Return self>value. | | __hash__(self, /) | Return hash(self). | | __index__(self, /) | Return self converted to an integer, if self is suitable for use as an index into a list. | | __int__(self, /) | int(self) | | __invert__(self, /) | ~self | | __le__(self, value, /) | Return self<=value. | | __lshift__(self, value, /) | Return self<<value. | | __lt__(self, value, /) | Return self<value. | | __mod__(self, value, /) | Return self%value. | | __mul__(self, value, /) | Return self*value. | | __ne__(self, value, /) | Return self!=value. | | __neg__(self, /) | -self | | __or__(self, value, /) | Return self|value. | | __pos__(self, /) | +self | | __pow__(self, value, mod=None, /) | Return pow(self, value, mod). | | __radd__(self, value, /) | Return value+self. | | __rand__(self, value, /) | Return value&self. | | __rdivmod__(self, value, /) | Return divmod(value, self). | | __rfloordiv__(self, value, /) | Return value//self. | | __rlshift__(self, value, /) | Return value<<self. | | __rmod__(self, value, /) | Return value%self. | | __rmul__(self, value, /) | Return value*self. | | __ror__(self, value, /) | Return value|self. | | __round__(...) | Rounding an Integral returns itself. | | Rounding with an ndigits argument also returns an integer. | | __rpow__(self, value, mod=None, /) | Return pow(value, self, mod). | | __rrshift__(self, value, /) | Return value>>self. | | __rshift__(self, value, /) | Return self>>value. | | __rsub__(self, value, /) | Return value-self. | | __rtruediv__(self, value, /) | Return value/self. | | __rxor__(self, value, /) | Return value^self. | | __sizeof__(self, /) | Returns size in memory, in bytes. | | __sub__(self, value, /) | Return self-value. | | __truediv__(self, value, /) | Return self/value. | | __trunc__(...) | Truncating an Integral returns itself. | | __xor__(self, value, /) | Return self^value. | | as_integer_ratio(self, /) | Return integer ratio. | | Return a pair of integers, whose ratio is exactly equal to the original int | and with a positive denominator. | | >>> (10).as_integer_ratio() | (10, 1) | >>> (-10).as_integer_ratio() | (-10, 1) | >>> (0).as_integer_ratio() | (0, 1) | | bit_count(self, /) | Number of ones in the binary representation of the absolute value of self. | | Also known as the population count. | | >>> bin(13) | '0b1101' | >>> (13).bit_count() | 3 | | bit_length(self, /) | Number of bits necessary to represent self in binary. | | >>> bin(37) | '0b100101' | >>> (37).bit_length() | 6 | | conjugate(...) | Returns self, the complex conjugate of any int. | | to_bytes(self, /, length, byteorder, *, signed=False) | Return an array of bytes representing an integer. | | length | Length of bytes object to use. An OverflowError is raised if the | integer is not representable with the given number of bytes. | byteorder | The byte order used to represent the integer. If byteorder is 'big', | the most significant byte is at the beginning of the byte array. If | byteorder is 'little', the most significant byte is at the end of the | byte array. To request the native byte order of the host system, use | `sys.byteorder' as the byte order value. | signed | Determines whether two's complement is used to represent the integer. | If signed is False and a negative integer is given, an OverflowError | is raised. | | ---------------------------------------------------------------------- | Class methods inherited from builtins.int: | | from_bytes(bytes, byteorder, *, signed=False) from builtins.type | Return the integer represented by the given array of bytes. | | bytes | Holds the array of bytes to convert. The argument must either | support the buffer protocol or be an iterable object producing bytes. | Bytes and bytearray are examples of built-in objects that support the | buffer protocol. | byteorder | The byte order used to represent the integer. If byteorder is 'big', | the most significant byte is at the beginning of the byte array. If | byteorder is 'little', the most significant byte is at the end of the | byte array. To request the native byte order of the host system, use | `sys.byteorder' as the byte order value. | signed | Indicates whether two's complement is used to represent the integer. | | ---------------------------------------------------------------------- | Data descriptors inherited from builtins.int: | | denominator | the denominator of a rational number in lowest terms | | imag | the imaginary part of a complex number | | numerator | the numerator of a rational number in lowest terms | | real | the real part of a complex number class ByteArray(_dbus_bindings._BytesBase) | ByteArray(str) | | ByteArray is a subtype of :py:class:`bytes` (an alias for | :py:class:`str` in Python 2 but a distinct type in Python 3) | which can be used when you want an | efficient immutable representation of a D-Bus byte array (signature ``ay``). | | By default, when byte arrays are converted from D-Bus to Python, they | come out as a `dbus.Array` of `dbus.Byte`. This is just for symmetry with | the other D-Bus types - in practice, what you usually want is the byte | array represented as a string, using this class. To get this, pass the | ``byte_arrays=True`` keyword argument to any of these methods: | | * any D-Bus method proxy, or ``connect_to_signal``, on the objects returned | by `Bus.get_object` | * any D-Bus method on a `dbus.Interface` | * `dbus.Interface.connect_to_signal` | * `Bus.add_signal_receiver` | | Import via:: | | from dbus import ByteArray | | Constructor:: | | ByteArray(str) | | Method resolution order: | ByteArray | _dbus_bindings._BytesBase | builtins.bytes | builtins.object | | Methods inherited from _dbus_bindings._BytesBase: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __repr__(self, /) | Return repr(self). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | ---------------------------------------------------------------------- | Static methods inherited from _dbus_bindings._BytesBase: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Methods inherited from builtins.bytes: | | __add__(self, value, /) | Return self+value. | | __contains__(self, key, /) | Return key in self. | | __eq__(self, value, /) | Return self==value. | | __ge__(self, value, /) | Return self>=value. | | __getitem__(self, key, /) | Return self[key]. | | __getnewargs__(...) | | __gt__(self, value, /) | Return self>value. | | __hash__(self, /) | Return hash(self). | | __iter__(self, /) | Implement iter(self). | | __le__(self, value, /) | Return self<=value. | | __len__(self, /) | Return len(self). | | __lt__(self, value, /) | Return self<value. | | __mod__(self, value, /) | Return self%value. | | __mul__(self, value, /) | Return self*value. | | __ne__(self, value, /) | Return self!=value. | | __rmod__(self, value, /) | Return value%self. | | __rmul__(self, value, /) | Return value*self. | | __str__(self, /) | Return str(self). | | capitalize(...) | B.capitalize() -> copy of B | | Return a copy of B with only its first character capitalized (ASCII) | and the rest lower-cased. | | center(self, width, fillchar=b' ', /) | Return a centered string of length width. | | Padding is done using the specified fill character. | | count(...) | B.count(sub[, start[, end]]) -> int | | Return the number of non-overlapping occurrences of subsection sub in | bytes B[start:end]. Optional arguments start and end are interpreted | as in slice notation. | | decode(self, /, encoding='utf-8', errors='strict') | Decode the bytes using the codec registered for encoding. | | encoding | The encoding with which to decode the bytes. | errors | The error handling scheme to use for the handling of decoding errors. | The default is 'strict' meaning that decoding errors raise a | UnicodeDecodeError. Other possible values are 'ignore' and 'replace' | as well as any other name registered with codecs.register_error that | can handle UnicodeDecodeErrors. | | endswith(...) | B.endswith(suffix[, start[, end]]) -> bool | | Return True if B ends with the specified suffix, False otherwise. | With optional start, test B beginning at that position. | With optional end, stop comparing B at that position. | suffix can also be a tuple of bytes to try. | | expandtabs(self, /, tabsize=8) | Return a copy where all tab characters are expanded using spaces. | | If tabsize is not given, a tab size of 8 characters is assumed. | | find(...) | B.find(sub[, start[, end]]) -> int | | Return the lowest index in B where subsection sub is found, | such that sub is contained within B[start,end]. Optional | arguments start and end are interpreted as in slice notation. | | Return -1 on failure. | | hex(...) | Create a string of hexadecimal numbers from a bytes object. | | sep | An optional single character or byte to separate hex bytes. | bytes_per_sep | How many bytes between separators. Positive values count from the | right, negative values count from the left. | | Example: | >>> value = b'\xb9\x01\xef' | >>> value.hex() | 'b901ef' | >>> value.hex(':') | 'b9:01:ef' | >>> value.hex(':', 2) | 'b9:01ef' | >>> value.hex(':', -2) | 'b901:ef' | | index(...) | B.index(sub[, start[, end]]) -> int | | Return the lowest index in B where subsection sub is found, | such that sub is contained within B[start,end]. Optional | arguments start and end are interpreted as in slice notation. | | Raises ValueError when the subsection is not found. | | isalnum(...) | B.isalnum() -> bool | | Return True if all characters in B are alphanumeric | and there is at least one character in B, False otherwise. | | isalpha(...) | B.isalpha() -> bool | | Return True if all characters in B are alphabetic | and there is at least one character in B, False otherwise. | | isascii(...) | B.isascii() -> bool | | Return True if B is empty or all characters in B are ASCII, | False otherwise. | | isdigit(...) | B.isdigit() -> bool | | Return True if all characters in B are digits | and there is at least one character in B, False otherwise. | | islower(...) | B.islower() -> bool | | Return True if all cased characters in B are lowercase and there is | at least one cased character in B, False otherwise. | | isspace(...) | B.isspace() -> bool | | Return True if all characters in B are whitespace | and there is at least one character in B, False otherwise. | | istitle(...) | B.istitle() -> bool | | Return True if B is a titlecased string and there is at least one | character in B, i.e. uppercase characters may only follow uncased | characters and lowercase characters only cased ones. Return False | otherwise. | | isupper(...) | B.isupper() -> bool | | Return True if all cased characters in B are uppercase and there is | at least one cased character in B, False otherwise. | | join(self, iterable_of_bytes, /) | Concatenate any number of bytes objects. | | The bytes whose method is called is inserted in between each pair. | | The result is returned as a new bytes object. | | Example: b'.'.join([b'ab', b'pq', b'rs']) -> b'ab.pq.rs'. | | ljust(self, width, fillchar=b' ', /) | Return a left-justified string of length width. | | Padding is done using the specified fill character. | | lower(...) | B.lower() -> copy of B | | Return a copy of B with all ASCII characters converted to lowercase. | | lstrip(self, bytes=None, /) | Strip leading bytes contained in the argument. | | If the argument is omitted or None, strip leading ASCII whitespace. | | partition(self, sep, /) | Partition the bytes into three parts using the given separator. | | This will search for the separator sep in the bytes. If the separator is found, | returns a 3-tuple containing the part before the separator, the separator | itself, and the part after it. | | If the separator is not found, returns a 3-tuple containing the original bytes | object and two empty bytes objects. | | removeprefix(self, prefix, /) | Return a bytes object with the given prefix string removed if present. | | If the bytes starts with the prefix string, return bytes[len(prefix):]. | Otherwise, return a copy of the original bytes. | | removesuffix(self, suffix, /) | Return a bytes object with the given suffix string removed if present. | | If the bytes ends with the suffix string and that suffix is not empty, | return bytes[:-len(prefix)]. Otherwise, return a copy of the original | bytes. | | replace(self, old, new, count=-1, /) | Return a copy with all occurrences of substring old replaced by new. | | count | Maximum number of occurrences to replace. | -1 (the default value) means replace all occurrences. | | If the optional argument count is given, only the first count occurrences are | replaced. | | rfind(...) | B.rfind(sub[, start[, end]]) -> int | | Return the highest index in B where subsection sub is found, | such that sub is contained within B[start,end]. Optional | arguments start and end are interpreted as in slice notation. | | Return -1 on failure. | | rindex(...) | B.rindex(sub[, start[, end]]) -> int | | Return the highest index in B where subsection sub is found, | such that sub is contained within B[start,end]. Optional | arguments start and end are interpreted as in slice notation. | | Raise ValueError when the subsection is not found. | | rjust(self, width, fillchar=b' ', /) | Return a right-justified string of length width. | | Padding is done using the specified fill character. | | rpartition(self, sep, /) | Partition the bytes into three parts using the given separator. | | This will search for the separator sep in the bytes, starting at the end. If | the separator is found, returns a 3-tuple containing the part before the | separator, the separator itself, and the part after it. | | If the separator is not found, returns a 3-tuple containing two empty bytes | objects and the original bytes object. | | rsplit(self, /, sep=None, maxsplit=-1) | Return a list of the sections in the bytes, using sep as the delimiter. | | sep | The delimiter according which to split the bytes. | None (the default value) means split on ASCII whitespace characters | (space, tab, return, newline, formfeed, vertical tab). | maxsplit | Maximum number of splits to do. | -1 (the default value) means no limit. | | Splitting is done starting at the end of the bytes and working to the front. | | rstrip(self, bytes=None, /) | Strip trailing bytes contained in the argument. | | If the argument is omitted or None, strip trailing ASCII whitespace. | | split(self, /, sep=None, maxsplit=-1) | Return a list of the sections in the bytes, using sep as the delimiter. | | sep | The delimiter according which to split the bytes. | None (the default value) means split on ASCII whitespace characters | (space, tab, return, newline, formfeed, vertical tab). | maxsplit | Maximum number of splits to do. | -1 (the default value) means no limit. | | splitlines(self, /, keepends=False) | Return a list of the lines in the bytes, breaking at line boundaries. | | Line breaks are not included in the resulting list unless keepends is given and | true. | | startswith(...) | B.startswith(prefix[, start[, end]]) -> bool | | Return True if B starts with the specified prefix, False otherwise. | With optional start, test B beginning at that position. | With optional end, stop comparing B at that position. | prefix can also be a tuple of bytes to try. | | strip(self, bytes=None, /) | Strip leading and trailing bytes contained in the argument. | | If the argument is omitted or None, strip leading and trailing ASCII whitespace. | | swapcase(...) | B.swapcase() -> copy of B | | Return a copy of B with uppercase ASCII characters converted | to lowercase ASCII and vice versa. | | title(...) | B.title() -> copy of B | | Return a titlecased version of B, i.e. ASCII words start with uppercase | characters, all remaining cased characters have lowercase. | | translate(self, table, /, delete=b'') | Return a copy with each character mapped by the given translation table. | | table | Translation table, which must be a bytes object of length 256. | | All characters occurring in the optional argument delete are removed. | The remaining characters are mapped through the given translation table. | | upper(...) | B.upper() -> copy of B | | Return a copy of B with all ASCII characters converted to uppercase. | | zfill(self, width, /) | Pad a numeric string with zeros on the left, to fill a field of the given width. | | The original string is never truncated. | | ---------------------------------------------------------------------- | Class methods inherited from builtins.bytes: | | fromhex(string, /) from builtins.type | Create a bytes object from a string of hexadecimal numbers. | | Spaces between two numbers are accepted. | Example: bytes.fromhex('B9 01EF') -> b'\\xb9\\x01\\xef'. | | ---------------------------------------------------------------------- | Static methods inherited from builtins.bytes: | | maketrans(frm, to, /) | Return a translation table useable for the bytes or bytearray translate method. | | The returned table will be one where each byte in frm is mapped to the byte at | the same position in to. | | The bytes objects frm and to must be of the same length. class DBusException(builtins.Exception) | DBusException(*args, **kwargs) | | Method resolution order: | DBusException | builtins.Exception | builtins.BaseException | builtins.object | | Methods defined here: | | __init__(self, *args, **kwargs) | Initialize self. See help(type(self)) for accurate signature. | | __str__(self) | Return a str error | | __unicode__(self) | Return a unicode error | | get_dbus_message(self) | | get_dbus_name(self) | | ---------------------------------------------------------------------- | Data descriptors defined here: | | __weakref__ | list of weak references to the object (if defined) | | ---------------------------------------------------------------------- | Data and other attributes defined here: | | include_traceback = False | | ---------------------------------------------------------------------- | Static methods inherited from builtins.Exception: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Methods inherited from builtins.BaseException: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __reduce__(...) | Helper for pickle. | | __repr__(self, /) | Return repr(self). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | __setstate__(...) | | with_traceback(...) | Exception.with_traceback(tb) -- | set self.__traceback__ to tb and return self. | | ---------------------------------------------------------------------- | Data descriptors inherited from builtins.BaseException: | | __cause__ | exception cause | | __context__ | exception context | | __dict__ | | __suppress_context__ | | __traceback__ | | args class Dictionary(builtins.dict) | dbus.Dictionary(mapping_or_iterable=(), signature=None, variant_level=0) | | An mapping whose keys are similar and whose values are similar, | implemented as a subtype of dict. | | As currently implemented, a Dictionary behaves just like a dict, but | with the addition of a ``signature`` property set by the constructor; | conversion of its items to D-Bus types is only done when it's sent in | a Message. This may change in future so validation is done earlier. | | :py:attr:`variant_level` must be non-negative; the default is 0. | | ``signature`` is either a string or None. If a string, it must consist | of exactly two complete type signatures, representing the 'key' type | (which must be a primitive type, i.e. one of "bdginoqstuxy") | and the 'value' type. The signature of the whole Dictionary will be | ``a{xx}`` where ``xx`` is replaced by the given signature. | | If it is None (the default), when the Dictionary is sent over | D-Bus, the key and value signatures will be guessed from an arbitrary | element of the Dictionary. | | Method resolution order: | Dictionary | builtins.dict | builtins.object | | Methods defined here: | | __init__(self, /, *args, **kwargs) | Initialize self. See help(type(self)) for accurate signature. | | __repr__(self, /) | Return repr(self). | | ---------------------------------------------------------------------- | Static methods defined here: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Data descriptors defined here: | | signature | The D-Bus signature of each key in this Dictionary, followed by that of each value in this Dictionary, as a Signature instance. | | variant_level | Indicates how many nested Variant containers this object | is contained in: if a message's wire format has a variant containing a | variant containing a dictionary, this is represented in Python by a | Dictionary with variant_level==2. | | ---------------------------------------------------------------------- | Methods inherited from builtins.dict: | | __contains__(self, key, /) | True if the dictionary has the specified key, else False. | | __delitem__(self, key, /) | Delete self[key]. | | __eq__(self, value, /) | Return self==value. | | __ge__(self, value, /) | Return self>=value. | | __getattribute__(self, name, /) | Return getattr(self, name). | | __getitem__(...) | x.__getitem__(y) <==> x[y] | | __gt__(self, value, /) | Return self>value. | | __ior__(self, value, /) | Return self|=value. | | __iter__(self, /) | Implement iter(self). | | __le__(self, value, /) | Return self<=value. | | __len__(self, /) | Return len(self). | | __lt__(self, value, /) | Return self<value. | | __ne__(self, value, /) | Return self!=value. | | __or__(self, value, /) | Return self|value. | | __reversed__(self, /) | Return a reverse iterator over the dict keys. | | __ror__(self, value, /) | Return value|self. | | __setitem__(self, key, value, /) | Set self[key] to value. | | __sizeof__(...) | D.__sizeof__() -> size of D in memory, in bytes | | clear(...) | D.clear() -> None. Remove all items from D. | | copy(...) | D.copy() -> a shallow copy of D | | get(self, key, default=None, /) | Return the value for key if key is in the dictionary, else default. | | items(...) | D.items() -> a set-like object providing a view on D's items | | keys(...) | D.keys() -> a set-like object providing a view on D's keys | | pop(...) | D.pop(k[,d]) -> v, remove specified key and return the corresponding value. | | If the key is not found, return the default if given; otherwise, | raise a KeyError. | | popitem(self, /) | Remove and return a (key, value) pair as a 2-tuple. | | Pairs are returned in LIFO (last-in, first-out) order. | Raises KeyError if the dict is empty. | | setdefault(self, key, default=None, /) | Insert key with a value of default if key is not in the dictionary. | | Return the value for key if key is in the dictionary, else default. | | update(...) | D.update([E, ]**F) -> None. Update D from dict/iterable E and F. | If E is present and has a .keys() method, then does: for k in E: D[k] = E[k] | If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v | In either case, this is followed by: for k in F: D[k] = F[k] | | values(...) | D.values() -> an object providing a view on D's values | | ---------------------------------------------------------------------- | Class methods inherited from builtins.dict: | | __class_getitem__(...) from builtins.type | See PEP 585 | | fromkeys(iterable, value=None, /) from builtins.type | Create a new dictionary with keys from iterable and values set to value. | | ---------------------------------------------------------------------- | Data and other attributes inherited from builtins.dict: | | __hash__ = None class Double(_dbus_bindings._FloatBase) | Double(x=0, /) | | A double-precision floating point number (a subtype of float). | | Method resolution order: | Double | _dbus_bindings._FloatBase | builtins.float | builtins.object | | Methods inherited from _dbus_bindings._FloatBase: | | __repr__(self, /) | Return repr(self). | | __str__(self, /) | Return str(self). | | ---------------------------------------------------------------------- | Static methods inherited from _dbus_bindings._FloatBase: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Data descriptors inherited from _dbus_bindings._FloatBase: | | variant_level | The number of nested variants wrapping the real data. 0 if not in a variant. | | ---------------------------------------------------------------------- | Methods inherited from builtins.float: | | __abs__(self, /) | abs(self) | | __add__(self, value, /) | Return self+value. | | __bool__(self, /) | True if self else False | | __ceil__(self, /) | Return the ceiling as an Integral. | | __divmod__(self, value, /) | Return divmod(self, value). | | __eq__(self, value, /) | Return self==value. | | __float__(self, /) | float(self) | | __floor__(self, /) | Return the floor as an Integral. | | __floordiv__(self, value, /) | Return self//value. | | __format__(self, format_spec, /) | Formats the float according to format_spec. | | __ge__(self, value, /) | Return self>=value. | | __getattribute__(self, name, /) | Return getattr(self, name). | | __getnewargs__(self, /) | | __gt__(self, value, /) | Return self>value. | | __hash__(self, /) | Return hash(self). | | __int__(self, /) | int(self) | | __le__(self, value, /) | Return self<=value. | | __lt__(self, value, /) | Return self<value. | | __mod__(self, value, /) | Return self%value. | | __mul__(self, value, /) | Return self*value. | | __ne__(self, value, /) | Return self!=value. | | __neg__(self, /) | -self | | __pos__(self, /) | +self | | __pow__(self, value, mod=None, /) | Return pow(self, value, mod). | | __radd__(self, value, /) | Return value+self. | | __rdivmod__(self, value, /) | Return divmod(value, self). | | __rfloordiv__(self, value, /) | Return value//self. | | __rmod__(self, value, /) | Return value%self. | | __rmul__(self, value, /) | Return value*self. | | __round__(self, ndigits=None, /) | Return the Integral closest to x, rounding half toward even. | | When an argument is passed, work like built-in round(x, ndigits). | | __rpow__(self, value, mod=None, /) | Return pow(value, self, mod). | | __rsub__(self, value, /) | Return value-self. | | __rtruediv__(self, value, /) | Return value/self. | | __sub__(self, value, /) | Return self-value. | | __truediv__(self, value, /) | Return self/value. | | __trunc__(self, /) | Return the Integral closest to x between 0 and x. | | as_integer_ratio(self, /) | Return integer ratio. | | Return a pair of integers, whose ratio is exactly equal to the original float | and with a positive denominator. | | Raise OverflowError on infinities and a ValueError on NaNs. | | >>> (10.0).as_integer_ratio() | (10, 1) | >>> (0.0).as_integer_ratio() | (0, 1) | >>> (-.25).as_integer_ratio() | (-1, 4) | | conjugate(self, /) | Return self, the complex conjugate of any float. | | hex(self, /) | Return a hexadecimal representation of a floating-point number. | | >>> (-0.1).hex() | '-0x1.999999999999ap-4' | >>> 3.14159.hex() | '0x1.921f9f01b866ep+1' | | is_integer(self, /) | Return True if the float is an integer. | | ---------------------------------------------------------------------- | Class methods inherited from builtins.float: | | __getformat__(typestr, /) from builtins.type | You probably don't want to use this function. | | typestr | Must be 'double' or 'float'. | | It exists mainly to be used in Python's test suite. | | This function returns whichever of 'unknown', 'IEEE, big-endian' or 'IEEE, | little-endian' best describes the format of floating point numbers used by the | C type named by typestr. | | __setformat__(typestr, fmt, /) from builtins.type | You probably don't want to use this function. | | typestr | Must be 'double' or 'float'. | fmt | Must be one of 'unknown', 'IEEE, big-endian' or 'IEEE, little-endian', | and in addition can only be one of the latter two if it appears to | match the underlying C reality. | | It exists mainly to be used in Python's test suite. | | Override the automatic determination of C-level floating point type. | This affects how floats are converted to and from binary strings. | | fromhex(string, /) from builtins.type | Create a floating-point number from a hexadecimal string. | | >>> float.fromhex('0x1.ffffp10') | 2047.984375 | >>> float.fromhex('-0x1p-1074') | -5e-324 | | ---------------------------------------------------------------------- | Data descriptors inherited from builtins.float: | | imag | the imaginary part of a complex number | | real | the real part of a complex number class Int16(_dbus_bindings._LongBase) | dbus.Int16(value: int[, variant_level: int]) | | A signed 16-bit integer between -0x8000 and +0x7FFF, represented as | a subtype of `int`. | | value must be within the allowed range, or OverflowError will be | raised. | | variant_level must be non-negative; the default is 0. | | .. py:attribute:: variant_level | | Indicates how many nested Variant containers this object | is contained in: if a message's wire format has a variant containing a | variant containing an int16, this is represented in Python by an | Int16 with variant_level==2. | | Method resolution order: | Int16 | _dbus_bindings._LongBase | builtins.int | builtins.object | | Static methods defined here: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Methods inherited from _dbus_bindings._LongBase: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __repr__(self, /) | Return repr(self). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | __str__(self, /) | Return str(self). | | ---------------------------------------------------------------------- | Methods inherited from builtins.int: | | __abs__(self, /) | abs(self) | | __add__(self, value, /) | Return self+value. | | __and__(self, value, /) | Return self&value. | | __bool__(self, /) | True if self else False | | __ceil__(...) | Ceiling of an Integral returns itself. | | __divmod__(self, value, /) | Return divmod(self, value). | | __eq__(self, value, /) | Return self==value. | | __float__(self, /) | float(self) | | __floor__(...) | Flooring an Integral returns itself. | | __floordiv__(self, value, /) | Return self//value. | | __format__(self, format_spec, /) | Default object formatter. | | __ge__(self, value, /) | Return self>=value. | | __getnewargs__(self, /) | | __gt__(self, value, /) | Return self>value. | | __hash__(self, /) | Return hash(self). | | __index__(self, /) | Return self converted to an integer, if self is suitable for use as an index into a list. | | __int__(self, /) | int(self) | | __invert__(self, /) | ~self | | __le__(self, value, /) | Return self<=value. | | __lshift__(self, value, /) | Return self<<value. | | __lt__(self, value, /) | Return self<value. | | __mod__(self, value, /) | Return self%value. | | __mul__(self, value, /) | Return self*value. | | __ne__(self, value, /) | Return self!=value. | | __neg__(self, /) | -self | | __or__(self, value, /) | Return self|value. | | __pos__(self, /) | +self | | __pow__(self, value, mod=None, /) | Return pow(self, value, mod). | | __radd__(self, value, /) | Return value+self. | | __rand__(self, value, /) | Return value&self. | | __rdivmod__(self, value, /) | Return divmod(value, self). | | __rfloordiv__(self, value, /) | Return value//self. | | __rlshift__(self, value, /) | Return value<<self. | | __rmod__(self, value, /) | Return value%self. | | __rmul__(self, value, /) | Return value*self. | | __ror__(self, value, /) | Return value|self. | | __round__(...) | Rounding an Integral returns itself. | | Rounding with an ndigits argument also returns an integer. | | __rpow__(self, value, mod=None, /) | Return pow(value, self, mod). | | __rrshift__(self, value, /) | Return value>>self. | | __rshift__(self, value, /) | Return self>>value. | | __rsub__(self, value, /) | Return value-self. | | __rtruediv__(self, value, /) | Return value/self. | | __rxor__(self, value, /) | Return value^self. | | __sizeof__(self, /) | Returns size in memory, in bytes. | | __sub__(self, value, /) | Return self-value. | | __truediv__(self, value, /) | Return self/value. | | __trunc__(...) | Truncating an Integral returns itself. | | __xor__(self, value, /) | Return self^value. | | as_integer_ratio(self, /) | Return integer ratio. | | Return a pair of integers, whose ratio is exactly equal to the original int | and with a positive denominator. | | >>> (10).as_integer_ratio() | (10, 1) | >>> (-10).as_integer_ratio() | (-10, 1) | >>> (0).as_integer_ratio() | (0, 1) | | bit_count(self, /) | Number of ones in the binary representation of the absolute value of self. | | Also known as the population count. | | >>> bin(13) | '0b1101' | >>> (13).bit_count() | 3 | | bit_length(self, /) | Number of bits necessary to represent self in binary. | | >>> bin(37) | '0b100101' | >>> (37).bit_length() | 6 | | conjugate(...) | Returns self, the complex conjugate of any int. | | to_bytes(self, /, length, byteorder, *, signed=False) | Return an array of bytes representing an integer. | | length | Length of bytes object to use. An OverflowError is raised if the | integer is not representable with the given number of bytes. | byteorder | The byte order used to represent the integer. If byteorder is 'big', | the most significant byte is at the beginning of the byte array. If | byteorder is 'little', the most significant byte is at the end of the | byte array. To request the native byte order of the host system, use | `sys.byteorder' as the byte order value. | signed | Determines whether two's complement is used to represent the integer. | If signed is False and a negative integer is given, an OverflowError | is raised. | | ---------------------------------------------------------------------- | Class methods inherited from builtins.int: | | from_bytes(bytes, byteorder, *, signed=False) from builtins.type | Return the integer represented by the given array of bytes. | | bytes | Holds the array of bytes to convert. The argument must either | support the buffer protocol or be an iterable object producing bytes. | Bytes and bytearray are examples of built-in objects that support the | buffer protocol. | byteorder | The byte order used to represent the integer. If byteorder is 'big', | the most significant byte is at the beginning of the byte array. If | byteorder is 'little', the most significant byte is at the end of the | byte array. To request the native byte order of the host system, use | `sys.byteorder' as the byte order value. | signed | Indicates whether two's complement is used to represent the integer. | | ---------------------------------------------------------------------- | Data descriptors inherited from builtins.int: | | denominator | the denominator of a rational number in lowest terms | | imag | the imaginary part of a complex number | | numerator | the numerator of a rational number in lowest terms | | real | the real part of a complex number class Int32(_dbus_bindings._LongBase) | dbus.Int32(value: int[, variant_level: int]) | | A signed 32-bit integer between -0x8000 0000 and +0x7FFF FFFF, represented as | a subtype of ``int``. | | ``value`` must be within the allowed range, or `OverflowError` will be | raised. | | :py:attr:`variant_level` must be non-negative; the default is 0. | | .. py:attribute:: variant_level | | Indicates how many nested Variant containers this object | is contained in: if a message's wire format has a variant containing a | variant containing an int32, this is represented in Python by an | Int32 with variant_level==2. | | Method resolution order: | Int32 | _dbus_bindings._LongBase | builtins.int | builtins.object | | Static methods defined here: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Methods inherited from _dbus_bindings._LongBase: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __repr__(self, /) | Return repr(self). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | __str__(self, /) | Return str(self). | | ---------------------------------------------------------------------- | Methods inherited from builtins.int: | | __abs__(self, /) | abs(self) | | __add__(self, value, /) | Return self+value. | | __and__(self, value, /) | Return self&value. | | __bool__(self, /) | True if self else False | | __ceil__(...) | Ceiling of an Integral returns itself. | | __divmod__(self, value, /) | Return divmod(self, value). | | __eq__(self, value, /) | Return self==value. | | __float__(self, /) | float(self) | | __floor__(...) | Flooring an Integral returns itself. | | __floordiv__(self, value, /) | Return self//value. | | __format__(self, format_spec, /) | Default object formatter. | | __ge__(self, value, /) | Return self>=value. | | __getnewargs__(self, /) | | __gt__(self, value, /) | Return self>value. | | __hash__(self, /) | Return hash(self). | | __index__(self, /) | Return self converted to an integer, if self is suitable for use as an index into a list. | | __int__(self, /) | int(self) | | __invert__(self, /) | ~self | | __le__(self, value, /) | Return self<=value. | | __lshift__(self, value, /) | Return self<<value. | | __lt__(self, value, /) | Return self<value. | | __mod__(self, value, /) | Return self%value. | | __mul__(self, value, /) | Return self*value. | | __ne__(self, value, /) | Return self!=value. | | __neg__(self, /) | -self | | __or__(self, value, /) | Return self|value. | | __pos__(self, /) | +self | | __pow__(self, value, mod=None, /) | Return pow(self, value, mod). | | __radd__(self, value, /) | Return value+self. | | __rand__(self, value, /) | Return value&self. | | __rdivmod__(self, value, /) | Return divmod(value, self). | | __rfloordiv__(self, value, /) | Return value//self. | | __rlshift__(self, value, /) | Return value<<self. | | __rmod__(self, value, /) | Return value%self. | | __rmul__(self, value, /) | Return value*self. | | __ror__(self, value, /) | Return value|self. | | __round__(...) | Rounding an Integral returns itself. | | Rounding with an ndigits argument also returns an integer. | | __rpow__(self, value, mod=None, /) | Return pow(value, self, mod). | | __rrshift__(self, value, /) | Return value>>self. | | __rshift__(self, value, /) | Return self>>value. | | __rsub__(self, value, /) | Return value-self. | | __rtruediv__(self, value, /) | Return value/self. | | __rxor__(self, value, /) | Return value^self. | | __sizeof__(self, /) | Returns size in memory, in bytes. | | __sub__(self, value, /) | Return self-value. | | __truediv__(self, value, /) | Return self/value. | | __trunc__(...) | Truncating an Integral returns itself. | | __xor__(self, value, /) | Return self^value. | | as_integer_ratio(self, /) | Return integer ratio. | | Return a pair of integers, whose ratio is exactly equal to the original int | and with a positive denominator. | | >>> (10).as_integer_ratio() | (10, 1) | >>> (-10).as_integer_ratio() | (-10, 1) | >>> (0).as_integer_ratio() | (0, 1) | | bit_count(self, /) | Number of ones in the binary representation of the absolute value of self. | | Also known as the population count. | | >>> bin(13) | '0b1101' | >>> (13).bit_count() | 3 | | bit_length(self, /) | Number of bits necessary to represent self in binary. | | >>> bin(37) | '0b100101' | >>> (37).bit_length() | 6 | | conjugate(...) | Returns self, the complex conjugate of any int. | | to_bytes(self, /, length, byteorder, *, signed=False) | Return an array of bytes representing an integer. | | length | Length of bytes object to use. An OverflowError is raised if the | integer is not representable with the given number of bytes. | byteorder | The byte order used to represent the integer. If byteorder is 'big', | the most significant byte is at the beginning of the byte array. If | byteorder is 'little', the most significant byte is at the end of the | byte array. To request the native byte order of the host system, use | `sys.byteorder' as the byte order value. | signed | Determines whether two's complement is used to represent the integer. | If signed is False and a negative integer is given, an OverflowError | is raised. | | ---------------------------------------------------------------------- | Class methods inherited from builtins.int: | | from_bytes(bytes, byteorder, *, signed=False) from builtins.type | Return the integer represented by the given array of bytes. | | bytes | Holds the array of bytes to convert. The argument must either | support the buffer protocol or be an iterable object producing bytes. | Bytes and bytearray are examples of built-in objects that support the | buffer protocol. | byteorder | The byte order used to represent the integer. If byteorder is 'big', | the most significant byte is at the beginning of the byte array. If | byteorder is 'little', the most significant byte is at the end of the | byte array. To request the native byte order of the host system, use | `sys.byteorder' as the byte order value. | signed | Indicates whether two's complement is used to represent the integer. | | ---------------------------------------------------------------------- | Data descriptors inherited from builtins.int: | | denominator | the denominator of a rational number in lowest terms | | imag | the imaginary part of a complex number | | numerator | the numerator of a rational number in lowest terms | | real | the real part of a complex number class Int64(_dbus_bindings._LongBase) | dbus.Int64(value: int[, variant_level: int]) | | A signed 64-bit integer between -0x8000 0000 0000 0000 and | +0x7FFF FFFF FFFF FFFF, represented as a | subtype of ``long`` in Python 2 or ``int`` in Python 3. | | Note that this may be changed in future to be a subtype of `int` on | 64-bit platforms; applications should not rely on either behaviour. | | ``value`` must be within the allowed range, or `OverflowError` will be | raised. | | :py:attr:`variant_level` must be non-negative; the default is 0. | | .. py:attribute:: variant_level | | Indicates how many nested Variant containers this object | is contained in: if a message's wire format has a variant containing a | variant containing an int64, this is represented in Python by an | Int64 with variant_level==2. | | Method resolution order: | Int64 | _dbus_bindings._LongBase | builtins.int | builtins.object | | Static methods defined here: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Methods inherited from _dbus_bindings._LongBase: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __repr__(self, /) | Return repr(self). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | __str__(self, /) | Return str(self). | | ---------------------------------------------------------------------- | Methods inherited from builtins.int: | | __abs__(self, /) | abs(self) | | __add__(self, value, /) | Return self+value. | | __and__(self, value, /) | Return self&value. | | __bool__(self, /) | True if self else False | | __ceil__(...) | Ceiling of an Integral returns itself. | | __divmod__(self, value, /) | Return divmod(self, value). | | __eq__(self, value, /) | Return self==value. | | __float__(self, /) | float(self) | | __floor__(...) | Flooring an Integral returns itself. | | __floordiv__(self, value, /) | Return self//value. | | __format__(self, format_spec, /) | Default object formatter. | | __ge__(self, value, /) | Return self>=value. | | __getnewargs__(self, /) | | __gt__(self, value, /) | Return self>value. | | __hash__(self, /) | Return hash(self). | | __index__(self, /) | Return self converted to an integer, if self is suitable for use as an index into a list. | | __int__(self, /) | int(self) | | __invert__(self, /) | ~self | | __le__(self, value, /) | Return self<=value. | | __lshift__(self, value, /) | Return self<<value. | | __lt__(self, value, /) | Return self<value. | | __mod__(self, value, /) | Return self%value. | | __mul__(self, value, /) | Return self*value. | | __ne__(self, value, /) | Return self!=value. | | __neg__(self, /) | -self | | __or__(self, value, /) | Return self|value. | | __pos__(self, /) | +self | | __pow__(self, value, mod=None, /) | Return pow(self, value, mod). | | __radd__(self, value, /) | Return value+self. | | __rand__(self, value, /) | Return value&self. | | __rdivmod__(self, value, /) | Return divmod(value, self). | | __rfloordiv__(self, value, /) | Return value//self. | | __rlshift__(self, value, /) | Return value<<self. | | __rmod__(self, value, /) | Return value%self. | | __rmul__(self, value, /) | Return value*self. | | __ror__(self, value, /) | Return value|self. | | __round__(...) | Rounding an Integral returns itself. | | Rounding with an ndigits argument also returns an integer. | | __rpow__(self, value, mod=None, /) | Return pow(value, self, mod). | | __rrshift__(self, value, /) | Return value>>self. | | __rshift__(self, value, /) | Return self>>value. | | __rsub__(self, value, /) | Return value-self. | | __rtruediv__(self, value, /) | Return value/self. | | __rxor__(self, value, /) | Return value^self. | | __sizeof__(self, /) | Returns size in memory, in bytes. | | __sub__(self, value, /) | Return self-value. | | __truediv__(self, value, /) | Return self/value. | | __trunc__(...) | Truncating an Integral returns itself. | | __xor__(self, value, /) | Return self^value. | | as_integer_ratio(self, /) | Return integer ratio. | | Return a pair of integers, whose ratio is exactly equal to the original int | and with a positive denominator. | | >>> (10).as_integer_ratio() | (10, 1) | >>> (-10).as_integer_ratio() | (-10, 1) | >>> (0).as_integer_ratio() | (0, 1) | | bit_count(self, /) | Number of ones in the binary representation of the absolute value of self. | | Also known as the population count. | | >>> bin(13) | '0b1101' | >>> (13).bit_count() | 3 | | bit_length(self, /) | Number of bits necessary to represent self in binary. | | >>> bin(37) | '0b100101' | >>> (37).bit_length() | 6 | | conjugate(...) | Returns self, the complex conjugate of any int. | | to_bytes(self, /, length, byteorder, *, signed=False) | Return an array of bytes representing an integer. | | length | Length of bytes object to use. An OverflowError is raised if the | integer is not representable with the given number of bytes. | byteorder | The byte order used to represent the integer. If byteorder is 'big', | the most significant byte is at the beginning of the byte array. If | byteorder is 'little', the most significant byte is at the end of the | byte array. To request the native byte order of the host system, use | `sys.byteorder' as the byte order value. | signed | Determines whether two's complement is used to represent the integer. | If signed is False and a negative integer is given, an OverflowError | is raised. | | ---------------------------------------------------------------------- | Class methods inherited from builtins.int: | | from_bytes(bytes, byteorder, *, signed=False) from builtins.type | Return the integer represented by the given array of bytes. | | bytes | Holds the array of bytes to convert. The argument must either | support the buffer protocol or be an iterable object producing bytes. | Bytes and bytearray are examples of built-in objects that support the | buffer protocol. | byteorder | The byte order used to represent the integer. If byteorder is 'big', | the most significant byte is at the beginning of the byte array. If | byteorder is 'little', the most significant byte is at the end of the | byte array. To request the native byte order of the host system, use | `sys.byteorder' as the byte order value. | signed | Indicates whether two's complement is used to represent the integer. | | ---------------------------------------------------------------------- | Data descriptors inherited from builtins.int: | | denominator | the denominator of a rational number in lowest terms | | imag | the imaginary part of a complex number | | numerator | the numerator of a rational number in lowest terms | | real | the real part of a complex number class Interface(builtins.object) | Interface(object, dbus_interface) | | An interface into a remote object. | | An Interface can be used to wrap ProxyObjects | so that calls can be routed to their correct | D-Bus interface. | | Methods defined here: | | __getattr__(self, member) | | __init__(self, object, dbus_interface) | Construct a proxy for the given interface on the given object. | | :Parameters: | `object` : `dbus.proxies.ProxyObject` or `dbus.Interface` | The remote object or another of its interfaces | `dbus_interface` : str | An interface the `object` implements | | __repr__(self) | Return repr(self). | | __str__ = __repr__(self) | | connect_to_signal(self, signal_name, handler_function, dbus_interface=None, **keywords) | Arrange for a function to be called when the given signal is | emitted. | | The parameters and keyword arguments are the same as for | `dbus.proxies.ProxyObject.connect_to_signal`, except that if | `dbus_interface` is None (the default), the D-Bus interface that | was passed to the `Interface` constructor is used. | | get_dbus_method(self, member, dbus_interface=None) | Return a proxy method representing the given D-Bus method. | | This is the same as `dbus.proxies.ProxyObject.get_dbus_method` | except that if `dbus_interface` is None (the default), | the D-Bus interface that was passed to the `Interface` constructor | is used. | | ---------------------------------------------------------------------- | Readonly properties defined here: | | __dbus_object_path__ | The D-Bus object path of the underlying object | | bus_name | The bus name to which the underlying proxy object is bound | | dbus_interface | The D-Bus interface represented | | object_path | The D-Bus object path of the underlying object | | proxy_object | The underlying proxy object | | requested_bus_name | The bus name which was requested when the underlying object was created | | ---------------------------------------------------------------------- | Data descriptors defined here: | | __dict__ | dictionary for instance variables (if defined) | | __weakref__ | list of weak references to the object (if defined) class IntrospectionParserException(DBusException) | IntrospectionParserException(msg='') | | Method resolution order: | IntrospectionParserException | DBusException | builtins.Exception | builtins.BaseException | builtins.object | | Methods defined here: | | __init__(self, msg='') | Initialize self. See help(type(self)) for accurate signature. | | ---------------------------------------------------------------------- | Data and other attributes defined here: | | include_traceback = True | | ---------------------------------------------------------------------- | Methods inherited from DBusException: | | __str__(self) | Return a str error | | __unicode__(self) | Return a unicode error | | get_dbus_message(self) | | get_dbus_name(self) | | ---------------------------------------------------------------------- | Data descriptors inherited from DBusException: | | __weakref__ | list of weak references to the object (if defined) | | ---------------------------------------------------------------------- | Static methods inherited from builtins.Exception: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Methods inherited from builtins.BaseException: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __reduce__(...) | Helper for pickle. | | __repr__(self, /) | Return repr(self). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | __setstate__(...) | | with_traceback(...) | Exception.with_traceback(tb) -- | set self.__traceback__ to tb and return self. | | ---------------------------------------------------------------------- | Data descriptors inherited from builtins.BaseException: | | __cause__ | exception cause | | __context__ | exception context | | __dict__ | | __suppress_context__ | | __traceback__ | | args class MissingErrorHandlerException(DBusException) | Method resolution order: | MissingErrorHandlerException | DBusException | builtins.Exception | builtins.BaseException | builtins.object | | Methods defined here: | | __init__(self) | Initialize self. See help(type(self)) for accurate signature. | | ---------------------------------------------------------------------- | Data and other attributes defined here: | | include_traceback = True | | ---------------------------------------------------------------------- | Methods inherited from DBusException: | | __str__(self) | Return a str error | | __unicode__(self) | Return a unicode error | | get_dbus_message(self) | | get_dbus_name(self) | | ---------------------------------------------------------------------- | Data descriptors inherited from DBusException: | | __weakref__ | list of weak references to the object (if defined) | | ---------------------------------------------------------------------- | Static methods inherited from builtins.Exception: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Methods inherited from builtins.BaseException: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __reduce__(...) | Helper for pickle. | | __repr__(self, /) | Return repr(self). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | __setstate__(...) | | with_traceback(...) | Exception.with_traceback(tb) -- | set self.__traceback__ to tb and return self. | | ---------------------------------------------------------------------- | Data descriptors inherited from builtins.BaseException: | | __cause__ | exception cause | | __context__ | exception context | | __dict__ | | __suppress_context__ | | __traceback__ | | args class MissingReplyHandlerException(DBusException) | Method resolution order: | MissingReplyHandlerException | DBusException | builtins.Exception | builtins.BaseException | builtins.object | | Methods defined here: | | __init__(self) | Initialize self. See help(type(self)) for accurate signature. | | ---------------------------------------------------------------------- | Data and other attributes defined here: | | include_traceback = True | | ---------------------------------------------------------------------- | Methods inherited from DBusException: | | __str__(self) | Return a str error | | __unicode__(self) | Return a unicode error | | get_dbus_message(self) | | get_dbus_name(self) | | ---------------------------------------------------------------------- | Data descriptors inherited from DBusException: | | __weakref__ | list of weak references to the object (if defined) | | ---------------------------------------------------------------------- | Static methods inherited from builtins.Exception: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Methods inherited from builtins.BaseException: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __reduce__(...) | Helper for pickle. | | __repr__(self, /) | Return repr(self). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | __setstate__(...) | | with_traceback(...) | Exception.with_traceback(tb) -- | set self.__traceback__ to tb and return self. | | ---------------------------------------------------------------------- | Data descriptors inherited from builtins.BaseException: | | __cause__ | exception cause | | __context__ | exception context | | __dict__ | | __suppress_context__ | | __traceback__ | | args class NameExistsException(DBusException) | NameExistsException(name) | | Method resolution order: | NameExistsException | DBusException | builtins.Exception | builtins.BaseException | builtins.object | | Methods defined here: | | __init__(self, name) | Initialize self. See help(type(self)) for accurate signature. | | ---------------------------------------------------------------------- | Data and other attributes defined here: | | include_traceback = True | | ---------------------------------------------------------------------- | Methods inherited from DBusException: | | __str__(self) | Return a str error | | __unicode__(self) | Return a unicode error | | get_dbus_message(self) | | get_dbus_name(self) | | ---------------------------------------------------------------------- | Data descriptors inherited from DBusException: | | __weakref__ | list of weak references to the object (if defined) | | ---------------------------------------------------------------------- | Static methods inherited from builtins.Exception: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Methods inherited from builtins.BaseException: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __reduce__(...) | Helper for pickle. | | __repr__(self, /) | Return repr(self). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | __setstate__(...) | | with_traceback(...) | Exception.with_traceback(tb) -- | set self.__traceback__ to tb and return self. | | ---------------------------------------------------------------------- | Data descriptors inherited from builtins.BaseException: | | __cause__ | exception cause | | __context__ | exception context | | __dict__ | | __suppress_context__ | | __traceback__ | | args class ObjectPath(_dbus_bindings._StrBase) | dbus.ObjectPath(path: str[, variant_level: int=0]) | A D-Bus object path, such as ``/com/example/MyApp/Documents/abc``. | | ObjectPath is a subtype of :py:class:`str`, and object-paths behave like strings. | | path must be an ASCII string following the syntax of object paths. | variant_level must be non-negative; the default is 0. | | .. py:attribute:: variant_level | | Indicates how many nested Variant containers this object | is contained in: if a message's wire format has a variant containing a | variant containing an object path, this is represented in Python by an | ObjectPath with variant_level==2. | | Method resolution order: | ObjectPath | _dbus_bindings._StrBase | builtins.str | builtins.object | | Static methods defined here: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Methods inherited from _dbus_bindings._StrBase: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __repr__(self, /) | Return repr(self). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | ---------------------------------------------------------------------- | Methods inherited from builtins.str: | | __add__(self, value, /) | Return self+value. | | __contains__(self, key, /) | Return key in self. | | __eq__(self, value, /) | Return self==value. | | __format__(self, format_spec, /) | Return a formatted version of the string as described by format_spec. | | __ge__(self, value, /) | Return self>=value. | | __getitem__(self, key, /) | Return self[key]. | | __getnewargs__(...) | | __gt__(self, value, /) | Return self>value. | | __hash__(self, /) | Return hash(self). | | __iter__(self, /) | Implement iter(self). | | __le__(self, value, /) | Return self<=value. | | __len__(self, /) | Return len(self). | | __lt__(self, value, /) | Return self<value. | | __mod__(self, value, /) | Return self%value. | | __mul__(self, value, /) | Return self*value. | | __ne__(self, value, /) | Return self!=value. | | __rmod__(self, value, /) | Return value%self. | | __rmul__(self, value, /) | Return value*self. | | __sizeof__(self, /) | Return the size of the string in memory, in bytes. | | __str__(self, /) | Return str(self). | | capitalize(self, /) | Return a capitalized version of the string. | | More specifically, make the first character have upper case and the rest lower | case. | | casefold(self, /) | Return a version of the string suitable for caseless comparisons. | | center(self, width, fillchar=' ', /) | Return a centered string of length width. | | Padding is done using the specified fill character (default is a space). | | count(...) | S.count(sub[, start[, end]]) -> int | | Return the number of non-overlapping occurrences of substring sub in | string S[start:end]. Optional arguments start and end are | interpreted as in slice notation. | | encode(self, /, encoding='utf-8', errors='strict') | Encode the string using the codec registered for encoding. | | encoding | The encoding in which to encode the string. | errors | The error handling scheme to use for encoding errors. | The default is 'strict' meaning that encoding errors raise a | UnicodeEncodeError. Other possible values are 'ignore', 'replace' and | 'xmlcharrefreplace' as well as any other name registered with | codecs.register_error that can handle UnicodeEncodeErrors. | | endswith(...) | S.endswith(suffix[, start[, end]]) -> bool | | Return True if S ends with the specified suffix, False otherwise. | With optional start, test S beginning at that position. | With optional end, stop comparing S at that position. | suffix can also be a tuple of strings to try. | | expandtabs(self, /, tabsize=8) | Return a copy where all tab characters are expanded using spaces. | | If tabsize is not given, a tab size of 8 characters is assumed. | | find(...) | S.find(sub[, start[, end]]) -> int | | Return the lowest index in S where substring sub is found, | such that sub is contained within S[start:end]. Optional | arguments start and end are interpreted as in slice notation. | | Return -1 on failure. | | format(...) | S.format(*args, **kwargs) -> str | | Return a formatted version of S, using substitutions from args and kwargs. | The substitutions are identified by braces ('{' and '}'). | | format_map(...) | S.format_map(mapping) -> str | | Return a formatted version of S, using substitutions from mapping. | The substitutions are identified by braces ('{' and '}'). | | index(...) | S.index(sub[, start[, end]]) -> int | | Return the lowest index in S where substring sub is found, | such that sub is contained within S[start:end]. Optional | arguments start and end are interpreted as in slice notation. | | Raises ValueError when the substring is not found. | | isalnum(self, /) | Return True if the string is an alpha-numeric string, False otherwise. | | A string is alpha-numeric if all characters in the string are alpha-numeric and | there is at least one character in the string. | | isalpha(self, /) | Return True if the string is an alphabetic string, False otherwise. | | A string is alphabetic if all characters in the string are alphabetic and there | is at least one character in the string. | | isascii(self, /) | Return True if all characters in the string are ASCII, False otherwise. | | ASCII characters have code points in the range U+0000-U+007F. | Empty string is ASCII too. | | isdecimal(self, /) | Return True if the string is a decimal string, False otherwise. | | A string is a decimal string if all characters in the string are decimal and | there is at least one character in the string. | | isdigit(self, /) | Return True if the string is a digit string, False otherwise. | | A string is a digit string if all characters in the string are digits and there | is at least one character in the string. | | isidentifier(self, /) | Return True if the string is a valid Python identifier, False otherwise. | | Call keyword.iskeyword(s) to test whether string s is a reserved identifier, | such as "def" or "class". | | islower(self, /) | Return True if the string is a lowercase string, False otherwise. | | A string is lowercase if all cased characters in the string are lowercase and | there is at least one cased character in the string. | | isnumeric(self, /) | Return True if the string is a numeric string, False otherwise. | | A string is numeric if all characters in the string are numeric and there is at | least one character in the string. | | isprintable(self, /) | Return True if the string is printable, False otherwise. | | A string is printable if all of its characters are considered printable in | repr() or if it is empty. | | isspace(self, /) | Return True if the string is a whitespace string, False otherwise. | | A string is whitespace if all characters in the string are whitespace and there | is at least one character in the string. | | istitle(self, /) | Return True if the string is a title-cased string, False otherwise. | | In a title-cased string, upper- and title-case characters may only | follow uncased characters and lowercase characters only cased ones. | | isupper(self, /) | Return True if the string is an uppercase string, False otherwise. | | A string is uppercase if all cased characters in the string are uppercase and | there is at least one cased character in the string. | | join(self, iterable, /) | Concatenate any number of strings. | | The string whose method is called is inserted in between each given string. | The result is returned as a new string. | | Example: '.'.join(['ab', 'pq', 'rs']) -> 'ab.pq.rs' | | ljust(self, width, fillchar=' ', /) | Return a left-justified string of length width. | | Padding is done using the specified fill character (default is a space). | | lower(self, /) | Return a copy of the string converted to lowercase. | | lstrip(self, chars=None, /) | Return a copy of the string with leading whitespace removed. | | If chars is given and not None, remove characters in chars instead. | | partition(self, sep, /) | Partition the string into three parts using the given separator. | | This will search for the separator in the string. If the separator is found, | returns a 3-tuple containing the part before the separator, the separator | itself, and the part after it. | | If the separator is not found, returns a 3-tuple containing the original string | and two empty strings. | | removeprefix(self, prefix, /) | Return a str with the given prefix string removed if present. | | If the string starts with the prefix string, return string[len(prefix):]. | Otherwise, return a copy of the original string. | | removesuffix(self, suffix, /) | Return a str with the given suffix string removed if present. | | If the string ends with the suffix string and that suffix is not empty, | return string[:-len(suffix)]. Otherwise, return a copy of the original | string. | | replace(self, old, new, count=-1, /) | Return a copy with all occurrences of substring old replaced by new. | | count | Maximum number of occurrences to replace. | -1 (the default value) means replace all occurrences. | | If the optional argument count is given, only the first count occurrences are | replaced. | | rfind(...) | S.rfind(sub[, start[, end]]) -> int | | Return the highest index in S where substring sub is found, | such that sub is contained within S[start:end]. Optional | arguments start and end are interpreted as in slice notation. | | Return -1 on failure. | | rindex(...) | S.rindex(sub[, start[, end]]) -> int | | Return the highest index in S where substring sub is found, | such that sub is contained within S[start:end]. Optional | arguments start and end are interpreted as in slice notation. | | Raises ValueError when the substring is not found. | | rjust(self, width, fillchar=' ', /) | Return a right-justified string of length width. | | Padding is done using the specified fill character (default is a space). | | rpartition(self, sep, /) | Partition the string into three parts using the given separator. | | This will search for the separator in the string, starting at the end. If | the separator is found, returns a 3-tuple containing the part before the | separator, the separator itself, and the part after it. | | If the separator is not found, returns a 3-tuple containing two empty strings | and the original string. | | rsplit(self, /, sep=None, maxsplit=-1) | Return a list of the substrings in the string, using sep as the separator string. | | sep | The separator used to split the string. | | When set to None (the default value), will split on any whitespace | character (including \\n \\r \\t \\f and spaces) and will discard | empty strings from the result. | maxsplit | Maximum number of splits (starting from the left). | -1 (the default value) means no limit. | | Splitting starts at the end of the string and works to the front. | | rstrip(self, chars=None, /) | Return a copy of the string with trailing whitespace removed. | | If chars is given and not None, remove characters in chars instead. | | split(self, /, sep=None, maxsplit=-1) | Return a list of the substrings in the string, using sep as the separator string. | | sep | The separator used to split the string. | | When set to None (the default value), will split on any whitespace | character (including \\n \\r \\t \\f and spaces) and will discard | empty strings from the result. | maxsplit | Maximum number of splits (starting from the left). | -1 (the default value) means no limit. | | Note, str.split() is mainly useful for data that has been intentionally | delimited. With natural text that includes punctuation, consider using | the regular expression module. | | splitlines(self, /, keepends=False) | Return a list of the lines in the string, breaking at line boundaries. | | Line breaks are not included in the resulting list unless keepends is given and | true. | | startswith(...) | S.startswith(prefix[, start[, end]]) -> bool | | Return True if S starts with the specified prefix, False otherwise. | With optional start, test S beginning at that position. | With optional end, stop comparing S at that position. | prefix can also be a tuple of strings to try. | | strip(self, chars=None, /) | Return a copy of the string with leading and trailing whitespace removed. | | If chars is given and not None, remove characters in chars instead. | | swapcase(self, /) | Convert uppercase characters to lowercase and lowercase characters to uppercase. | | title(self, /) | Return a version of the string where each word is titlecased. | | More specifically, words start with uppercased characters and all remaining | cased characters have lower case. | | translate(self, table, /) | Replace each character in the string using the given translation table. | | table | Translation table, which must be a mapping of Unicode ordinals to | Unicode ordinals, strings, or None. | | The table must implement lookup/indexing via __getitem__, for instance a | dictionary or list. If this operation raises LookupError, the character is | left untouched. Characters mapped to None are deleted. | | upper(self, /) | Return a copy of the string converted to uppercase. | | zfill(self, width, /) | Pad a numeric string with zeros on the left, to fill a field of the given width. | | The string is never truncated. | | ---------------------------------------------------------------------- | Static methods inherited from builtins.str: | | maketrans(...) | Return a translation table usable for str.translate(). | | If there is only one argument, it must be a dictionary mapping Unicode | ordinals (integers) or characters to Unicode ordinals, strings or None. | Character keys will be then converted to ordinals. | If there are two arguments, they must be strings of equal length, and | in the resulting dictionary, each character in x will be mapped to the | character at the same position in y. If there is a third argument, it | must be a string, whose characters will be mapped to None in the result. class SessionBus(Bus) | SessionBus(private=False, mainloop=None) | | The session (current login) message bus. | | Method resolution order: | SessionBus | Bus | dbus.bus.BusConnection | dbus.connection.Connection | _dbus_bindings.Connection | builtins.object | | Static methods defined here: | | __new__(cls, private=False, mainloop=None) | Return a connection to the session bus. | | :Parameters: | `private` : bool | If true, never return an existing shared instance, but instead | return a private connection. | `mainloop` : dbus.mainloop.NativeMainLoop | The main loop to use. The default is to use the default | main loop if one has been set up, or raise an exception | if none has been. | | ---------------------------------------------------------------------- | Methods inherited from Bus: | | __repr__(self) | Return repr(self). | | __str__ = __repr__(self) | | close(self) | close() | | Close the connection. | | get_connection(self) | Return self, for backwards compatibility with earlier dbus-python | versions where Bus was not a subclass of Connection. | | :Deprecated: since 0.80.0 | | ---------------------------------------------------------------------- | Static methods inherited from Bus: | | get_session(private=False) | Static method that returns a connection to the session bus. | | :Parameters: | `private` : bool | If true, do not return a shared connection. | | get_starter(private=False) | Static method that returns a connection to the starter bus. | | :Parameters: | `private` : bool | If true, do not return a shared connection. | | get_system(private=False) | Static method that returns a connection to the system bus. | | :Parameters: | `private` : bool | If true, do not return a shared connection. | | ---------------------------------------------------------------------- | Methods inherited from dbus.bus.BusConnection: | | activate_name_owner(self, bus_name) | Return the unique name for the given bus name, activating it | if necessary and possible. | | If the name is already unique or this connection is not to a | bus daemon, just return it. | | :Returns: a bus name. If the given `bus_name` exists, the returned | name identifies its current owner; otherwise the returned name | does not exist. | :Raises DBusException: if the implementation has failed | to activate the given bus name. | :Since: 0.81.0 | | add_match_string(self, rule) | Arrange for this application to receive messages on the bus that | match the given rule. This version will block. | | :Parameters: | `rule` : str | The match rule | :Raises `DBusException`: on error. | :Since: 0.80.0 | | add_match_string_non_blocking(self, rule) | Arrange for this application to receive messages on the bus that | match the given rule. This version will not block, but any errors | will be ignored. | | | :Parameters: | `rule` : str | The match rule | :Raises `DBusException`: on error. | :Since: 0.80.0 | | add_signal_receiver(self, handler_function, signal_name=None, dbus_interface=None, bus_name=None, path=None, **keywords) | Arrange for the given function to be called when a signal matching | the parameters is received. | | :Parameters: | `handler_function` : callable | The function to be called. Its positional arguments will | be the arguments of the signal. By default it will receive | no keyword arguments, but see the description of | the optional keyword arguments below. | `signal_name` : str | The signal name; None (the default) matches all names | `dbus_interface` : str | The D-Bus interface name with which to qualify the signal; | None (the default) matches all interface names | `bus_name` : str | A bus name for the sender, which will be resolved to a | unique name if it is not already; None (the default) matches | any sender. | `path` : str | The object path of the object which must have emitted the | signal; None (the default) matches any object path | :Keywords: | `utf8_strings` : bool | If True, the handler function will receive any string | arguments as dbus.UTF8String objects (a subclass of str | guaranteed to be UTF-8). If False (default) it will receive | any string arguments as dbus.String objects (a subclass of | unicode). | `byte_arrays` : bool | If True, the handler function will receive any byte-array | arguments as dbus.ByteArray objects (a subclass of str). | If False (default) it will receive any byte-array | arguments as a dbus.Array of dbus.Byte (subclasses of: | a list of ints). | `sender_keyword` : str | If not None (the default), the handler function will receive | the unique name of the sending endpoint as a keyword | argument with this name. | `destination_keyword` : str | If not None (the default), the handler function will receive | the bus name of the destination (or None if the signal is a | broadcast, as is usual) as a keyword argument with this name. | `interface_keyword` : str | If not None (the default), the handler function will receive | the signal interface as a keyword argument with this name. | `member_keyword` : str | If not None (the default), the handler function will receive | the signal name as a keyword argument with this name. | `path_keyword` : str | If not None (the default), the handler function will receive | the object-path of the sending object as a keyword argument | with this name. | `message_keyword` : str | If not None (the default), the handler function will receive | the `dbus.lowlevel.SignalMessage` as a keyword argument with | this name. | `arg...` : unicode or UTF-8 str | If there are additional keyword parameters of the form | ``arg``\ *n*, match only signals where the *n*\ th argument | is the value given for that keyword parameter. As of this | time only string arguments can be matched (in particular, | object paths and signatures can't). | `named_service` : str | A deprecated alias for `bus_name`. | | get_name_owner(self, bus_name) | Return the unique connection name of the primary owner of the | given name. | | :Raises `DBusException`: if the `bus_name` has no owner | :Since: 0.81.0 | | get_object(self, bus_name, object_path, introspect=True, follow_name_owner_changes=False, **kwargs) | Return a local proxy for the given remote object. | | Method calls on the proxy are translated into method calls on the | remote object. | | :Parameters: | `bus_name` : str | A bus name (either the unique name or a well-known name) | of the application owning the object. The keyword argument | named_service is a deprecated alias for this. | `object_path` : str | The object path of the desired object | `introspect` : bool | If true (default), attempt to introspect the remote | object to find out supported methods and their signatures | `follow_name_owner_changes` : bool | If the object path is a well-known name and this parameter | is false (default), resolve the well-known name to the unique | name of its current owner and bind to that instead; if the | ownership of the well-known name changes in future, | keep communicating with the original owner. | This is necessary if the D-Bus API used is stateful. | | If the object path is a well-known name and this parameter | is true, whenever the well-known name changes ownership in | future, bind to the new owner, if any. | | If the given object path is a unique name, this parameter | has no effect. | | :Returns: a `dbus.proxies.ProxyObject` | :Raises `DBusException`: if resolving the well-known name to a | unique name fails | | get_unix_user(self, bus_name) | Get the numeric uid of the process owning the given bus name. | | :Parameters: | `bus_name` : str | A bus name, either unique or well-known | :Returns: a `dbus.UInt32` | :Since: 0.80.0 | | list_activatable_names(self) | Return a list of all names that can be activated on the bus. | | :Returns: a dbus.Array of dbus.UTF8String | :Since: 0.81.0 | | list_names(self) | Return a list of all currently-owned names on the bus. | | :Returns: a dbus.Array of dbus.UTF8String | :Since: 0.81.0 | | name_has_owner(self, bus_name) | Return True iff the given bus name has an owner on this bus. | | :Parameters: | `bus_name` : str | The bus name to look up | :Returns: a `bool` | | release_name(self, name) | Release a bus name. | | :Parameters: | `name` : str | The well-known name to be released | :Returns: `RELEASE_NAME_REPLY_RELEASED`, | `RELEASE_NAME_REPLY_NON_EXISTENT` | or `RELEASE_NAME_REPLY_NOT_OWNER` | :Raises `DBusException`: if the bus daemon cannot be contacted or | returns an error. | | remove_match_string(self, rule) | Arrange for this application to receive messages on the bus that | match the given rule. This version will block. | | :Parameters: | `rule` : str | The match rule | :Raises `DBusException`: on error. | :Since: 0.80.0 | | remove_match_string_non_blocking(self, rule) | Arrange for this application to receive messages on the bus that | match the given rule. This version will not block, but any errors | will be ignored. | | | :Parameters: | `rule` : str | The match rule | :Raises `DBusException`: on error. | :Since: 0.80.0 | | request_name(self, name, flags=0) | Request a bus name. | | :Parameters: | `name` : str | The well-known name to be requested | `flags` : dbus.UInt32 | A bitwise-OR of 0 or more of the flags | `NAME_FLAG_ALLOW_REPLACEMENT`, | `NAME_FLAG_REPLACE_EXISTING` | and `NAME_FLAG_DO_NOT_QUEUE` | :Returns: `REQUEST_NAME_REPLY_PRIMARY_OWNER`, | `REQUEST_NAME_REPLY_IN_QUEUE`, | `REQUEST_NAME_REPLY_EXISTS` or | `REQUEST_NAME_REPLY_ALREADY_OWNER` | :Raises `DBusException`: if the bus daemon cannot be contacted or | returns an error. | | start_service_by_name(self, bus_name, flags=0) | Start a service which will implement the given bus name on this Bus. | | :Parameters: | `bus_name` : str | The well-known bus name to be activated. | `flags` : dbus.UInt32 | Flags to pass to StartServiceByName (currently none are | defined) | | :Returns: A tuple of 2 elements. The first is always True, the | second is either START_REPLY_SUCCESS or | START_REPLY_ALREADY_RUNNING. | | :Raises `DBusException`: if the service could not be started. | :Since: 0.80.0 | | watch_name_owner(self, bus_name, callback) | Watch the unique connection name of the primary owner of the | given name. | | `callback` will be called with one argument, which is either the | unique connection name, or the empty string (meaning the name is | not owned). | | :Since: 0.81.0 | | ---------------------------------------------------------------------- | Data and other attributes inherited from dbus.bus.BusConnection: | | START_REPLY_ALREADY_RUNNING = 2 | | START_REPLY_SUCCESS = 1 | | TYPE_SESSION = 0 | | TYPE_STARTER = 2 | | TYPE_SYSTEM = 1 | | ---------------------------------------------------------------------- | Methods inherited from dbus.connection.Connection: | | __init__(self, *args, **kwargs) | Initialize self. See help(type(self)) for accurate signature. | | call_async(self, bus_name, object_path, dbus_interface, method, signature, args, reply_handler, error_handler, timeout=-1.0, byte_arrays=False, require_main_loop=True, **kwargs) | Call the given method, asynchronously. | | If the reply_handler is None, successful replies will be ignored. | If the error_handler is None, failures will be ignored. If both | are None, the implementation may request that no reply is sent. | | :Returns: The dbus.lowlevel.PendingCall. | :Since: 0.81.0 | | call_blocking(self, bus_name, object_path, dbus_interface, method, signature, args, timeout=-1.0, byte_arrays=False, **kwargs) | Call the given method, synchronously. | :Since: 0.81.0 | | call_on_disconnection(self, callable) | Arrange for `callable` to be called with one argument (this | Connection object) when the Connection becomes | disconnected. | | :Since: 0.83.0 | | remove_signal_receiver(self, handler_or_match, signal_name=None, dbus_interface=None, bus_name=None, path=None, **keywords) | | ---------------------------------------------------------------------- | Data descriptors inherited from dbus.connection.Connection: | | __dict__ | dictionary for instance variables (if defined) | | ---------------------------------------------------------------------- | Data and other attributes inherited from dbus.connection.Connection: | | ProxyObjectClass = <class 'dbus.proxies.ProxyObject'> | A proxy to the remote Object. | | A ProxyObject is provided by the Bus. ProxyObjects | have member functions, and can be called like normal Python objects. | | | ---------------------------------------------------------------------- | Methods inherited from _dbus_bindings.Connection: | | add_message_filter(...) | add_message_filter(callable) | | Add the given message filter to the internal list. | | Filters are handlers that are run on all incoming messages, prior to the | objects registered to handle object paths. | | Filters are run in the order that they were added. The same handler can | be added as a filter more than once, in which case it will be run more | than once. Filters added during a filter callback won't be run on the | message being processed. | | flush(...) | flush() | | Block until the outgoing message queue is empty. | | get_is_authenticated(...) | get_is_authenticated() -> bool | | Return true if this Connection was ever authenticated. | | get_is_connected(...) | get_is_connected() -> bool | | Return true if this Connection is connected. | | get_peer_unix_process_id(...) | get_peer_unix_process_id() -> long or None | | Get the UNIX process ID at the other end of the connection, if it has been | authenticated. Return None if this is a non-UNIX platform or the | connection has not been authenticated. | | get_peer_unix_user(...) | get_peer_unix_user() -> long or None | | Get the UNIX user ID at the other end of the connection, if it has been | authenticated. Return None if this is a non-UNIX platform or the | connection has not been authenticated. | | get_unique_name(...) | get_unique_name() -> str | | Return this application's unique name on this bus. | | :Raises DBusException: if the connection has no unique name yet | (for Bus objects this can't happen, for peer-to-peer connections | this means you haven't called `set_unique_name`) | | get_unix_fd(...) | get_unix_fd() -> int or None | | Get the connection's UNIX file descriptor, if any. | | This can be used for SELinux access control checks with ``getpeercon()`` | for example. **Do not** read or write to the file descriptor, or try to | ``select()`` on it. | | list_exported_child_objects(...) | list_exported_child_objects(path: str) -> list of str | | Return a list of the names of objects exported on this Connection as | direct children of the given object path. | | Each name returned may be converted to a valid object path using | ``dbus.ObjectPath('%s%s%s' % (path, (path != '/' and '/' or ''), name))``. | For the purposes of this function, every parent or ancestor of an exported | object is considered to be an exported object, even if it's only an object | synthesized by the library to support introspection. | | remove_message_filter(...) | remove_message_filter(callable) | | Remove the given message filter (see `add_message_filter` for details). | | :Raises LookupError: | The given callable is not among the registered filters | | send_message(...) | send_message(msg) -> long | | Queue the given message for sending, and return the message serial number. | | :Parameters: | `msg` : dbus.lowlevel.Message | The message to be sent. | | send_message_with_reply(...) | send_message_with_reply(msg, reply_handler, timeout_s=-1, require_main_loop=False) -> dbus.lowlevel.PendingCall | | Queue the message for sending; expect a reply via the returned PendingCall, | which can also be used to cancel the pending call. | | :Parameters: | `msg` : dbus.lowlevel.Message | The message to be sent | `reply_handler` : callable | Asynchronous reply handler: will be called with one positional | parameter, a Message instance representing the reply. | `timeout_s` : float | If the reply takes more than this many seconds, a timeout error | will be created locally and raised instead. If this timeout is | negative (default), a sane default (supplied by libdbus) is used. | `require_main_loop` : bool | If True, raise RuntimeError if this Connection does not have a main | loop configured. If False (default) and there is no main loop, you are | responsible for calling block() on the PendingCall. | | send_message_with_reply_and_block(...) | send_message_with_reply_and_block(msg, timeout_s=-1) -> dbus.lowlevel.Message | | Send the message and block while waiting for a reply. | | This does not re-enter the main loop, so it can lead to a deadlock, if | the called method tries to make a synchronous call to a method in this | application. As such, it's probably a bad idea. | | :Parameters: | `msg` : dbus.lowlevel.Message | The message to be sent | `timeout_s` : float | If the reply takes more than this many seconds, a timeout error | will be created locally and raised instead. If this timeout is | negative (default), a sane default (supplied by libdbus) is used. | :Returns: | A `dbus.lowlevel.Message` instance (probably a `dbus.lowlevel.MethodReturnMessage`) on success | :Raises dbus.DBusException: | On error (including if the reply arrives but is an | error message) | | set_allow_anonymous(...) | set_allow_anonymous(bool) | | Allows anonymous clients. Call this on the server side of a connection in a on_connection_added callback | | set_exit_on_disconnect(...) | set_exit_on_disconnect(bool) | | Set whether the C function ``_exit`` will be called when this Connection | becomes disconnected. This will cause the program to exit without calling | any cleanup code or exit handlers. | | The default is for this feature to be disabled for Connections and enabled | for Buses. | | set_unique_name(...) | set_unique_name(str) | | Set this application's unique name on this bus. Raise ValueError if it has | already been set. class Signature(_dbus_bindings._StrBase) | Signature(value: str or unicode[, variant_level: int]) | | A string subclass whose values are restricted to valid D-Bus | signatures. When iterated over, instead of individual characters it | produces Signature instances representing single complete types. | | ``value`` must be a valid D-Bus signature (zero or more single complete | types). | | :py:attr:`variant_level` must be non-negative; the default is 0. | | .. py:attribute:: variant_level | | Indicates how many nested Variant containers this object | is contained in: if a message's wire format has a variant containing a | variant containing a signature, this is represented in Python by a | Signature with variant_level==2. | | Method resolution order: | Signature | _dbus_bindings._StrBase | builtins.str | builtins.object | | Methods defined here: | | __iter__(self, /) | Implement iter(self). | | ---------------------------------------------------------------------- | Static methods defined here: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Methods inherited from _dbus_bindings._StrBase: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __repr__(self, /) | Return repr(self). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | ---------------------------------------------------------------------- | Methods inherited from builtins.str: | | __add__(self, value, /) | Return self+value. | | __contains__(self, key, /) | Return key in self. | | __eq__(self, value, /) | Return self==value. | | __format__(self, format_spec, /) | Return a formatted version of the string as described by format_spec. | | __ge__(self, value, /) | Return self>=value. | | __getitem__(self, key, /) | Return self[key]. | | __getnewargs__(...) | | __gt__(self, value, /) | Return self>value. | | __hash__(self, /) | Return hash(self). | | __le__(self, value, /) | Return self<=value. | | __len__(self, /) | Return len(self). | | __lt__(self, value, /) | Return self<value. | | __mod__(self, value, /) | Return self%value. | | __mul__(self, value, /) | Return self*value. | | __ne__(self, value, /) | Return self!=value. | | __rmod__(self, value, /) | Return value%self. | | __rmul__(self, value, /) | Return value*self. | | __sizeof__(self, /) | Return the size of the string in memory, in bytes. | | __str__(self, /) | Return str(self). | | capitalize(self, /) | Return a capitalized version of the string. | | More specifically, make the first character have upper case and the rest lower | case. | | casefold(self, /) | Return a version of the string suitable for caseless comparisons. | | center(self, width, fillchar=' ', /) | Return a centered string of length width. | | Padding is done using the specified fill character (default is a space). | | count(...) | S.count(sub[, start[, end]]) -> int | | Return the number of non-overlapping occurrences of substring sub in | string S[start:end]. Optional arguments start and end are | interpreted as in slice notation. | | encode(self, /, encoding='utf-8', errors='strict') | Encode the string using the codec registered for encoding. | | encoding | The encoding in which to encode the string. | errors | The error handling scheme to use for encoding errors. | The default is 'strict' meaning that encoding errors raise a | UnicodeEncodeError. Other possible values are 'ignore', 'replace' and | 'xmlcharrefreplace' as well as any other name registered with | codecs.register_error that can handle UnicodeEncodeErrors. | | endswith(...) | S.endswith(suffix[, start[, end]]) -> bool | | Return True if S ends with the specified suffix, False otherwise. | With optional start, test S beginning at that position. | With optional end, stop comparing S at that position. | suffix can also be a tuple of strings to try. | | expandtabs(self, /, tabsize=8) | Return a copy where all tab characters are expanded using spaces. | | If tabsize is not given, a tab size of 8 characters is assumed. | | find(...) | S.find(sub[, start[, end]]) -> int | | Return the lowest index in S where substring sub is found, | such that sub is contained within S[start:end]. Optional | arguments start and end are interpreted as in slice notation. | | Return -1 on failure. | | format(...) | S.format(*args, **kwargs) -> str | | Return a formatted version of S, using substitutions from args and kwargs. | The substitutions are identified by braces ('{' and '}'). | | format_map(...) | S.format_map(mapping) -> str | | Return a formatted version of S, using substitutions from mapping. | The substitutions are identified by braces ('{' and '}'). | | index(...) | S.index(sub[, start[, end]]) -> int | | Return the lowest index in S where substring sub is found, | such that sub is contained within S[start:end]. Optional | arguments start and end are interpreted as in slice notation. | | Raises ValueError when the substring is not found. | | isalnum(self, /) | Return True if the string is an alpha-numeric string, False otherwise. | | A string is alpha-numeric if all characters in the string are alpha-numeric and | there is at least one character in the string. | | isalpha(self, /) | Return True if the string is an alphabetic string, False otherwise. | | A string is alphabetic if all characters in the string are alphabetic and there | is at least one character in the string. | | isascii(self, /) | Return True if all characters in the string are ASCII, False otherwise. | | ASCII characters have code points in the range U+0000-U+007F. | Empty string is ASCII too. | | isdecimal(self, /) | Return True if the string is a decimal string, False otherwise. | | A string is a decimal string if all characters in the string are decimal and | there is at least one character in the string. | | isdigit(self, /) | Return True if the string is a digit string, False otherwise. | | A string is a digit string if all characters in the string are digits and there | is at least one character in the string. | | isidentifier(self, /) | Return True if the string is a valid Python identifier, False otherwise. | | Call keyword.iskeyword(s) to test whether string s is a reserved identifier, | such as "def" or "class". | | islower(self, /) | Return True if the string is a lowercase string, False otherwise. | | A string is lowercase if all cased characters in the string are lowercase and | there is at least one cased character in the string. | | isnumeric(self, /) | Return True if the string is a numeric string, False otherwise. | | A string is numeric if all characters in the string are numeric and there is at | least one character in the string. | | isprintable(self, /) | Return True if the string is printable, False otherwise. | | A string is printable if all of its characters are considered printable in | repr() or if it is empty. | | isspace(self, /) | Return True if the string is a whitespace string, False otherwise. | | A string is whitespace if all characters in the string are whitespace and there | is at least one character in the string. | | istitle(self, /) | Return True if the string is a title-cased string, False otherwise. | | In a title-cased string, upper- and title-case characters may only | follow uncased characters and lowercase characters only cased ones. | | isupper(self, /) | Return True if the string is an uppercase string, False otherwise. | | A string is uppercase if all cased characters in the string are uppercase and | there is at least one cased character in the string. | | join(self, iterable, /) | Concatenate any number of strings. | | The string whose method is called is inserted in between each given string. | The result is returned as a new string. | | Example: '.'.join(['ab', 'pq', 'rs']) -> 'ab.pq.rs' | | ljust(self, width, fillchar=' ', /) | Return a left-justified string of length width. | | Padding is done using the specified fill character (default is a space). | | lower(self, /) | Return a copy of the string converted to lowercase. | | lstrip(self, chars=None, /) | Return a copy of the string with leading whitespace removed. | | If chars is given and not None, remove characters in chars instead. | | partition(self, sep, /) | Partition the string into three parts using the given separator. | | This will search for the separator in the string. If the separator is found, | returns a 3-tuple containing the part before the separator, the separator | itself, and the part after it. | | If the separator is not found, returns a 3-tuple containing the original string | and two empty strings. | | removeprefix(self, prefix, /) | Return a str with the given prefix string removed if present. | | If the string starts with the prefix string, return string[len(prefix):]. | Otherwise, return a copy of the original string. | | removesuffix(self, suffix, /) | Return a str with the given suffix string removed if present. | | If the string ends with the suffix string and that suffix is not empty, | return string[:-len(suffix)]. Otherwise, return a copy of the original | string. | | replace(self, old, new, count=-1, /) | Return a copy with all occurrences of substring old replaced by new. | | count | Maximum number of occurrences to replace. | -1 (the default value) means replace all occurrences. | | If the optional argument count is given, only the first count occurrences are | replaced. | | rfind(...) | S.rfind(sub[, start[, end]]) -> int | | Return the highest index in S where substring sub is found, | such that sub is contained within S[start:end]. Optional | arguments start and end are interpreted as in slice notation. | | Return -1 on failure. | | rindex(...) | S.rindex(sub[, start[, end]]) -> int | | Return the highest index in S where substring sub is found, | such that sub is contained within S[start:end]. Optional | arguments start and end are interpreted as in slice notation. | | Raises ValueError when the substring is not found. | | rjust(self, width, fillchar=' ', /) | Return a right-justified string of length width. | | Padding is done using the specified fill character (default is a space). | | rpartition(self, sep, /) | Partition the string into three parts using the given separator. | | This will search for the separator in the string, starting at the end. If | the separator is found, returns a 3-tuple containing the part before the | separator, the separator itself, and the part after it. | | If the separator is not found, returns a 3-tuple containing two empty strings | and the original string. | | rsplit(self, /, sep=None, maxsplit=-1) | Return a list of the substrings in the string, using sep as the separator string. | | sep | The separator used to split the string. | | When set to None (the default value), will split on any whitespace | character (including \\n \\r \\t \\f and spaces) and will discard | empty strings from the result. | maxsplit | Maximum number of splits (starting from the left). | -1 (the default value) means no limit. | | Splitting starts at the end of the string and works to the front. | | rstrip(self, chars=None, /) | Return a copy of the string with trailing whitespace removed. | | If chars is given and not None, remove characters in chars instead. | | split(self, /, sep=None, maxsplit=-1) | Return a list of the substrings in the string, using sep as the separator string. | | sep | The separator used to split the string. | | When set to None (the default value), will split on any whitespace | character (including \\n \\r \\t \\f and spaces) and will discard | empty strings from the result. | maxsplit | Maximum number of splits (starting from the left). | -1 (the default value) means no limit. | | Note, str.split() is mainly useful for data that has been intentionally | delimited. With natural text that includes punctuation, consider using | the regular expression module. | | splitlines(self, /, keepends=False) | Return a list of the lines in the string, breaking at line boundaries. | | Line breaks are not included in the resulting list unless keepends is given and | true. | | startswith(...) | S.startswith(prefix[, start[, end]]) -> bool | | Return True if S starts with the specified prefix, False otherwise. | With optional start, test S beginning at that position. | With optional end, stop comparing S at that position. | prefix can also be a tuple of strings to try. | | strip(self, chars=None, /) | Return a copy of the string with leading and trailing whitespace removed. | | If chars is given and not None, remove characters in chars instead. | | swapcase(self, /) | Convert uppercase characters to lowercase and lowercase characters to uppercase. | | title(self, /) | Return a version of the string where each word is titlecased. | | More specifically, words start with uppercased characters and all remaining | cased characters have lower case. | | translate(self, table, /) | Replace each character in the string using the given translation table. | | table | Translation table, which must be a mapping of Unicode ordinals to | Unicode ordinals, strings, or None. | | The table must implement lookup/indexing via __getitem__, for instance a | dictionary or list. If this operation raises LookupError, the character is | left untouched. Characters mapped to None are deleted. | | upper(self, /) | Return a copy of the string converted to uppercase. | | zfill(self, width, /) | Pad a numeric string with zeros on the left, to fill a field of the given width. | | The string is never truncated. | | ---------------------------------------------------------------------- | Static methods inherited from builtins.str: | | maketrans(...) | Return a translation table usable for str.translate(). | | If there is only one argument, it must be a dictionary mapping Unicode | ordinals (integers) or characters to Unicode ordinals, strings or None. | Character keys will be then converted to ordinals. | If there are two arguments, they must be strings of equal length, and | in the resulting dictionary, each character in x will be mapped to the | character at the same position in y. If there is a third argument, it | must be a string, whose characters will be mapped to None in the result. class StarterBus(Bus) | StarterBus(private=False, mainloop=None) | | The bus that activated this process (only valid if | this process was launched by DBus activation). | | Method resolution order: | StarterBus | Bus | dbus.bus.BusConnection | dbus.connection.Connection | _dbus_bindings.Connection | builtins.object | | Static methods defined here: | | __new__(cls, private=False, mainloop=None) | Return a connection to the bus that activated this process. | | :Parameters: | `private` : bool | If true, never return an existing shared instance, but instead | return a private connection. | `mainloop` : dbus.mainloop.NativeMainLoop | The main loop to use. The default is to use the default | main loop if one has been set up, or raise an exception | if none has been. | | ---------------------------------------------------------------------- | Methods inherited from Bus: | | __repr__(self) | Return repr(self). | | __str__ = __repr__(self) | | close(self) | close() | | Close the connection. | | get_connection(self) | Return self, for backwards compatibility with earlier dbus-python | versions where Bus was not a subclass of Connection. | | :Deprecated: since 0.80.0 | | ---------------------------------------------------------------------- | Static methods inherited from Bus: | | get_session(private=False) | Static method that returns a connection to the session bus. | | :Parameters: | `private` : bool | If true, do not return a shared connection. | | get_starter(private=False) | Static method that returns a connection to the starter bus. | | :Parameters: | `private` : bool | If true, do not return a shared connection. | | get_system(private=False) | Static method that returns a connection to the system bus. | | :Parameters: | `private` : bool | If true, do not return a shared connection. | | ---------------------------------------------------------------------- | Methods inherited from dbus.bus.BusConnection: | | activate_name_owner(self, bus_name) | Return the unique name for the given bus name, activating it | if necessary and possible. | | If the name is already unique or this connection is not to a | bus daemon, just return it. | | :Returns: a bus name. If the given `bus_name` exists, the returned | name identifies its current owner; otherwise the returned name | does not exist. | :Raises DBusException: if the implementation has failed | to activate the given bus name. | :Since: 0.81.0 | | add_match_string(self, rule) | Arrange for this application to receive messages on the bus that | match the given rule. This version will block. | | :Parameters: | `rule` : str | The match rule | :Raises `DBusException`: on error. | :Since: 0.80.0 | | add_match_string_non_blocking(self, rule) | Arrange for this application to receive messages on the bus that | match the given rule. This version will not block, but any errors | will be ignored. | | | :Parameters: | `rule` : str | The match rule | :Raises `DBusException`: on error. | :Since: 0.80.0 | | add_signal_receiver(self, handler_function, signal_name=None, dbus_interface=None, bus_name=None, path=None, **keywords) | Arrange for the given function to be called when a signal matching | the parameters is received. | | :Parameters: | `handler_function` : callable | The function to be called. Its positional arguments will | be the arguments of the signal. By default it will receive | no keyword arguments, but see the description of | the optional keyword arguments below. | `signal_name` : str | The signal name; None (the default) matches all names | `dbus_interface` : str | The D-Bus interface name with which to qualify the signal; | None (the default) matches all interface names | `bus_name` : str | A bus name for the sender, which will be resolved to a | unique name if it is not already; None (the default) matches | any sender. | `path` : str | The object path of the object which must have emitted the | signal; None (the default) matches any object path | :Keywords: | `utf8_strings` : bool | If True, the handler function will receive any string | arguments as dbus.UTF8String objects (a subclass of str | guaranteed to be UTF-8). If False (default) it will receive | any string arguments as dbus.String objects (a subclass of | unicode). | `byte_arrays` : bool | If True, the handler function will receive any byte-array | arguments as dbus.ByteArray objects (a subclass of str). | If False (default) it will receive any byte-array | arguments as a dbus.Array of dbus.Byte (subclasses of: | a list of ints). | `sender_keyword` : str | If not None (the default), the handler function will receive | the unique name of the sending endpoint as a keyword | argument with this name. | `destination_keyword` : str | If not None (the default), the handler function will receive | the bus name of the destination (or None if the signal is a | broadcast, as is usual) as a keyword argument with this name. | `interface_keyword` : str | If not None (the default), the handler function will receive | the signal interface as a keyword argument with this name. | `member_keyword` : str | If not None (the default), the handler function will receive | the signal name as a keyword argument with this name. | `path_keyword` : str | If not None (the default), the handler function will receive | the object-path of the sending object as a keyword argument | with this name. | `message_keyword` : str | If not None (the default), the handler function will receive | the `dbus.lowlevel.SignalMessage` as a keyword argument with | this name. | `arg...` : unicode or UTF-8 str | If there are additional keyword parameters of the form | ``arg``\ *n*, match only signals where the *n*\ th argument | is the value given for that keyword parameter. As of this | time only string arguments can be matched (in particular, | object paths and signatures can't). | `named_service` : str | A deprecated alias for `bus_name`. | | get_name_owner(self, bus_name) | Return the unique connection name of the primary owner of the | given name. | | :Raises `DBusException`: if the `bus_name` has no owner | :Since: 0.81.0 | | get_object(self, bus_name, object_path, introspect=True, follow_name_owner_changes=False, **kwargs) | Return a local proxy for the given remote object. | | Method calls on the proxy are translated into method calls on the | remote object. | | :Parameters: | `bus_name` : str | A bus name (either the unique name or a well-known name) | of the application owning the object. The keyword argument | named_service is a deprecated alias for this. | `object_path` : str | The object path of the desired object | `introspect` : bool | If true (default), attempt to introspect the remote | object to find out supported methods and their signatures | `follow_name_owner_changes` : bool | If the object path is a well-known name and this parameter | is false (default), resolve the well-known name to the unique | name of its current owner and bind to that instead; if the | ownership of the well-known name changes in future, | keep communicating with the original owner. | This is necessary if the D-Bus API used is stateful. | | If the object path is a well-known name and this parameter | is true, whenever the well-known name changes ownership in | future, bind to the new owner, if any. | | If the given object path is a unique name, this parameter | has no effect. | | :Returns: a `dbus.proxies.ProxyObject` | :Raises `DBusException`: if resolving the well-known name to a | unique name fails | | get_unix_user(self, bus_name) | Get the numeric uid of the process owning the given bus name. | | :Parameters: | `bus_name` : str | A bus name, either unique or well-known | :Returns: a `dbus.UInt32` | :Since: 0.80.0 | | list_activatable_names(self) | Return a list of all names that can be activated on the bus. | | :Returns: a dbus.Array of dbus.UTF8String | :Since: 0.81.0 | | list_names(self) | Return a list of all currently-owned names on the bus. | | :Returns: a dbus.Array of dbus.UTF8String | :Since: 0.81.0 | | name_has_owner(self, bus_name) | Return True iff the given bus name has an owner on this bus. | | :Parameters: | `bus_name` : str | The bus name to look up | :Returns: a `bool` | | release_name(self, name) | Release a bus name. | | :Parameters: | `name` : str | The well-known name to be released | :Returns: `RELEASE_NAME_REPLY_RELEASED`, | `RELEASE_NAME_REPLY_NON_EXISTENT` | or `RELEASE_NAME_REPLY_NOT_OWNER` | :Raises `DBusException`: if the bus daemon cannot be contacted or | returns an error. | | remove_match_string(self, rule) | Arrange for this application to receive messages on the bus that | match the given rule. This version will block. | | :Parameters: | `rule` : str | The match rule | :Raises `DBusException`: on error. | :Since: 0.80.0 | | remove_match_string_non_blocking(self, rule) | Arrange for this application to receive messages on the bus that | match the given rule. This version will not block, but any errors | will be ignored. | | | :Parameters: | `rule` : str | The match rule | :Raises `DBusException`: on error. | :Since: 0.80.0 | | request_name(self, name, flags=0) | Request a bus name. | | :Parameters: | `name` : str | The well-known name to be requested | `flags` : dbus.UInt32 | A bitwise-OR of 0 or more of the flags | `NAME_FLAG_ALLOW_REPLACEMENT`, | `NAME_FLAG_REPLACE_EXISTING` | and `NAME_FLAG_DO_NOT_QUEUE` | :Returns: `REQUEST_NAME_REPLY_PRIMARY_OWNER`, | `REQUEST_NAME_REPLY_IN_QUEUE`, | `REQUEST_NAME_REPLY_EXISTS` or | `REQUEST_NAME_REPLY_ALREADY_OWNER` | :Raises `DBusException`: if the bus daemon cannot be contacted or | returns an error. | | start_service_by_name(self, bus_name, flags=0) | Start a service which will implement the given bus name on this Bus. | | :Parameters: | `bus_name` : str | The well-known bus name to be activated. | `flags` : dbus.UInt32 | Flags to pass to StartServiceByName (currently none are | defined) | | :Returns: A tuple of 2 elements. The first is always True, the | second is either START_REPLY_SUCCESS or | START_REPLY_ALREADY_RUNNING. | | :Raises `DBusException`: if the service could not be started. | :Since: 0.80.0 | | watch_name_owner(self, bus_name, callback) | Watch the unique connection name of the primary owner of the | given name. | | `callback` will be called with one argument, which is either the | unique connection name, or the empty string (meaning the name is | not owned). | | :Since: 0.81.0 | | ---------------------------------------------------------------------- | Data and other attributes inherited from dbus.bus.BusConnection: | | START_REPLY_ALREADY_RUNNING = 2 | | START_REPLY_SUCCESS = 1 | | TYPE_SESSION = 0 | | TYPE_STARTER = 2 | | TYPE_SYSTEM = 1 | | ---------------------------------------------------------------------- | Methods inherited from dbus.connection.Connection: | | __init__(self, *args, **kwargs) | Initialize self. See help(type(self)) for accurate signature. | | call_async(self, bus_name, object_path, dbus_interface, method, signature, args, reply_handler, error_handler, timeout=-1.0, byte_arrays=False, require_main_loop=True, **kwargs) | Call the given method, asynchronously. | | If the reply_handler is None, successful replies will be ignored. | If the error_handler is None, failures will be ignored. If both | are None, the implementation may request that no reply is sent. | | :Returns: The dbus.lowlevel.PendingCall. | :Since: 0.81.0 | | call_blocking(self, bus_name, object_path, dbus_interface, method, signature, args, timeout=-1.0, byte_arrays=False, **kwargs) | Call the given method, synchronously. | :Since: 0.81.0 | | call_on_disconnection(self, callable) | Arrange for `callable` to be called with one argument (this | Connection object) when the Connection becomes | disconnected. | | :Since: 0.83.0 | | remove_signal_receiver(self, handler_or_match, signal_name=None, dbus_interface=None, bus_name=None, path=None, **keywords) | | ---------------------------------------------------------------------- | Data descriptors inherited from dbus.connection.Connection: | | __dict__ | dictionary for instance variables (if defined) | | ---------------------------------------------------------------------- | Data and other attributes inherited from dbus.connection.Connection: | | ProxyObjectClass = <class 'dbus.proxies.ProxyObject'> | A proxy to the remote Object. | | A ProxyObject is provided by the Bus. ProxyObjects | have member functions, and can be called like normal Python objects. | | | ---------------------------------------------------------------------- | Methods inherited from _dbus_bindings.Connection: | | add_message_filter(...) | add_message_filter(callable) | | Add the given message filter to the internal list. | | Filters are handlers that are run on all incoming messages, prior to the | objects registered to handle object paths. | | Filters are run in the order that they were added. The same handler can | be added as a filter more than once, in which case it will be run more | than once. Filters added during a filter callback won't be run on the | message being processed. | | flush(...) | flush() | | Block until the outgoing message queue is empty. | | get_is_authenticated(...) | get_is_authenticated() -> bool | | Return true if this Connection was ever authenticated. | | get_is_connected(...) | get_is_connected() -> bool | | Return true if this Connection is connected. | | get_peer_unix_process_id(...) | get_peer_unix_process_id() -> long or None | | Get the UNIX process ID at the other end of the connection, if it has been | authenticated. Return None if this is a non-UNIX platform or the | connection has not been authenticated. | | get_peer_unix_user(...) | get_peer_unix_user() -> long or None | | Get the UNIX user ID at the other end of the connection, if it has been | authenticated. Return None if this is a non-UNIX platform or the | connection has not been authenticated. | | get_unique_name(...) | get_unique_name() -> str | | Return this application's unique name on this bus. | | :Raises DBusException: if the connection has no unique name yet | (for Bus objects this can't happen, for peer-to-peer connections | this means you haven't called `set_unique_name`) | | get_unix_fd(...) | get_unix_fd() -> int or None | | Get the connection's UNIX file descriptor, if any. | | This can be used for SELinux access control checks with ``getpeercon()`` | for example. **Do not** read or write to the file descriptor, or try to | ``select()`` on it. | | list_exported_child_objects(...) | list_exported_child_objects(path: str) -> list of str | | Return a list of the names of objects exported on this Connection as | direct children of the given object path. | | Each name returned may be converted to a valid object path using | ``dbus.ObjectPath('%s%s%s' % (path, (path != '/' and '/' or ''), name))``. | For the purposes of this function, every parent or ancestor of an exported | object is considered to be an exported object, even if it's only an object | synthesized by the library to support introspection. | | remove_message_filter(...) | remove_message_filter(callable) | | Remove the given message filter (see `add_message_filter` for details). | | :Raises LookupError: | The given callable is not among the registered filters | | send_message(...) | send_message(msg) -> long | | Queue the given message for sending, and return the message serial number. | | :Parameters: | `msg` : dbus.lowlevel.Message | The message to be sent. | | send_message_with_reply(...) | send_message_with_reply(msg, reply_handler, timeout_s=-1, require_main_loop=False) -> dbus.lowlevel.PendingCall | | Queue the message for sending; expect a reply via the returned PendingCall, | which can also be used to cancel the pending call. | | :Parameters: | `msg` : dbus.lowlevel.Message | The message to be sent | `reply_handler` : callable | Asynchronous reply handler: will be called with one positional | parameter, a Message instance representing the reply. | `timeout_s` : float | If the reply takes more than this many seconds, a timeout error | will be created locally and raised instead. If this timeout is | negative (default), a sane default (supplied by libdbus) is used. | `require_main_loop` : bool | If True, raise RuntimeError if this Connection does not have a main | loop configured. If False (default) and there is no main loop, you are | responsible for calling block() on the PendingCall. | | send_message_with_reply_and_block(...) | send_message_with_reply_and_block(msg, timeout_s=-1) -> dbus.lowlevel.Message | | Send the message and block while waiting for a reply. | | This does not re-enter the main loop, so it can lead to a deadlock, if | the called method tries to make a synchronous call to a method in this | application. As such, it's probably a bad idea. | | :Parameters: | `msg` : dbus.lowlevel.Message | The message to be sent | `timeout_s` : float | If the reply takes more than this many seconds, a timeout error | will be created locally and raised instead. If this timeout is | negative (default), a sane default (supplied by libdbus) is used. | :Returns: | A `dbus.lowlevel.Message` instance (probably a `dbus.lowlevel.MethodReturnMessage`) on success | :Raises dbus.DBusException: | On error (including if the reply arrives but is an | error message) | | set_allow_anonymous(...) | set_allow_anonymous(bool) | | Allows anonymous clients. Call this on the server side of a connection in a on_connection_added callback | | set_exit_on_disconnect(...) | set_exit_on_disconnect(bool) | | Set whether the C function ``_exit`` will be called when this Connection | becomes disconnected. This will cause the program to exit without calling | any cleanup code or exit handlers. | | The default is for this feature to be disabled for Connections and enabled | for Buses. | | set_unique_name(...) | set_unique_name(str) | | Set this application's unique name on this bus. Raise ValueError if it has | already been set. class String(builtins.str) | dbus.String(value: str or unicode[, variant_level: int]) | | A string represented using Unicode - a subtype of ``unicode`` (Python 2) | or ``str`` (Python 3). | | All strings on D-Bus are required to be valid Unicode; in the "wire | protocol" they're transported as UTF-8. | | By default, when strings are converted from D-Bus to Python, they | come out as this class. In Python 2, if you prefer to get UTF-8 strings | (as instances | of a subtype of `str`) or you want to avoid the conversion overhead of | going from UTF-8 to Python's internal Unicode representation, see the | documentation for `dbus.UTF8String`. | | variant_level must be non-negative; the default is 0. | | Method resolution order: | String | builtins.str | builtins.object | | Methods defined here: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __repr__(self, /) | Return repr(self). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | ---------------------------------------------------------------------- | Static methods defined here: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Data descriptors defined here: | | variant_level | Indicates how many nested Variant containers this object | is contained in: if a message's wire format has a variant containing a | variant containing an array, this is represented in Python by a | String or UTF8String with variant_level==2. | | ---------------------------------------------------------------------- | Methods inherited from builtins.str: | | __add__(self, value, /) | Return self+value. | | __contains__(self, key, /) | Return key in self. | | __eq__(self, value, /) | Return self==value. | | __format__(self, format_spec, /) | Return a formatted version of the string as described by format_spec. | | __ge__(self, value, /) | Return self>=value. | | __getitem__(self, key, /) | Return self[key]. | | __getnewargs__(...) | | __gt__(self, value, /) | Return self>value. | | __hash__(self, /) | Return hash(self). | | __iter__(self, /) | Implement iter(self). | | __le__(self, value, /) | Return self<=value. | | __len__(self, /) | Return len(self). | | __lt__(self, value, /) | Return self<value. | | __mod__(self, value, /) | Return self%value. | | __mul__(self, value, /) | Return self*value. | | __ne__(self, value, /) | Return self!=value. | | __rmod__(self, value, /) | Return value%self. | | __rmul__(self, value, /) | Return value*self. | | __sizeof__(self, /) | Return the size of the string in memory, in bytes. | | __str__(self, /) | Return str(self). | | capitalize(self, /) | Return a capitalized version of the string. | | More specifically, make the first character have upper case and the rest lower | case. | | casefold(self, /) | Return a version of the string suitable for caseless comparisons. | | center(self, width, fillchar=' ', /) | Return a centered string of length width. | | Padding is done using the specified fill character (default is a space). | | count(...) | S.count(sub[, start[, end]]) -> int | | Return the number of non-overlapping occurrences of substring sub in | string S[start:end]. Optional arguments start and end are | interpreted as in slice notation. | | encode(self, /, encoding='utf-8', errors='strict') | Encode the string using the codec registered for encoding. | | encoding | The encoding in which to encode the string. | errors | The error handling scheme to use for encoding errors. | The default is 'strict' meaning that encoding errors raise a | UnicodeEncodeError. Other possible values are 'ignore', 'replace' and | 'xmlcharrefreplace' as well as any other name registered with | codecs.register_error that can handle UnicodeEncodeErrors. | | endswith(...) | S.endswith(suffix[, start[, end]]) -> bool | | Return True if S ends with the specified suffix, False otherwise. | With optional start, test S beginning at that position. | With optional end, stop comparing S at that position. | suffix can also be a tuple of strings to try. | | expandtabs(self, /, tabsize=8) | Return a copy where all tab characters are expanded using spaces. | | If tabsize is not given, a tab size of 8 characters is assumed. | | find(...) | S.find(sub[, start[, end]]) -> int | | Return the lowest index in S where substring sub is found, | such that sub is contained within S[start:end]. Optional | arguments start and end are interpreted as in slice notation. | | Return -1 on failure. | | format(...) | S.format(*args, **kwargs) -> str | | Return a formatted version of S, using substitutions from args and kwargs. | The substitutions are identified by braces ('{' and '}'). | | format_map(...) | S.format_map(mapping) -> str | | Return a formatted version of S, using substitutions from mapping. | The substitutions are identified by braces ('{' and '}'). | | index(...) | S.index(sub[, start[, end]]) -> int | | Return the lowest index in S where substring sub is found, | such that sub is contained within S[start:end]. Optional | arguments start and end are interpreted as in slice notation. | | Raises ValueError when the substring is not found. | | isalnum(self, /) | Return True if the string is an alpha-numeric string, False otherwise. | | A string is alpha-numeric if all characters in the string are alpha-numeric and | there is at least one character in the string. | | isalpha(self, /) | Return True if the string is an alphabetic string, False otherwise. | | A string is alphabetic if all characters in the string are alphabetic and there | is at least one character in the string. | | isascii(self, /) | Return True if all characters in the string are ASCII, False otherwise. | | ASCII characters have code points in the range U+0000-U+007F. | Empty string is ASCII too. | | isdecimal(self, /) | Return True if the string is a decimal string, False otherwise. | | A string is a decimal string if all characters in the string are decimal and | there is at least one character in the string. | | isdigit(self, /) | Return True if the string is a digit string, False otherwise. | | A string is a digit string if all characters in the string are digits and there | is at least one character in the string. | | isidentifier(self, /) | Return True if the string is a valid Python identifier, False otherwise. | | Call keyword.iskeyword(s) to test whether string s is a reserved identifier, | such as "def" or "class". | | islower(self, /) | Return True if the string is a lowercase string, False otherwise. | | A string is lowercase if all cased characters in the string are lowercase and | there is at least one cased character in the string. | | isnumeric(self, /) | Return True if the string is a numeric string, False otherwise. | | A string is numeric if all characters in the string are numeric and there is at | least one character in the string. | | isprintable(self, /) | Return True if the string is printable, False otherwise. | | A string is printable if all of its characters are considered printable in | repr() or if it is empty. | | isspace(self, /) | Return True if the string is a whitespace string, False otherwise. | | A string is whitespace if all characters in the string are whitespace and there | is at least one character in the string. | | istitle(self, /) | Return True if the string is a title-cased string, False otherwise. | | In a title-cased string, upper- and title-case characters may only | follow uncased characters and lowercase characters only cased ones. | | isupper(self, /) | Return True if the string is an uppercase string, False otherwise. | | A string is uppercase if all cased characters in the string are uppercase and | there is at least one cased character in the string. | | join(self, iterable, /) | Concatenate any number of strings. | | The string whose method is called is inserted in between each given string. | The result is returned as a new string. | | Example: '.'.join(['ab', 'pq', 'rs']) -> 'ab.pq.rs' | | ljust(self, width, fillchar=' ', /) | Return a left-justified string of length width. | | Padding is done using the specified fill character (default is a space). | | lower(self, /) | Return a copy of the string converted to lowercase. | | lstrip(self, chars=None, /) | Return a copy of the string with leading whitespace removed. | | If chars is given and not None, remove characters in chars instead. | | partition(self, sep, /) | Partition the string into three parts using the given separator. | | This will search for the separator in the string. If the separator is found, | returns a 3-tuple containing the part before the separator, the separator | itself, and the part after it. | | If the separator is not found, returns a 3-tuple containing the original string | and two empty strings. | | removeprefix(self, prefix, /) | Return a str with the given prefix string removed if present. | | If the string starts with the prefix string, return string[len(prefix):]. | Otherwise, return a copy of the original string. | | removesuffix(self, suffix, /) | Return a str with the given suffix string removed if present. | | If the string ends with the suffix string and that suffix is not empty, | return string[:-len(suffix)]. Otherwise, return a copy of the original | string. | | replace(self, old, new, count=-1, /) | Return a copy with all occurrences of substring old replaced by new. | | count | Maximum number of occurrences to replace. | -1 (the default value) means replace all occurrences. | | If the optional argument count is given, only the first count occurrences are | replaced. | | rfind(...) | S.rfind(sub[, start[, end]]) -> int | | Return the highest index in S where substring sub is found, | such that sub is contained within S[start:end]. Optional | arguments start and end are interpreted as in slice notation. | | Return -1 on failure. | | rindex(...) | S.rindex(sub[, start[, end]]) -> int | | Return the highest index in S where substring sub is found, | such that sub is contained within S[start:end]. Optional | arguments start and end are interpreted as in slice notation. | | Raises ValueError when the substring is not found. | | rjust(self, width, fillchar=' ', /) | Return a right-justified string of length width. | | Padding is done using the specified fill character (default is a space). | | rpartition(self, sep, /) | Partition the string into three parts using the given separator. | | This will search for the separator in the string, starting at the end. If | the separator is found, returns a 3-tuple containing the part before the | separator, the separator itself, and the part after it. | | If the separator is not found, returns a 3-tuple containing two empty strings | and the original string. | | rsplit(self, /, sep=None, maxsplit=-1) | Return a list of the substrings in the string, using sep as the separator string. | | sep | The separator used to split the string. | | When set to None (the default value), will split on any whitespace | character (including \\n \\r \\t \\f and spaces) and will discard | empty strings from the result. | maxsplit | Maximum number of splits (starting from the left). | -1 (the default value) means no limit. | | Splitting starts at the end of the string and works to the front. | | rstrip(self, chars=None, /) | Return a copy of the string with trailing whitespace removed. | | If chars is given and not None, remove characters in chars instead. | | split(self, /, sep=None, maxsplit=-1) | Return a list of the substrings in the string, using sep as the separator string. | | sep | The separator used to split the string. | | When set to None (the default value), will split on any whitespace | character (including \\n \\r \\t \\f and spaces) and will discard | empty strings from the result. | maxsplit | Maximum number of splits (starting from the left). | -1 (the default value) means no limit. | | Note, str.split() is mainly useful for data that has been intentionally | delimited. With natural text that includes punctuation, consider using | the regular expression module. | | splitlines(self, /, keepends=False) | Return a list of the lines in the string, breaking at line boundaries. | | Line breaks are not included in the resulting list unless keepends is given and | true. | | startswith(...) | S.startswith(prefix[, start[, end]]) -> bool | | Return True if S starts with the specified prefix, False otherwise. | With optional start, test S beginning at that position. | With optional end, stop comparing S at that position. | prefix can also be a tuple of strings to try. | | strip(self, chars=None, /) | Return a copy of the string with leading and trailing whitespace removed. | | If chars is given and not None, remove characters in chars instead. | | swapcase(self, /) | Convert uppercase characters to lowercase and lowercase characters to uppercase. | | title(self, /) | Return a version of the string where each word is titlecased. | | More specifically, words start with uppercased characters and all remaining | cased characters have lower case. | | translate(self, table, /) | Replace each character in the string using the given translation table. | | table | Translation table, which must be a mapping of Unicode ordinals to | Unicode ordinals, strings, or None. | | The table must implement lookup/indexing via __getitem__, for instance a | dictionary or list. If this operation raises LookupError, the character is | left untouched. Characters mapped to None are deleted. | | upper(self, /) | Return a copy of the string converted to uppercase. | | zfill(self, width, /) | Pad a numeric string with zeros on the left, to fill a field of the given width. | | The string is never truncated. | | ---------------------------------------------------------------------- | Static methods inherited from builtins.str: | | maketrans(...) | Return a translation table usable for str.translate(). | | If there is only one argument, it must be a dictionary mapping Unicode | ordinals (integers) or characters to Unicode ordinals, strings or None. | Character keys will be then converted to ordinals. | If there are two arguments, they must be strings of equal length, and | in the resulting dictionary, each character in x will be mapped to the | character at the same position in y. If there is a third argument, it | must be a string, whose characters will be mapped to None in the result. class Struct(builtins.tuple) | Struct(iterable=(), /) | | dbus.Struct(iterable, signature=None, variant_level=0) | | An structure containing items of possibly distinct types. | | D-Bus structs may not be empty, so the iterable argument is required and | may not be an empty iterable. | | ``signature`` is either None, or a string representing the contents of the | struct as one or more complete type signatures. The overall signature of | the struct will be the given signature enclosed in parentheses, ``()``. | | If the signature is None (default) it will be guessed | from the types of the items during construction. | | :py:attr:`variant_level` must be non-negative; the default is 0. | | .. py:attribute:: variant_level | | Indicates how many nested Variant containers this object | is contained in: if a message's wire format has a variant containing a | variant containing a struct, this is represented in Python by a | Struct with variant_level==2. | | Method resolution order: | Struct | builtins.tuple | builtins.object | | Methods defined here: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __repr__(self, /) | Return repr(self). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | ---------------------------------------------------------------------- | Static methods defined here: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Methods inherited from builtins.tuple: | | __add__(self, value, /) | Return self+value. | | __contains__(self, key, /) | Return key in self. | | __eq__(self, value, /) | Return self==value. | | __ge__(self, value, /) | Return self>=value. | | __getitem__(self, key, /) | Return self[key]. | | __getnewargs__(self, /) | | __gt__(self, value, /) | Return self>value. | | __hash__(self, /) | Return hash(self). | | __iter__(self, /) | Implement iter(self). | | __le__(self, value, /) | Return self<=value. | | __len__(self, /) | Return len(self). | | __lt__(self, value, /) | Return self<value. | | __mul__(self, value, /) | Return self*value. | | __ne__(self, value, /) | Return self!=value. | | __rmul__(self, value, /) | Return value*self. | | count(self, value, /) | Return number of occurrences of value. | | index(self, value, start=0, stop=9223372036854775807, /) | Return first index of value. | | Raises ValueError if the value is not present. | | ---------------------------------------------------------------------- | Class methods inherited from builtins.tuple: | | __class_getitem__(...) from builtins.type | See PEP 585 class SystemBus(Bus) | SystemBus(private=False, mainloop=None) | | The system-wide message bus. | | Method resolution order: | SystemBus | Bus | dbus.bus.BusConnection | dbus.connection.Connection | _dbus_bindings.Connection | builtins.object | | Static methods defined here: | | __new__(cls, private=False, mainloop=None) | Return a connection to the system bus. | | :Parameters: | `private` : bool | If true, never return an existing shared instance, but instead | return a private connection. | `mainloop` : dbus.mainloop.NativeMainLoop | The main loop to use. The default is to use the default | main loop if one has been set up, or raise an exception | if none has been. | | ---------------------------------------------------------------------- | Methods inherited from Bus: | | __repr__(self) | Return repr(self). | | __str__ = __repr__(self) | | close(self) | close() | | Close the connection. | | get_connection(self) | Return self, for backwards compatibility with earlier dbus-python | versions where Bus was not a subclass of Connection. | | :Deprecated: since 0.80.0 | | ---------------------------------------------------------------------- | Static methods inherited from Bus: | | get_session(private=False) | Static method that returns a connection to the session bus. | | :Parameters: | `private` : bool | If true, do not return a shared connection. | | get_starter(private=False) | Static method that returns a connection to the starter bus. | | :Parameters: | `private` : bool | If true, do not return a shared connection. | | get_system(private=False) | Static method that returns a connection to the system bus. | | :Parameters: | `private` : bool | If true, do not return a shared connection. | | ---------------------------------------------------------------------- | Methods inherited from dbus.bus.BusConnection: | | activate_name_owner(self, bus_name) | Return the unique name for the given bus name, activating it | if necessary and possible. | | If the name is already unique or this connection is not to a | bus daemon, just return it. | | :Returns: a bus name. If the given `bus_name` exists, the returned | name identifies its current owner; otherwise the returned name | does not exist. | :Raises DBusException: if the implementation has failed | to activate the given bus name. | :Since: 0.81.0 | | add_match_string(self, rule) | Arrange for this application to receive messages on the bus that | match the given rule. This version will block. | | :Parameters: | `rule` : str | The match rule | :Raises `DBusException`: on error. | :Since: 0.80.0 | | add_match_string_non_blocking(self, rule) | Arrange for this application to receive messages on the bus that | match the given rule. This version will not block, but any errors | will be ignored. | | | :Parameters: | `rule` : str | The match rule | :Raises `DBusException`: on error. | :Since: 0.80.0 | | add_signal_receiver(self, handler_function, signal_name=None, dbus_interface=None, bus_name=None, path=None, **keywords) | Arrange for the given function to be called when a signal matching | the parameters is received. | | :Parameters: | `handler_function` : callable | The function to be called. Its positional arguments will | be the arguments of the signal. By default it will receive | no keyword arguments, but see the description of | the optional keyword arguments below. | `signal_name` : str | The signal name; None (the default) matches all names | `dbus_interface` : str | The D-Bus interface name with which to qualify the signal; | None (the default) matches all interface names | `bus_name` : str | A bus name for the sender, which will be resolved to a | unique name if it is not already; None (the default) matches | any sender. | `path` : str | The object path of the object which must have emitted the | signal; None (the default) matches any object path | :Keywords: | `utf8_strings` : bool | If True, the handler function will receive any string | arguments as dbus.UTF8String objects (a subclass of str | guaranteed to be UTF-8). If False (default) it will receive | any string arguments as dbus.String objects (a subclass of | unicode). | `byte_arrays` : bool | If True, the handler function will receive any byte-array | arguments as dbus.ByteArray objects (a subclass of str). | If False (default) it will receive any byte-array | arguments as a dbus.Array of dbus.Byte (subclasses of: | a list of ints). | `sender_keyword` : str | If not None (the default), the handler function will receive | the unique name of the sending endpoint as a keyword | argument with this name. | `destination_keyword` : str | If not None (the default), the handler function will receive | the bus name of the destination (or None if the signal is a | broadcast, as is usual) as a keyword argument with this name. | `interface_keyword` : str | If not None (the default), the handler function will receive | the signal interface as a keyword argument with this name. | `member_keyword` : str | If not None (the default), the handler function will receive | the signal name as a keyword argument with this name. | `path_keyword` : str | If not None (the default), the handler function will receive | the object-path of the sending object as a keyword argument | with this name. | `message_keyword` : str | If not None (the default), the handler function will receive | the `dbus.lowlevel.SignalMessage` as a keyword argument with | this name. | `arg...` : unicode or UTF-8 str | If there are additional keyword parameters of the form | ``arg``\ *n*, match only signals where the *n*\ th argument | is the value given for that keyword parameter. As of this | time only string arguments can be matched (in particular, | object paths and signatures can't). | `named_service` : str | A deprecated alias for `bus_name`. | | get_name_owner(self, bus_name) | Return the unique connection name of the primary owner of the | given name. | | :Raises `DBusException`: if the `bus_name` has no owner | :Since: 0.81.0 | | get_object(self, bus_name, object_path, introspect=True, follow_name_owner_changes=False, **kwargs) | Return a local proxy for the given remote object. | | Method calls on the proxy are translated into method calls on the | remote object. | | :Parameters: | `bus_name` : str | A bus name (either the unique name or a well-known name) | of the application owning the object. The keyword argument | named_service is a deprecated alias for this. | `object_path` : str | The object path of the desired object | `introspect` : bool | If true (default), attempt to introspect the remote | object to find out supported methods and their signatures | `follow_name_owner_changes` : bool | If the object path is a well-known name and this parameter | is false (default), resolve the well-known name to the unique | name of its current owner and bind to that instead; if the | ownership of the well-known name changes in future, | keep communicating with the original owner. | This is necessary if the D-Bus API used is stateful. | | If the object path is a well-known name and this parameter | is true, whenever the well-known name changes ownership in | future, bind to the new owner, if any. | | If the given object path is a unique name, this parameter | has no effect. | | :Returns: a `dbus.proxies.ProxyObject` | :Raises `DBusException`: if resolving the well-known name to a | unique name fails | | get_unix_user(self, bus_name) | Get the numeric uid of the process owning the given bus name. | | :Parameters: | `bus_name` : str | A bus name, either unique or well-known | :Returns: a `dbus.UInt32` | :Since: 0.80.0 | | list_activatable_names(self) | Return a list of all names that can be activated on the bus. | | :Returns: a dbus.Array of dbus.UTF8String | :Since: 0.81.0 | | list_names(self) | Return a list of all currently-owned names on the bus. | | :Returns: a dbus.Array of dbus.UTF8String | :Since: 0.81.0 | | name_has_owner(self, bus_name) | Return True iff the given bus name has an owner on this bus. | | :Parameters: | `bus_name` : str | The bus name to look up | :Returns: a `bool` | | release_name(self, name) | Release a bus name. | | :Parameters: | `name` : str | The well-known name to be released | :Returns: `RELEASE_NAME_REPLY_RELEASED`, | `RELEASE_NAME_REPLY_NON_EXISTENT` | or `RELEASE_NAME_REPLY_NOT_OWNER` | :Raises `DBusException`: if the bus daemon cannot be contacted or | returns an error. | | remove_match_string(self, rule) | Arrange for this application to receive messages on the bus that | match the given rule. This version will block. | | :Parameters: | `rule` : str | The match rule | :Raises `DBusException`: on error. | :Since: 0.80.0 | | remove_match_string_non_blocking(self, rule) | Arrange for this application to receive messages on the bus that | match the given rule. This version will not block, but any errors | will be ignored. | | | :Parameters: | `rule` : str | The match rule | :Raises `DBusException`: on error. | :Since: 0.80.0 | | request_name(self, name, flags=0) | Request a bus name. | | :Parameters: | `name` : str | The well-known name to be requested | `flags` : dbus.UInt32 | A bitwise-OR of 0 or more of the flags | `NAME_FLAG_ALLOW_REPLACEMENT`, | `NAME_FLAG_REPLACE_EXISTING` | and `NAME_FLAG_DO_NOT_QUEUE` | :Returns: `REQUEST_NAME_REPLY_PRIMARY_OWNER`, | `REQUEST_NAME_REPLY_IN_QUEUE`, | `REQUEST_NAME_REPLY_EXISTS` or | `REQUEST_NAME_REPLY_ALREADY_OWNER` | :Raises `DBusException`: if the bus daemon cannot be contacted or | returns an error. | | start_service_by_name(self, bus_name, flags=0) | Start a service which will implement the given bus name on this Bus. | | :Parameters: | `bus_name` : str | The well-known bus name to be activated. | `flags` : dbus.UInt32 | Flags to pass to StartServiceByName (currently none are | defined) | | :Returns: A tuple of 2 elements. The first is always True, the | second is either START_REPLY_SUCCESS or | START_REPLY_ALREADY_RUNNING. | | :Raises `DBusException`: if the service could not be started. | :Since: 0.80.0 | | watch_name_owner(self, bus_name, callback) | Watch the unique connection name of the primary owner of the | given name. | | `callback` will be called with one argument, which is either the | unique connection name, or the empty string (meaning the name is | not owned). | | :Since: 0.81.0 | | ---------------------------------------------------------------------- | Data and other attributes inherited from dbus.bus.BusConnection: | | START_REPLY_ALREADY_RUNNING = 2 | | START_REPLY_SUCCESS = 1 | | TYPE_SESSION = 0 | | TYPE_STARTER = 2 | | TYPE_SYSTEM = 1 | | ---------------------------------------------------------------------- | Methods inherited from dbus.connection.Connection: | | __init__(self, *args, **kwargs) | Initialize self. See help(type(self)) for accurate signature. | | call_async(self, bus_name, object_path, dbus_interface, method, signature, args, reply_handler, error_handler, timeout=-1.0, byte_arrays=False, require_main_loop=True, **kwargs) | Call the given method, asynchronously. | | If the reply_handler is None, successful replies will be ignored. | If the error_handler is None, failures will be ignored. If both | are None, the implementation may request that no reply is sent. | | :Returns: The dbus.lowlevel.PendingCall. | :Since: 0.81.0 | | call_blocking(self, bus_name, object_path, dbus_interface, method, signature, args, timeout=-1.0, byte_arrays=False, **kwargs) | Call the given method, synchronously. | :Since: 0.81.0 | | call_on_disconnection(self, callable) | Arrange for `callable` to be called with one argument (this | Connection object) when the Connection becomes | disconnected. | | :Since: 0.83.0 | | remove_signal_receiver(self, handler_or_match, signal_name=None, dbus_interface=None, bus_name=None, path=None, **keywords) | | ---------------------------------------------------------------------- | Data descriptors inherited from dbus.connection.Connection: | | __dict__ | dictionary for instance variables (if defined) | | ---------------------------------------------------------------------- | Data and other attributes inherited from dbus.connection.Connection: | | ProxyObjectClass = <class 'dbus.proxies.ProxyObject'> | A proxy to the remote Object. | | A ProxyObject is provided by the Bus. ProxyObjects | have member functions, and can be called like normal Python objects. | | | ---------------------------------------------------------------------- | Methods inherited from _dbus_bindings.Connection: | | add_message_filter(...) | add_message_filter(callable) | | Add the given message filter to the internal list. | | Filters are handlers that are run on all incoming messages, prior to the | objects registered to handle object paths. | | Filters are run in the order that they were added. The same handler can | be added as a filter more than once, in which case it will be run more | than once. Filters added during a filter callback won't be run on the | message being processed. | | flush(...) | flush() | | Block until the outgoing message queue is empty. | | get_is_authenticated(...) | get_is_authenticated() -> bool | | Return true if this Connection was ever authenticated. | | get_is_connected(...) | get_is_connected() -> bool | | Return true if this Connection is connected. | | get_peer_unix_process_id(...) | get_peer_unix_process_id() -> long or None | | Get the UNIX process ID at the other end of the connection, if it has been | authenticated. Return None if this is a non-UNIX platform or the | connection has not been authenticated. | | get_peer_unix_user(...) | get_peer_unix_user() -> long or None | | Get the UNIX user ID at the other end of the connection, if it has been | authenticated. Return None if this is a non-UNIX platform or the | connection has not been authenticated. | | get_unique_name(...) | get_unique_name() -> str | | Return this application's unique name on this bus. | | :Raises DBusException: if the connection has no unique name yet | (for Bus objects this can't happen, for peer-to-peer connections | this means you haven't called `set_unique_name`) | | get_unix_fd(...) | get_unix_fd() -> int or None | | Get the connection's UNIX file descriptor, if any. | | This can be used for SELinux access control checks with ``getpeercon()`` | for example. **Do not** read or write to the file descriptor, or try to | ``select()`` on it. | | list_exported_child_objects(...) | list_exported_child_objects(path: str) -> list of str | | Return a list of the names of objects exported on this Connection as | direct children of the given object path. | | Each name returned may be converted to a valid object path using | ``dbus.ObjectPath('%s%s%s' % (path, (path != '/' and '/' or ''), name))``. | For the purposes of this function, every parent or ancestor of an exported | object is considered to be an exported object, even if it's only an object | synthesized by the library to support introspection. | | remove_message_filter(...) | remove_message_filter(callable) | | Remove the given message filter (see `add_message_filter` for details). | | :Raises LookupError: | The given callable is not among the registered filters | | send_message(...) | send_message(msg) -> long | | Queue the given message for sending, and return the message serial number. | | :Parameters: | `msg` : dbus.lowlevel.Message | The message to be sent. | | send_message_with_reply(...) | send_message_with_reply(msg, reply_handler, timeout_s=-1, require_main_loop=False) -> dbus.lowlevel.PendingCall | | Queue the message for sending; expect a reply via the returned PendingCall, | which can also be used to cancel the pending call. | | :Parameters: | `msg` : dbus.lowlevel.Message | The message to be sent | `reply_handler` : callable | Asynchronous reply handler: will be called with one positional | parameter, a Message instance representing the reply. | `timeout_s` : float | If the reply takes more than this many seconds, a timeout error | will be created locally and raised instead. If this timeout is | negative (default), a sane default (supplied by libdbus) is used. | `require_main_loop` : bool | If True, raise RuntimeError if this Connection does not have a main | loop configured. If False (default) and there is no main loop, you are | responsible for calling block() on the PendingCall. | | send_message_with_reply_and_block(...) | send_message_with_reply_and_block(msg, timeout_s=-1) -> dbus.lowlevel.Message | | Send the message and block while waiting for a reply. | | This does not re-enter the main loop, so it can lead to a deadlock, if | the called method tries to make a synchronous call to a method in this | application. As such, it's probably a bad idea. | | :Parameters: | `msg` : dbus.lowlevel.Message | The message to be sent | `timeout_s` : float | If the reply takes more than this many seconds, a timeout error | will be created locally and raised instead. If this timeout is | negative (default), a sane default (supplied by libdbus) is used. | :Returns: | A `dbus.lowlevel.Message` instance (probably a `dbus.lowlevel.MethodReturnMessage`) on success | :Raises dbus.DBusException: | On error (including if the reply arrives but is an | error message) | | set_allow_anonymous(...) | set_allow_anonymous(bool) | | Allows anonymous clients. Call this on the server side of a connection in a on_connection_added callback | | set_exit_on_disconnect(...) | set_exit_on_disconnect(bool) | | Set whether the C function ``_exit`` will be called when this Connection | becomes disconnected. This will cause the program to exit without calling | any cleanup code or exit handlers. | | The default is for this feature to be disabled for Connections and enabled | for Buses. | | set_unique_name(...) | set_unique_name(str) | | Set this application's unique name on this bus. Raise ValueError if it has | already been set. class UInt16(_dbus_bindings._LongBase) | dbus.UInt16(value: int[, variant_level: int]) | | An unsigned 16-bit integer between 0 and 0xFFFF, represented as | a subtype of ``int``. | | ``value`` must be within the allowed range, or `OverflowError` will be | raised. | | :py:attr:`variant_level` must be non-negative; the default is 0. | | .. py:attribute:: variant_level | | Indicates how many nested Variant containers this object | is contained in: if a message's wire format has a variant containing a | variant containing a uint16, this is represented in Python by a | UInt16 with variant_level==2. | | Method resolution order: | UInt16 | _dbus_bindings._LongBase | builtins.int | builtins.object | | Static methods defined here: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Methods inherited from _dbus_bindings._LongBase: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __repr__(self, /) | Return repr(self). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | __str__(self, /) | Return str(self). | | ---------------------------------------------------------------------- | Methods inherited from builtins.int: | | __abs__(self, /) | abs(self) | | __add__(self, value, /) | Return self+value. | | __and__(self, value, /) | Return self&value. | | __bool__(self, /) | True if self else False | | __ceil__(...) | Ceiling of an Integral returns itself. | | __divmod__(self, value, /) | Return divmod(self, value). | | __eq__(self, value, /) | Return self==value. | | __float__(self, /) | float(self) | | __floor__(...) | Flooring an Integral returns itself. | | __floordiv__(self, value, /) | Return self//value. | | __format__(self, format_spec, /) | Default object formatter. | | __ge__(self, value, /) | Return self>=value. | | __getnewargs__(self, /) | | __gt__(self, value, /) | Return self>value. | | __hash__(self, /) | Return hash(self). | | __index__(self, /) | Return self converted to an integer, if self is suitable for use as an index into a list. | | __int__(self, /) | int(self) | | __invert__(self, /) | ~self | | __le__(self, value, /) | Return self<=value. | | __lshift__(self, value, /) | Return self<<value. | | __lt__(self, value, /) | Return self<value. | | __mod__(self, value, /) | Return self%value. | | __mul__(self, value, /) | Return self*value. | | __ne__(self, value, /) | Return self!=value. | | __neg__(self, /) | -self | | __or__(self, value, /) | Return self|value. | | __pos__(self, /) | +self | | __pow__(self, value, mod=None, /) | Return pow(self, value, mod). | | __radd__(self, value, /) | Return value+self. | | __rand__(self, value, /) | Return value&self. | | __rdivmod__(self, value, /) | Return divmod(value, self). | | __rfloordiv__(self, value, /) | Return value//self. | | __rlshift__(self, value, /) | Return value<<self. | | __rmod__(self, value, /) | Return value%self. | | __rmul__(self, value, /) | Return value*self. | | __ror__(self, value, /) | Return value|self. | | __round__(...) | Rounding an Integral returns itself. | | Rounding with an ndigits argument also returns an integer. | | __rpow__(self, value, mod=None, /) | Return pow(value, self, mod). | | __rrshift__(self, value, /) | Return value>>self. | | __rshift__(self, value, /) | Return self>>value. | | __rsub__(self, value, /) | Return value-self. | | __rtruediv__(self, value, /) | Return value/self. | | __rxor__(self, value, /) | Return value^self. | | __sizeof__(self, /) | Returns size in memory, in bytes. | | __sub__(self, value, /) | Return self-value. | | __truediv__(self, value, /) | Return self/value. | | __trunc__(...) | Truncating an Integral returns itself. | | __xor__(self, value, /) | Return self^value. | | as_integer_ratio(self, /) | Return integer ratio. | | Return a pair of integers, whose ratio is exactly equal to the original int | and with a positive denominator. | | >>> (10).as_integer_ratio() | (10, 1) | >>> (-10).as_integer_ratio() | (-10, 1) | >>> (0).as_integer_ratio() | (0, 1) | | bit_count(self, /) | Number of ones in the binary representation of the absolute value of self. | | Also known as the population count. | | >>> bin(13) | '0b1101' | >>> (13).bit_count() | 3 | | bit_length(self, /) | Number of bits necessary to represent self in binary. | | >>> bin(37) | '0b100101' | >>> (37).bit_length() | 6 | | conjugate(...) | Returns self, the complex conjugate of any int. | | to_bytes(self, /, length, byteorder, *, signed=False) | Return an array of bytes representing an integer. | | length | Length of bytes object to use. An OverflowError is raised if the | integer is not representable with the given number of bytes. | byteorder | The byte order used to represent the integer. If byteorder is 'big', | the most significant byte is at the beginning of the byte array. If | byteorder is 'little', the most significant byte is at the end of the | byte array. To request the native byte order of the host system, use | `sys.byteorder' as the byte order value. | signed | Determines whether two's complement is used to represent the integer. | If signed is False and a negative integer is given, an OverflowError | is raised. | | ---------------------------------------------------------------------- | Class methods inherited from builtins.int: | | from_bytes(bytes, byteorder, *, signed=False) from builtins.type | Return the integer represented by the given array of bytes. | | bytes | Holds the array of bytes to convert. The argument must either | support the buffer protocol or be an iterable object producing bytes. | Bytes and bytearray are examples of built-in objects that support the | buffer protocol. | byteorder | The byte order used to represent the integer. If byteorder is 'big', | the most significant byte is at the beginning of the byte array. If | byteorder is 'little', the most significant byte is at the end of the | byte array. To request the native byte order of the host system, use | `sys.byteorder' as the byte order value. | signed | Indicates whether two's complement is used to represent the integer. | | ---------------------------------------------------------------------- | Data descriptors inherited from builtins.int: | | denominator | the denominator of a rational number in lowest terms | | imag | the imaginary part of a complex number | | numerator | the numerator of a rational number in lowest terms | | real | the real part of a complex number class UInt32(_dbus_bindings._LongBase) | dbus.UInt32(value: int[, variant_level: int]) | | An unsigned 32-bit integer between 0 and 0xFFFF FFFF, represented as a | subtype of ``long`` in Python 2 or ``int`` in Python 3. | | ``value`` must be within the allowed range, or `OverflowError` will be | raised. | | :py:attr:`variant_level` must be non-negative; the default is 0. | | .. py:attribute:: variant_level | | Indicates how many nested Variant containers this object | is contained in: if a message's wire format has a variant containing a | variant containing a uint32, this is represented in Python by a | UInt32 with variant_level==2. | | Method resolution order: | UInt32 | _dbus_bindings._LongBase | builtins.int | builtins.object | | Static methods defined here: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Methods inherited from _dbus_bindings._LongBase: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __repr__(self, /) | Return repr(self). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | __str__(self, /) | Return str(self). | | ---------------------------------------------------------------------- | Methods inherited from builtins.int: | | __abs__(self, /) | abs(self) | | __add__(self, value, /) | Return self+value. | | __and__(self, value, /) | Return self&value. | | __bool__(self, /) | True if self else False | | __ceil__(...) | Ceiling of an Integral returns itself. | | __divmod__(self, value, /) | Return divmod(self, value). | | __eq__(self, value, /) | Return self==value. | | __float__(self, /) | float(self) | | __floor__(...) | Flooring an Integral returns itself. | | __floordiv__(self, value, /) | Return self//value. | | __format__(self, format_spec, /) | Default object formatter. | | __ge__(self, value, /) | Return self>=value. | | __getnewargs__(self, /) | | __gt__(self, value, /) | Return self>value. | | __hash__(self, /) | Return hash(self). | | __index__(self, /) | Return self converted to an integer, if self is suitable for use as an index into a list. | | __int__(self, /) | int(self) | | __invert__(self, /) | ~self | | __le__(self, value, /) | Return self<=value. | | __lshift__(self, value, /) | Return self<<value. | | __lt__(self, value, /) | Return self<value. | | __mod__(self, value, /) | Return self%value. | | __mul__(self, value, /) | Return self*value. | | __ne__(self, value, /) | Return self!=value. | | __neg__(self, /) | -self | | __or__(self, value, /) | Return self|value. | | __pos__(self, /) | +self | | __pow__(self, value, mod=None, /) | Return pow(self, value, mod). | | __radd__(self, value, /) | Return value+self. | | __rand__(self, value, /) | Return value&self. | | __rdivmod__(self, value, /) | Return divmod(value, self). | | __rfloordiv__(self, value, /) | Return value//self. | | __rlshift__(self, value, /) | Return value<<self. | | __rmod__(self, value, /) | Return value%self. | | __rmul__(self, value, /) | Return value*self. | | __ror__(self, value, /) | Return value|self. | | __round__(...) | Rounding an Integral returns itself. | | Rounding with an ndigits argument also returns an integer. | | __rpow__(self, value, mod=None, /) | Return pow(value, self, mod). | | __rrshift__(self, value, /) | Return value>>self. | | __rshift__(self, value, /) | Return self>>value. | | __rsub__(self, value, /) | Return value-self. | | __rtruediv__(self, value, /) | Return value/self. | | __rxor__(self, value, /) | Return value^self. | | __sizeof__(self, /) | Returns size in memory, in bytes. | | __sub__(self, value, /) | Return self-value. | | __truediv__(self, value, /) | Return self/value. | | __trunc__(...) | Truncating an Integral returns itself. | | __xor__(self, value, /) | Return self^value. | | as_integer_ratio(self, /) | Return integer ratio. | | Return a pair of integers, whose ratio is exactly equal to the original int | and with a positive denominator. | | >>> (10).as_integer_ratio() | (10, 1) | >>> (-10).as_integer_ratio() | (-10, 1) | >>> (0).as_integer_ratio() | (0, 1) | | bit_count(self, /) | Number of ones in the binary representation of the absolute value of self. | | Also known as the population count. | | >>> bin(13) | '0b1101' | >>> (13).bit_count() | 3 | | bit_length(self, /) | Number of bits necessary to represent self in binary. | | >>> bin(37) | '0b100101' | >>> (37).bit_length() | 6 | | conjugate(...) | Returns self, the complex conjugate of any int. | | to_bytes(self, /, length, byteorder, *, signed=False) | Return an array of bytes representing an integer. | | length | Length of bytes object to use. An OverflowError is raised if the | integer is not representable with the given number of bytes. | byteorder | The byte order used to represent the integer. If byteorder is 'big', | the most significant byte is at the beginning of the byte array. If | byteorder is 'little', the most significant byte is at the end of the | byte array. To request the native byte order of the host system, use | `sys.byteorder' as the byte order value. | signed | Determines whether two's complement is used to represent the integer. | If signed is False and a negative integer is given, an OverflowError | is raised. | | ---------------------------------------------------------------------- | Class methods inherited from builtins.int: | | from_bytes(bytes, byteorder, *, signed=False) from builtins.type | Return the integer represented by the given array of bytes. | | bytes | Holds the array of bytes to convert. The argument must either | support the buffer protocol or be an iterable object producing bytes. | Bytes and bytearray are examples of built-in objects that support the | buffer protocol. | byteorder | The byte order used to represent the integer. If byteorder is 'big', | the most significant byte is at the beginning of the byte array. If | byteorder is 'little', the most significant byte is at the end of the | byte array. To request the native byte order of the host system, use | `sys.byteorder' as the byte order value. | signed | Indicates whether two's complement is used to represent the integer. | | ---------------------------------------------------------------------- | Data descriptors inherited from builtins.int: | | denominator | the denominator of a rational number in lowest terms | | imag | the imaginary part of a complex number | | numerator | the numerator of a rational number in lowest terms | | real | the real part of a complex number class UInt64(_dbus_bindings._LongBase) | dbus.UInt64(value: int[, variant_level: int]) | | An unsigned 64-bit integer between 0 and 0xFFFF FFFF FFFF FFFF, | subtype of ``long`` in Python 2 or ``int`` in Python 3. | | ``value`` must be within the allowed range, or `OverflowError` will be | raised. | | :py:attr:`variant_level` must be non-negative; the default is 0. | | .. py:attribute:: variant_level | | Indicates how many nested Variant containers this object | is contained in: if a message's wire format has a variant containing a | variant containing a uint64, this is represented in Python by a | UInt64 with variant_level==2. | | Method resolution order: | UInt64 | _dbus_bindings._LongBase | builtins.int | builtins.object | | Static methods defined here: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Methods inherited from _dbus_bindings._LongBase: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __repr__(self, /) | Return repr(self). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | __str__(self, /) | Return str(self). | | ---------------------------------------------------------------------- | Methods inherited from builtins.int: | | __abs__(self, /) | abs(self) | | __add__(self, value, /) | Return self+value. | | __and__(self, value, /) | Return self&value. | | __bool__(self, /) | True if self else False | | __ceil__(...) | Ceiling of an Integral returns itself. | | __divmod__(self, value, /) | Return divmod(self, value). | | __eq__(self, value, /) | Return self==value. | | __float__(self, /) | float(self) | | __floor__(...) | Flooring an Integral returns itself. | | __floordiv__(self, value, /) | Return self//value. | | __format__(self, format_spec, /) | Default object formatter. | | __ge__(self, value, /) | Return self>=value. | | __getnewargs__(self, /) | | __gt__(self, value, /) | Return self>value. | | __hash__(self, /) | Return hash(self). | | __index__(self, /) | Return self converted to an integer, if self is suitable for use as an index into a list. | | __int__(self, /) | int(self) | | __invert__(self, /) | ~self | | __le__(self, value, /) | Return self<=value. | | __lshift__(self, value, /) | Return self<<value. | | __lt__(self, value, /) | Return self<value. | | __mod__(self, value, /) | Return self%value. | | __mul__(self, value, /) | Return self*value. | | __ne__(self, value, /) | Return self!=value. | | __neg__(self, /) | -self | | __or__(self, value, /) | Return self|value. | | __pos__(self, /) | +self | | __pow__(self, value, mod=None, /) | Return pow(self, value, mod). | | __radd__(self, value, /) | Return value+self. | | __rand__(self, value, /) | Return value&self. | | __rdivmod__(self, value, /) | Return divmod(value, self). | | __rfloordiv__(self, value, /) | Return value//self. | | __rlshift__(self, value, /) | Return value<<self. | | __rmod__(self, value, /) | Return value%self. | | __rmul__(self, value, /) | Return value*self. | | __ror__(self, value, /) | Return value|self. | | __round__(...) | Rounding an Integral returns itself. | | Rounding with an ndigits argument also returns an integer. | | __rpow__(self, value, mod=None, /) | Return pow(value, self, mod). | | __rrshift__(self, value, /) | Return value>>self. | | __rshift__(self, value, /) | Return self>>value. | | __rsub__(self, value, /) | Return value-self. | | __rtruediv__(self, value, /) | Return value/self. | | __rxor__(self, value, /) | Return value^self. | | __sizeof__(self, /) | Returns size in memory, in bytes. | | __sub__(self, value, /) | Return self-value. | | __truediv__(self, value, /) | Return self/value. | | __trunc__(...) | Truncating an Integral returns itself. | | __xor__(self, value, /) | Return self^value. | | as_integer_ratio(self, /) | Return integer ratio. | | Return a pair of integers, whose ratio is exactly equal to the original int | and with a positive denominator. | | >>> (10).as_integer_ratio() | (10, 1) | >>> (-10).as_integer_ratio() | (-10, 1) | >>> (0).as_integer_ratio() | (0, 1) | | bit_count(self, /) | Number of ones in the binary representation of the absolute value of self. | | Also known as the population count. | | >>> bin(13) | '0b1101' | >>> (13).bit_count() | 3 | | bit_length(self, /) | Number of bits necessary to represent self in binary. | | >>> bin(37) | '0b100101' | >>> (37).bit_length() | 6 | | conjugate(...) | Returns self, the complex conjugate of any int. | | to_bytes(self, /, length, byteorder, *, signed=False) | Return an array of bytes representing an integer. | | length | Length of bytes object to use. An OverflowError is raised if the | integer is not representable with the given number of bytes. | byteorder | The byte order used to represent the integer. If byteorder is 'big', | the most significant byte is at the beginning of the byte array. If | byteorder is 'little', the most significant byte is at the end of the | byte array. To request the native byte order of the host system, use | `sys.byteorder' as the byte order value. | signed | Determines whether two's complement is used to represent the integer. | If signed is False and a negative integer is given, an OverflowError | is raised. | | ---------------------------------------------------------------------- | Class methods inherited from builtins.int: | | from_bytes(bytes, byteorder, *, signed=False) from builtins.type | Return the integer represented by the given array of bytes. | | bytes | Holds the array of bytes to convert. The argument must either | support the buffer protocol or be an iterable object producing bytes. | Bytes and bytearray are examples of built-in objects that support the | buffer protocol. | byteorder | The byte order used to represent the integer. If byteorder is 'big', | the most significant byte is at the beginning of the byte array. If | byteorder is 'little', the most significant byte is at the end of the | byte array. To request the native byte order of the host system, use | `sys.byteorder' as the byte order value. | signed | Indicates whether two's complement is used to represent the integer. | | ---------------------------------------------------------------------- | Data descriptors inherited from builtins.int: | | denominator | the denominator of a rational number in lowest terms | | imag | the imaginary part of a complex number | | numerator | the numerator of a rational number in lowest terms | | real | the real part of a complex number class UnknownMethodException(DBusException) | UnknownMethodException(method) | | Method resolution order: | UnknownMethodException | DBusException | builtins.Exception | builtins.BaseException | builtins.object | | Methods defined here: | | __init__(self, method) | Initialize self. See help(type(self)) for accurate signature. | | ---------------------------------------------------------------------- | Data and other attributes defined here: | | include_traceback = True | | ---------------------------------------------------------------------- | Methods inherited from DBusException: | | __str__(self) | Return a str error | | __unicode__(self) | Return a unicode error | | get_dbus_message(self) | | get_dbus_name(self) | | ---------------------------------------------------------------------- | Data descriptors inherited from DBusException: | | __weakref__ | list of weak references to the object (if defined) | | ---------------------------------------------------------------------- | Static methods inherited from builtins.Exception: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Methods inherited from builtins.BaseException: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __reduce__(...) | Helper for pickle. | | __repr__(self, /) | Return repr(self). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | __setstate__(...) | | with_traceback(...) | Exception.with_traceback(tb) -- | set self.__traceback__ to tb and return self. | | ---------------------------------------------------------------------- | Data descriptors inherited from builtins.BaseException: | | __cause__ | exception cause | | __context__ | exception context | | __dict__ | | __suppress_context__ | | __traceback__ | | args class ValidationException(DBusException) | ValidationException(msg='') | | Method resolution order: | ValidationException | DBusException | builtins.Exception | builtins.BaseException | builtins.object | | Methods defined here: | | __init__(self, msg='') | Initialize self. See help(type(self)) for accurate signature. | | ---------------------------------------------------------------------- | Data and other attributes defined here: | | include_traceback = True | | ---------------------------------------------------------------------- | Methods inherited from DBusException: | | __str__(self) | Return a str error | | __unicode__(self) | Return a unicode error | | get_dbus_message(self) | | get_dbus_name(self) | | ---------------------------------------------------------------------- | Data descriptors inherited from DBusException: | | __weakref__ | list of weak references to the object (if defined) | | ---------------------------------------------------------------------- | Static methods inherited from builtins.Exception: | | __new__(*args, **kwargs) from builtins.type | Create and return a new object. See help(type) for accurate signature. | | ---------------------------------------------------------------------- | Methods inherited from builtins.BaseException: | | __delattr__(self, name, /) | Implement delattr(self, name). | | __getattribute__(self, name, /) | Return getattr(self, name). | | __reduce__(...) | Helper for pickle. | | __repr__(self, /) | Return repr(self). | | __setattr__(self, name, value, /) | Implement setattr(self, name, value). | | __setstate__(...) | | with_traceback(...) | Exception.with_traceback(tb) -- | set self.__traceback__ to tb and return self. | | ---------------------------------------------------------------------- | Data descriptors inherited from builtins.BaseException: | | __cause__ | exception cause | | __context__ | exception context | | __dict__ | | __suppress_context__ | | __traceback__ | | args FUNCTIONS get_default_main_loop(...) get_default_main_loop() -> object Return the global default dbus-python main loop wrapper, which is used when no main loop wrapper is passed to the Connection constructor. If None, there is no default and you should always pass the mainloop parameter to the constructor - if you don't, then asynchronous calls, connecting to signals and exporting objects will raise an exception. There is no default until set_default_main_loop is called. set_default_main_loop(...) set_default_main_loop(object) Change the global default dbus-python main loop wrapper, which is used when no main loop wrapper is passed to the Connection constructor. If None, return to the initial situation: there is no default, and you must always pass the mainloop parameter to the constructor. Two types of main loop wrapper are planned in dbus-python. Native main-loop wrappers are instances of `dbus.mainloop.NativeMainLoop` supplied by extension modules like `dbus.mainloop.glib`: they have no Python API, but connect themselves to ``libdbus`` using native code. Python main-loop wrappers are not yet implemented. They will be objects supporting the interface defined by `dbus.mainloop.MainLoop`, with an API entirely based on Python methods. validate_bus_name(...) validate_bus_name(name, allow_unique=True, allow_well_known=True) Raise ValueError if the argument is not a valid bus name. By default both unique and well-known names are accepted. :Parameters: `name` : str The name to be validated `allow_unique` : bool If False, unique names of the form :1.123 will be rejected `allow_well_known` : bool If False, well-known names of the form com.example.Foo will be rejected :Since: 0.80 validate_error_name(...) validate_error_name(name) Raise ValueError if the given string is not a valid error name. :Since: 0.80 validate_interface_name(...) validate_interface_name(name) Raise ValueError if the given string is not a valid interface name. :Since: 0.80 validate_member_name(...) validate_member_name(name) Raise ValueError if the argument is not a valid member (signal or method) name. :Since: 0.80 validate_object_path(...) validate_object_path(name) Raise ValueError if the given string is not a valid object path. :Since: 0.80 DATA BUS_DAEMON_IFACE = 'org.freedesktop.DBus' BUS_DAEMON_NAME = 'org.freedesktop.DBus' BUS_DAEMON_PATH = '/org/freedesktop/DBus' INTROSPECTABLE_IFACE = 'org.freedesktop.DBus.Introspectable' LOCAL_IFACE = 'org.freedesktop.DBus.Local' LOCAL_PATH = '/org/freedesktop/DBus/Local' PEER_IFACE = 'org.freedesktop.DBus.Peer' PROPERTIES_IFACE = 'org.freedesktop.DBus.Properties' __all__ = ['Bus', 'SystemBus', 'SessionBus', 'StarterBus', 'Interface'... __docformat__ = 'restructuredtext' VERSION 1.2.18 FILE /usr/lib/python3/dist-packages/dbus/__init__.py
Generated by phpMan Author: Che Dong Under GNU General Public License
2026-06-02 05:14 @216.73.216.198 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)