NEWS

   1 D-Bus Python Bindings 0.82.2 (unreleased)
   2 =========================================
   3
   4 Fixes:
   5
   6 * Connection.call_async() measures timeouts in seconds, as was always intended.
   7   This means that calls through a proxy object with a reply_handler and
   8   error_handler will measure the timeout in seconds too. call_blocking()
   9   already used seconds, and still does. Existing code using timeouts for
  10   async calls (which would only have worked with 0.82.1) will have to adjust
  11   the timeout length. This applies to the OLPC Sugar environment as used in
  12   Trial 2, for instance.
  13
  14 * Introspect() now works on objects exported in more than one location.
  15   (fd.o #11794)
  16
  17 * Building against Python 2.4 on non-Debian-derived distributions, or a
  18   non-default Python version on Gentoo, should work again (revenge
  19   of fd.o #11282, thanks Eyal Ben David).
  20
  21 D-Bus Python Bindings 0.82.1 (2007-07-11)
  22 =========================================
  23
  24 The "double precision" release.
  25
  26 Fixes:
  27
  28 * Parse the timeout correctly in send_message_with_reply() and
  29   send_message_with_reply_and_block(), fixing the use of non-default timeouts
  30   (bugs.fd.o #11489)
  31 * The tutorial no longer uses interactive-Python syntax, as it confused users.
  32   (bugs.fd.o #11209)
  33 * When making a call via a proxy object with ignore_reply=True, also get the
  34   necessary introspection data asynchronously. This can avoid deadlocks in
  35   some cases, such as calling methods in the same process (though this is not
  36   recommended, for efficiency and sanity reasons).
  37 * dbus.lowlevel exposes enough constants to write correct filter functions.
  38 * We don't use dbus_watch_get_fd() (deprecated in libdbus) unless our libdbus
  39   is too old to have the modern replacement, dbus_watch_get_unix_fd().
  40
  41 Deprecations:
  42
  43 * Omitting the bus argument in the BusName constructor is deprecated.
  44   The fact that it uses the globally shared connection to the session bus by
  45   default is uncomfortably subtle.
  46
  47 D-Bus Python Bindings 0.82.0 (2007-06-19)
  48 =========================================
  49
  50 Features:
  51
  52 * dbus.service.Object can start off with no Connection or object path, and
  53   become exported later. If suitable class attributes are set, objects can
  54   even be exported on multiple connections, or with multiple object-paths,
  55   or both.
  56
  57 * dbus.service.FallbackObject implements a whole subtree of object-path space
  58   (fd.o #9295).
  59
  60 * ``@method`` accepts a parameter ``connection_keyword`` so methods can find
  61   out which connection to use for any follow-up actions.
  62
  63 * ``@signal`` has a new parameter ``rel_path_keyword`` which gets the path at
  64   which to emit the signal, relative to the path of the FallbackObject.
  65   ``path_keyword`` is now deprecated, and will raise an exception if used
  66   on an object with ``SUPPORTS_MULTIPLE_OBJECT_PATHS``, including any
  67   ``FallbackObject``.
  68
  69 Fixes:
  70
  71 * In watch_name_owner, only the desired name is watched!
  72
  73 * When cleaning up signal matches, errors are ignored. This avoids using up
  74   scarce pending-call allowance on dbus-daemon < 1.1, and emitting error
  75   messages if we get disconnected.
  76
  77 * Signal handlers which are bound to a unique name are automatically
  78   disconnected when the unique name goes away, reducing the likelihood that
  79   applications will leak signal matches.
  80
  81 * Some corrections were made to the tutorial (@service and @method take a
  82   parameter dbus_interface, not just interface; fd.o #11209).
  83
  84 * ${PYTHON}-config is used to get the Python include path (patch from
  85   Sebastien Bacher/Ubuntu, fd.o #11282).
  86
  87 D-Bus Python Bindings 0.81.1 (4 June 2007)
  88 ==========================================
  89
  90 Features:
  91
  92 * When an Error message on the bus is represented as a DBusException, the
  93   error name is copied into the exception and can be retrieved by
  94   get_dbus_name(). Exception handlers should use this instead of looking at
  95   the stringified form of the exception, unless backwards compatibility
  96   is needed.
  97 * DBusException objects now get all arguments from the Error message, not
  98   just the first (although there will usually only be one). Use the 'args'
  99   attribute if you need to retrieve them.
 100 * The Connection, BusConnection and Bus classes have a method
 101   list_exported_child_objects(path: str) -> list of str, which wraps
 102   dbus_connection_list_registered()
 103 * You can remove objects from D-Bus before they become unreferenced, by
 104   using dbus.service.Object.remove_from_connection()
 105   (https://bugs.freedesktop.org/show_bug.cgi?id=10457)
 106
 107 Bug fixes:
 108
 109 * Don't deadlock when removing a signal match that tracks name-owner changes.
 110   (http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=426412)
 111 * Include child nodes in introspection using list_exported_child_objects()
 112
 113 D-Bus Python Bindings 0.81.0 (9 May 2007)
 114 =========================================
 115
 116 The 'series of tubes' release
 117 -----------------------------
 118
 119 This is a feature release with support for non-bus-daemon connections
 120 and improved GObject integration.
 121
 122 Features:
 123
 124 * Bus has a superclass dbus.bus.BusConnection (a connection to a bus daemon,
 125   but without the shared-connection semantics or any deprecated API)
 126   for the benefit of those wanting to subclass bus daemon connections
 127
 128 * BusConnection has a superclass dbus.connection.Connection (a
 129   connection without a bus daemon) for use in peer-to-peer situations,
 130   or distributed pseudo-bus situations without a bus daemon such as
 131   Telepathy's Tubes API
 132
 133 * dbus.gobject_service.ExportedGObject is like dbus.service.Object, but
 134   is also a subclass of GObject (with the necessary metaclass magic to
 135   make this work). Until someone has verified that the GObject side of
 136   things works as expected too, I consider this API to be potentially
 137   subject to change!
 138
 139 * Connection and BusConnection have gained a number of useful methods,
 140   including watch_name_owner (track name owner changes asynchronously,
 141   avoiding race conditions), call_blocking and call_async (blocking and
 142   asynchronous method calls without going via a proxy - note that these
 143   are semi-low-level interfaces which don't do introspection), and
 144   list_names, list_activatable_names and get_name_owner which are
 145   simple wrappers for the corresponding org.freedesktop.DBus methods
 146
 147 * dbus.Interface (now also available at dbus.proxies.Interface)
 148   and dbus.proxies.ProxyObject now have some reasonably obvious properties.
 149
 150 Deprecations:
 151
 152 * All keyword arguments called named_service are deprecated in favour of an
 153   argument called bus_name (to be compatible with both older and newer
 154   dbus-python, you should pass these positional arguments).
 155
 156 * The bus keyword argument to dbus.proxies.ProxyObject is deprecated in
 157   favour of an argument called conn, because proxies will work on non-bus
 158   connections now (again, for maximum compatibility you should use a
 159   positional argument for this).
 160
 161 * No warning is raised for this, but I consider calling any remote method
 162   on a ProxyObject or Interface whose name is either alllowercase or
 163   lower_case_with_underscores to be deprecated, and reserve the right
 164   to add properties or methods of this form in future releases - use
 165   ProxyObject.get_dbus_method if you must call a remote method named in
 166   this way. Methods named following TheUsualDBusConvention or
 167   theJavaConvention are safe.
 168
 169 Bugfixes:
 170
 171 * Exceptions in signal handlers print a stack trace to stderr (this can
 172   be redirected elsewhere with Python's logging framework). Partially
 173   addresses fd.o #9980.
 174
 175 * The reserved local interface and object path are properly checked for.
 176
 177 * When you return a tuple that is not a Struct from a method with no
 178   out_signature, it's interpreted as multiple return values, not a
 179   single Struct (closes fd.o #10174).
 180
 181 * If send_with_reply() returns TRUE but with pending call NULL, dbus-python
 182   no longer crashes. This can happen when unexpectedly disconnected.
 183
 184 * Arguments are not examined for functions declared METH_NOARGS (this is
 185   unnecessary and can cause a crash).
 186
 187 Other notable changes:
 188
 189 * dbus-python uses the standard Python logging framework throughout.
 190   The first time a WARNING or ERROR is generated, it will configure the
 191   logging framework to output to stderr, unless you have already
 192   configured logging in your application.
 193
 194 * The tutorial now advocates the use of add_signal_receiver if all you
 195   want to do is listen for signals: this avoids undesired activation,
 196   e.g. of Listen or Rhythmbox (!). Addresses fd.o #10743, fd.o #10568.
 197
 198 D-Bus Python Bindings 0.80.2 (13 February 2007)
 199 ===============================================
 200 - Fix numerous memory and reference leaks
 201 - Only use -Werror if the user specifically asks for it
 202 - Audit tp_dealloc callbacks to make sure they correctly preserve the
 203   exception state
 204 - Relicense files solely owned by Collabora Ltd. more permissively (LGPL/AFL
 205   rather than GPL/AFL) - this includes the tutorial and all the C code
 206
 207 D-Bus Python Bindings 0.80.1 (24 January 2007)
 208 ==============================================
 209 - The "oops" release
 210 - Install dbus/_version.py, so dbus.__version__ exists again
 211
 212 D-Bus Python Bindings 0.80.0 (24 January 2007)
 213 ==============================================
 214 - The "everything changes" release
 215 - Rewrite dbus_bindings (Pyrex) as _dbus_bindings (C) - API changes!
 216 - Define what's public API
 217 - Move low-level but still public API to dbus.lowlevel
 218 - Remove Variant class, add variant_level property on all D-Bus types
 219 - Make signal matching keep working as expected when name ownership changes
 220 - Use unambiguous D-Bus types when transferring from D-Bus to Python
 221 - Follow well-defined rules when transferring from Python to D-Bus
 222 - Add utf8_strings and byte_arrays options in various places, so a user
 223   can tweak the calling conventions to be more efficient
 224 - Raise RuntimeError if user tries to use a connection with no main loop
 225   to do something that won't work without one
 226 - Make asynchronous method calls actually asynchronous when made before
 227   introspection results come back
 228 - Redo main loop machinery so we can add pure-Python main loops later without
 229   API breakage
 230 - Allow construction of a dbus.service.Object if you don't have a BusName
 231   (or even a Bus)
 232 - Port introspection XML parser from libxml2 (external package) to expat
 233   (included with Python)
 234 - Port build system from distutils to autoconf/automake/libtool
 235 - Install a header file for third-party main loop integration
 236 - Make compatible with Python 2.5, including on 64-bit platforms
 237 - Add docstrings throughout
 238 - Add more tests and examples
 239 - Add interoperability tests (which interoperate with Java)
 240 - Add copyright notices!
 241
 242 D-Bus Python Bindings 0.71 (24 July 2006)
 243 ==============================================================
 244 - Binary modules are now installed in the correct directory
 245 - Distutils exports the dbus and dbus-glib cflags
 246
 247 D-Bus Python Bindings 0.70 (17 July 2006)
 248 ==============================================================
 249 - First release of bindings split
 250 - Move to a distutils build enviornment
 251 - It is possible to now specify sender_keyword="foo", path_keyword="bar" when
 252   adding a signal listener