Release notes

0.8

2022-04-03

• Removed jeepney.integrate APIs, which were deprecated in 0.7. Use jeepney.io instead (see Connecting to DBus and sending messages).
• Removed deprecated jeepney.io.tornado API. Tornado now uses the asyncio event loop, so you can use it along with jeepney.io.asyncio.
• Deprecated conn.router attribute in the Blocking I/O integration. Use proxies or send_and_get_reply() to find replies to method calls, and filter() for other routing.
• Added docs page with background on D-Bus (What is D-Bus?).

0.7.1

2021-07-28

• Add async with support to DBusConnection in the asyncio integration.
• Fix calling receive() immediately after opening a connection in the asyncio integration.

Thanks to Aleksandr Mezin for these changes.

0.7

2021-07-21

• Support for sending and receiving file descriptors. This is available with the blocking, threading and trio integration layers.
• Deprecated older integration APIs, in favour of new APIs introduced in 0.5.
• Fixed passing a deque in to filter() in the blocking integration API.

0.6

2020-11-19

• New method recv_until_filtered() in the blocking I/O integration to receive messages until one is filtered into a queue.
• More efficient buffering of received data waiting to be parsed into D-Bus messages.

0.5

2020-11-10

• New common scheme for I/O integration - see Connections and Routers.
  • This is designed for tasks to wait for messages and then act on them, rather than triggering callbacks. This is based on ideas from ‘structured concurrency’, which also informs the design of Trio. See this blog post by Nathaniel Smith for more background.
  • There are new integrations for Trio and threading.
  • The old integration interfaces should still work for now, but they will be deprecated and eventually removed.
• Message.serialise() accepts a serial number, to serialise outgoing messages without modifying the message object.
• Improved documentation, including API docs.

0.4.3

2020-03-04

• The blocking integration now throws ConnectionResetError on all systems when the connection was closed from the other end. It would previously hang on some systems.

0.4.2

2020-01-03

• The blocking DBusConnection integration class now has a .close() method, and can be used as a context manager:

  from jeepney.integrate.blocking import connect_and_authenticate
  with connect_and_authenticate() as connection:
      ...
  

0.4.1

2019-08-11

• Avoid using asyncio.Future for the blocking integration.
• Set the ‘destination’ field on method return and error messages to the ‘sender’ from the parent message.

Thanks to Oscar Caballero and Thomas Grainger for contributing to this release.

0.4

2018-09-24

• Authentication failures now raise a new AuthenticationError subclass of ValueError, so that they can be caught specifically.
• Fixed logic error when authentication is rejected.
• Use effective user ID for authentication instead of real user ID. In typical use cases these are the same, but where they differ, effective uid seems to be the relevant one.
• The 64 MiB size limit for an array is now checked when serialising it.
• New function jeepney.auth.make_auth_anonymous() to prepare an anonymous authentication message. This is not used by the wrappers in Jeepney at the moment, but may be useful for third party code in some situations.
• New examples for subscribing to D-Bus signals, with blocking I/O and with asyncio.
• Various improvements to documentation.

Thanks to Jane Soko and Gitlab user xiretza for contributing to this release.