# Release notes

## 0.9

2025-02-27

- Fixed subscribing to messages on the message bus with a `path_namespace` parameter (MR !38)

- Fixed authentication on (some?) BSDs, using SCM_CREDS (MR !33), for all integrations except for asyncio (which does not expose `sendmsg`).

- `DBusAddress` and message generators will now raise `ValueError` if given invalid D-Bus names - bus names, object paths, or interface names (MR !36). Previously these could easily be sent in messages, resulting in the bus closing the connection.

- Bindings can now be generated from D-Bus XML in a file with the new `--file` option (MR !34).

- The `async_timeout` package is no longer required for running the tests on Python 3.11 or above (MR !39).

### Breaking changes

- Removed the deprecated `connection.router` API in the blocking IO integration (MR !40).

- Removed the deprecated `unwrap` parameter from `send_and_get_reply` in the blocking integration (MR !37).

## 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.