bleak-retry-connector

v4.7.0 (2026-08-30)

This release is published under the MIT License.

Chores

• Ignore .DS_Store (#321, de1cc83)

• ci: Bump browniebroke/hacktoberfest-labeler-action from 2.6.0 to 2.7.0 in the github-actions group (#318, 52c6cc0)

• deps-dev: Bump blockbuster from 1.5.26 to 1.5.27 (#319, b85c1a0)

• deps-dev: Bump pytest-asyncio from 1.3.0 to 1.4.0 (#295, cce9119)

• pre-commit.ci: Pre-commit autoupdate (#317, 28131b3)

Documentation

• Fix misleading comment in disconnect_devices (#310, 24697b0)

Features

• Add restore_discoveries_sync (#320, be0a8a0)

---

Detailed Changes: v4.6.3...v4.7.0

v4.6.3 (2026-07-22)

This release is published under the MIT License.

Bug Fixes

• Retry EOFError and BrokenPipeError in retry_bluetooth_connection_error (#309, 9beb5f8)

Chores

• deps-dev: Bump pytest from 9.0.3 to 9.1.1 (#301, 9df7d9e)

---

Detailed Changes: v4.6.2...v4.6.3

v4.6.2 (2026-07-22)

This release is published under the MIT License.

Bug Fixes

• release: Resume CHANGELOG updates after semantic-release v9 bump (#306, 30d7851)

Chores

• Fix PyPI classifier from Pre-Alpha to Production/Stable (#305, 6e089ea)

• ci: Bump the github-actions group across 1 directory with 6 updates (#308, d6ed953)

• deps: Bump bleak from 2.1.1 to 3.0.2 (#273, c391abc)

• deps: Bump bluetooth-adapters from 2.1.1 to 2.3.0 (#290, f926c9a)

• deps: Bump dbus-fast from 4.3.0 to 5.0.13 (#291, 21be400)

• deps: Bump dbus-fast from 5.0.13 to 5.0.22 (#298, 1aa1243)

• pre-commit.ci: Pre-commit autoupdate (#294, 859f414)

• pre-commit.ci: Pre-commit autoupdate (#289, 416c8a9)

Documentation

• Clarify cached_services parameter is effectively unused (#292, fa41a1b)

• Document DISCONNECT_TIMEOUT in Constants section (#284, 6462cb6)

• Mark ble_device_callback as deprecated and unused (#287, edb1520)

Refactoring

• Inline _disconnect_devices wrapper (#283, fd3d826)

Testing

• Conformance canary for private bleak internals (#307, 57d1e2e)

---

Detailed Changes: v4.6.1...v4.6.2

v4.6.1 (2026-05-21)

This release is published under the MIT License.

Bug Fixes

• Prevent get_device exceptions escaping clear_cache (#281, 6a48758)

Chores

• Replace isort and black with ruff (#246, 8b4052f)

• ci: Bump codecov/codecov-action from 5 to 6 in the github-actions group (#243, 83389fb)

• deps: Bump dbus-fast from 4.0.0 to 4.3.0 (#272, a15f6c0)

• deps-dev: Bump idna from 3.10 to 3.15 (#274, baf999a)

• deps-dev: Bump pygments from 2.19.2 to 2.20.0 (#250, 4b7bf41)

• deps-dev: Bump pytest from 9.0.2 to 9.0.3 (#249, 75f08f8)

• deps-dev: Bump pytest-cov from 7.0.0 to 7.1.0 (#271, 2154c69)

• deps-dev: Bump requests from 2.32.5 to 2.33.0 (#247, 617032c)

• deps-dev: Bump urllib3 from 2.6.3 to 2.7.0 (#248, 85995bd)

• pre-commit.ci: Pre-commit autoupdate (#269, d30b967)

• pre-commit.ci: Pre-commit autoupdate (#242, 0fb6e5d)

Continuous Integration

• Add Python 3.14 to test matrix (#240, c17507c)

• Fix CI status badge in README (#241, 645902f)

Documentation

• Add extension methods documentation (#239, a842ae3)

• Cover remaining undocumented public APIs (#251, 00cfa18)

• Document undocumented public APIs (#245, 8efbdc0)

• Export BleakConnectionError and BleakOutOfConnectionSlotsError in all (#278, cf2f9a3)

• Fix copy-paste docstring on BleakConnectionError (#279, f882c56)

• Replace black code-style badge with ruff (#252, 7466b3d)

Refactoring

• Drop dead rssi variable from establish_connection debug logs (#280, 5add034)

• Import DISCONNECT_TIMEOUT from const instead of redefining (#282, 7888a3d)

Testing

• Cover init.py fallback paths (87% → 95%) (#267, 0f5c10e)

• Cover bleak_manager DBus socket cache paths (#260, 8d2dd75)

• Cover clear_cache early returns and RemoveDevice send path (#265, bd29b78)

• Cover dbus.disconnect_devices (#261, 4804bd2)

• Cover EOFError reconnect path in establish_connection (#263, 0d16a08)

• Cover establish_connection branches with debug logging off (#276, 4fa03f4)

• Cover get_bluez_device, get_device_by_adapter and get_connected_devices (#264, 2d02ba3)

• Cover missing branches in calculate_backoff_time (#259, 5570aed)

• Cover restore_discoveries early-return branches (#275, 0130731)

• Cover wait_for_device_to_reappear no-debug branches and _get_services_cache (#270, 51b5434)

• Cover wait_for_disconnect and reappear debug logging (#262, 373806d)

• Drop deprecated BLEDevice kwargs from test fixtures (#257, d037fae)

• Integrate blockbuster to catch blocking calls in async tests (#256, f1b8c6e)

• Make sync tests async to silence pytest-asyncio warnings (#258, d4e8377)

• Stop _prime_dbus_coverage from leaking an event loop (#277, 6324ada)

---

Detailed Changes: v4.6.0...v4.6.1

v4.6.0 (2026-03-07)

This release is published under the MIT License.

Chores

• ci: Bump the github-actions group with 2 updates (#210, e0f7eb8)

• deps: Bump bleak from 2.0.0 to 2.1.1 (#212, 820af9d)

• deps: Bump dbus-fast from 3.1.2 to 4.0.0 (#214, ce401a4)

• deps: Bump sphinx-rtd-theme from 3.0.2 to 3.1.0 (#211, a11dca4)

• deps-dev: Bump pytest from 8.4.2 to 9.0.2 (#213, 69ea901)

• deps-dev: Bump pytest-cov from 6.2.1 to 7.0.0 (#195, 42bbca4)

• deps-dev: Bump urllib3 from 2.6.0 to 2.6.3 (#208, 1bbf154)

• pre-commit.ci: Pre-commit autoupdate (#237, 37fb634)

• pre-commit.ci: Pre-commit autoupdate (#236, 8a8efd8)

• pre-commit.ci: Pre-commit autoupdate (#215, 0fb4f51)

• pre-commit.ci: Pre-commit autoupdate (#209, c59de42)

Features

• Add BLE connection parameters API (#238, 6c5a22e)

---

Detailed Changes: v4.5.0...v4.6.0

v4.5.0 (2026-01-07)

This release is published under the MIT License.

Chores

• ci: Bump the github-actions group across 1 directory with 5 updates (#197, 3e9f6e9)

• ci: Bump the github-actions group with 4 updates (#204, 6fb5d1b)

• deps: Bump bleak from 1.1.0 to 1.1.1 (#191, 2792cda)

• deps: Bump bluetooth-adapters from 2.0.0 to 2.1.1 (#194, d9a0aa6)

• deps: Bump dbus-fast from 2.44.3 to 3.1.2 (#203, f5bae70)

• deps-dev: Bump pytest from 8.4.1 to 8.4.2 (#189, c392357)

• deps-dev: Bump pytest-asyncio from 1.1.0 to 1.3.0 (#200, 9845789)

• deps-dev: Bump urllib3 from 2.5.0 to 2.6.0 (#207, 2af8fd5)

• pre-commit.ci: Pre-commit autoupdate (#205, 7a6a101)

• pre-commit.ci: Pre-commit autoupdate (#199, b092c85)

• pre-commit.ci: Pre-commit autoupdate (#192, 1c63244)

Features

• Add support for bleak 2.0.0 (#206, 570d86f)

---

Detailed Changes: v4.4.4...v4.5.0

v4.4.4 (2025-11-12)

This release is published under the MIT License.

Bug Fixes

• deps: Depend on bleak and bluetooth-adapters on Python 3.14 too (#198, acd2487)

---

Detailed Changes: v4.4.3...v4.4.4

v4.4.3 (2025-08-29)

This release is published under the MIT License.

Bug Fixes

• Cache should always be considered valid for ESPHome/MacOS (#187, 0d82b6d)

---

Detailed Changes: v4.4.2...v4.4.3

v4.4.2 (2025-08-29)

This release is published under the MIT License.

Bug Fixes

• Validate services exist on D-Bus before enabling Bleak cache (#186, c89ca6d)

---

Detailed Changes: v4.4.1...v4.4.2

v4.4.1 (2025-08-27)

This release is published under the MIT License.

Bug Fixes

• Prevent KeyError when adapter unplugged during connection (#185, c2b7473)

---

Detailed Changes: v4.4.0...v4.4.1

v4.4.0 (2025-08-23)

This release is published under the MIT License.

Features

• Document why exceptions are raised (#184, 233adef)

---

Detailed Changes: v4.3.0...v4.4.0

v4.3.0 (2025-08-19)

This release is published under the MIT License.

Features

• Link readme to docs (#183, f5c96fd)

---

Detailed Changes: v4.2.0...v4.3.0

v4.2.0 (2025-08-19)

This release is published under the MIT License.

Features

• Add flag to know if bleak-retry-connector is being used for habluetooth (#182, 31252ff)

---

Detailed Changes: v4.1.0...v4.2.0

v4.1.0 (2025-08-19)

This release is published under the MIT License.

Features

• Add docs (#181, 6f74df4)

---

Detailed Changes: v4.0.2...v4.1.0

v4.0.2 (2025-08-19)

This release is published under the MIT License.

Bug Fixes

• Treat ESP_GATT_CONN_CONN_CANCEL as out-of-slots error (#180, 03fdcde)

---

Detailed Changes: v4.0.1...v4.0.2

v4.0.1 (2025-08-12)

This release is published under the MIT License.

Bug Fixes

• Restoring device history (#179, 872b48a)

Chores

• ci: Bump the github-actions group across 1 directory with 3 updates (#178, a29d24b)

• ci: Bump the github-actions group with 2 updates (#171, 0374adb)

• deps: Bump bleak from 1.0.1 to 1.1.0 (#177, 9da4c49)

• deps: Bump dbus-fast from 2.44.1 to 2.44.3 (#176, 2fe43b7)

• deps-dev: Bump pytest-asyncio from 1.0.0 to 1.1.0 (#172, b73dc78)

• pre-commit.ci: Pre-commit autoupdate (#174, f7d4cd5)

• pre-commit.ci: Pre-commit autoupdate (#170, cf55c99)

---

Detailed Changes: v4.0.0...v4.0.1

v4.0.0 (2025-07-01)

This release is published under the MIT License.

Chores

• ci: Bump the github-actions group with 2 updates (#164, 9050ec4)

• ci: Bump the github-actions group with 2 updates (#162, 66738aa)

• ci: Bump the github-actions group with 2 updates (#160, 34a3448)

• deps: Bump dbus-fast from 2.43.0 to 2.44.1 (#157, 4749ca6)

• deps-dev: Bump pytest from 8.3.5 to 8.4.1 (#167, 314d090)

• deps-dev: Bump pytest-asyncio from 0.25.3 to 0.26.0 (#158, 7fc1b70)

• deps-dev: Bump pytest-asyncio from 0.26.0 to 1.0.0 (#165, 5d3cbfd)

• deps-dev: Bump pytest-cov from 6.1.0 to 6.1.1 (#156, ab91190)

• deps-dev: Bump pytest-cov from 6.1.1 to 6.2.1 (#166, 7cab7be)

• pre-commit.ci: Pre-commit autoupdate (#161, 45d0a38)

• pre-commit.ci: Pre-commit autoupdate (#159, 8faf2d9)

• pre-commit.ci: Pre-commit autoupdate (#155, 1f9bb55)

• pre-commit.ci: Pre-commit autoupdate (#154, 8b6e602)

Features

• Update for bleak 1.x (#169, 61a4a3d)

---

Detailed Changes: v3.10.0...v4.0.0

v3.10.0 (2025-04-01)

This release is published under the MIT License.

Chores

• Update dependabot.yml to increase GHA update frequency (53b72a1)

• Update deps (#152, c4b0050)

dependabot does not yet support new pyproject.toml format

• ci: Bump the github-actions group across 1 directory with 8 updates (#150, 1f67cb0)

• chore(ci): bump the github-actions group across 1 directory with 8 updates

Bumps the github-actions group with 8 updates in the / directory:

| Package | From | To | | --- | --- | --- | | actions/checkout | 3 | 4 | | actions/setup-python | 3 | 5 | | pre-commit/action | 2.0.3 | 3.0.1 | | wagoid/commitlint-github-action | 4.1.11 | 6.2.1 | | codecov/codecov-action | 3 | 5 | | python-semantic-release/python-semantic-release | 7.34.6 | 9.21.0 | | browniebroke/hacktoberfest-labeler-action | 2.2.0 | 2.3.0 | | tiangolo/issue-manager | 0.4.0 | 0.5.1 |

Updates actions/checkout from 3 to 4 - Release notes - Changelog - Commits

Updates actions/setup-python from 3 to 5 - Release notes - Commits

Updates pre-commit/action from 2.0.3 to 3.0.1 - Release notes - Commits

Updates wagoid/commitlint-github-action from 4.1.11 to 6.2.1 - Changelog - Commits

Updates codecov/codecov-action from 3 to 5 - Release notes - Changelog - Commits

Updates python-semantic-release/python-semantic-release from 7.34.6 to 9.21.0 - Release notes - Changelog - Commits

Updates browniebroke/hacktoberfest-labeler-action from 2.2.0 to 2.3.0 - Release notes - Changelog - Commits

Updates tiangolo/issue-manager from 0.4.0 to 0.5.1 - Release notes - Commits

--- updated-dependencies: - dependency-name: actions/checkout dependency-type: direct:production

update-type: version-update:semver-major

dependency-group: github-actions

• dependency-name: actions/setup-python dependency-type: direct:production

• dependency-name: pre-commit/action dependency-type: direct:production

• dependency-name: wagoid/commitlint-github-action dependency-type: direct:production

• dependency-name: codecov/codecov-action dependency-type: direct:production

• dependency-name: python-semantic-release/python-semantic-release dependency-type: direct:production

• dependency-name: browniebroke/hacktoberfest-labeler-action dependency-type: direct:production

update-type: version-update:semver-minor

• dependency-name: tiangolo/issue-manager dependency-type: direct:production

dependency-group: github-actions ...

Signed-off-by: dependabot[bot] support@github.com

• chore: update pyproject

• chore: adjust actions

---

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Co-authored-by: J. Nick Koston nick@koston.org

• pre-commit.ci: Pre-commit autoupdate (#149, b71c2d6)

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

• pre-commit.ci: Pre-commit autoupdate (#151, ace8adf)

updates:

• github.com/commitizen-tools/commitizen: v4.2.2 → v4.4.1
• github.com/PyCQA/isort: 6.0.0 → 6.0.1
• github.com/PyCQA/flake8: 7.1.2 → 7.2.0

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Features

• Switch to trusted publishing (#153, 4b8510c)

---

Detailed Changes: v3.9.0...v3.10.0

Feature

• Add internal stop_discovery method for habluetooth (#148) (ae9feac)

Fix

• Update poetry to v2 (#144) (9b45308)

Feature

• Add method to fetch current allocations (#138) (4dc325b)

Feature

• Add support for getting callbacks on slot allocation change (#133) (ae21ecb)

Feature

• Add support for Python 3.13 (#119) (f2c3fa5)

Feature

• Add device path to the disconnect debug logging (#111) (8e010b3)

Feature

• Add close_stale_connections_by_address (#110) (74de12f)

Feature

• Handle services changed during connecting (#108) (1c65413)

Fix

• Correct fetching the global bluez manager when its not running (#106) (38c63a9)

Feature

• Remove devices on cache clear to cleanup disk cache (#103) (349e0de)

Yanked

• This release was yanked because there was a significant bug fetching the bluez global manager when not running under Home Assistant which is fixed in 3.2.1

Fix

• Ensure timeouts work with py3.11 (#102) (4951aef)

Fix

• Increase bleak safety timeout to allow for longer disconnect timeout (#101) (39380a7)

Requirements change

• bleak>=0.21.0 is required to support the longer timeout since it has a fix for BlueZ connection attempts hanging

Fix

• Check more often for a device to reappear after the adapter runs out of slots (#100) (4c9c9c0)

Feature

• Decrease backoff times (#97) (37b71c8)
• Update the out of slots message to be more clear (#95) (9269a82)

Fix

• Bluez services cache clear was ineffective (#93) (ec86cb6)

Fix

• Update for bleak 0.20.0 (#92) (78f9a1e)

Fix

• Bump python-semantic-release (#90) (c401988)
• Lint (#89) (c3b5ff8)
• Typing for generic BleakClient classes and the retry_bluetooth_connection_error decorator (#86) (8ddf242)

Breaking

• In preparation for the use of Python 3.10 typing features such as ParamSpec, which is unavailable on Python 3.9. (58f9958)

Fix

• Make bluetooth-adapters install Linux only as well (#85) (910f0b7)
• Only import from bluetooth_adapters when running on linux (#84) (51926f7)

Feature

• Remove freshen fallback logic since Home Assistant always provides us the best path to the device now (#83) (0954d2d)

Fix

• _on_characteristic_value_changed in BleakSlotManager should accept any arguments (#82) (71cc37e)

Feature

• Add utility function to get device_source (#81) (d72ce15)

Feature

• Add connection slot manager (#80) (d8bb8d9)

Fix

• Stop trying to get devices from bluez if dbus setup times out (#78) (a8da722)

Fix

• Optimize IS_LINUX check in restore_discoveries (#77) (f22eb33)

Feature

• Add restore_discoveries to fix missing devices (#76) (f4432ac)

Feature

• Add function to clear the cache (#75) (6ca6011)

Fix

• Always log the connection attempt number (#74) (3306053)

Fix

• Avoid logging connecting and connected since our BLEDevice may be stale (#72) (10e040c)

Fix

• Enable service cache by default since esp32s are unreliable without it (#71) (0e90c1c)

Fix

• Stop trying to check dbus once the socket is missing (#70) (74bd63b)

Fix

• Teach the connector about more esp32 errors and times (#68) (09cb73d)

Fix

• Increase backoff when local ble adapter runs out of connection slots (#67) (cac7e57)

Fix

• Adjust connect timeout to match macos write timeout (#66) (1396fdc)

Fix

• Adjust backoffs for slower esp32 proxies (#64) (702a829)

Fix

• Reduce logging as timeouts are expected (#63) (8b91838)

Feature

• Mark ESP_GATT_ERROR as a transient error (#62) (6d76ac4)

Feature

• Log the adapter when connecting (#61) (ab873c8)

Feature

• Teach the connector about transient esp32 errors (#60) (486fbbc)

Feature

• Increase timeouts now that bleak has resolved the timeout with service discovery and bluez (#59) (2a65e27)

Fix

• Missing backoff execution with esp32 (#58) (3229424)

Fix

• Ensure we back off for longer when out of slots (#57) (efeced3)