pax_global_header 0000666 0000000 0000000 00000000064 14750422166 0014521 g ustar 00root root 0000000 0000000 52 comment=641fbb29022e4aacc243eaf6cf08ff0274b194f6
bleak-retry-connector-3.8.1/ 0000775 0000000 0000000 00000000000 14750422166 0015743 5 ustar 00root root 0000000 0000000 bleak-retry-connector-3.8.1/.all-contributorsrc 0000664 0000000 0000000 00000000474 14750422166 0021601 0 ustar 00root root 0000000 0000000 {
"projectName": "bleak-retry-connector",
"projectOwner": "bluetooth-devices",
"repoType": "github",
"repoHost": "https://github.com",
"files": [
"README.md"
],
"imageSize": 80,
"commit": true,
"commitConvention": "angular",
"contributors": [],
"contributorsPerLine": 7,
"skipCi": true
}
bleak-retry-connector-3.8.1/.editorconfig 0000664 0000000 0000000 00000000444 14750422166 0020422 0 ustar 00root root 0000000 0000000 # http://editorconfig.org
root = true
[*]
indent_style = space
indent_size = 4
trim_trailing_whitespace = true
insert_final_newline = true
charset = utf-8
end_of_line = lf
[*.bat]
indent_style = tab
end_of_line = crlf
[LICENSE]
insert_final_newline = false
[Makefile]
indent_style = tab
bleak-retry-connector-3.8.1/.flake8 0000664 0000000 0000000 00000000056 14750422166 0017117 0 ustar 00root root 0000000 0000000 [flake8]
exclude = docs
max-line-length = 120
bleak-retry-connector-3.8.1/.github/ 0000775 0000000 0000000 00000000000 14750422166 0017303 5 ustar 00root root 0000000 0000000 bleak-retry-connector-3.8.1/.github/ISSUE_TEMPLATE/ 0000775 0000000 0000000 00000000000 14750422166 0021466 5 ustar 00root root 0000000 0000000 bleak-retry-connector-3.8.1/.github/ISSUE_TEMPLATE/1-bug_report.md 0000664 0000000 0000000 00000000422 14750422166 0024314 0 ustar 00root root 0000000 0000000 ---
name: Bug report
about: Create a report to help us improve
labels: bug
---
**Describe the bug**
A clear and concise description of what the bug is.
**To Reproduce**
Steps to reproduce the behavior:
**Additional context**
Add any other context about the problem here.
bleak-retry-connector-3.8.1/.github/ISSUE_TEMPLATE/2-feature-request.md 0000664 0000000 0000000 00000000672 14750422166 0025275 0 ustar 00root root 0000000 0000000 ---
name: Feature request
about: Suggest an idea for this project
labels: enhancement
---
**Is your feature request related to a problem? Please describe.**
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
**Describe the solution you'd like**
A clear and concise description of what you want to happen.
**Additional context**
Add any other context or screenshots about the feature request here.
bleak-retry-connector-3.8.1/.github/dependabot.yml 0000664 0000000 0000000 00000001015 14750422166 0022130 0 ustar 00root root 0000000 0000000 # To get started with Dependabot version updates, you'll need to specify which
# package ecosystems to update and where the package manifests are located.
# Please see the documentation for all configuration options:
# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
version: 2
updates:
- package-ecosystem: "pip" # See documentation for possible values
directory: "/" # Location of package manifests
schedule:
interval: "weekly"
bleak-retry-connector-3.8.1/.github/labels.toml 0000664 0000000 0000000 00000003515 14750422166 0021446 0 ustar 00root root 0000000 0000000 [breaking]
color = "ffcc00"
name = "breaking"
description = "Breaking change."
[bug]
color = "d73a4a"
name = "bug"
description = "Something isn't working"
[dependencies]
color = "0366d6"
name = "dependencies"
description = "Pull requests that update a dependency file"
[github_actions]
color = "000000"
name = "github_actions"
description = "Update of github actions"
[documentation]
color = "1bc4a5"
name = "documentation"
description = "Improvements or additions to documentation"
[duplicate]
color = "cfd3d7"
name = "duplicate"
description = "This issue or pull request already exists"
[enhancement]
color = "a2eeef"
name = "enhancement"
description = "New feature or request"
["good first issue"]
color = "7057ff"
name = "good first issue"
description = "Good for newcomers"
["help wanted"]
color = "008672"
name = "help wanted"
description = "Extra attention is needed"
[invalid]
color = "e4e669"
name = "invalid"
description = "This doesn't seem right"
[nochangelog]
color = "555555"
name = "nochangelog"
description = "Exclude pull requests from changelog"
[question]
color = "d876e3"
name = "question"
description = "Further information is requested"
[removed]
color = "e99695"
name = "removed"
description = "Removed piece of functionalities."
[tests]
color = "bfd4f2"
name = "tests"
description = "CI, CD and testing related changes"
[wontfix]
color = "ffffff"
name = "wontfix"
description = "This will not be worked on"
[discussion]
color = "c2e0c6"
name = "discussion"
description = "Some discussion around the project"
[hacktoberfest]
color = "ffa663"
name = "hacktoberfest"
description = "Good issues for Hacktoberfest"
[answered]
color = "0ee2b6"
name = "answered"
description = "Automatically closes as answered after a delay"
[waiting]
color = "5f7972"
name = "waiting"
description = "Automatically closes if no answer after a delay"
bleak-retry-connector-3.8.1/.github/workflows/ 0000775 0000000 0000000 00000000000 14750422166 0021340 5 ustar 00root root 0000000 0000000 bleak-retry-connector-3.8.1/.github/workflows/ci.yml 0000664 0000000 0000000 00000004017 14750422166 0022460 0 ustar 00root root 0000000 0000000 name: CI
on:
push:
branches:
- main
pull_request:
concurrency:
group: ${{ github.head_ref || github.run_id }}
cancel-in-progress: true
jobs:
lint:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: actions/setup-python@v3
with:
python-version: "3.11"
- uses: pre-commit/action@v2.0.3
# Make sure commit messages follow the conventional commits convention:
# https://www.conventionalcommits.org
commitlint:
name: Lint Commit Messages
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
with:
fetch-depth: 0
- uses: wagoid/commitlint-github-action@v4.1.11
test:
strategy:
fail-fast: false
matrix:
python-version:
- "3.10"
- "3.11"
- "3.12"
- "3.13"
os:
- ubuntu-latest
runs-on: ${{ matrix.os }}
steps:
- uses: actions/checkout@v3
- name: Set up Python
uses: actions/setup-python@v3
with:
python-version: ${{ matrix.python-version }}
- uses: snok/install-poetry@v1
- name: Install Dependencies
run: poetry install
- name: Test with Pytest
run: poetry run pytest --cov-report=xml
- name: Upload coverage to Codecov
uses: codecov/codecov-action@v3
with:
token: ${{ secrets.CODECOV_TOKEN }}
release:
runs-on: ubuntu-latest
environment: release
if: github.ref == 'refs/heads/main'
needs:
- test
- lint
- commitlint
steps:
- uses: actions/checkout@v3
with:
fetch-depth: 0
# Run semantic release:
# - Update CHANGELOG.md
# - Update version in code
# - Create git tag
# - Create GitHub release
# - Publish to PyPI
- name: Python Semantic Release
uses: python-semantic-release/python-semantic-release@v7.34.6
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
pypi_token: ${{ secrets.PYPI_TOKEN }}
bleak-retry-connector-3.8.1/.github/workflows/hacktoberfest.yml 0000664 0000000 0000000 00000000534 14750422166 0024711 0 ustar 00root root 0000000 0000000 name: Hacktoberfest
on:
schedule:
# Run every day in October
- cron: "0 0 * 10 *"
# Run on the 1st of November to revert
- cron: "0 13 1 11 *"
jobs:
hacktoberfest:
runs-on: ubuntu-latest
steps:
- uses: browniebroke/hacktoberfest-labeler-action@v2.2.0
with:
github_token: ${{ secrets.GH_PAT }}
bleak-retry-connector-3.8.1/.github/workflows/issue-manager.yml 0000664 0000000 0000000 00000001340 14750422166 0024621 0 ustar 00root root 0000000 0000000 name: Issue Manager
on:
schedule:
- cron: "0 0 * * *"
issue_comment:
types:
- created
issues:
types:
- labeled
pull_request_target:
types:
- labeled
workflow_dispatch:
jobs:
issue-manager:
runs-on: ubuntu-latest
steps:
- uses: tiangolo/issue-manager@0.4.0
with:
token: ${{ secrets.GITHUB_TOKEN }}
config: >
{
"answered": {
"message": "Assuming the original issue was solved, it will be automatically closed now."
},
"waiting": {
"message": "Automatically closing. To re-open, please provide the additional information requested."
}
}
bleak-retry-connector-3.8.1/.github/workflows/labels.yml 0000664 0000000 0000000 00000000775 14750422166 0023336 0 ustar 00root root 0000000 0000000 name: Sync Github labels
on:
push:
branches:
- main
paths:
- ".github/**"
jobs:
labels:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Set up Python
uses: actions/setup-python@v3
with:
python-version: 3.11
- name: Install labels
run: pip install labels
- name: Sync config with Github
run: labels -u ${{ github.repository_owner }} -t ${{ secrets.GITHUB_TOKEN }} sync -f .github/labels.toml
bleak-retry-connector-3.8.1/.gitignore 0000664 0000000 0000000 00000004066 14750422166 0017741 0 ustar 00root root 0000000 0000000 # Created by .ignore support plugin (hsz.mobi)
### Python template
# Byte-compiled / optimized / DLL files
__pycache__/
*.py[cod]
*$py.class
# C extensions
*.so
# Distribution / packaging
.Python
build/
develop-eggs/
dist/
downloads/
eggs/
.eggs/
lib/
lib64/
parts/
sdist/
var/
wheels/
share/python-wheels/
*.egg-info/
.installed.cfg
*.egg
MANIFEST
# PyInstaller
# Usually these files are written by a python script from a template
# before PyInstaller builds the exe, so as to inject date/other infos into it.
*.manifest
*.spec
# Installer logs
pip-log.txt
pip-delete-this-directory.txt
# Unit test / coverage reports
htmlcov/
.tox/
.nox/
.coverage
.coverage.*
.cache
nosetests.xml
coverage.xml
*.cover
*.py,cover
.hypothesis/
.pytest_cache/
cover/
# Translations
*.mo
*.pot
# Django stuff:
*.log
local_settings.py
db.sqlite3
db.sqlite3-journal
# Flask stuff:
instance/
.webassets-cache
# Scrapy stuff:
.scrapy
# Sphinx documentation
docs/_build/
# PyBuilder
.pybuilder/
target/
# Jupyter Notebook
.ipynb_checkpoints
# IPython
profile_default/
ipython_config.py
# pyenv
# For a library or package, you might want to ignore these files since the code is
# intended to run in multiple environments; otherwise, check them in:
# .python-version
# pipenv
# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
# However, in case of collaboration, if having platform-specific dependencies or dependencies
# having no cross-platform support, pipenv may install dependencies that don't work, or not
# install all needed dependencies.
#Pipfile.lock
# PEP 582; used by e.g. github.com/David-OConnor/pyflow
__pypackages__/
# Celery stuff
celerybeat-schedule
celerybeat.pid
# SageMath parsed files
*.sage.py
# Environments
.env
.venv
env/
venv/
ENV/
env.bak/
venv.bak/
# Spyder project settings
.spyderproject
.spyproject
# Rope project settings
.ropeproject
# mkdocs documentation
/site
# mypy
.mypy_cache/
.dmypy.json
dmypy.json
# Pyre type checker
.pyre/
# pytype static type analyzer
.pytype/
# Cython debug symbols
cython_debug/
bleak-retry-connector-3.8.1/.gitpod.yml 0000664 0000000 0000000 00000000306 14750422166 0020031 0 ustar 00root root 0000000 0000000 tasks:
- command: |
pip install poetry
PIP_USER=false poetry install
- command: |
pip install pre-commit
pre-commit install
PIP_USER=false pre-commit install-hooks
bleak-retry-connector-3.8.1/.idea/ 0000775 0000000 0000000 00000000000 14750422166 0016723 5 ustar 00root root 0000000 0000000 bleak-retry-connector-3.8.1/.idea/bleak-retry-connector.iml 0000664 0000000 0000000 00000000515 14750422166 0023640 0 ustar 00root root 0000000 0000000
bleak-retry-connector-3.8.1/.idea/watcherTasks.xml 0000664 0000000 0000000 00000005253 14750422166 0022115 0 ustar 00root root 0000000 0000000
bleak-retry-connector-3.8.1/.idea/workspace.xml 0000664 0000000 0000000 00000002741 14750422166 0021447 0 ustar 00root root 0000000 0000000
bleak-retry-connector-3.8.1/.pre-commit-config.yaml 0000664 0000000 0000000 00000003416 14750422166 0022230 0 ustar 00root root 0000000 0000000 # See https://pre-commit.com for more information
# See https://pre-commit.com/hooks.html for more hooks
exclude: "CHANGELOG.md"
default_stages: [pre-commit]
ci:
autofix_commit_msg: "chore(pre-commit.ci): auto fixes"
autoupdate_commit_msg: "chore(pre-commit.ci): pre-commit autoupdate"
repos:
- repo: https://github.com/commitizen-tools/commitizen
rev: v4.1.1
hooks:
- id: commitizen
stages: [commit-msg]
- repo: https://github.com/pre-commit/pre-commit-hooks
rev: v5.0.0
hooks:
- id: debug-statements
- id: check-builtin-literals
- id: check-case-conflict
- id: check-docstring-first
- id: check-json
- id: check-toml
- id: check-xml
- id: check-yaml
- id: detect-private-key
- id: end-of-file-fixer
- id: trailing-whitespace
- id: debug-statements
- repo: https://github.com/pre-commit/mirrors-prettier
rev: v4.0.0-alpha.8
hooks:
- id: prettier
args: ["--tab-width", "2"]
additional_dependencies:
- prettier@2.8.4
- repo: https://github.com/asottile/pyupgrade
rev: v3.19.1
hooks:
- id: pyupgrade
args: [--py310-plus]
- repo: https://github.com/PyCQA/isort
rev: 6.0.0
hooks:
- id: isort
- repo: https://github.com/psf/black
rev: 25.1.0
hooks:
- id: black
- repo: https://github.com/codespell-project/codespell
rev: v2.4.1
hooks:
- id: codespell
- repo: https://github.com/PyCQA/flake8
rev: 7.1.1
hooks:
- id: flake8
- repo: https://github.com/pre-commit/mirrors-mypy
rev: v1.14.1
hooks:
- id: mypy
additional_dependencies: []
- repo: https://github.com/PyCQA/bandit
rev: 1.8.2
hooks:
- id: bandit
args: [-x, tests]
bleak-retry-connector-3.8.1/.readthedocs.yml 0000664 0000000 0000000 00000001005 14750422166 0021025 0 ustar 00root root 0000000 0000000 # Read the Docs configuration file
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
# Required
version: 2
# Build documentation in the docs/ directory with Sphinx
sphinx:
configuration: docs/source/conf.py
# Set the version of Python and other tools you might need
build:
os: ubuntu-22.04
tools:
python: "3.11"
# Optionally declare the Python requirements required to build your docs
python:
install:
- method: pip
path: .
extra_requirements:
- docs
bleak-retry-connector-3.8.1/CHANGELOG.md 0000664 0000000 0000000 00000061377 14750422166 0017572 0 ustar 00root root 0000000 0000000 # Changelog
## v3.8.1 (2025-02-04)
### Fix
* Update poetry to v2 ([#144](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/144)) ([`9b45308`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/9b45308e6055c4a42c50228b2e21b20e2adfd604))
## v3.8.0 (2025-01-21)
### Feature
* Add method to fetch current allocations ([#138](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/138)) ([`4dc325b`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/4dc325b4db5afc613064ba1257987a4a0e00fa7e))
## v3.7.0 (2025-01-18)
### Feature
* Add support for getting callbacks on slot allocation change ([#133](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/133)) ([`ae21ecb`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/ae21ecb8524555dceafbbe47fb5d3b62efd51f1a))
## v3.6.0 (2024-10-05)
### Feature
* Add support for Python 3.13 ([#119](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/119)) ([`f2c3fa5`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/f2c3fa58217d4133b83aafd5ea885edc9e78ae85))
## v3.5.0 (2024-04-10)
### Feature
* Add device path to the disconnect debug logging ([#111](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/111)) ([`8e010b3`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/8e010b3f3754b156e68699f5727be77d4f8412a3))
## v3.4.0 (2024-01-01)
### Feature
* Add close_stale_connections_by_address ([#110](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/110)) ([`74de12f`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/74de12fb5a9269bce677cb76ae0f05daf1af343a))
## v3.3.0 (2023-10-25)
### Feature
* Handle services changed during connecting ([#108](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/108)) ([`1c65413`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/1c65413cad1e6c42d6bf2c0a8cdec82d9d9a7484))
## v3.2.1 (2023-09-14)
### Fix
* Correct fetching the global bluez manager when its not running ([#106](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/106)) ([`38c63a9`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/38c63a974dd05f7a1e42d647e3ca13884e9b4e62))
## v3.2.0 (2023-09-14)
### Feature
* Remove devices on cache clear to cleanup disk cache ([#103](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/103)) ([`349e0de`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/349e0deeb2bee443e82d23b816bbd7036a476718))
## v3.1.3 (2023-09-07)
### Fix
* Ensure timeouts work with py3.11 ([#102](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/102)) ([`4951aef`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/4951aefd9de0e22235dbbd64a15357e67f496d87))
## v3.1.2 (2023-09-03)
### Fix
* Increase bleak safety timeout to allow for longer disconnect timeout ([#101](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/101)) ([`39380a7`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/39380a744b9aed832b51ad20671af86b99186560))
## v3.1.1 (2023-07-25)
### Fix
* Check more often for a device to reappear after the adapter runs out of slots ([#100](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/100)) ([`4c9c9c0`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/4c9c9c0670c79d9425e26b761a20d588dd259a26))
## v3.1.0 (2023-07-19)
### Feature
* Decrease backoff times ([#97](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/97)) ([`37b71c8`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/37b71c8bf1bd456de3d44ca4f7845de07c853bbc))
* Update the out of slots message to be more clear ([#95](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/95)) ([`9269a82`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/9269a82f5f1c88c382856c88e98102d1b83dc436))
## v3.0.2 (2023-03-25)
### Fix
* Bluez services cache clear was ineffective ([#93](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/93)) ([`ec86cb6`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/ec86cb6788ba075920867b5cb06d1f5fa49d18ae))
## v3.0.1 (2023-03-18)
### Fix
* Update for bleak 0.20.0 ([#92](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/92)) ([`78f9a1e`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/78f9a1e81768ee9543595a6c8673c8c635f63244))
## v3.0.0 (2023-02-25)
### Fix
* Bump python-semantic-release ([#90](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/90)) ([`c401988`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/c4019883c9bad3f91a20029e8adf35962a59a488))
* Lint ([#89](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/89)) ([`c3b5ff8`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/c3b5ff8870b8a5c6cb7972d9e1a0ca677cc0c78d))
* Typing for generic BleakClient classes and the retry_bluetooth_connection_error decorator ([#86](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/86)) ([`8ddf242`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/8ddf2426ff2fc5274dc2e8a905233a2c30f57fbb))
### Breaking
* In preparation for the use of Python 3.10 typing features such as ParamSpec, which is unavailable on Python 3.9. ([`58f9958`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/58f9958785b40d2fbade39ef7f56dab931f888a6))
## v2.13.1 (2023-01-12)
### Fix
* Make bluetooth-adapters install Linux only as well ([#85](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/85)) ([`910f0b7`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/910f0b7147c31d1133bc5d308d134a72e47c3ff5))
* Only import from bluetooth_adapters when running on linux ([#84](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/84)) ([`51926f7`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/51926f7a679437df875f7cb5b6e53253ae10f0b6))
## v2.13.0 (2022-12-23)
### Feature
* Remove freshen fallback logic since Home Assistant always provides us the best path to the device now ([#83](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/83)) ([`0954d2d`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/0954d2dfc7ff06f3b7445140c644aeaf7ea36384))
## v2.12.1 (2022-12-22)
### Fix
* _on_characteristic_value_changed in BleakSlotManager should accept any arguments ([#82](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/82)) ([`71cc37e`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/71cc37ef6b0b7492fb58aaeb9115737e95bd9f0e))
## v2.12.0 (2022-12-22)
### Feature
* Add utility function to get device_source ([#81](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/81)) ([`d72ce15`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/d72ce150edba658b4d4edb43f3bbd158cba9988f))
## v2.11.0 (2022-12-22)
### Feature
* Add connection slot manager ([#80](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/80)) ([`d8bb8d9`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/d8bb8d96fb019152fb97e4006a8e6a1d11213a7d))
## v2.10.2 (2022-12-12)
### Fix
* Stop trying to get devices from bluez if dbus setup times out ([#78](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/78)) ([`a8da722`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/a8da7222d6d7ab725152141f560dc1bb681bf4cf))
## v2.10.1 (2022-12-05)
### Fix
* Optimize IS_LINUX check in restore_discoveries ([#77](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/77)) ([`f22eb33`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/f22eb33e1d29d5a6ca8697061de9fbb1bf583bec))
## v2.10.0 (2022-12-05)
### Feature
* Add restore_discoveries to fix missing devices ([#76](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/76)) ([`f4432ac`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/f4432ac086abc0e847ac12818fa22cfaa04a3521))
## v2.9.0 (2022-12-03)
### Feature
* Add function to clear the cache ([#75](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/75)) ([`6ca6011`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/6ca601104cd13cefa9c2d6db05cdc019aaf18329))
## v2.8.9 (2022-12-02)
### Fix
* Always log the connection attempt number ([#74](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/74)) ([`3306053`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/3306053a3903efa565355e2331b31db739bac094))
## v2.8.8 (2022-12-02)
### Fix
* Avoid logging connecting and connected since our BLEDevice may be stale ([#72](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/72)) ([`10e040c`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/10e040c9eb563d31b3e0caf41ee390234e239c4f))
## v2.8.7 (2022-12-02)
### Fix
* Enable service cache by default since esp32s are unreliable without it ([#71](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/71)) ([`0e90c1c`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/0e90c1c79fac01e5e0a39c51b733616d1d324aeb))
## v2.8.6 (2022-11-30)
### Fix
* Stop trying to check dbus once the socket is missing ([#70](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/70)) ([`74bd63b`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/74bd63b5b5c68eca6e7f0fa4e932a3ebab26a59e))
## v2.8.5 (2022-11-19)
### Fix
* Teach the connector about more esp32 errors and times ([#68](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/68)) ([`09cb73d`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/09cb73df4d6908665220df74f91aee4d200f6bad))
## v2.8.4 (2022-11-11)
### Fix
* Increase backoff when local ble adapter runs out of connection slots ([#67](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/67)) ([`cac7e57`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/cac7e57fbb13ee7beaa1eb18d51def661bc92ee3))
## v2.8.3 (2022-11-06)
### Fix
* Adjust connect timeout to match macos write timeout ([#66](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/66)) ([`1396fdc`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/1396fdc0b3235cf67ae919bf1c2a308d4437d023))
## v2.8.2 (2022-11-01)
### Fix
* Adjust backoffs for slower esp32 proxies ([#64](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/64)) ([`702a829`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/702a82921ad30fb4934b5056271cea842a758c08))
## v2.8.1 (2022-10-31)
### Fix
* Reduce logging as timeouts are expected ([#63](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/63)) ([`8b91838`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/8b918380d4772544e4471456df459f5d6d457a61))
## v2.8.0 (2022-10-31)
### Feature
* Mark ESP_GATT_ERROR as a transient error ([#62](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/62)) ([`6d76ac4`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/6d76ac433c0d4727c12c4f7b4de0b039e7bbc4c2))
## v2.7.0 (2022-10-30)
### Feature
* Log the adapter when connecting ([#61](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/61)) ([`ab873c8`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/ab873c83da6dd37cd4da3e4e61c3f6fc1ffa0c9f))
## v2.6.0 (2022-10-30)
### Feature
* Teach the connector about transient esp32 errors ([#60](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/60)) ([`486fbbc`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/486fbbc13b9665fcdacf79f7240240602c8f477a))
## v2.5.0 (2022-10-29)
### Feature
* Increase timeouts now that bleak has resolved the timeout with service discovery and bluez ([#59](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/59)) ([`2a65e27`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/2a65e276ffe3ab598eb8f6eb3cf3bcf7a5269780))
## v2.4.2 (2022-10-24)
### Fix
* Missing backoff execution with esp32 ([#58](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/58)) ([`3229424`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/3229424cae6dc7a9052efe080e110327eaa60f4d))
## v2.4.1 (2022-10-24)
### Fix
* Ensure we back off for longer when out of slots ([#57](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/57)) ([`efeced3`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/efeced3fa36fad7d0659e3ed30a7a150370dc923))
## v2.4.0 (2022-10-24)
### Feature
* Improve handling of out of esp32 proxy connection slots ([#56](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/56)) ([`982b7ae`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/982b7ae1cc12d50a899329466fd4b760aaaec5ca))
## v2.3.2 (2022-10-22)
### Fix
* Ensure client is returned when debug is off ([#55](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/55)) ([`7ddcac8`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/7ddcac8f14126817cb5df4e7773739c6656dcd24))
## v2.3.1 (2022-10-18)
### Fix
* Do not attempt to disconnect non-bluez bledevices ([#54](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/54)) ([`54b6c84`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/54b6c8446629a216eeaf570f1677b67b38b6f081))
## v2.3.0 (2022-10-15)
### Feature
* Add a retry_bluetooth_connection_error decorator ([#53](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/53)) ([`8bb706d`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/8bb706d09fa2cdaa3e2a3caf830dc92b26add4cc))
## v2.2.0 (2022-10-15)
### Feature
* Update for new bleak 19 ([#52](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/52)) ([`9baafa5`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/9baafa5cbffa9fcd8ee8bd3040014c0d06a2085c))
## v2.1.3 (2022-09-26)
### Fix
* Bump dbus-fast ([#51](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/51)) ([`68167a3`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/68167a3eee222c3b0c241616c302aacacb8a3cdd))
## v2.1.2 (2022-09-26)
### Fix
* Adjust stale comment in freshen_ble_device ([#50](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/50)) ([`6cabc1f`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/6cabc1f557629c7591cb1cef482ae5d9791349b5))
## v2.1.1 (2022-09-26)
### Fix
* Set disconnected_callback in the constructor for newer bleak compat ([#49](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/49)) ([`e2e25b3`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/e2e25b3d6077aac7c766ecb844b0b492e66efff1))
## v2.1.0 (2022-09-26)
### Feature
* Add get_device_by_adapter api ([#48](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/48)) ([`238b1f0`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/238b1f09b07e4e65dbf79472adbe9f7932f553fc))
## v2.0.2 (2022-09-25)
### Fix
* Republish to fix python-semantic-release detecting the wrong version ([#47](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/47)) ([`65f3cf2`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/65f3cf23dc2eab0f666dd45bd7b82058d32e2ba2))
## v1.17.3 (2022-09-24)
### Fix
* Log message when freshen fails ([#44](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/44)) ([`8365937`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/83659374d661c67b81ba204bda9d0f8bf886adf1))
## v1.17.2 (2022-09-23)
### Fix
* Add a guard to freshen_ble_device so it can be called on non-linux ([#43](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/43)) ([`4558a67`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/4558a67d4a291f6986dbc7d80fc1cfb2c9f4b4da))
## v1.17.1 (2022-09-15)
### Fix
* Adjust backoff times to reduce race risk ([#40](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/40)) ([`786b442`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/786b442c5e0102b6693cf98f86770a6ad80e4157))
## v1.17.0 (2022-09-15)
### Feature
* Provide a BLEAK_RETRY_EXCEPTIONS constant ([#39](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/39)) ([`55dc2e1`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/55dc2e141d9059ed544ab4f0d333d09c97f6fab0))
## v1.16.0 (2022-09-14)
### Feature
* Do not disconnect unexpectedly connected devices if bleak supports reusing them ([#35](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/35)) ([`be603ce`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/be603ce379f6a46ee750e7c3bcbd79d533d2a3ff))
## v1.15.1 (2022-09-13)
### Fix
* Revert requirement for newer bleak ([#34](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/34)) ([`fe7ec26`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/fe7ec26a7479855e6c37dd4f9b5ac86c93d8d1b8))
## v1.15.0 (2022-09-12)
### Feature
* Bleak 0.17 support ([#33](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/33)) ([`ffce2c5`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/ffce2c51d3acddfa1efa9e2a396956521a768dd1))
## v1.14.0 (2022-09-11)
### Feature
* Implement a smarter backoff ([#32](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/32)) ([`8272daa`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/8272daa12d3553001b53f637407a720ab209a57f))
## v1.13.2 (2022-09-11)
### Fix
* Race during disconnect when unexpectedly connected ([#30](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/30)) ([`2ceef9f`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/2ceef9f49cedb3f2721f5d969b4117fe2cb2de7c))
## v1.13.1 (2022-09-11)
### Fix
* Disconnect unexpectedly connected devices on other adapters ([#29](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/29)) ([`85a3efe`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/85a3efe1589dc48eb009da7c3aaa69d7decfe26d))
## v1.13.0 (2022-09-10)
### Feature
* Make get_device and close_stale_connections part of __all__ ([#27](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/27)) ([`4d7edfd`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/4d7edfd2f2597e8cba96c925a1e7f4ae55986623))
## v1.12.3 (2022-09-10)
### Fix
* Disconnect devices that are unexpectedly connected before connecting ([#26](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/26)) ([`47b31d3`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/47b31d38b481288472a6923d968a9c4dd6f2b1c6))
## v1.12.2 (2022-09-10)
### Fix
* Handle already connected devices with no rssi value ([#25](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/25)) ([`0dfd3b0`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/0dfd3b07ae6836a61d31c613534e3322dabd3761))
## v1.12.1 (2022-09-10)
### Fix
* Get_device returning no device when already connected ([#24](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/24)) ([`1063b76`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/1063b764959cabfdab572de85d1ad622e6ff7a20))
## v1.12.0 (2022-09-10)
### Feature
* Add get_device helper to find already connected devices ([#23](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/23)) ([`595e6a0`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/595e6a09c06a29a55000e6b582db12b85884f75a))
## v1.11.1 (2022-09-10)
### Fix
* Handle Dbus EOFError while connecting ([#22](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/22)) ([`b0bc92d`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/b0bc92d00b77f570836fa59f4f88403152f78539))
## v1.11.0 (2022-08-20)
### Feature
* Handle stale BLEDevices when an adapter goes offline ([#21](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/21)) ([`012c94c`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/012c94c17e81511f84764037a48be1ba686453b3))
## v1.10.1 (2022-08-19)
### Fix
* Add workaround for when get_services raises ([#20](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/20)) ([`1c92f6e`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/1c92f6ed3b643f8f739e7a27b56111cd71e23696))
## v1.10.0 (2022-08-19)
### Feature
* Log path to the device ([#19](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/19)) ([`6a9f293`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/6a9f2930e06ee393f0b3885c3d845d485c18babd))
## v1.9.0 (2022-08-19)
### Feature
* Add ble_device_callback to get a new BLEDevice between connect attempts ([#18](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/18)) ([`450268b`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/450268b8498f730576957f0dbb1cbe0dedbdf14a))
## v1.8.0 (2022-08-15)
### Feature
* Add last known rssi to the debug log ([#17](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/17)) ([`1032317`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/10323172a1faacca01e6bfb690e92b9e5fb1bd80))
## v1.7.2 (2022-08-12)
### Fix
* Handle device going in and out of range frequently ([#16](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/16)) ([`89b8c1b`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/89b8c1ba63151043d0d6977b0c4a173cb616a9a5))
## v1.7.1 (2022-08-12)
### Fix
* Race during disconnect error ([#14](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/14)) ([`dccbbb1`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/dccbbb1e34028dbd3e3b155502bb70d1ffaa11a8))
## v1.7.0 (2022-08-11)
### Feature
* Add ble_device_has_changed helper ([#13](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/13)) ([`0a23bb8`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/0a23bb8bbd2c8d0fafc20f3d2da36415ed4759be))
## v1.6.0 (2022-08-11)
### Feature
* Cached services ([#11](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/11)) ([`1fe23d6`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/1fe23d6397a7ac2b5994778a9ddc06e687de5ba3))
## v1.5.0 (2022-08-08)
### Feature
* Rethrow UnknownObject as BleakNotFoundError ([#12](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/12)) ([`a07c50e`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/a07c50e8a910aadc6cec806c0e8888a00def97f6))
## v1.4.0 (2022-08-05)
### Feature
* Improve error reporting when there is a poor connection ([#10](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/10)) ([`d022777`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/d0227773ff01b4d665fd7bd3e94a330d61214f88))
## v1.3.0 (2022-08-04)
### Feature
* Improve chance of connecting with poor signal ([#9](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/9)) ([`f0322e7`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/f0322e73d450eaf0d088f0dd26a934f3fff40907))
## v1.2.0 (2022-08-03)
### Feature
* Handle BrokenPipeError from dbus-next via bleak ([#8](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/8)) ([`21da55d`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/21da55dcc37754bcbf904c6ab8162cd4f091e2c4))
## v1.1.1 (2022-08-02)
### Fix
* Add back the bleak overall safety timeout ([#7](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/7)) ([`f3f8ded`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/f3f8ded4082bb155d2626a3ec3c693b11bbc355b))
## v1.1.0 (2022-07-24)
### Feature
* Pass additional kwargs to the client class ([#6](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/6)) ([`808e05b`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/808e05bc2d831307f3e093a9d9d42a2409a0a681))
## v1.0.2 (2022-07-22)
### Fix
* Push a new release now that pypi is working again ([#5](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/5)) ([`3480e22`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/3480e225e8567e6b4a75d166c6a5b3e4661ebb46))
## v1.0.1 (2022-07-22)
### Fix
* Add comments ([#4](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/4)) ([`4bc5563`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/4bc5563c23bc8cdb9ae44ede0d2ea86693968610))
## v0.1.1 (2022-07-22)
### Fix
* Republish ([#3](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/3)) ([`2b1a504`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/2b1a5042f2250db16d655b1f18a24e74f82f77d2))
## v0.1.0 (2022-07-22)
### Feature
* First release ([#2](https://github.com/Bluetooth-Devices/bleak-retry-connector/issues/2)) ([`f11f9b5`](https://github.com/Bluetooth-Devices/bleak-retry-connector/commit/f11f9b5ea1a998bfbd407ffaff299d40243e4e0a))
bleak-retry-connector-3.8.1/CONTRIBUTING.md 0000664 0000000 0000000 00000007502 14750422166 0020200 0 ustar 00root root 0000000 0000000 # Contributing
Contributions are welcome, and they are greatly appreciated! Every little helps, and credit will always be given.
You can contribute in many ways:
## Types of Contributions
### Report Bugs
Report bugs to [our issue page][gh-issues]. If you are reporting a bug, please include:
- Your operating system name and version.
- Any details about your local setup that might be helpful in troubleshooting.
- Detailed steps to reproduce the bug.
### Fix Bugs
Look through the GitHub issues for bugs. Anything tagged with "bug" and "help wanted" is open to whoever wants to implement it.
### Implement Features
Look through the GitHub issues for features. Anything tagged with "enhancement" and "help wanted" is open to whoever wants to implement it.
### Write Documentation
Bleak Retry Connector could always use more documentation, whether as part of the official Bleak Retry Connector docs, in docstrings, or even on the web in blog posts, articles, and such.
### Submit Feedback
The best way to send feedback [our issue page][gh-issues] on GitHub. If you are proposing a feature:
- Explain in detail how it would work.
- Keep the scope as narrow as possible, to make it easier to implement.
- Remember that this is a volunteer-driven project, and that contributions are welcome 😊
## Get Started!
Ready to contribute? Here's how to set yourself up for local development.
1. Fork the repo on GitHub.
2. Clone your fork locally:
```shell
$ git clone git@github.com:your_name_here/bleak-retry-connector.git
```
3. Install the project dependencies with [Poetry](https://python-poetry.org):
```shell
$ poetry install
```
4. Create a branch for local development:
```shell
$ git checkout -b name-of-your-bugfix-or-feature
```
Now you can make your changes locally.
5. When you're done making changes, check that your changes pass our tests:
```shell
$ poetry run pytest
```
6. Linting is done through [pre-commit](https://pre-commit.com). Provided you have the tool installed globally, you can run them all as one-off:
```shell
$ pre-commit run -a
```
Or better, install the hooks once and have them run automatically each time you commit:
```shell
$ pre-commit install
```
7. Commit your changes and push your branch to GitHub:
```shell
$ git add .
$ git commit -m "feat(something): your detailed description of your changes"
$ git push origin name-of-your-bugfix-or-feature
```
Note: the commit message should follow [the conventional commits](https://www.conventionalcommits.org). We run [`commitlint` on CI](https://github.com/marketplace/actions/commit-linter) to validate it, and if you've installed pre-commit hooks at the previous step, the message will be checked at commit time.
8. Submit a pull request through the GitHub website or using the GitHub CLI (if you have it installed):
```shell
$ gh pr create --fill
```
## Pull Request Guidelines
We like to have the pull request open as soon as possible, that's a great place to discuss any piece of work, even unfinished. You can use draft pull request if it's still a work in progress. Here are a few guidelines to follow:
1. Include tests for feature or bug fixes.
2. Update the documentation for significant features.
3. Ensure tests are passing on CI.
## Tips
To run a subset of tests:
```shell
$ pytest tests
```
## Making a new release
The deployment should be automated and can be triggered from the Semantic Release workflow in GitHub. The next version will be based on [the commit logs](https://python-semantic-release.readthedocs.io/en/latest/commit-log-parsing.html#commit-log-parsing). This is done by [python-semantic-release](https://python-semantic-release.readthedocs.io/en/latest/index.html) via a GitHub action.
[gh-issues]: https://github.com/bluetooth-devices/bleak-retry-connector/issues
bleak-retry-connector-3.8.1/LICENSE 0000664 0000000 0000000 00000002060 14750422166 0016746 0 ustar 00root root 0000000 0000000
MIT License
Copyright (c) 2022 J. Nick Koston
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
bleak-retry-connector-3.8.1/README.md 0000664 0000000 0000000 00000007137 14750422166 0017232 0 ustar 00root root 0000000 0000000 # Bleak Retry Connector
A connector for Bleak Clients that handles transient connection failures
## Installation
Install this via pip (or your favourite package manager):
`pip install bleak-retry-connector`
## Contributors ✨
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
## Credits
This package was created with
[Cookiecutter](https://github.com/audreyr/cookiecutter) and the
[browniebroke/cookiecutter-pypackage](https://github.com/browniebroke/cookiecutter-pypackage)
project template.
bleak-retry-connector-3.8.1/commitlint.config.js 0000664 0000000 0000000 00000000364 14750422166 0021727 0 ustar 00root root 0000000 0000000 module.exports = {
extends: ["@commitlint/config-conventional"],
rules: {
"header-max-length": [0, "always", Infinity],
"body-max-line-length": [0, "always", Infinity],
"footer-max-line-length": [0, "always", Infinity],
},
};
bleak-retry-connector-3.8.1/docs/ 0000775 0000000 0000000 00000000000 14750422166 0016673 5 ustar 00root root 0000000 0000000 bleak-retry-connector-3.8.1/docs/Makefile 0000664 0000000 0000000 00000001175 14750422166 0020337 0 ustar 00root root 0000000 0000000 # Minimal makefile for Sphinx documentation
#
# You can set these variables from the command line, and also
# from the environment for the first two.
SPHINXOPTS ?=
SPHINXBUILD ?= sphinx-build
SOURCEDIR = source
BUILDDIR = build
# Put it first so that "make" without argument is like "make help".
help:
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
.PHONY: help Makefile
# Catch-all target: route all unknown targets to Sphinx using the new
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
%: Makefile
$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
bleak-retry-connector-3.8.1/docs/make.bat 0000664 0000000 0000000 00000001374 14750422166 0020305 0 ustar 00root root 0000000 0000000 @ECHO OFF
pushd %~dp0
REM Command file for Sphinx documentation
if "%SPHINXBUILD%" == "" (
set SPHINXBUILD=sphinx-build
)
set SOURCEDIR=source
set BUILDDIR=build
if "%1" == "" goto help
%SPHINXBUILD% >NUL 2>NUL
if errorlevel 9009 (
echo.
echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
echo.installed, then set the SPHINXBUILD environment variable to point
echo.to the full path of the 'sphinx-build' executable. Alternatively you
echo.may add the Sphinx directory to PATH.
echo.
echo.If you don't have Sphinx installed, grab it from
echo.http://sphinx-doc.org/
exit /b 1
)
%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
goto end
:help
%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
:end
popd
bleak-retry-connector-3.8.1/docs/source/ 0000775 0000000 0000000 00000000000 14750422166 0020173 5 ustar 00root root 0000000 0000000 bleak-retry-connector-3.8.1/docs/source/_static/ 0000775 0000000 0000000 00000000000 14750422166 0021621 5 ustar 00root root 0000000 0000000 bleak-retry-connector-3.8.1/docs/source/_static/.gitkeep 0000664 0000000 0000000 00000000000 14750422166 0023240 0 ustar 00root root 0000000 0000000 bleak-retry-connector-3.8.1/docs/source/changelog.md 0000664 0000000 0000000 00000000045 14750422166 0022443 0 ustar 00root root 0000000 0000000 ```{include} ../../CHANGELOG.md
```
bleak-retry-connector-3.8.1/docs/source/conf.py 0000664 0000000 0000000 00000003657 14750422166 0021505 0 ustar 00root root 0000000 0000000 # Configuration file for the Sphinx documentation builder.
#
# This file only contains a selection of the most common options. For a full
# list see the documentation:
# https://www.sphinx-doc.org/en/master/usage/configuration.html
# -- Path setup --------------------------------------------------------------
# If extensions (or modules to document with autodoc) are in another directory,
# add these directories to sys.path here. If the directory is relative to the
# documentation root, use os.path.abspath to make it absolute, like shown here.
#
# import os
# import sys
# sys.path.insert(0, os.path.abspath('.'))
from typing import Any
# -- Project information -----------------------------------------------------
project = "Bleak Retry Connector"
copyright = "2020, J. Nick Koston"
author = "J. Nick Koston"
# -- General configuration ---------------------------------------------------
# Add any Sphinx extension module names here, as strings. They can be
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
# ones.
extensions = [
"myst_parser",
]
# The suffix of source filenames.
source_suffix = [".rst", ".md"]
# Add any paths that contain templates here, relative to this directory.
templates_path = ["_templates"]
# List of patterns, relative to source directory, that match files and
# directories to ignore when looking for source files.
# This pattern also affects html_static_path and html_extra_path.
exclude_patterns: list[Any] = []
# -- Options for HTML output -------------------------------------------------
# The theme to use for HTML and HTML Help pages. See the documentation for
# a list of builtin themes.
#
html_theme = "sphinx_rtd_theme"
# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
html_static_path = ["_static"]
bleak-retry-connector-3.8.1/docs/source/contributing.md 0000664 0000000 0000000 00000000050 14750422166 0023217 0 ustar 00root root 0000000 0000000 ```{include} ../../CONTRIBUTING.md
```
bleak-retry-connector-3.8.1/docs/source/index.md 0000664 0000000 0000000 00000000365 14750422166 0021630 0 ustar 00root root 0000000 0000000 # Welcome to Bleak Retry Connector documentation!
```{toctree}
:caption: Installation & Usage
:maxdepth: 2
installation
usage
```
```{toctree}
:caption: Project Info
:maxdepth: 2
changelog
contributing
```
```{include} ../../README.md
```
bleak-retry-connector-3.8.1/docs/source/installation.md 0000664 0000000 0000000 00000000300 14750422166 0023207 0 ustar 00root root 0000000 0000000 # Installation
The package is published on [PyPI](https://pypi.org/project/deezer-python/) and can be installed with `pip` (or any equivalent):
```bash
pip install bleak-retry-connector
```
bleak-retry-connector-3.8.1/docs/source/usage.md 0000664 0000000 0000000 00000000153 14750422166 0021620 0 ustar 00root root 0000000 0000000 # Usage
To use this package, import it:
```python
import bleak_retry_connector
```
TODO: Document usage
bleak-retry-connector-3.8.1/poetry.lock 0000664 0000000 0000000 00000165763 14750422166 0020161 0 ustar 00root root 0000000 0000000 # This file is automatically @generated by Poetry 2.0.1 and should not be changed by hand.
[[package]]
name = "aiooui"
version = "0.1.7"
description = "Async OUI lookups"
optional = false
python-versions = "<4.0,>=3.9"
groups = ["main"]
markers = "platform_system == \"Linux\""
files = [
{file = "aiooui-0.1.7-cp310-cp310-manylinux_2_31_x86_64.whl", hash = "sha256:8bb53e015a6e78e10bc36957733ca84714885361c4c4b9a5262e9ad3db83c333"},
{file = "aiooui-0.1.7-py3-none-any.whl", hash = "sha256:fb9ffbf061e84d9bc638f53205a2844d00da6839ad758afa91269b49ee927013"},
{file = "aiooui-0.1.7.tar.gz", hash = "sha256:b390c9e602de1faecf3c1f0b98270a95e2d00a4da208a62d507a9635ab8a5d05"},
]
[[package]]
name = "async-timeout"
version = "4.0.3"
description = "Timeout context manager for asyncio programs"
optional = false
python-versions = ">=3.7"
groups = ["main"]
markers = "python_version < \"3.11\""
files = [
{file = "async-timeout-4.0.3.tar.gz", hash = "sha256:4640d96be84d82d02ed59ea2b7105a0f7b33abe8703703cd0ab0bf87c427522f"},
{file = "async_timeout-4.0.3-py3-none-any.whl", hash = "sha256:7405140ff1230c310e51dc27b3145b9092d659ce68ff733fb0cefe3ee42be028"},
]
[[package]]
name = "bleak"
version = "0.22.3"
description = "Bluetooth Low Energy platform Agnostic Klient"
optional = false
python-versions = "<3.14,>=3.8"
groups = ["main"]
files = [
{file = "bleak-0.22.3-py3-none-any.whl", hash = "sha256:1e62a9f5e0c184826e6c906e341d8aca53793e4596eeaf4e0b191e7aca5c461c"},
{file = "bleak-0.22.3.tar.gz", hash = "sha256:3149c3c19657e457727aa53d9d6aeb89658495822cd240afd8aeca4dd09c045c"},
]
[package.dependencies]
async-timeout = {version = ">=3.0.0,<5", markers = "python_version < \"3.11\""}
bleak-winrt = {version = ">=1.2.0,<2.0.0", markers = "platform_system == \"Windows\" and python_version < \"3.12\""}
dbus-fast = {version = ">=1.83.0,<3", markers = "platform_system == \"Linux\""}
pyobjc-core = {version = ">=10.3,<11.0", markers = "platform_system == \"Darwin\""}
pyobjc-framework-CoreBluetooth = {version = ">=10.3,<11.0", markers = "platform_system == \"Darwin\""}
pyobjc-framework-libdispatch = {version = ">=10.3,<11.0", markers = "platform_system == \"Darwin\""}
typing-extensions = {version = ">=4.7.0", markers = "python_version < \"3.12\""}
winrt-runtime = {version = ">=2,<3", markers = "platform_system == \"Windows\" and python_version >= \"3.12\""}
"winrt-Windows.Devices.Bluetooth" = {version = ">=2,<3", markers = "platform_system == \"Windows\" and python_version >= \"3.12\""}
"winrt-Windows.Devices.Bluetooth.Advertisement" = {version = ">=2,<3", markers = "platform_system == \"Windows\" and python_version >= \"3.12\""}
"winrt-Windows.Devices.Bluetooth.GenericAttributeProfile" = {version = ">=2,<3", markers = "platform_system == \"Windows\" and python_version >= \"3.12\""}
"winrt-Windows.Devices.Enumeration" = {version = ">=2,<3", markers = "platform_system == \"Windows\" and python_version >= \"3.12\""}
"winrt-Windows.Foundation" = {version = ">=2,<3", markers = "platform_system == \"Windows\" and python_version >= \"3.12\""}
"winrt-Windows.Foundation.Collections" = {version = ">=2,<3", markers = "platform_system == \"Windows\" and python_version >= \"3.12\""}
"winrt-Windows.Storage.Streams" = {version = ">=2,<3", markers = "platform_system == \"Windows\" and python_version >= \"3.12\""}
[[package]]
name = "bleak-winrt"
version = "1.2.0"
description = "Python WinRT bindings for Bleak"
optional = false
python-versions = "*"
groups = ["main"]
markers = "platform_system == \"Windows\" and python_version < \"3.12\""
files = [
{file = "bleak-winrt-1.2.0.tar.gz", hash = "sha256:0577d070251b9354fc6c45ffac57e39341ebb08ead014b1bdbd43e211d2ce1d6"},
{file = "bleak_winrt-1.2.0-cp310-cp310-win32.whl", hash = "sha256:a2ae3054d6843ae0cfd3b94c83293a1dfd5804393977dd69bde91cb5099fc47c"},
{file = "bleak_winrt-1.2.0-cp310-cp310-win_amd64.whl", hash = "sha256:677df51dc825c6657b3ae94f00bd09b8ab88422b40d6a7bdbf7972a63bc44e9a"},
{file = "bleak_winrt-1.2.0-cp311-cp311-win32.whl", hash = "sha256:9449cdb942f22c9892bc1ada99e2ccce9bea8a8af1493e81fefb6de2cb3a7b80"},
{file = "bleak_winrt-1.2.0-cp311-cp311-win_amd64.whl", hash = "sha256:98c1b5a6a6c431ac7f76aa4285b752fe14a1c626bd8a1dfa56f66173ff120bee"},
{file = "bleak_winrt-1.2.0-cp37-cp37m-win32.whl", hash = "sha256:623ac511696e1f58d83cb9c431e32f613395f2199b3db7f125a3d872cab968a4"},
{file = "bleak_winrt-1.2.0-cp37-cp37m-win_amd64.whl", hash = "sha256:13ab06dec55469cf51a2c187be7b630a7a2922e1ea9ac1998135974a7239b1e3"},
{file = "bleak_winrt-1.2.0-cp38-cp38-win32.whl", hash = "sha256:5a36ff8cd53068c01a795a75d2c13054ddc5f99ce6de62c1a97cd343fc4d0727"},
{file = "bleak_winrt-1.2.0-cp38-cp38-win_amd64.whl", hash = "sha256:810c00726653a962256b7acd8edf81ab9e4a3c66e936a342ce4aec7dbd3a7263"},
{file = "bleak_winrt-1.2.0-cp39-cp39-win32.whl", hash = "sha256:dd740047a08925bde54bec357391fcee595d7b8ca0c74c87170a5cbc3f97aa0a"},
{file = "bleak_winrt-1.2.0-cp39-cp39-win_amd64.whl", hash = "sha256:63130c11acfe75c504a79c01f9919e87f009f5e742bfc7b7a5c2a9c72bf591a7"},
]
[[package]]
name = "bluetooth-adapters"
version = "0.21.1"
description = "Tools to enumerate and find Bluetooth Adapters"
optional = false
python-versions = "<3.14,>=3.9"
groups = ["main"]
markers = "platform_system == \"Linux\""
files = [
{file = "bluetooth_adapters-0.21.1-py3-none-any.whl", hash = "sha256:5637d25fbdff215abda884f93912089e58cd75cc44c4d78902b773fd19e86ea8"},
{file = "bluetooth_adapters-0.21.1.tar.gz", hash = "sha256:6840bb235ce51e7f03779126e59e73266ad36893d7ca7d562e6008fde7a17fba"},
]
[package.dependencies]
aiooui = ">=0.1.1"
async-timeout = {version = ">=3.0.0", markers = "python_version < \"3.11\""}
bleak = ">=0.21.1"
dbus-fast = {version = ">=1.21.0", markers = "platform_system == \"Linux\""}
uart-devices = ">=0.1.0"
usb-devices = ">=0.4.5"
[package.extras]
docs = ["Sphinx (>=5,<8)", "myst-parser (>=0.18,<3.1)", "sphinx-rtd-theme (>=1,<4)"]
[[package]]
name = "colorama"
version = "0.4.6"
description = "Cross-platform colored terminal text."
optional = false
python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,>=2.7"
groups = ["dev"]
markers = "sys_platform == \"win32\""
files = [
{file = "colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6"},
{file = "colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44"},
]
[[package]]
name = "coverage"
version = "7.6.10"
description = "Code coverage measurement for Python"
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "coverage-7.6.10-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:5c912978f7fbf47ef99cec50c4401340436d200d41d714c7a4766f377c5b7b78"},
{file = "coverage-7.6.10-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:a01ec4af7dfeb96ff0078ad9a48810bb0cc8abcb0115180c6013a6b26237626c"},
{file = "coverage-7.6.10-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a3b204c11e2b2d883946fe1d97f89403aa1811df28ce0447439178cc7463448a"},
{file = "coverage-7.6.10-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:32ee6d8491fcfc82652a37109f69dee9a830e9379166cb73c16d8dc5c2915165"},
{file = "coverage-7.6.10-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:675cefc4c06e3b4c876b85bfb7c59c5e2218167bbd4da5075cbe3b5790a28988"},
{file = "coverage-7.6.10-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:f4f620668dbc6f5e909a0946a877310fb3d57aea8198bde792aae369ee1c23b5"},
{file = "coverage-7.6.10-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:4eea95ef275de7abaef630c9b2c002ffbc01918b726a39f5a4353916ec72d2f3"},
{file = "coverage-7.6.10-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:e2f0280519e42b0a17550072861e0bc8a80a0870de260f9796157d3fca2733c5"},
{file = "coverage-7.6.10-cp310-cp310-win32.whl", hash = "sha256:bc67deb76bc3717f22e765ab3e07ee9c7a5e26b9019ca19a3b063d9f4b874244"},
{file = "coverage-7.6.10-cp310-cp310-win_amd64.whl", hash = "sha256:0f460286cb94036455e703c66988851d970fdfd8acc2a1122ab7f4f904e4029e"},
{file = "coverage-7.6.10-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:ea3c8f04b3e4af80e17bab607c386a830ffc2fb88a5484e1df756478cf70d1d3"},
{file = "coverage-7.6.10-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:507a20fc863cae1d5720797761b42d2d87a04b3e5aeb682ef3b7332e90598f43"},
{file = "coverage-7.6.10-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d37a84878285b903c0fe21ac8794c6dab58150e9359f1aaebbeddd6412d53132"},
{file = "coverage-7.6.10-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:a534738b47b0de1995f85f582d983d94031dffb48ab86c95bdf88dc62212142f"},
{file = "coverage-7.6.10-cp311-cp311-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0d7a2bf79378d8fb8afaa994f91bfd8215134f8631d27eba3e0e2c13546ce994"},
{file = "coverage-7.6.10-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:6713ba4b4ebc330f3def51df1d5d38fad60b66720948112f114968feb52d3f99"},
{file = "coverage-7.6.10-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:ab32947f481f7e8c763fa2c92fd9f44eeb143e7610c4ca9ecd6a36adab4081bd"},
{file = "coverage-7.6.10-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:7bbd8c8f1b115b892e34ba66a097b915d3871db7ce0e6b9901f462ff3a975377"},
{file = "coverage-7.6.10-cp311-cp311-win32.whl", hash = "sha256:299e91b274c5c9cdb64cbdf1b3e4a8fe538a7a86acdd08fae52301b28ba297f8"},
{file = "coverage-7.6.10-cp311-cp311-win_amd64.whl", hash = "sha256:489a01f94aa581dbd961f306e37d75d4ba16104bbfa2b0edb21d29b73be83609"},
{file = "coverage-7.6.10-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:27c6e64726b307782fa5cbe531e7647aee385a29b2107cd87ba7c0105a5d3853"},
{file = "coverage-7.6.10-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:c56e097019e72c373bae32d946ecf9858fda841e48d82df7e81c63ac25554078"},
{file = "coverage-7.6.10-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c7827a5bc7bdb197b9e066cdf650b2887597ad124dd99777332776f7b7c7d0d0"},
{file = "coverage-7.6.10-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:204a8238afe787323a8b47d8be4df89772d5c1e4651b9ffa808552bdf20e1d50"},
{file = "coverage-7.6.10-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e67926f51821b8e9deb6426ff3164870976fe414d033ad90ea75e7ed0c2e5022"},
{file = "coverage-7.6.10-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:e78b270eadb5702938c3dbe9367f878249b5ef9a2fcc5360ac7bff694310d17b"},
{file = "coverage-7.6.10-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:714f942b9c15c3a7a5fe6876ce30af831c2ad4ce902410b7466b662358c852c0"},
{file = "coverage-7.6.10-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:abb02e2f5a3187b2ac4cd46b8ced85a0858230b577ccb2c62c81482ca7d18852"},
{file = "coverage-7.6.10-cp312-cp312-win32.whl", hash = "sha256:55b201b97286cf61f5e76063f9e2a1d8d2972fc2fcfd2c1272530172fd28c359"},
{file = "coverage-7.6.10-cp312-cp312-win_amd64.whl", hash = "sha256:e4ae5ac5e0d1e4edfc9b4b57b4cbecd5bc266a6915c500f358817a8496739247"},
{file = "coverage-7.6.10-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:05fca8ba6a87aabdd2d30d0b6c838b50510b56cdcfc604d40760dae7153b73d9"},
{file = "coverage-7.6.10-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:9e80eba8801c386f72e0712a0453431259c45c3249f0009aff537a517b52942b"},
{file = "coverage-7.6.10-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a372c89c939d57abe09e08c0578c1d212e7a678135d53aa16eec4430adc5e690"},
{file = "coverage-7.6.10-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:ec22b5e7fe7a0fa8509181c4aac1db48f3dd4d3a566131b313d1efc102892c18"},
{file = "coverage-7.6.10-cp313-cp313-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:26bcf5c4df41cad1b19c84af71c22cbc9ea9a547fc973f1f2cc9a290002c8b3c"},
{file = "coverage-7.6.10-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:4e4630c26b6084c9b3cb53b15bd488f30ceb50b73c35c5ad7871b869cb7365fd"},
{file = "coverage-7.6.10-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:2396e8116db77789f819d2bc8a7e200232b7a282c66e0ae2d2cd84581a89757e"},
{file = "coverage-7.6.10-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:79109c70cc0882e4d2d002fe69a24aa504dec0cc17169b3c7f41a1d341a73694"},
{file = "coverage-7.6.10-cp313-cp313-win32.whl", hash = "sha256:9e1747bab246d6ff2c4f28b4d186b205adced9f7bd9dc362051cc37c4a0c7bd6"},
{file = "coverage-7.6.10-cp313-cp313-win_amd64.whl", hash = "sha256:254f1a3b1eef5f7ed23ef265eaa89c65c8c5b6b257327c149db1ca9d4a35f25e"},
{file = "coverage-7.6.10-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:2ccf240eb719789cedbb9fd1338055de2761088202a9a0b73032857e53f612fe"},
{file = "coverage-7.6.10-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:0c807ca74d5a5e64427c8805de15b9ca140bba13572d6d74e262f46f50b13273"},
{file = "coverage-7.6.10-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2bcfa46d7709b5a7ffe089075799b902020b62e7ee56ebaed2f4bdac04c508d8"},
{file = "coverage-7.6.10-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:4e0de1e902669dccbf80b0415fb6b43d27edca2fbd48c74da378923b05316098"},
{file = "coverage-7.6.10-cp313-cp313t-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f7b444c42bbc533aaae6b5a2166fd1a797cdb5eb58ee51a92bee1eb94a1e1cb"},
{file = "coverage-7.6.10-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:b330368cb99ef72fcd2dc3ed260adf67b31499584dc8a20225e85bfe6f6cfed0"},
{file = "coverage-7.6.10-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:9a7cfb50515f87f7ed30bc882f68812fd98bc2852957df69f3003d22a2aa0abf"},
{file = "coverage-7.6.10-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:6f93531882a5f68c28090f901b1d135de61b56331bba82028489bc51bdd818d2"},
{file = "coverage-7.6.10-cp313-cp313t-win32.whl", hash = "sha256:89d76815a26197c858f53c7f6a656686ec392b25991f9e409bcef020cd532312"},
{file = "coverage-7.6.10-cp313-cp313t-win_amd64.whl", hash = "sha256:54a5f0f43950a36312155dae55c505a76cd7f2b12d26abeebbe7a0b36dbc868d"},
{file = "coverage-7.6.10-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:656c82b8a0ead8bba147de9a89bda95064874c91a3ed43a00e687f23cc19d53a"},
{file = "coverage-7.6.10-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:ccc2b70a7ed475c68ceb548bf69cec1e27305c1c2606a5eb7c3afff56a1b3b27"},
{file = "coverage-7.6.10-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a5e37dc41d57ceba70956fa2fc5b63c26dba863c946ace9705f8eca99daecdc4"},
{file = "coverage-7.6.10-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0aa9692b4fdd83a4647eeb7db46410ea1322b5ed94cd1715ef09d1d5922ba87f"},
{file = "coverage-7.6.10-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:aa744da1820678b475e4ba3dfd994c321c5b13381d1041fe9c608620e6676e25"},
{file = "coverage-7.6.10-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:c0b1818063dc9e9d838c09e3a473c1422f517889436dd980f5d721899e66f315"},
{file = "coverage-7.6.10-cp39-cp39-musllinux_1_2_i686.whl", hash = "sha256:59af35558ba08b758aec4d56182b222976330ef8d2feacbb93964f576a7e7a90"},
{file = "coverage-7.6.10-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:7ed2f37cfce1ce101e6dffdfd1c99e729dd2ffc291d02d3e2d0af8b53d13840d"},
{file = "coverage-7.6.10-cp39-cp39-win32.whl", hash = "sha256:4bcc276261505d82f0ad426870c3b12cb177752834a633e737ec5ee79bbdff18"},
{file = "coverage-7.6.10-cp39-cp39-win_amd64.whl", hash = "sha256:457574f4599d2b00f7f637a0700a6422243b3565509457b2dbd3f50703e11f59"},
{file = "coverage-7.6.10-pp39.pp310-none-any.whl", hash = "sha256:fd34e7b3405f0cc7ab03d54a334c17a9e802897580d964bd8c2001f4b9fd488f"},
{file = "coverage-7.6.10.tar.gz", hash = "sha256:7fb105327c8f8f0682e29843e2ff96af9dcbe5bab8eeb4b398c6a33a16d80a23"},
]
[package.dependencies]
tomli = {version = "*", optional = true, markers = "python_full_version <= \"3.11.0a6\" and extra == \"toml\""}
[package.extras]
toml = ["tomli"]
[[package]]
name = "dbus-fast"
version = "2.32.0"
description = "A faster version of dbus-next"
optional = false
python-versions = "<4.0,>=3.9"
groups = ["main", "dev"]
files = [
{file = "dbus_fast-2.32.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c52d1c8c95563f5a583264a8ff561564fd55af1a7546e4635d7413494d150709"},
{file = "dbus_fast-2.32.0-cp310-cp310-manylinux_2_17_i686.manylinux_2_5_i686.manylinux1_i686.manylinux2014_i686.whl", hash = "sha256:cd532d5e0d8dc28b936b36d4ac02c7e1c486b647f393e0ba390da12eaae3b05e"},
{file = "dbus_fast-2.32.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5053ebf011fa1e4754934b89c99c1bfb1686f751af9f05a10997be635c5b6e71"},
{file = "dbus_fast-2.32.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:7d58293cc994a76e6561b954117b74c83351736082c2c0f9bba844e4f35d7499"},
{file = "dbus_fast-2.32.0-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:5b0be52f27995a53344ffe92aaf47e7df62b04c8b51dec73ecafa2fec0d23951"},
{file = "dbus_fast-2.32.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:126f54c208d7e711d0f5e0ba2e54fecec58fbfea8fc56875a1019c599adb551a"},
{file = "dbus_fast-2.32.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3eb4815475599aa437a805674fc88e93db76218257b5fb8aacff35bbbe8d5e00"},
{file = "dbus_fast-2.32.0-cp311-cp311-manylinux_2_17_i686.manylinux_2_5_i686.manylinux1_i686.manylinux2014_i686.whl", hash = "sha256:fa11c7a4e82dcc37e3dd72ca73fc619eb575d2c8c5016035de4299d38a90f46e"},
{file = "dbus_fast-2.32.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a9bb96ac5c8e564b250e318f2481ef5465e2f7160aba55b177f88229a7640cd8"},
{file = "dbus_fast-2.32.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:d033da7a1b0f80c62ca0fe0f0a582200883a49deaff6d3e52a34a95839f17b55"},
{file = "dbus_fast-2.32.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:4b6576864ebcaaf18336ef75b8a9f36affdcefbbdade18613309bc4f8536003b"},
{file = "dbus_fast-2.32.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:29ff6e39e5950a4f5fa49199af83d916e22dc372380348ed103c8692b721eea0"},
{file = "dbus_fast-2.32.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:74ac784ce469ad81c2594924fc4eb3c99aa6d53072c1c3ad2078a3f579228656"},
{file = "dbus_fast-2.32.0-cp312-cp312-manylinux_2_17_i686.manylinux_2_5_i686.manylinux1_i686.manylinux2014_i686.whl", hash = "sha256:4273c7df8ff4a4555b42669e9f89e63b5ea11962ea6164b646b73a54f94ad68c"},
{file = "dbus_fast-2.32.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:241e7f8329eabd5ddcf75dd347e2073b999a4d3677435729ccca7268f625ad15"},
{file = "dbus_fast-2.32.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:ff8a57a050e3d3a981c66e11a3c1e14fdd1b17292085310418b58c6ae1a1e771"},
{file = "dbus_fast-2.32.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:2d719283799331f0a9329e316ea6f0c2b114f05cbc2b699015141c40b093676c"},
{file = "dbus_fast-2.32.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:ef6e948b29da6317f7538e01ef3e0f502929bb9d93a635a02f41cc6339e05153"},
{file = "dbus_fast-2.32.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:608da9b8ab8c7c93a153be64cc1e7725706d64f40d21dc76238f4a4c4fd696e1"},
{file = "dbus_fast-2.32.0-cp313-cp313-manylinux_2_17_i686.manylinux_2_5_i686.manylinux1_i686.manylinux2014_i686.whl", hash = "sha256:1f269881525245776a937191b4b65aa0a7a6cd800687425d54d40d697573fb00"},
{file = "dbus_fast-2.32.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9a97f3130a8226ecbd94a9fe8f4b5f692b00f64e3087d5a8d4aee0115d7f93b1"},
{file = "dbus_fast-2.32.0-cp313-cp313-manylinux_2_36_x86_64.whl", hash = "sha256:845425c5a6ccc9b12de9b42ad9edf7e15fdc3e0b9c5261aaf3318623131aa6c5"},
{file = "dbus_fast-2.32.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:389f926dfc9b650078b3448276147f24f061eedf7214f58e2d2023543c3d972b"},
{file = "dbus_fast-2.32.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:a1cb3d621471af90f2632937737292c39fd2ffa19e71485ca772de323bdffefc"},
{file = "dbus_fast-2.32.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:3b25567610d29f760c2971544f61387dbafe282571fd663d5caa9b2ae0703d19"},
{file = "dbus_fast-2.32.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a57b53f1d20a36bcf1c033960f8474e44c58b3535d1987b990876f65d12075e4"},
{file = "dbus_fast-2.32.0-cp39-cp39-manylinux_2_17_i686.manylinux_2_5_i686.manylinux1_i686.manylinux2014_i686.whl", hash = "sha256:09e9856d5200632042d02039c2d20a41f6973b2abddc03a48d65c0d28c25c843"},
{file = "dbus_fast-2.32.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e89435269f5e07a8bb352bf29454fe706362c17e8b27e75c66c84e669c59f29a"},
{file = "dbus_fast-2.32.0-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:d2011d796810ca682c32005e15962763787d993f944029e1f18665f9ecc3be9d"},
{file = "dbus_fast-2.32.0-cp39-cp39-musllinux_1_2_i686.whl", hash = "sha256:23f9688a5b4d3c918e24686ba0cde1c929675612f4dd4d217f101cbe1cb0c96f"},
{file = "dbus_fast-2.32.0-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:f24b0dc97a69e6d8291d1916e5eedc39630ab5bce7d953fe55a126a1938e6425"},
{file = "dbus_fast-2.32.0-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ea6ce84db6ecb6bea29b5c208d60b7e31443dabb50b66f5c30c3df68c629ccb8"},
{file = "dbus_fast-2.32.0-pp310-pypy310_pp73-manylinux_2_17_i686.manylinux_2_5_i686.manylinux1_i686.manylinux2014_i686.whl", hash = "sha256:7a82ab4e3ea5d4253eea13b6425fd042323b3f90068c6945ccbb919b7a5e8602"},
{file = "dbus_fast-2.32.0-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux_2_5_x86_64.manylinux1_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bffc5ffe1716cde9986eda72d0cbec667beb29aeb8bd56e2d19dc75113ffa864"},
{file = "dbus_fast-2.32.0-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8bcf99ca822788baa78d0ec9782db2907a13a007c95d0a4a5660420d5ee4e6eb"},
{file = "dbus_fast-2.32.0-pp39-pypy39_pp73-manylinux_2_17_i686.manylinux_2_5_i686.manylinux1_i686.manylinux2014_i686.whl", hash = "sha256:986d3d15e4030f87485a583db08f11a37989e24f08927cc582fafac738c3ce15"},
{file = "dbus_fast-2.32.0-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux_2_5_x86_64.manylinux1_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f48431e43fb31b506c74eab0eddfe7c4546fb00fdd856c176534508c2d21d003"},
{file = "dbus_fast-2.32.0.tar.gz", hash = "sha256:501b01387b8da5c9f1093f8405dadb4b9f2d2fb54ebc7ad5dd3667bcbc8f7d16"},
]
[[package]]
name = "exceptiongroup"
version = "1.2.0"
description = "Backport of PEP 654 (exception groups)"
optional = false
python-versions = ">=3.7"
groups = ["dev"]
markers = "python_version < \"3.11\""
files = [
{file = "exceptiongroup-1.2.0-py3-none-any.whl", hash = "sha256:4bfd3996ac73b41e9b9628b04e079f193850720ea5945fc96a08633c66912f14"},
{file = "exceptiongroup-1.2.0.tar.gz", hash = "sha256:91f5c769735f051a4290d52edd0858999b57e5876e9f85937691bd4c9fa3ed68"},
]
[package.extras]
test = ["pytest (>=6)"]
[[package]]
name = "iniconfig"
version = "2.0.0"
description = "brain-dead simple config-ini parsing"
optional = false
python-versions = ">=3.7"
groups = ["dev"]
files = [
{file = "iniconfig-2.0.0-py3-none-any.whl", hash = "sha256:b6a85871a79d2e3b22d2d1b94ac2824226a63c6b741c88f7ae975f18b6778374"},
{file = "iniconfig-2.0.0.tar.gz", hash = "sha256:2d91e135bf72d31a410b17c16da610a82cb55f6b0477d1a902134b24a455b8b3"},
]
[[package]]
name = "packaging"
version = "23.2"
description = "Core utilities for Python packages"
optional = false
python-versions = ">=3.7"
groups = ["dev"]
files = [
{file = "packaging-23.2-py3-none-any.whl", hash = "sha256:8c491190033a9af7e1d931d0b5dacc2ef47509b34dd0de67ed209b5203fc88c7"},
{file = "packaging-23.2.tar.gz", hash = "sha256:048fb0e9405036518eaaf48a55953c750c11e1a1b68e0dd1a9d62ed0c092cfc5"},
]
[[package]]
name = "pluggy"
version = "1.5.0"
description = "plugin and hook calling mechanisms for python"
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "pluggy-1.5.0-py3-none-any.whl", hash = "sha256:44e1ad92c8ca002de6377e165f3e0f1be63266ab4d554740532335b9d75ea669"},
{file = "pluggy-1.5.0.tar.gz", hash = "sha256:2cffa88e94fdc978c4c574f15f9e59b7f4201d439195c3715ca9e2486f1d0cf1"},
]
[package.extras]
dev = ["pre-commit", "tox"]
testing = ["pytest", "pytest-benchmark"]
[[package]]
name = "pyobjc-core"
version = "10.3.1"
description = "Python<->ObjC Interoperability Module"
optional = false
python-versions = ">=3.8"
groups = ["main"]
markers = "platform_system == \"Darwin\""
files = [
{file = "pyobjc_core-10.3.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:ea46d2cda17921e417085ac6286d43ae448113158afcf39e0abe484c58fb3d78"},
{file = "pyobjc_core-10.3.1-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:899d3c84d2933d292c808f385dc881a140cf08632907845043a333a9d7c899f9"},
{file = "pyobjc_core-10.3.1-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:6ff5823d13d0a534cdc17fa4ad47cf5bee4846ce0fd27fc40012e12b46db571b"},
{file = "pyobjc_core-10.3.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:2581e8e68885bcb0e11ec619e81ef28e08ee3fac4de20d8cc83bc5af5bcf4a90"},
{file = "pyobjc_core-10.3.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:ea98d4c2ec39ca29e62e0327db21418696161fb138ee6278daf2acbedf7ce504"},
{file = "pyobjc_core-10.3.1-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:4c179c26ee2123d0aabffb9dbc60324b62b6f8614fb2c2328b09386ef59ef6d8"},
{file = "pyobjc_core-10.3.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:cb901fce65c9be420c40d8a6ee6fff5ff27c6945f44fd7191989b982baa66dea"},
{file = "pyobjc_core-10.3.1.tar.gz", hash = "sha256:b204a80ccc070f9ab3f8af423a3a25a6fd787e228508d00c4c30f8ac538ba720"},
]
[[package]]
name = "pyobjc-framework-cocoa"
version = "10.3.1"
description = "Wrappers for the Cocoa frameworks on macOS"
optional = false
python-versions = ">=3.8"
groups = ["main"]
markers = "platform_system == \"Darwin\""
files = [
{file = "pyobjc_framework_Cocoa-10.3.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:4cb4f8491ab4d9b59f5187e42383f819f7a46306a4fa25b84f126776305291d1"},
{file = "pyobjc_framework_Cocoa-10.3.1-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:5f31021f4f8fdf873b57a97ee1f3c1620dbe285e0b4eaed73dd0005eb72fd773"},
{file = "pyobjc_framework_Cocoa-10.3.1-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:11b4e0bad4bbb44a4edda128612f03cdeab38644bbf174de0c13129715497296"},
{file = "pyobjc_framework_Cocoa-10.3.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:de5e62e5ccf2871a94acf3bf79646b20ea893cc9db78afa8d1fe1b0d0f7cbdb0"},
{file = "pyobjc_framework_Cocoa-10.3.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:6c5af24610ab639bd1f521ce4500484b40787f898f691b7a23da3339e6bc8b90"},
{file = "pyobjc_framework_Cocoa-10.3.1-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:a7151186bb7805deea434fae9a4423335e6371d105f29e73cc2036c6779a9dbc"},
{file = "pyobjc_framework_Cocoa-10.3.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:743d2a1ac08027fd09eab65814c79002a1d0421d7c0074ffd1217b6560889744"},
{file = "pyobjc_framework_cocoa-10.3.1.tar.gz", hash = "sha256:1cf20714daaa986b488fb62d69713049f635c9d41a60c8da97d835710445281a"},
]
[package.dependencies]
pyobjc-core = ">=10.3.1"
[[package]]
name = "pyobjc-framework-corebluetooth"
version = "10.3.1"
description = "Wrappers for the framework CoreBluetooth on macOS"
optional = false
python-versions = ">=3.8"
groups = ["main"]
markers = "platform_system == \"Darwin\""
files = [
{file = "pyobjc_framework_CoreBluetooth-10.3.1-cp36-abi3-macosx_10_13_universal2.whl", hash = "sha256:c89ee6fba0ed359c46b4908a7d01f88f133be025bd534cbbf4fb9c183e62fc97"},
{file = "pyobjc_framework_CoreBluetooth-10.3.1-cp36-abi3-macosx_10_9_universal2.whl", hash = "sha256:2f261a386aa6906f9d4601d35ff71a13315dbca1a0698bf1f1ecfe3971de4648"},
{file = "pyobjc_framework_CoreBluetooth-10.3.1-cp36-abi3-macosx_10_9_x86_64.whl", hash = "sha256:5211df0da2e8be511d9a54a48505dd7af0c4d04546fe2027dd723801d633c6ba"},
{file = "pyobjc_framework_CoreBluetooth-10.3.1-cp36-abi3-macosx_11_0_universal2.whl", hash = "sha256:b8becd4e406be289a2d423611d3ad40730532a1f6728effb2200e68c9c04c3e8"},
{file = "pyobjc_framework_corebluetooth-10.3.1.tar.gz", hash = "sha256:dc5d326ab5541b8b68e7e920aa8363851e779cb8c33842f6cfeef4674cc62f94"},
]
[package.dependencies]
pyobjc-core = ">=10.3.1"
pyobjc-framework-Cocoa = ">=10.3.1"
[[package]]
name = "pyobjc-framework-libdispatch"
version = "10.3.1"
description = "Wrappers for libdispatch on macOS"
optional = false
python-versions = ">=3.8"
groups = ["main"]
markers = "platform_system == \"Darwin\""
files = [
{file = "pyobjc_framework_libdispatch-10.3.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:5543aea8acd53fb02bcf962b003a2a9c2bdacf28dc290c31a3d2de7543ef8392"},
{file = "pyobjc_framework_libdispatch-10.3.1-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:3e0db3138aae333f0b87b42586bc016430a76638af169aab9cef6afee4e5f887"},
{file = "pyobjc_framework_libdispatch-10.3.1-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:b209dbc9338cd87e053ede4d782b8c445bcc0b9a3d0365a6ffa1f9cd5143c301"},
{file = "pyobjc_framework_libdispatch-10.3.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:a74e62314376dc2d34bc5d4a86cedaf5795786178ebccd0553c58e8fa73400a3"},
{file = "pyobjc_framework_libdispatch-10.3.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:8e8fb27ac86d48605eb2107ac408ed8de281751df81f5430fe66c8228d7626b8"},
{file = "pyobjc_framework_libdispatch-10.3.1-cp38-cp38-macosx_11_0_universal2.whl", hash = "sha256:0a7a19afef70c98b3b527fb2c9adb025444bcb50f65c8d7b949f1efb51bde577"},
{file = "pyobjc_framework_libdispatch-10.3.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:109044cddecb3332cbb75f14819cd01b98aacfefe91204c776b491eccc58a112"},
{file = "pyobjc_framework_libdispatch-10.3.1.tar.gz", hash = "sha256:f5c3475498cb32f54d75e21952670e4a32c8517fb2db2e90869f634edc942446"},
]
[package.dependencies]
pyobjc-core = ">=10.3.1"
pyobjc-framework-Cocoa = ">=10.3.1"
[[package]]
name = "pytest"
version = "8.3.4"
description = "pytest: simple powerful testing with Python"
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "pytest-8.3.4-py3-none-any.whl", hash = "sha256:50e16d954148559c9a74109af1eaf0c945ba2d8f30f0a3d3335edde19788b6f6"},
{file = "pytest-8.3.4.tar.gz", hash = "sha256:965370d062bce11e73868e0335abac31b4d3de0e82f4007408d242b4f8610761"},
]
[package.dependencies]
colorama = {version = "*", markers = "sys_platform == \"win32\""}
exceptiongroup = {version = ">=1.0.0rc8", markers = "python_version < \"3.11\""}
iniconfig = "*"
packaging = "*"
pluggy = ">=1.5,<2"
tomli = {version = ">=1", markers = "python_version < \"3.11\""}
[package.extras]
dev = ["argcomplete", "attrs (>=19.2)", "hypothesis (>=3.56)", "mock", "pygments (>=2.7.2)", "requests", "setuptools", "xmlschema"]
[[package]]
name = "pytest-asyncio"
version = "0.25.3"
description = "Pytest support for asyncio"
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "pytest_asyncio-0.25.3-py3-none-any.whl", hash = "sha256:9e89518e0f9bd08928f97a3482fdc4e244df17529460bc038291ccaf8f85c7c3"},
{file = "pytest_asyncio-0.25.3.tar.gz", hash = "sha256:fc1da2cf9f125ada7e710b4ddad05518d4cee187ae9412e9ac9271003497f07a"},
]
[package.dependencies]
pytest = ">=8.2,<9"
[package.extras]
docs = ["sphinx (>=5.3)", "sphinx-rtd-theme (>=1)"]
testing = ["coverage (>=6.2)", "hypothesis (>=5.7.1)"]
[[package]]
name = "pytest-cov"
version = "6.0.0"
description = "Pytest plugin for measuring coverage."
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "pytest-cov-6.0.0.tar.gz", hash = "sha256:fde0b595ca248bb8e2d76f020b465f3b107c9632e6a1d1705f17834c89dcadc0"},
{file = "pytest_cov-6.0.0-py3-none-any.whl", hash = "sha256:eee6f1b9e61008bd34975a4d5bab25801eb31898b032dd55addc93e96fcaaa35"},
]
[package.dependencies]
coverage = {version = ">=7.5", extras = ["toml"]}
pytest = ">=4.6"
[package.extras]
testing = ["fields", "hunter", "process-tests", "pytest-xdist", "virtualenv"]
[[package]]
name = "tomli"
version = "2.0.1"
description = "A lil' TOML parser"
optional = false
python-versions = ">=3.7"
groups = ["dev"]
markers = "python_full_version <= \"3.11.0a6\""
files = [
{file = "tomli-2.0.1-py3-none-any.whl", hash = "sha256:939de3e7a6161af0c887ef91b7d41a53e7c5a1ca976325f429cb46ea9bc30ecc"},
{file = "tomli-2.0.1.tar.gz", hash = "sha256:de526c12914f0c550d15924c62d72abc48d6fe7364aa87328337a31007fe8a4f"},
]
[[package]]
name = "typing-extensions"
version = "4.9.0"
description = "Backported and Experimental Type Hints for Python 3.8+"
optional = false
python-versions = ">=3.8"
groups = ["main"]
markers = "python_version < \"3.12\""
files = [
{file = "typing_extensions-4.9.0-py3-none-any.whl", hash = "sha256:af72aea155e91adfc61c3ae9e0e342dbc0cba726d6cba4b6c72c1f34e47291cd"},
{file = "typing_extensions-4.9.0.tar.gz", hash = "sha256:23478f88c37f27d76ac8aee6c905017a143b0b1b886c3c9f66bc2fd94f9f5783"},
]
[[package]]
name = "uart-devices"
version = "0.1.0"
description = "UART Devices for Linux"
optional = false
python-versions = "<4.0,>=3.8"
groups = ["main"]
markers = "platform_system == \"Linux\""
files = [
{file = "uart_devices-0.1.0-py3-none-any.whl", hash = "sha256:f019357945a4f2d619e43a7cef7cee4f52aeff06aa5c674f9da448dce3c9cd64"},
{file = "uart_devices-0.1.0.tar.gz", hash = "sha256:7f0342c0ba0bc2a4c13c9ead5462dc9feeaca507e5c7017ebd074a69567ad9b1"},
]
[[package]]
name = "usb-devices"
version = "0.4.5"
description = "Tools for mapping, describing, and resetting USB devices"
optional = false
python-versions = ">=3.9,<4.0"
groups = ["main"]
markers = "platform_system == \"Linux\""
files = [
{file = "usb_devices-0.4.5-py3-none-any.whl", hash = "sha256:8a415219ef1395e25aa0bddcad484c88edf9673acdeae8a07223ca7222a01dcf"},
{file = "usb_devices-0.4.5.tar.gz", hash = "sha256:9b5c7606df2bc791c6c45b7f76244a0cbed83cb6fa4c68791a143c03345e195d"},
]
[[package]]
name = "winrt-runtime"
version = "2.2.0"
description = "Python projection of Windows Runtime (WinRT) APIs"
optional = false
python-versions = "<3.14,>=3.9"
groups = ["main"]
markers = "platform_system == \"Windows\" and python_version >= \"3.12\""
files = [
{file = "winrt_runtime-2.2.0-cp310-cp310-win32.whl", hash = "sha256:ab034330d6b64ce93683bdc14d4f3f83dfafbf1f72b45893505f7d684e5e7fe1"},
{file = "winrt_runtime-2.2.0-cp310-cp310-win_amd64.whl", hash = "sha256:ad9927a1838dea47ceb2d773c0269242bcee7cb5379ed801547788ab435da502"},
{file = "winrt_runtime-2.2.0-cp310-cp310-win_arm64.whl", hash = "sha256:87745ae54d054957a99c70875c1ac3c89cca258ed06836ae308fbbb7dda4ef61"},
{file = "winrt_runtime-2.2.0-cp311-cp311-win32.whl", hash = "sha256:7ee2397934c1c4a090f9d889292def90b8f673dc1d320f1f07931ad1cb6e49bf"},
{file = "winrt_runtime-2.2.0-cp311-cp311-win_amd64.whl", hash = "sha256:f110b0f451b514cf09c4fa0e73bab54d4b598c3092df9dd87940403998e81f30"},
{file = "winrt_runtime-2.2.0-cp311-cp311-win_arm64.whl", hash = "sha256:27606e7a393a26e484f03db699c4d7c206d180a3736a6cd68fba3b3896e364a4"},
{file = "winrt_runtime-2.2.0-cp312-cp312-win32.whl", hash = "sha256:5a769bfb4e264b7fd306027da90c6e4e615667e9afdd8e5d712bc45bdabaf0d2"},
{file = "winrt_runtime-2.2.0-cp312-cp312-win_amd64.whl", hash = "sha256:ef30ea7446a1e37660265b76e586fcffc0e83a859b7729141cdf68cbedf808a8"},
{file = "winrt_runtime-2.2.0-cp312-cp312-win_arm64.whl", hash = "sha256:d8f6338fb8433b4df900c8f173959a5ae9ac63b0b20faddb338e76a6e9391bc9"},
{file = "winrt_runtime-2.2.0-cp313-cp313-win32.whl", hash = "sha256:6d8c1122158edc96cac956a5ab62bc06a56e088bdf83d0993a455216b3fd1cac"},
{file = "winrt_runtime-2.2.0-cp313-cp313-win_amd64.whl", hash = "sha256:76b2dc846e6802375113c9ce9e7fcc4292926bd788445f34d404bae72d2b4f4b"},
{file = "winrt_runtime-2.2.0-cp313-cp313-win_arm64.whl", hash = "sha256:faacc05577573702cb135e7da4d619f4990c768063dc869362f13d856a0738e3"},
{file = "winrt_runtime-2.2.0-cp39-cp39-win32.whl", hash = "sha256:f00334e3304a43e1742514bed2dc736a9242e831676f605fdfb5d62932714b18"},
{file = "winrt_runtime-2.2.0-cp39-cp39-win_amd64.whl", hash = "sha256:ef1b2dc31576d686cce088a349b539fc0f47bdf2f66fb8ea63a6964dc069d00d"},
{file = "winrt_runtime-2.2.0-cp39-cp39-win_arm64.whl", hash = "sha256:1c9e8a609cf00acc426eae2ed4ad866991a0f33f196ec9dc69af95ae43b4373b"},
{file = "winrt_runtime-2.2.0.tar.gz", hash = "sha256:37a673b295ebd5f6dc5a3b42fd52c8e4589ca3e605deb54c26d0877d2575ec85"},
]
[[package]]
name = "winrt-windows-devices-bluetooth"
version = "2.2.0"
description = "Python projection of Windows Runtime (WinRT) APIs"
optional = false
python-versions = "<3.14,>=3.9"
groups = ["main"]
markers = "platform_system == \"Windows\" and python_version >= \"3.12\""
files = [
{file = "winrt_Windows.Devices.Bluetooth-2.2.0-cp310-cp310-win32.whl", hash = "sha256:f3ced50ded44f74ac901d05f99cdd0bdf78e3a939a42d3cd80c33e510b4b8569"},
{file = "winrt_Windows.Devices.Bluetooth-2.2.0-cp310-cp310-win_amd64.whl", hash = "sha256:241a8f0ab06f6178d2e5757e7bc1f6c37e00e65ab6858ae676a1723a6445fa92"},
{file = "winrt_Windows.Devices.Bluetooth-2.2.0-cp310-cp310-win_arm64.whl", hash = "sha256:3abefa3d11b4af9d9731d9d1a71083b1ef301fa30f7006a6c1f341426dd6d733"},
{file = "winrt_Windows.Devices.Bluetooth-2.2.0-cp311-cp311-win32.whl", hash = "sha256:4215c45595201f5f43f98b1e8911ff5cb0b303fe3298fa4d91a7bdc6d5523853"},
{file = "winrt_Windows.Devices.Bluetooth-2.2.0-cp311-cp311-win_amd64.whl", hash = "sha256:5cda69842b30bf56b10ea1a747d01b295abc910d9ccc10e9c97e8f554cd536e0"},
{file = "winrt_Windows.Devices.Bluetooth-2.2.0-cp311-cp311-win_arm64.whl", hash = "sha256:f7c12a28cd04eb05bacc73d8025ba135a929b9d511d21f20d0072d735853e8a2"},
{file = "winrt_Windows.Devices.Bluetooth-2.2.0-cp312-cp312-win32.whl", hash = "sha256:c929ea5215942fb26081b26aae094a2f70551cc0a59499ab2c9ea1f6d6b991f9"},
{file = "winrt_Windows.Devices.Bluetooth-2.2.0-cp312-cp312-win_amd64.whl", hash = "sha256:c1444e2031f3e69990d412b9edf75413a09280744bbc088a6b0760d94d356d4b"},
{file = "winrt_Windows.Devices.Bluetooth-2.2.0-cp312-cp312-win_arm64.whl", hash = "sha256:f2d06ce6c43e37ea09ac073805ac6f9f62ae10ce552c90ae6eca978accd3f434"},
{file = "winrt_Windows.Devices.Bluetooth-2.2.0-cp313-cp313-win32.whl", hash = "sha256:b44a45c60f1d9fa288a12119991060ef7998793c6b93baa84308cfb090492788"},
{file = "winrt_Windows.Devices.Bluetooth-2.2.0-cp313-cp313-win_amd64.whl", hash = "sha256:fb698a55d06dc34643437b370c35fa064bd28762561e880715a30463c359fa44"},
{file = "winrt_Windows.Devices.Bluetooth-2.2.0-cp313-cp313-win_arm64.whl", hash = "sha256:cb350bfe21bab3573c9cd84006efad9c46a395a2943ab474105aed8b21bb88a4"},
{file = "winrt_Windows.Devices.Bluetooth-2.2.0-cp39-cp39-win32.whl", hash = "sha256:7ee056e4c1a542352bcacbb95f898b7ae2739b3e0a63f7ab1290a7e2569f6393"},
{file = "winrt_Windows.Devices.Bluetooth-2.2.0-cp39-cp39-win_amd64.whl", hash = "sha256:f919cee2a49c3c48d1ef9dd84b419a6438000ef43bc35a7a349291c162cab4f3"},
{file = "winrt_Windows.Devices.Bluetooth-2.2.0-cp39-cp39-win_arm64.whl", hash = "sha256:f223af93675f6f92ab87de08c6d413ecc8ab19014b7438893437c42dcb2b0969"},
{file = "winrt_windows_devices_bluetooth-2.2.0.tar.gz", hash = "sha256:95a5cf9c1e915557a28a4f017ea1ff7357039ee23526258f9cc161cf080b4577"},
]
[package.dependencies]
winrt-runtime = "2.2.0"
[package.extras]
all = ["winrt-Windows.Devices.Bluetooth.GenericAttributeProfile[all] (==2.2.0)", "winrt-Windows.Devices.Bluetooth.Rfcomm[all] (==2.2.0)", "winrt-Windows.Devices.Enumeration[all] (==2.2.0)", "winrt-Windows.Devices.Radios[all] (==2.2.0)", "winrt-Windows.Foundation.Collections[all] (==2.2.0)", "winrt-Windows.Foundation[all] (==2.2.0)", "winrt-Windows.Networking[all] (==2.2.0)", "winrt-Windows.Storage.Streams[all] (==2.2.0)"]
[[package]]
name = "winrt-windows-devices-bluetooth-advertisement"
version = "2.2.0"
description = "Python projection of Windows Runtime (WinRT) APIs"
optional = false
python-versions = "<3.14,>=3.9"
groups = ["main"]
markers = "platform_system == \"Windows\" and python_version >= \"3.12\""
files = [
{file = "winrt_Windows.Devices.Bluetooth.Advertisement-2.2.0-cp310-cp310-win32.whl", hash = "sha256:3d5fddffd5f6eeafebe1bcbaa096b8962c28c9236490f6f887ac2ed3ee4ed62c"},
{file = "winrt_Windows.Devices.Bluetooth.Advertisement-2.2.0-cp310-cp310-win_amd64.whl", hash = "sha256:f1cb5a835dc3574b0c47a613fa49eeeccdd9aa5801d43d7b7606ad5ce3614a54"},
{file = "winrt_Windows.Devices.Bluetooth.Advertisement-2.2.0-cp310-cp310-win_arm64.whl", hash = "sha256:9c2530c4972671ffb8a6e54621490c6c7a8c13b4d57e6474e05b62f211bbaab6"},
{file = "winrt_Windows.Devices.Bluetooth.Advertisement-2.2.0-cp311-cp311-win32.whl", hash = "sha256:28b36b3be137bdb6bdaad0d7a620c1a8b156e3c2737d08b9827af02b3c9d52bf"},
{file = "winrt_Windows.Devices.Bluetooth.Advertisement-2.2.0-cp311-cp311-win_amd64.whl", hash = "sha256:52948f17ecfc70c58b07077191985712172b518b5e3f4874e5708d175b7ace72"},
{file = "winrt_Windows.Devices.Bluetooth.Advertisement-2.2.0-cp311-cp311-win_arm64.whl", hash = "sha256:338296b76c01840c1dc10799a405b76460346bf677af11e6ab324311fd58e1a9"},
{file = "winrt_Windows.Devices.Bluetooth.Advertisement-2.2.0-cp312-cp312-win32.whl", hash = "sha256:4c14f48ac1886a3d374ee511467f0a61f26d88a321bf97d47429859730ee9248"},
{file = "winrt_Windows.Devices.Bluetooth.Advertisement-2.2.0-cp312-cp312-win_amd64.whl", hash = "sha256:89a658e901de88373e6a17a98273b8555e3f80563f2cc362b7f75817a7f9d915"},
{file = "winrt_Windows.Devices.Bluetooth.Advertisement-2.2.0-cp312-cp312-win_arm64.whl", hash = "sha256:3b2b1b34f37a3329cf72793a089dd13fefd7b582c3e3a53a69a1353fd18940a3"},
{file = "winrt_Windows.Devices.Bluetooth.Advertisement-2.2.0-cp313-cp313-win32.whl", hash = "sha256:1b2d42c3d90b3e985954196b9a9e4007e22ff468d3d020c5a4acdee2821018fe"},
{file = "winrt_Windows.Devices.Bluetooth.Advertisement-2.2.0-cp313-cp313-win_amd64.whl", hash = "sha256:8d964c599670ea21b97afe2435e7638ca26e04936aacc0550474b6ec3fea988f"},
{file = "winrt_Windows.Devices.Bluetooth.Advertisement-2.2.0-cp313-cp313-win_arm64.whl", hash = "sha256:add4f459f0a02d1da38d579c3af887cfc3fe54f7782d779cf4ffe7f24404f1ff"},
{file = "winrt_Windows.Devices.Bluetooth.Advertisement-2.2.0-cp39-cp39-win32.whl", hash = "sha256:756aeb2408bd59983a34da7f2552690d9e1071ad75de96aff15b365e1137b157"},
{file = "winrt_Windows.Devices.Bluetooth.Advertisement-2.2.0-cp39-cp39-win_amd64.whl", hash = "sha256:9d19ef4cb00f58e10bdd0a2eb497eabecb3a2a5586fdcacebae6f0009585f3f1"},
{file = "winrt_Windows.Devices.Bluetooth.Advertisement-2.2.0-cp39-cp39-win_arm64.whl", hash = "sha256:1008641262bbbe130b6fcda76b9c890327aa416ef5b240a6a2cbb895d37dd3c7"},
{file = "winrt_windows_devices_bluetooth_advertisement-2.2.0.tar.gz", hash = "sha256:bcbf246994b60e5de4bea9eb3fa01c5d6452200789004d14df70b27be9aa4775"},
]
[package.dependencies]
winrt-runtime = "2.2.0"
[package.extras]
all = ["winrt-Windows.Devices.Bluetooth[all] (==2.2.0)", "winrt-Windows.Foundation.Collections[all] (==2.2.0)", "winrt-Windows.Foundation[all] (==2.2.0)", "winrt-Windows.Storage.Streams[all] (==2.2.0)"]
[[package]]
name = "winrt-windows-devices-bluetooth-genericattributeprofile"
version = "2.2.0"
description = "Python projection of Windows Runtime (WinRT) APIs"
optional = false
python-versions = "<3.14,>=3.9"
groups = ["main"]
markers = "platform_system == \"Windows\" and python_version >= \"3.12\""
files = [
{file = "winrt_Windows.Devices.Bluetooth.GenericAttributeProfile-2.2.0-cp310-cp310-win32.whl", hash = "sha256:1472f89b9d6527137e1c58dfb46f22faf2753c477a9d4f85f789b3266ad282a9"},
{file = "winrt_Windows.Devices.Bluetooth.GenericAttributeProfile-2.2.0-cp310-cp310-win_amd64.whl", hash = "sha256:e25702f1aa6d4ecdf335805a50048e70ee2206499cfd7ed4fbe1a92358bdcc16"},
{file = "winrt_Windows.Devices.Bluetooth.GenericAttributeProfile-2.2.0-cp310-cp310-win_arm64.whl", hash = "sha256:d07d27a6f8f7a1f52aa978724d5a09d43053b428c71563892b70df409049a37a"},
{file = "winrt_Windows.Devices.Bluetooth.GenericAttributeProfile-2.2.0-cp311-cp311-win32.whl", hash = "sha256:5c6c863daaa99b0bb670730296137b7c718d94726c112ff44ec73c8b27a12ded"},
{file = "winrt_Windows.Devices.Bluetooth.GenericAttributeProfile-2.2.0-cp311-cp311-win_amd64.whl", hash = "sha256:fbee7c90c0a155477eba09eb09297711b2cb32f6ede4c01d0afe58cb3776f06a"},
{file = "winrt_Windows.Devices.Bluetooth.GenericAttributeProfile-2.2.0-cp311-cp311-win_arm64.whl", hash = "sha256:655777193fd338e1a8c30ebbb8460c017d08548c54ddec9fc5503f1605c47332"},
{file = "winrt_Windows.Devices.Bluetooth.GenericAttributeProfile-2.2.0-cp312-cp312-win32.whl", hash = "sha256:45a48ab8da94eee1590f22826c084f4b1f8c32107a023f05d6a03437931a6852"},
{file = "winrt_Windows.Devices.Bluetooth.GenericAttributeProfile-2.2.0-cp312-cp312-win_amd64.whl", hash = "sha256:395cb2fecd0835a402c3c4f274395bc689549b2a6b4155d3ad97b29ec87ee4f2"},
{file = "winrt_Windows.Devices.Bluetooth.GenericAttributeProfile-2.2.0-cp312-cp312-win_arm64.whl", hash = "sha256:25063b43550c5630f188cfb263ab09acc920db97d1625c48e24baa6e7d445b6e"},
{file = "winrt_Windows.Devices.Bluetooth.GenericAttributeProfile-2.2.0-cp313-cp313-win32.whl", hash = "sha256:d1d26512fe45c3be0dbeb932dbd75abd580cd46ccfc278fcf51042eff302fa9c"},
{file = "winrt_Windows.Devices.Bluetooth.GenericAttributeProfile-2.2.0-cp313-cp313-win_amd64.whl", hash = "sha256:21786840502a34958dd5fb137381f9144a6437b49ee90a877beb3148ead6cfe9"},
{file = "winrt_Windows.Devices.Bluetooth.GenericAttributeProfile-2.2.0-cp313-cp313-win_arm64.whl", hash = "sha256:5d98852458b639e875bb4895a9ad2d5626059bc99c5f745be0560d235502d648"},
{file = "winrt_Windows.Devices.Bluetooth.GenericAttributeProfile-2.2.0-cp39-cp39-win32.whl", hash = "sha256:827b390b1a47c9aa6bfd717b66822f4fc698b0c02c8678924e2bc6ac37093b65"},
{file = "winrt_Windows.Devices.Bluetooth.GenericAttributeProfile-2.2.0-cp39-cp39-win_amd64.whl", hash = "sha256:727567b725ca94b677bda97a6f725d58fc1a4652d4cc232b44cc57dd7ba9ee87"},
{file = "winrt_Windows.Devices.Bluetooth.GenericAttributeProfile-2.2.0-cp39-cp39-win_arm64.whl", hash = "sha256:ac901d17d2350785bce18282cd29d002d2c4da8adff5160891c4115ae010a2d0"},
{file = "winrt_windows_devices_bluetooth_genericattributeprofile-2.2.0.tar.gz", hash = "sha256:0de4ee5f57223107f25c20f6bb2739947670a2f8cf09907f3e611efc81e7c6e0"},
]
[package.dependencies]
winrt-runtime = "2.2.0"
[package.extras]
all = ["winrt-Windows.Devices.Bluetooth[all] (==2.2.0)", "winrt-Windows.Devices.Enumeration[all] (==2.2.0)", "winrt-Windows.Foundation.Collections[all] (==2.2.0)", "winrt-Windows.Foundation[all] (==2.2.0)", "winrt-Windows.Storage.Streams[all] (==2.2.0)"]
[[package]]
name = "winrt-windows-devices-enumeration"
version = "2.2.0"
description = "Python projection of Windows Runtime (WinRT) APIs"
optional = false
python-versions = "<3.14,>=3.9"
groups = ["main"]
markers = "platform_system == \"Windows\" and python_version >= \"3.12\""
files = [
{file = "winrt_Windows.Devices.Enumeration-2.2.0-cp310-cp310-win32.whl", hash = "sha256:69e87ba0ae5c31f60bc07d0558d91af96213d8b8b2b1be0ccf3e5824cab466ef"},
{file = "winrt_Windows.Devices.Enumeration-2.2.0-cp310-cp310-win_amd64.whl", hash = "sha256:e6993d5305ff750c5c51f57253935458996fb45c049891f2fb00772cc6ece6b3"},
{file = "winrt_Windows.Devices.Enumeration-2.2.0-cp310-cp310-win_arm64.whl", hash = "sha256:bb54aa94b17052d65fe4fa5777183cf9bfb697574c3461759114d3ec0c802cec"},
{file = "winrt_Windows.Devices.Enumeration-2.2.0-cp311-cp311-win32.whl", hash = "sha256:fef83263e73c2611d223f06735d2c2a16629d723f74e1964dc882f90b6e1cda1"},
{file = "winrt_Windows.Devices.Enumeration-2.2.0-cp311-cp311-win_amd64.whl", hash = "sha256:cf3cec5a6fba069ecbd4f3efa95e9f197aeebdd05a60bcd52b953888169ab7ee"},
{file = "winrt_Windows.Devices.Enumeration-2.2.0-cp311-cp311-win_arm64.whl", hash = "sha256:d9ce308c492c1e9f2417f91ad02e366f4269cc1c6d271f0be4092b758df4c9bf"},
{file = "winrt_Windows.Devices.Enumeration-2.2.0-cp312-cp312-win32.whl", hash = "sha256:5bea21988749fad21574ea789b4090cfbfbb982a5f9a42b2d6f05b3ad47f68bd"},
{file = "winrt_Windows.Devices.Enumeration-2.2.0-cp312-cp312-win_amd64.whl", hash = "sha256:c9718d7033550a029e0c2848ff620bf063a519cb22ab9d880d64ceb302763a48"},
{file = "winrt_Windows.Devices.Enumeration-2.2.0-cp312-cp312-win_arm64.whl", hash = "sha256:69f67f01aa519304e4af04a1a23261bd8b57136395de2e08d56968f9c6daa18e"},
{file = "winrt_Windows.Devices.Enumeration-2.2.0-cp313-cp313-win32.whl", hash = "sha256:84447916282773d7b7e5a445eae0ab273c21105f1bbcdfb7d8e21cd41403d5c1"},
{file = "winrt_Windows.Devices.Enumeration-2.2.0-cp313-cp313-win_amd64.whl", hash = "sha256:1bb9d97f8d2518bb5b331f825431814277de4341811a1776e79d51767e79700c"},
{file = "winrt_Windows.Devices.Enumeration-2.2.0-cp313-cp313-win_arm64.whl", hash = "sha256:2a5408423f680f6b36d7accad7151336ea16ad1eaa2652f60ed88e2cbd14562c"},
{file = "winrt_Windows.Devices.Enumeration-2.2.0-cp39-cp39-win32.whl", hash = "sha256:51f4c9b6f3376913e3009bfe232cfc082357b24d6eeec098cf53f361527e1c1f"},
{file = "winrt_Windows.Devices.Enumeration-2.2.0-cp39-cp39-win_amd64.whl", hash = "sha256:1e6895d5538539d0c6bd081374e7646684901038d4d2dede7841b63adfaf8086"},
{file = "winrt_Windows.Devices.Enumeration-2.2.0-cp39-cp39-win_arm64.whl", hash = "sha256:0845fca0841003ae446650ab6695c38d45623bc1e8e40a43e839e450a874fd6f"},
{file = "winrt_windows_devices_enumeration-2.2.0.tar.gz", hash = "sha256:cfe1780101e3ef9c5b4716cca608aa6b6ddf19f1d7a2a70434241d438db19d3d"},
]
[package.dependencies]
winrt-runtime = "2.2.0"
[package.extras]
all = ["winrt-Windows.ApplicationModel.Background[all] (==2.2.0)", "winrt-Windows.Foundation.Collections[all] (==2.2.0)", "winrt-Windows.Foundation[all] (==2.2.0)", "winrt-Windows.Security.Credentials[all] (==2.2.0)", "winrt-Windows.Storage.Streams[all] (==2.2.0)", "winrt-Windows.UI.Popups[all] (==2.2.0)", "winrt-Windows.UI[all] (==2.2.0)"]
[[package]]
name = "winrt-windows-foundation"
version = "2.2.0"
description = "Python projection of Windows Runtime (WinRT) APIs"
optional = false
python-versions = "<3.14,>=3.9"
groups = ["main"]
markers = "platform_system == \"Windows\" and python_version >= \"3.12\""
files = [
{file = "winrt_Windows.Foundation-2.2.0-cp310-cp310-win32.whl", hash = "sha256:cb86bbf04f72d983e4ae13db0a48784638b36214bb2c44809f39686ef3314354"},
{file = "winrt_Windows.Foundation-2.2.0-cp310-cp310-win_amd64.whl", hash = "sha256:2dbd0957216c07db4b91a144a0ffa7c8892cc668b19ca15b78067255445741b2"},
{file = "winrt_Windows.Foundation-2.2.0-cp310-cp310-win_arm64.whl", hash = "sha256:5345f7d0504aa1a605be5b5fe0d1944b322591f7669c2c86b7c45384924c8c9b"},
{file = "winrt_Windows.Foundation-2.2.0-cp311-cp311-win32.whl", hash = "sha256:f6711adf8a34e48c94183e792f153de5f3796f8f3c045356544605384bbcb7e1"},
{file = "winrt_Windows.Foundation-2.2.0-cp311-cp311-win_amd64.whl", hash = "sha256:0a5bfe2647659e7ec288d8552e61e577a931914531ccc9cb958469d85f049d6b"},
{file = "winrt_Windows.Foundation-2.2.0-cp311-cp311-win_arm64.whl", hash = "sha256:9eabbd1b179fd04f167884fa0feaa17ccd67d89f6eac4099b16c6c0dc22e9f32"},
{file = "winrt_Windows.Foundation-2.2.0-cp312-cp312-win32.whl", hash = "sha256:0f0319659f00d04d13fc5db45f574479a396147c955628dc2dda056397a0df28"},
{file = "winrt_Windows.Foundation-2.2.0-cp312-cp312-win_amd64.whl", hash = "sha256:8bc605242d268cd8ccce68c78ec4a967b8e5431c3a969c9e7a01d454696dfb3f"},
{file = "winrt_Windows.Foundation-2.2.0-cp312-cp312-win_arm64.whl", hash = "sha256:f901b20c3a874a2cf9dcb1e97bbcff329d95fd3859a873be314a5a58073b4690"},
{file = "winrt_Windows.Foundation-2.2.0-cp313-cp313-win32.whl", hash = "sha256:c5cf43bb1dccf3a302d16572d53f26479d277e02606531782c364056c2323678"},
{file = "winrt_Windows.Foundation-2.2.0-cp313-cp313-win_amd64.whl", hash = "sha256:10c84276ff182a06da6deb1ba9ad375f9b3fbc15c3684a160e775005d915197a"},
{file = "winrt_Windows.Foundation-2.2.0-cp313-cp313-win_arm64.whl", hash = "sha256:473cc57664bfd5401ec171c8f55079cdc8a980210f2c82fb2945361ea640bfbf"},
{file = "winrt_Windows.Foundation-2.2.0-cp39-cp39-win32.whl", hash = "sha256:32578bd31eda714bc5cb5b10f0e778c720a2e45bc9b3c60690faa1615336047d"},
{file = "winrt_Windows.Foundation-2.2.0-cp39-cp39-win_amd64.whl", hash = "sha256:7bfb62127959f56fdacad6a817176a8b22cf6917a0d5c3e5d25cdad33a90173a"},
{file = "winrt_Windows.Foundation-2.2.0-cp39-cp39-win_arm64.whl", hash = "sha256:07ea5a2f05cb9fb433371e55f70fbe27f32a6eb07ae28042f01678b4d82d823a"},
{file = "winrt_windows_foundation-2.2.0.tar.gz", hash = "sha256:9a76291204900cd92008163fbe273ae43c9a925ca4a5a29cdd736e59cd397bf1"},
]
[package.dependencies]
winrt-runtime = "2.2.0"
[package.extras]
all = ["winrt-Windows.Foundation.Collections[all] (==2.2.0)"]
[[package]]
name = "winrt-windows-foundation-collections"
version = "2.2.0"
description = "Python projection of Windows Runtime (WinRT) APIs"
optional = false
python-versions = "<3.14,>=3.9"
groups = ["main"]
markers = "platform_system == \"Windows\" and python_version >= \"3.12\""
files = [
{file = "winrt_Windows.Foundation.Collections-2.2.0-cp310-cp310-win32.whl", hash = "sha256:92a031fca53910c8bce683391888ba3427db178fc47653310de16fb7e9131e9d"},
{file = "winrt_Windows.Foundation.Collections-2.2.0-cp310-cp310-win_amd64.whl", hash = "sha256:a71925d738a443cf27522f34ced84730f1b325f69ccdd0145580e6078d4481c5"},
{file = "winrt_Windows.Foundation.Collections-2.2.0-cp310-cp310-win_arm64.whl", hash = "sha256:74c9419b26b510e6e95182e02dc55a78094b6f2af5002330467d030ae6d0b765"},
{file = "winrt_Windows.Foundation.Collections-2.2.0-cp311-cp311-win32.whl", hash = "sha256:8a76d79be0af1840b9c5ac1879dcf5aa65b512accd8278ac6424dcbfdb2a6fe1"},
{file = "winrt_Windows.Foundation.Collections-2.2.0-cp311-cp311-win_amd64.whl", hash = "sha256:b18dcd7bc8cf70758b965397e26da725ac345dd9f16b922b0204e8f21ed4d7e6"},
{file = "winrt_Windows.Foundation.Collections-2.2.0-cp311-cp311-win_arm64.whl", hash = "sha256:1d6b0b04683e98989dd611940b5fe36c1338f6d91f43c1bdc88f2f2f1956a968"},
{file = "winrt_Windows.Foundation.Collections-2.2.0-cp312-cp312-win32.whl", hash = "sha256:ade4ea4584ba96e39d2b34f1036d8cb40ff2e9609a090562cfd2b8837dc7f828"},
{file = "winrt_Windows.Foundation.Collections-2.2.0-cp312-cp312-win_amd64.whl", hash = "sha256:1e896291c5efe0566db84eab13888bee7300392a6811ae85c55ced51bac0b147"},
{file = "winrt_Windows.Foundation.Collections-2.2.0-cp312-cp312-win_arm64.whl", hash = "sha256:e44e13027597fcc638073459dcc159a21c57f9dbe0e9a2282326e32386c25bd0"},
{file = "winrt_Windows.Foundation.Collections-2.2.0-cp313-cp313-win32.whl", hash = "sha256:ea7fa3a7ecb754eb09408e7127cd960d316cc1ba60a6440e191a81f14b42265c"},
{file = "winrt_Windows.Foundation.Collections-2.2.0-cp313-cp313-win_amd64.whl", hash = "sha256:f338860e27a8a67b386273c73ad10c680a9f40a42e0185cc6443d208a7425ece"},
{file = "winrt_Windows.Foundation.Collections-2.2.0-cp313-cp313-win_arm64.whl", hash = "sha256:dd705d4c62bd8c109f2bc667a0c76dc30ef9a1b2ced3e7bd95253a31e39781df"},
{file = "winrt_Windows.Foundation.Collections-2.2.0-cp39-cp39-win32.whl", hash = "sha256:6798595621ad58473fe9e86f5f58d732628d88f06535b68c4d86cb5aed78f2b3"},
{file = "winrt_Windows.Foundation.Collections-2.2.0-cp39-cp39-win_amd64.whl", hash = "sha256:c8ac098a60dad586e950a8236bab09ae57b6a08147d36db6b0aed135a9a81831"},
{file = "winrt_Windows.Foundation.Collections-2.2.0-cp39-cp39-win_arm64.whl", hash = "sha256:c67105ebd88faf10d2941516c0ea9f73d9282fb8a7d2a73163a7a7e013bba839"},
{file = "winrt_windows_foundation_collections-2.2.0.tar.gz", hash = "sha256:10db64da49185af3e14465cd65ec4055eb122a96daedb73b774889f3b7fcfa63"},
]
[package.dependencies]
winrt-runtime = "2.2.0"
[package.extras]
all = ["winrt-Windows.Foundation[all] (==2.2.0)"]
[[package]]
name = "winrt-windows-storage-streams"
version = "2.2.0"
description = "Python projection of Windows Runtime (WinRT) APIs"
optional = false
python-versions = "<3.14,>=3.9"
groups = ["main"]
markers = "platform_system == \"Windows\" and python_version >= \"3.12\""
files = [
{file = "winrt_Windows.Storage.Streams-2.2.0-cp310-cp310-win32.whl", hash = "sha256:e888ae08f1245f8b6d53783487581fc664683bb29778f2acca6bafb6a78bcc22"},
{file = "winrt_Windows.Storage.Streams-2.2.0-cp310-cp310-win_amd64.whl", hash = "sha256:9213576d566398657142372aa34354b9f7b8ce0581cff308c7afbc0d908368a1"},
{file = "winrt_Windows.Storage.Streams-2.2.0-cp310-cp310-win_arm64.whl", hash = "sha256:49d2bdd749994fb81c813f02f3c506fff580f358083b65a123308f322c2fe6cf"},
{file = "winrt_Windows.Storage.Streams-2.2.0-cp311-cp311-win32.whl", hash = "sha256:db4ebe7ed79a585a1bb78a3f8cea05f7d74a6a8bc913f61b31ddfe3ae10d134d"},
{file = "winrt_Windows.Storage.Streams-2.2.0-cp311-cp311-win_amd64.whl", hash = "sha256:f9f77c5398eb90c58645c62b6f278f701d2636c0007817cc6fc28256adbebdcb"},
{file = "winrt_Windows.Storage.Streams-2.2.0-cp311-cp311-win_arm64.whl", hash = "sha256:894c2616eeae887275a1a64a4233964f9466ee1281b8c11ec7c06d64aafec88a"},
{file = "winrt_Windows.Storage.Streams-2.2.0-cp312-cp312-win32.whl", hash = "sha256:85a2eefb2935db92d10b8e9be836c431d47298b566b55da633b11f822c63838d"},
{file = "winrt_Windows.Storage.Streams-2.2.0-cp312-cp312-win_amd64.whl", hash = "sha256:f88cdc6204219c7f1b58d793826ea2eff013a45306fbb340d61c10896c237547"},
{file = "winrt_Windows.Storage.Streams-2.2.0-cp312-cp312-win_arm64.whl", hash = "sha256:78af200d0db5ebe151b1df194de97f1e71c2d5f5cba4da09798c15402f4ab91d"},
{file = "winrt_Windows.Storage.Streams-2.2.0-cp313-cp313-win32.whl", hash = "sha256:6408184ba5d17e0d408d7c0b85357a58f13c775521d17a8730f1a680553e0061"},
{file = "winrt_Windows.Storage.Streams-2.2.0-cp313-cp313-win_amd64.whl", hash = "sha256:ad9cd8e97cf4115ba074ec153ab273c370e690abb010d8b3b970339d20f94321"},
{file = "winrt_Windows.Storage.Streams-2.2.0-cp313-cp313-win_arm64.whl", hash = "sha256:c467cf04005b72efd769ea99c7c15973db44d5ac6084a7c7714af85e49981abd"},
{file = "winrt_Windows.Storage.Streams-2.2.0-cp39-cp39-win32.whl", hash = "sha256:f72559b5de7c3a0cab97cd50ab594a0e3278df4d38e03f79b5b2d2e13e926c4c"},
{file = "winrt_Windows.Storage.Streams-2.2.0-cp39-cp39-win_amd64.whl", hash = "sha256:37bf5bb801aa1e4a4c6f3ddfe2b8c9b05d7726ebfdfc8b9bfe41bdcc3866749b"},
{file = "winrt_Windows.Storage.Streams-2.2.0-cp39-cp39-win_arm64.whl", hash = "sha256:2dcab77a7affb1136503edec82a755b82716abd882fadd5f50ce260438b9c21b"},
{file = "winrt_windows_storage_streams-2.2.0.tar.gz", hash = "sha256:46a8718c4e00a129d305f03571789f4bed530c05e135c2476494af93f374b68a"},
]
[package.dependencies]
winrt-runtime = "2.2.0"
[package.extras]
all = ["winrt-Windows.Foundation.Collections[all] (==2.2.0)", "winrt-Windows.Foundation[all] (==2.2.0)", "winrt-Windows.Storage[all] (==2.2.0)", "winrt-Windows.System[all] (==2.2.0)"]
[metadata]
lock-version = "2.1"
python-versions = ">=3.10,<3.14"
content-hash = "150043315f0f6f9e8cd06670e8ceaa20217096ce4dfadc7d2fc42c4e7a5fabc4"
bleak-retry-connector-3.8.1/pyproject.toml 0000664 0000000 0000000 00000004774 14750422166 0020673 0 ustar 00root root 0000000 0000000 [project]
name = "bleak-retry-connector"
version = "3.8.1"
description = "A connector for Bleak Clients that handles transient connection failures"
authors = [{ name = "J. Nick Koston", email = "nick@koston.org" }]
license = "MIT"
readme = "README.md"
requires-python = ">=3.10"
dynamic = ["classifiers", "dependencies"]
[project.urls]
"Documentation" = "https://bleak-retry-connector.readthedocs.io"
"Repository" = "https://github.com/bluetooth-devices/bleak-retry-connector"
"Bug Tracker" = "https://github.com/bluetooth-devices/bleak-retry-connector/issues"
"Changelog" = "https://github.com/bluetooth-devices/bleak-retry-connector/blob/main/CHANGELOG.md"
[tool.poetry]
classifiers = [
"Development Status :: 2 - Pre-Alpha",
"Intended Audience :: Developers",
"Natural Language :: English",
"Operating System :: OS Independent",
"Topic :: Software Development :: Libraries",
]
packages = [
{ include = "bleak_retry_connector", from = "src" },
]
[tool.poetry.dependencies]
python = ">=3.10,<3.14"
# Documentation Dependencies
bleak = ">=0.21.0"
async-timeout = {version = ">=3.0.0", python = "<3.11"}
dbus-fast = {version = ">=1.14.0", markers = "platform_system == \"Linux\""}
bluetooth-adapters = {version = ">=0.15.2", markers = "platform_system == \"Linux\""}
[tool.poetry.group.dev.dependencies]
dbus-fast = ">=1.4.0"
pytest = "^8.3"
pytest-cov = "^6.0"
pytest-asyncio = "^0.25.3"
[tool.semantic_release]
branch = "main"
version_toml = "pyproject.toml:project.version"
version_variable = "src/bleak_retry_connector/__init__.py:__version__"
build_command = "pip install poetry && poetry build"
[tool.pytest.ini_options]
addopts = "-v -Wdefault --cov=bleak_retry_connector --cov-report=term-missing:skip-covered"
pythonpath = ["src"]
[tool.coverage.run]
branch = true
[tool.coverage.report]
exclude_lines = [
"pragma: no cover",
"@overload",
"if TYPE_CHECKING",
"raise NotImplementedError",
]
[tool.isort]
profile = "black"
known_first_party = ["bleak_retry_connector", "tests"]
[tool.mypy]
check_untyped_defs = true
disallow_any_generics = true
disallow_incomplete_defs = true
disallow_untyped_defs = true
mypy_path = "src/"
no_implicit_optional = true
show_error_codes = true
warn_unreachable = true
warn_unused_ignores = true
exclude = [
'docs/.*',
'setup.py',
]
[[tool.mypy.overrides]]
module = "tests.*"
allow_untyped_defs = true
[[tool.mypy.overrides]]
module = "docs.*"
ignore_errors = true
[build-system]
requires = ["poetry-core>=2.0.0"]
build-backend = "poetry.core.masonry.api"
bleak-retry-connector-3.8.1/renovate.json 0000664 0000000 0000000 00000000101 14750422166 0020451 0 ustar 00root root 0000000 0000000 {
"extends": ["github>browniebroke/renovate-configs:python"]
}
bleak-retry-connector-3.8.1/setup.py 0000664 0000000 0000000 00000000373 14750422166 0017460 0 ustar 00root root 0000000 0000000 #!/usr/bin/env python
# This is a shim to allow GitHub to detect the package, build is done with poetry
# Taken from https://github.com/Textualize/rich
import setuptools
if __name__ == "__main__":
setuptools.setup(name="bleak-retry-connector")
bleak-retry-connector-3.8.1/src/ 0000775 0000000 0000000 00000000000 14750422166 0016532 5 ustar 00root root 0000000 0000000 bleak-retry-connector-3.8.1/src/bleak_retry_connector/ 0000775 0000000 0000000 00000000000 14750422166 0023107 5 ustar 00root root 0000000 0000000 bleak-retry-connector-3.8.1/src/bleak_retry_connector/__init__.py 0000664 0000000 0000000 00000044700 14750422166 0025225 0 ustar 00root root 0000000 0000000 from __future__ import annotations
__version__ = "3.8.1"
import asyncio
import logging
from collections.abc import Awaitable, Callable
from typing import Any, ParamSpec, TypeVar
from bleak import BleakClient, BleakScanner
from bleak.backends.device import BLEDevice
from bleak.backends.service import BleakGATTServiceCollection
from bleak.exc import BleakDBusError, BleakDeviceNotFoundError, BleakError
from .bluez import ( # noqa: F401
AllocationChange,
AllocationChangeEvent,
Allocations,
BleakSlotManager,
_get_properties,
clear_cache,
device_source,
get_connected_devices,
get_device,
get_device_by_adapter,
wait_for_device_to_reappear,
wait_for_disconnect,
)
from .const import IS_LINUX, NO_RSSI_VALUE, RSSI_SWITCH_THRESHOLD
from .util import asyncio_timeout
DISCONNECT_TIMEOUT = 5
DEFAULT_ATTEMPTS = 2
if IS_LINUX:
from bluetooth_adapters import load_history_from_managed_objects
from .dbus import disconnect_devices
else:
load_history_from_managed_objects = None
disconnect_devices = None # type: ignore[assignment]
# Make sure bleak and dbus-fast have time
# to run their cleanup callbacks or the
# retry call will just fail in the same way.
BLEAK_TRANSIENT_BACKOFF_TIME = 0.25
BLEAK_TRANSIENT_MEDIUM_BACKOFF_TIME = 0.50
BLEAK_TRANSIENT_LONG_BACKOFF_TIME = 1.0
BLEAK_DBUS_BACKOFF_TIME = 0.25
BLEAK_OUT_OF_SLOTS_BACKOFF_TIME = 4.00
BLEAK_BACKOFF_TIME = 0.1
# Expected disconnect or ran out of slots
# after checking, don't backoff since we
# want to retry immediately.
BLEAK_DISCONNECTED_BACKOFF_TIME = 0.0
__all__ = [
"BleakSlotManager", # Currently only possible for BlueZ, for MacOS we have no of knowing
"ble_device_description",
"establish_connection",
"close_stale_connections",
"close_stale_connections_by_address",
"clear_cache",
"get_device",
"get_device_by_adapter",
"device_source",
"restore_discoveries",
"retry_bluetooth_connection_error",
"BleakClientWithServiceCache",
"BleakAbortedError",
"BleakNotFoundError",
"BLEAK_RETRY_EXCEPTIONS",
"RSSI_SWITCH_THRESHOLD",
"NO_RSSI_VALUE",
]
BLEAK_EXCEPTIONS = (AttributeError, BleakError)
BLEAK_RETRY_EXCEPTIONS = (
*BLEAK_EXCEPTIONS,
EOFError,
BrokenPipeError,
asyncio.TimeoutError,
)
_LOGGER = logging.getLogger(__name__)
MAX_TRANSIENT_ERRORS = 9
# Shorter time outs and more attempts
# seems to be better for dbus, and corebluetooth
# is happy either way. Ideally we want everything
# to finish in < 60s or declare we cannot connect
MAX_CONNECT_ATTEMPTS = 4
BLEAK_TIMEOUT = 20.0
# Bleak may not always timeout
# since the dbus connection can stall
# so we have an additional timeout to
# be sure we do not block forever
# This is likely fixed in https://github.com/hbldh/bleak/pull/1092
#
# This also accounts for the time it
# takes for the esp32s to disconnect
#
BLEAK_SAFETY_TIMEOUT = 60.0
TRANSIENT_ERRORS_LONG_BACKOFF = {
"ESP_GATT_ERROR",
}
TRANSIENT_ERRORS_MEDIUM_BACKOFF = {
"ESP_GATT_CONN_TIMEOUT",
"ESP_GATT_CONN_FAIL_ESTABLISH",
}
DEVICE_MISSING_ERRORS = {"org.freedesktop.DBus.Error.UnknownObject"}
OUT_OF_SLOTS_ERRORS = {"available connection", "connection slot"}
TRANSIENT_ERRORS = {
"le-connection-abort-by-local",
"br-connection-canceled",
"ESP_GATT_CONN_FAIL_ESTABLISH",
"ESP_GATT_CONN_TERMINATE_PEER_USER",
"ESP_GATT_CONN_TERMINATE_LOCAL_HOST",
"ESP_GATT_CONN_CONN_CANCEL",
} | OUT_OF_SLOTS_ERRORS
# Currently the same as transient error
ABORT_ERRORS = (
TRANSIENT_ERRORS | TRANSIENT_ERRORS_MEDIUM_BACKOFF | TRANSIENT_ERRORS_LONG_BACKOFF
)
ABORT_ADVICE = (
"Interference/range; "
"External Bluetooth adapter w/extension may help; "
"Extension cables reduce USB 3 port interference"
)
DEVICE_MISSING_ADVICE = (
"The device disappeared; " "Try restarting the scanner or moving the device closer"
)
OUT_OF_SLOTS_ADVICE = (
"The proxy/adapter is out of connection slots or the device is no longer reachable; "
"Add additional proxies (https://esphome.github.io/bluetooth-proxies/) near this device"
)
NORMAL_DISCONNECT = "Disconnected"
class BleakNotFoundError(BleakError):
"""The device was not found."""
class BleakConnectionError(BleakError):
"""The device was not found."""
class BleakAbortedError(BleakError):
"""The connection was aborted."""
class BleakOutOfConnectionSlotsError(BleakError):
"""The proxy/adapter is out of connection slots."""
class BleakClientWithServiceCache(BleakClient):
"""A BleakClient that implements service caching."""
def set_cached_services(self, services: BleakGATTServiceCollection | None) -> None:
"""Set the cached services.
No longer used since bleak 0.17+ has service caching built-in.
This was only kept for backwards compatibility.
"""
async def clear_cache(self) -> bool:
"""Clear the cached services."""
if hasattr(super(), "clear_cache"):
return await super().clear_cache()
_LOGGER.warning("clear_cache not implemented in bleak version")
return False
def ble_device_has_changed(original: BLEDevice, new: BLEDevice) -> bool:
"""Check if the device has changed."""
return bool(
original.address != new.address
or (
isinstance(original.details, dict)
and isinstance(new.details, dict)
and "path" in original.details
and "path" in new.details
and original.details["path"] != new.details["path"]
)
)
def ble_device_description(device: BLEDevice) -> str:
"""Get the device description."""
details = device.details
address = device.address
name = device.name
if name != address:
base_name = f"{address} - {name}"
else:
base_name = address
if isinstance(details, dict):
if path := details.get("path"):
# /org/bluez/hci2
return f"{base_name} -> {path[0:15]}"
if source := details.get("source"):
return f"{base_name} -> {source}"
return base_name
def calculate_backoff_time(exc: Exception) -> float:
"""Calculate the backoff time based on the exception."""
if isinstance(
exc, (BleakDBusError, EOFError, asyncio.TimeoutError, BrokenPipeError)
):
return BLEAK_DBUS_BACKOFF_TIME
# If the adapter runs out of slots can get a BleakDeviceNotFoundError
# since the device is no longer visible on the adapter. Almost none of
# the adapters document how many connection slots they have so we cannot
# know if we are out of slots or not. We can only guess based on the
# error message and backoff.
if isinstance(exc, (BleakDeviceNotFoundError, BleakNotFoundError)):
return BLEAK_OUT_OF_SLOTS_BACKOFF_TIME
if isinstance(exc, BleakError):
bleak_error = str(exc)
if any(error in bleak_error for error in OUT_OF_SLOTS_ERRORS):
return BLEAK_OUT_OF_SLOTS_BACKOFF_TIME
if any(error in bleak_error for error in TRANSIENT_ERRORS_MEDIUM_BACKOFF):
return BLEAK_TRANSIENT_MEDIUM_BACKOFF_TIME
if any(error in bleak_error for error in TRANSIENT_ERRORS_LONG_BACKOFF):
return BLEAK_TRANSIENT_LONG_BACKOFF_TIME
if any(error in bleak_error for error in TRANSIENT_ERRORS):
return BLEAK_TRANSIENT_BACKOFF_TIME
if NORMAL_DISCONNECT in bleak_error:
return BLEAK_DISCONNECTED_BACKOFF_TIME
return BLEAK_BACKOFF_TIME
async def _disconnect_devices(devices: list[BLEDevice]) -> None:
"""Disconnect the devices."""
if IS_LINUX:
await disconnect_devices(devices)
async def close_stale_connections_by_address(
address: str, only_other_adapters: bool = False
) -> None:
"""Close stale connections by address."""
if not IS_LINUX or not (device := await get_device(address)):
return
await close_stale_connections(device, only_other_adapters)
async def close_stale_connections(
device: BLEDevice, only_other_adapters: bool = False
) -> None:
"""Close stale connections."""
if not IS_LINUX or not (devices := await get_connected_devices(device)):
return
to_disconnect: list[BLEDevice] = []
for connected_device in devices:
if only_other_adapters and not ble_device_has_changed(connected_device, device):
_LOGGER.debug(
"%s - %s: unexpectedly connected, not disconnecting since only_other_adapters is set",
connected_device.name,
connected_device.address,
)
else:
_LOGGER.debug(
"%s - %s: unexpectedly connected, disconnecting",
connected_device.name,
connected_device.address,
)
to_disconnect.append(connected_device)
if not to_disconnect:
return
await _disconnect_devices(to_disconnect)
AnyBleakClient = TypeVar("AnyBleakClient", bound=BleakClient)
async def establish_connection(
client_class: type[AnyBleakClient],
device: BLEDevice,
name: str,
disconnected_callback: Callable[[AnyBleakClient], None] | None = None,
max_attempts: int = MAX_CONNECT_ATTEMPTS,
cached_services: BleakGATTServiceCollection | None = None,
ble_device_callback: Callable[[], BLEDevice] | None = None,
use_services_cache: bool = True,
**kwargs: Any,
) -> AnyBleakClient:
"""Establish a connection to the device."""
timeouts = 0
connect_errors = 0
transient_errors = 0
attempt = 0
def _raise_if_needed(name: str, description: str, exc: Exception) -> None:
"""Raise if we reach the max attempts."""
if (
timeouts + connect_errors < max_attempts
and transient_errors < MAX_TRANSIENT_ERRORS
):
return
msg = (
f"{name} - {description}: Failed to connect after "
f"{attempt} attempt(s): {str(exc) or type(exc).__name__}"
)
# Sure would be nice if bleak gave us typed exceptions
if isinstance(exc, asyncio.TimeoutError):
raise BleakNotFoundError(msg) from exc
if isinstance(exc, BleakDeviceNotFoundError) or "not found" in str(exc):
raise BleakNotFoundError(f"{msg}: {DEVICE_MISSING_ADVICE}") from exc
if isinstance(exc, BleakError):
if any(error in str(exc) for error in OUT_OF_SLOTS_ERRORS):
raise BleakOutOfConnectionSlotsError(
f"{msg}: {OUT_OF_SLOTS_ADVICE}"
) from exc
if any(error in str(exc) for error in ABORT_ERRORS):
raise BleakAbortedError(f"{msg}: {ABORT_ADVICE}") from exc
if any(error in str(exc) for error in DEVICE_MISSING_ERRORS):
raise BleakNotFoundError(f"{msg}: {DEVICE_MISSING_ADVICE}") from exc
raise BleakConnectionError(msg) from exc
debug_enabled = _LOGGER.isEnabledFor(logging.DEBUG)
rssi: int | None = None
if IS_LINUX and (devices := await get_connected_devices(device)):
# Bleak 0.17 will handle already connected devices for us so
# if we are already connected we swap the device to the connected
# device.
device = devices[0]
client = client_class(device, disconnected_callback=disconnected_callback, **kwargs)
while True:
attempt += 1
if debug_enabled:
_LOGGER.debug(
"%s - %s: Connection attempt: %s",
name,
device.address,
attempt,
)
try:
async with asyncio_timeout(BLEAK_SAFETY_TIMEOUT):
await client.connect(
timeout=BLEAK_TIMEOUT,
dangerous_use_bleak_cache=use_services_cache
or bool(cached_services),
)
if debug_enabled:
_LOGGER.debug(
"%s - %s: Connected after %s attempts",
name,
device.address,
attempt,
)
except asyncio.TimeoutError as exc:
timeouts += 1
if debug_enabled:
_LOGGER.debug(
"%s - %s: Timed out trying to connect (attempt: %s, last rssi: %s)",
name,
device.address,
attempt,
rssi,
)
backoff_time = calculate_backoff_time(exc)
await wait_for_disconnect(device, backoff_time)
_raise_if_needed(name, device.address, exc)
except KeyError as exc:
# Likely: KeyError: 'org.bluez.GattService1' from bleak
# ideally we would get a better error from bleak, but this is
# better than nothing.
# self._properties[service_path][defs.GATT_SERVICE_INTERFACE]
transient_errors += 1
if debug_enabled:
_LOGGER.debug(
"%s - %s: Failed to connect due to services changes: %s (attempt: %s, last rssi: %s)",
name,
device.address,
str(exc),
attempt,
rssi,
)
if isinstance(client, BleakClientWithServiceCache):
await client.clear_cache()
await client.disconnect()
backoff_time = calculate_backoff_time(exc)
await wait_for_disconnect(device, backoff_time)
_raise_if_needed(name, device.address, exc)
except BrokenPipeError as exc:
# BrokenPipeError is raised by dbus-next when the device disconnects
#
# bleak.exc.BleakDBusError: [org.bluez.Error] le-connection-abort-by-local
# During handling of the above exception, another exception occurred:
# Traceback (most recent call last):
# File "bleak/backends/bluezdbus/client.py", line 177, in connect
# reply = await self._bus.call(
# File "dbus_next/aio/message_bus.py", line 63, in write_callback
# self.offset += self.sock.send(self.buf[self.offset:])
# BrokenPipeError: [Errno 32] Broken pipe
transient_errors += 1
if debug_enabled:
_LOGGER.debug(
"%s - %s: Failed to connect: %s (attempt: %s, last rssi: %s)",
name,
device.address,
str(exc),
attempt,
rssi,
)
_raise_if_needed(name, device.address, exc)
except EOFError as exc:
transient_errors += 1
backoff_time = calculate_backoff_time(exc)
if debug_enabled:
_LOGGER.debug(
"%s - %s: Failed to connect: %s, backing off: %s (attempt: %s, last rssi: %s)",
name,
device.address,
str(exc),
backoff_time,
attempt,
rssi,
)
await wait_for_disconnect(device, backoff_time)
_raise_if_needed(name, device.address, exc)
except BLEAK_EXCEPTIONS as exc:
bleak_error = str(exc)
# BleakDeviceNotFoundError can mean that the adapter has run out of
# connection slots.
device_missing = isinstance(
exc, (BleakNotFoundError, BleakDeviceNotFoundError)
)
if device_missing or any(
error in bleak_error for error in TRANSIENT_ERRORS
):
transient_errors += 1
else:
connect_errors += 1
backoff_time = calculate_backoff_time(exc)
if debug_enabled:
_LOGGER.debug(
"%s - %s: Failed to connect: %s, device_missing: %s, backing off: %s (attempt: %s, last rssi: %s)",
name,
device.address,
bleak_error,
device_missing,
backoff_time,
attempt,
rssi,
)
await wait_for_disconnect(device, backoff_time)
_raise_if_needed(name, device.address, exc)
else:
return client
# Ensure the disconnect callback
# has a chance to run before we try to reconnect
await asyncio.sleep(0)
raise RuntimeError("This should never happen")
P = ParamSpec("P")
T = TypeVar("T")
def retry_bluetooth_connection_error(
attempts: int = DEFAULT_ATTEMPTS,
) -> Callable[[Callable[P, Awaitable[T]]], Callable[P, Awaitable[T]]]:
"""Define a wrapper to retry on bluetooth connection error."""
def _decorator_retry_bluetooth_connection_error(
func: Callable[P, Awaitable[T]],
) -> Callable[P, Awaitable[T]]:
"""Define a wrapper to retry on bleak error.
The accessory is allowed to disconnect us any time so
we need to retry the operation.
"""
async def _async_wrap_bluetooth_connection_error_retry( # type: ignore[return]
*args: P.args, **kwargs: P.kwargs
) -> T:
for attempt in range(attempts):
try:
return await func(*args, **kwargs)
except BLEAK_EXCEPTIONS as ex:
backoff_time = calculate_backoff_time(ex)
if attempt == attempts - 1:
raise
_LOGGER.debug(
"Bleak error calling %s, backing off: %s, retrying...",
func,
backoff_time,
exc_info=True,
)
await asyncio.sleep(backoff_time)
return _async_wrap_bluetooth_connection_error_retry
return _decorator_retry_bluetooth_connection_error
async def restore_discoveries(scanner: BleakScanner, adapter: str) -> None:
"""Restore discoveries from the bus."""
if not IS_LINUX:
# This is only supported on Linux
return
if not (properties := await _get_properties()):
_LOGGER.debug("Failed to restore discoveries for %s", adapter)
return
backend = scanner._backend
before = len(backend.seen_devices)
backend.seen_devices.update(
{
address: (history.device, history.advertisement_data)
for address, history in load_history_from_managed_objects(
properties, adapter
).items()
}
)
_LOGGER.debug(
"Restored %s discoveries for %s", len(backend.seen_devices) - before, adapter
)
bleak-retry-connector-3.8.1/src/bleak_retry_connector/bleak_manager.py 0000664 0000000 0000000 00000004364 14750422166 0026240 0 ustar 00root root 0000000 0000000 from __future__ import annotations
import asyncio
import contextlib
import logging
from .const import DBUS_CONNECT_TIMEOUT, IS_LINUX
from .util import asyncio_timeout
_LOGGER = logging.getLogger(__name__)
_global_instances: dict[asyncio.AbstractEventLoop, BlueZManager] | None = None
if IS_LINUX:
with contextlib.suppress(ImportError): # pragma: no cover
from bleak.backends.bluezdbus.manager import ( # pragma: no cover
BlueZManager,
get_global_bluez_manager,
)
with contextlib.suppress(ImportError): # pragma: no cover
from bleak.backends.bluezdbus.manager import ( # type: ignore[no-redef] # pragma: no cover
_global_instances,
)
async def get_global_bluez_manager_with_timeout() -> BlueZManager | None:
"""Get the properties."""
if not IS_LINUX:
return None
loop = asyncio.get_running_loop()
if _global_instances and (manager := _global_instances.get(loop)):
return manager
if (
getattr(get_global_bluez_manager_with_timeout, "_has_dbus_socket", None)
is False
):
# We are not running on a system with DBus do don't
# keep trying to call get_global_bluez_manager as it
# waits for a bit trying to connect to DBus.
return None
try:
async with asyncio_timeout(DBUS_CONNECT_TIMEOUT):
return await get_global_bluez_manager()
except FileNotFoundError as ex:
setattr(get_global_bluez_manager_with_timeout, "_has_dbus_socket", False)
_LOGGER.debug(
"Dbus socket at %s not found, will not try again until next restart: %s",
ex.filename,
ex,
)
except asyncio.TimeoutError:
setattr(get_global_bluez_manager_with_timeout, "_has_dbus_socket", False)
_LOGGER.debug(
"Timed out trying to connect to DBus; will not try again until next restart"
)
except Exception as ex: # pylint: disable=broad-except
_LOGGER.debug(
"get_global_bluez_manager_with_timeout failed: %s", ex, exc_info=True
)
return None
def _reset_dbus_socket_cache() -> None:
"""Reset the dbus socket cache."""
setattr(get_global_bluez_manager_with_timeout, "_has_dbus_socket", None)
bleak-retry-connector-3.8.1/src/bleak_retry_connector/bluez.py 0000664 0000000 0000000 00000044605 14750422166 0024613 0 ustar 00root root 0000000 0000000 from __future__ import annotations
import asyncio
import contextlib
import logging
import time
from collections.abc import Callable, Generator
from dataclasses import dataclass
from enum import Enum
from functools import partial
from typing import Any
from bleak.backends.device import BLEDevice
from bleak.exc import BleakError
from .bleak_manager import get_global_bluez_manager_with_timeout
from .const import (
DISCONNECT_TIMEOUT,
IS_LINUX,
NO_RSSI_VALUE,
REAPPEAR_WAIT_INTERVAL,
RSSI_SWITCH_THRESHOLD,
)
from .util import asyncio_timeout
if IS_LINUX:
from dbus_fast.message import Message
_LOGGER = logging.getLogger(__name__)
if IS_LINUX:
with contextlib.suppress(ImportError): # pragma: no cover
from bleak.backends.bluezdbus import defs # pragma: no cover
from bleak.backends.bluezdbus.manager import ( # pragma: no cover
BlueZManager,
DeviceWatcher,
)
class AllocationChange(Enum):
"""Allocation change."""
ALLOCATED = 1
RELEASED = 2
@dataclass(slots=True)
class AllocationChangeEvent:
change: AllocationChange
path: str | None # D-Bus object path of the device
adapter: str # Adapter/Controller (hciX)
address: str # Address of the remote BLE device
@dataclass(slots=True)
class Allocations:
adapter: str # Adapter/Controller (hciX)
slots: int # Number of slots
free: int # Number of free slots
allocated: list[str] # Addresses of connected devices
def device_source(device: BLEDevice) -> str | None:
"""Return the device source."""
return _device_details_value_or_none(device, "source")
def _device_details_value_or_none(device: BLEDevice, key: str) -> Any | None:
"""Return a value from device details or None."""
details = device.details
if not isinstance(details, dict) or key not in details:
return None
key_value: str = device.details[key]
return key_value
def adapter_from_path(path: str) -> str:
"""Get the adapter from a ble device path."""
return path.split("/")[3]
def address_from_path(path: str) -> str:
"""Get the address from a ble device path."""
return path.split("/")[-1].removeprefix("dev_").replace("_", ":").upper()
def path_from_ble_device(device: BLEDevice) -> str | None:
"""Get the adapter from a ble device."""
return _device_details_value_or_none(device, "path")
def _on_characteristic_value_changed(*args: Any, **kwargs: Any) -> None:
"""Dummy callback for registering characteristic value changed."""
class BleakSlotManager:
"""A class to manage the connection slots."""
def __init__(self) -> None:
"""Initialize the class."""
self._adapter_slots: dict[str, int] = {}
self._allocations_by_adapter: dict[str, dict[str, DeviceWatcher]] = {}
self._manager: BlueZManager | None = None
self._callbacks: set[Callable[[AllocationChangeEvent], None]] = set()
async def async_setup(self) -> None:
"""Set up the class."""
self._manager = await get_global_bluez_manager_with_timeout()
def diagnostics(self) -> dict[str, Any]:
"""Return diagnostics."""
return {
"manager": self._manager is not None,
"adapter_slots": self._adapter_slots,
"allocations_by_adapter": {
adapter: self._get_allocations(adapter)
for adapter in self._adapter_slots
},
}
def get_allocations(self, adapter: str) -> Allocations:
"""Get the allocations."""
slots = self._adapter_slots.get(adapter, 0)
allocated = [
address_from_path(path) for path in self._allocations_by_adapter[adapter]
]
free = slots - len(allocated)
return Allocations(adapter, slots, free, allocated)
def _get_allocations(self, adapter: str) -> list[str]:
"""Get connected path allocations."""
if self._manager is None:
return []
return list(self._allocations_by_adapter[adapter])
def remove_adapter(self, adapter: str) -> None:
"""Remove an adapter."""
del self._adapter_slots[adapter]
watchers = self._allocations_by_adapter[adapter]
if self._manager is None:
return
for watcher in watchers.values():
self._manager.remove_device_watcher(watcher)
del self._allocations_by_adapter[adapter]
def register_allocation_callback(
self, callback: Callable[[AllocationChangeEvent], None]
) -> Callable[[], None]:
"""Register a callback for when allocations change."""
self._callbacks.add(callback)
return partial(self.unregister_allocation_callback, callback)
def unregister_allocation_callback(
self, callback: Callable[[AllocationChangeEvent], None]
) -> None:
"""Unregister a callback."""
self._callbacks.discard(callback)
def register_adapter(self, adapter: str, slots: int) -> None:
"""Register an adapter."""
self._allocations_by_adapter[adapter] = {}
self._adapter_slots[adapter] = slots
if self._manager is None:
return
for path, device in self._manager._properties.items():
if (
defs.DEVICE_INTERFACE in device
and device[defs.DEVICE_INTERFACE].get("Connected")
and adapter_from_path(path) == adapter
):
self._allocate_and_watch_slot(path)
def _allocate_and_watch_slot(self, path: str) -> None:
"""Setup a device watcher."""
assert self._manager is not None # nosec
adapter = adapter_from_path(path)
allocations = self._allocations_by_adapter[adapter]
def _on_device_connected_changed(connected: bool) -> None:
if not connected:
self._release_slot(path)
allocations[path] = self._manager.add_device_watcher(
path,
on_connected_changed=_on_device_connected_changed,
on_characteristic_value_changed=_on_characteristic_value_changed,
)
self._call_callbacks(AllocationChange.ALLOCATED, path)
def release_slot(self, device: BLEDevice) -> None:
"""Release a slot."""
if (
self._manager is None
or not (path := path_from_ble_device(device))
or self._manager.is_connected(path)
):
return
self._release_slot(path)
def _release_slot(self, path: str) -> None:
"""Unconditional release of the slot."""
assert self._manager is not None # nosec
adapter = adapter_from_path(path)
allocations = self._allocations_by_adapter[adapter]
if watcher := allocations.pop(path, None):
self._manager.remove_device_watcher(watcher)
self._call_callbacks(AllocationChange.RELEASED, path)
def _call_callbacks(self, change: AllocationChange, path: str) -> None:
"""Call the callbacks."""
for callback_ in self._callbacks:
try:
callback_(
AllocationChangeEvent(
change, path, adapter_from_path(path), address_from_path(path)
)
)
except Exception: # pylint
_LOGGER.exception("Error in callback")
def allocate_slot(self, device: BLEDevice) -> bool:
"""Allocate a slot."""
if (
self._manager is None
or not (path := path_from_ble_device(device))
or not (adapter := adapter_from_path(path))
or adapter not in self._allocations_by_adapter
):
return True
allocations = self._allocations_by_adapter[adapter]
if path in allocations:
# Already connected
return True
if len(allocations) >= self._adapter_slots[adapter]:
_LOGGER.debug(
"No slots available for %s (used by: %s)",
path,
self._get_allocations(adapter),
)
return False
self._allocate_and_watch_slot(path)
return True
async def _get_properties() -> dict[str, dict[str, dict[str, Any]]] | None:
"""Get the properties."""
if bluez_manager := await get_global_bluez_manager_with_timeout():
return bluez_manager._properties # pylint: disable=protected-access
return None
async def clear_cache(address: str) -> bool:
"""Clear the cache for a device."""
if not IS_LINUX or not await get_device(address):
return False
caches_cleared: list[str] = []
with contextlib.suppress(Exception):
if not (manager := await get_global_bluez_manager_with_timeout()):
_LOGGER.warning("Failed to clear cache for %s because no manager", address)
return False
services_cache = manager._services_cache
bluez_path = address_to_bluez_path(address)
for path in _get_possible_paths(bluez_path):
if services_cache.pop(path, None):
caches_cleared.append(path)
_LOGGER.debug("Cleared cache for %s: %s", address, caches_cleared)
async with asyncio_timeout(DISCONNECT_TIMEOUT):
for device_path in caches_cleared:
# Send since we are going to ignore errors
# in case the device is already gone
await manager._bus.send(
Message(
destination=defs.BLUEZ_SERVICE,
path=adapter_path_from_device_path(device_path),
interface=defs.ADAPTER_INTERFACE,
member="RemoveDevice",
signature="o",
body=[device_path],
)
)
return bool(caches_cleared)
def adapter_path_from_device_path(device_path: str) -> str:
"""
Scrape the adapter path from a D-Bus device path.
Args:
device_path: The D-Bus object path of the device.
Returns:
A D-Bus object path of the adapter.
"""
# /org/bluez/hci1/dev_FA_23_9D_AA_45_46
return device_path[:15]
async def wait_for_device_to_reappear(device: BLEDevice, wait_timeout: float) -> bool:
"""Wait for a device to reappear on the bus."""
await asyncio.sleep(0)
if (
not IS_LINUX
or not isinstance(device.details, dict)
or "path" not in device.details
or not (properties := await _get_properties())
):
await asyncio.sleep(wait_timeout)
return False
debug = _LOGGER.isEnabledFor(logging.DEBUG)
device_path = address_to_bluez_path(device.address)
for i in range(int(wait_timeout / REAPPEAR_WAIT_INTERVAL)):
for path in _get_possible_paths(device_path):
if path in properties and properties[path].get(defs.DEVICE_INTERFACE):
if debug:
_LOGGER.debug(
"%s - %s: Device re-appeared on bus after %s seconds as %s",
device.name,
device.address,
i * REAPPEAR_WAIT_INTERVAL,
path,
)
return True
if debug:
_LOGGER.debug(
"%s - %s: Waiting %s/%s for device to re-appear on bus",
device.name,
device.address,
(i + 1) * REAPPEAR_WAIT_INTERVAL,
wait_timeout,
)
await asyncio.sleep(REAPPEAR_WAIT_INTERVAL)
if debug:
_LOGGER.debug(
"%s - %s: Device did not re-appear on bus after %s seconds",
device.name,
device.address,
wait_timeout,
)
return False
async def wait_for_disconnect(device: BLEDevice, min_wait_time: float) -> None:
"""Wait for the device to disconnect.
After a connection failure, the device may not have
had time to disconnect so we wait for it to do so.
If we do not wait, we may end up connecting to the
same device again before it has had time to disconnect.
"""
if (
not IS_LINUX
or not isinstance(device.details, dict)
or "path" not in device.details
):
await asyncio.sleep(min_wait_time)
return
device_path = device.details["path"]
start = time.monotonic() if min_wait_time else 0
try:
if not (manager := await get_global_bluez_manager_with_timeout()):
_LOGGER.debug(
"%s - %s: Failed to wait for disconnect because no manager",
device.name,
device.address,
)
return
async with asyncio_timeout(DISCONNECT_TIMEOUT):
await manager._wait_condition(device_path, "Connected", False)
end = time.monotonic() if min_wait_time else 0
waited = end - start
_LOGGER.debug(
"%s - %s: Waited %s seconds to disconnect",
device.name,
device.address,
waited,
)
if min_wait_time and waited < min_wait_time:
await asyncio.sleep(min_wait_time - waited)
except (BleakError, KeyError) as ex:
# Device was removed from bus
#
# In testing it was found that most of the CSR adapters
# only support 5 slots and the broadcom only support 7 slots.
#
# When they run out of slots the device they are trying to
# connect to disappears from the bus so we must backoff
_LOGGER.debug(
"%s - %s: Device was removed from bus at %s, waiting %s for it to re-appear: (%s) %s",
device.name,
device.address,
device_path,
min_wait_time,
type(ex),
ex,
)
await wait_for_device_to_reappear(device, min_wait_time)
except Exception: # pylint: disable=broad-except
_LOGGER.debug(
"%s - %s: Failed waiting for disconnect at %s",
device.name,
device.address,
device_path,
exc_info=True,
)
async def get_device_by_adapter(address: str, adapter: str) -> BLEDevice | None:
"""Get the device by adapter and address."""
if not IS_LINUX:
return None
if not (properties := await _get_properties()):
return None
device_path = address_to_bluez_path(address, adapter)
if device_path in properties and (
device_props := properties[device_path].get(defs.DEVICE_INTERFACE)
):
return ble_device_from_properties(device_path, device_props)
return None
async def get_bluez_device(
name: str, path: str, rssi: int | None = None, _log_disappearance: bool = True
) -> BLEDevice | None:
"""Get a BLEDevice object for a BlueZ DBus path."""
best_path = device_path = path
rssi_to_beat: int = rssi or NO_RSSI_VALUE
if not (properties := await _get_properties()):
return None
if (
device_path not in properties
or defs.DEVICE_INTERFACE not in properties[device_path]
):
# device has disappeared so take
# anything over the current path
if _log_disappearance:
_LOGGER.debug("%s - %s: Device has disappeared", name, device_path)
rssi_to_beat = NO_RSSI_VALUE
for path in _get_possible_paths(device_path):
if path not in properties or not (
device_props := properties[path].get(defs.DEVICE_INTERFACE)
):
continue
if device_props.get("Connected"):
# device is connected so take it
_LOGGER.debug("%s - %s: Device is already connected", name, path)
if path == device_path:
# device is connected to the path we were given
# so we can just return None so it will be used
return None
return ble_device_from_properties(path, device_props)
if path == device_path:
# Device is not connected and is the original path
# so no need to check it since returning None will
# cause the device to be used anyways.
continue
alternate_device_rssi: int = device_props.get("RSSI") or NO_RSSI_VALUE
if (
rssi_to_beat != NO_RSSI_VALUE
and alternate_device_rssi - RSSI_SWITCH_THRESHOLD < rssi_to_beat
):
continue
best_path = path
_LOGGER.debug(
"%s - %s: Found path %s with better RSSI %s > %s",
name,
device_path,
path,
alternate_device_rssi,
rssi_to_beat,
)
rssi_to_beat = alternate_device_rssi
if best_path == device_path:
return None
return ble_device_from_properties(
best_path, properties[best_path][defs.DEVICE_INTERFACE]
)
async def get_connected_devices(device: BLEDevice) -> list[BLEDevice]:
"""Check if the device is connected."""
connected: list[BLEDevice] = []
if not isinstance(device.details, dict) or "path" not in device.details:
return connected
if not (properties := await _get_properties()):
return connected
device_path = device.details["path"]
for path in _get_possible_paths(device_path):
if path not in properties or defs.DEVICE_INTERFACE not in properties[path]:
continue
props = properties[path][defs.DEVICE_INTERFACE]
if props.get("Connected"):
connected.append(ble_device_from_properties(path, props))
return connected
async def get_device(address: str) -> BLEDevice | None:
"""Get the device."""
if not IS_LINUX:
return None
return await get_bluez_device(
address, address_to_bluez_path(address), _log_disappearance=False
)
def address_to_bluez_path(address: str, adapter: str | None = None) -> str:
"""Convert an address to a BlueZ path."""
return f"/org/bluez/{adapter or 'hciX'}/dev_{address.upper().replace(':', '_')}"
def _get_possible_paths(path: str) -> Generator[str]:
"""Get the possible paths."""
# The path is deterministic so we splice up the string
# /org/bluez/hci2/dev_FA_23_9D_AA_45_46
for i in range(0, 9):
yield f"{path[0:14]}{i}{path[15:]}"
def ble_device_from_properties(path: str, props: dict[str, Any]) -> BLEDevice:
"""Get a BLEDevice from a dict of properties."""
return BLEDevice(
props["Address"],
props["Alias"],
{"path": path, "props": props},
props.get("RSSI") or NO_RSSI_VALUE,
uuids=props.get("UUIDs", []),
manufacturer_data={
k: bytes(v) for k, v in props.get("ManufacturerData", {}).items()
},
)
bleak-retry-connector-3.8.1/src/bleak_retry_connector/const.py 0000664 0000000 0000000 00000000333 14750422166 0024606 0 ustar 00root root 0000000 0000000 from __future__ import annotations
import platform
IS_LINUX = platform.system() == "Linux"
NO_RSSI_VALUE = -127
RSSI_SWITCH_THRESHOLD = 5
DISCONNECT_TIMEOUT = 5
REAPPEAR_WAIT_INTERVAL = 0.5
DBUS_CONNECT_TIMEOUT = 8.5
bleak-retry-connector-3.8.1/src/bleak_retry_connector/dbus.py 0000664 0000000 0000000 00000002531 14750422166 0024417 0 ustar 00root root 0000000 0000000 from __future__ import annotations
import contextlib
from bleak.backends.bluezdbus import defs
from bleak.backends.device import BLEDevice
from dbus_fast.message import Message
from .bleak_manager import get_global_bluez_manager_with_timeout
from .const import DISCONNECT_TIMEOUT
from .util import asyncio_timeout
async def disconnect_devices(devices: list[BLEDevice]) -> None:
"""Disconnect a list of devices."""
valid_devices = [
device
for device in devices
if isinstance(device.details, dict) and "path" in device.details
]
if not valid_devices:
return
if not (bluez_manager := await get_global_bluez_manager_with_timeout()):
return
bus = bluez_manager._bus
for device in valid_devices:
# https://bleak.readthedocs.io/en/latest/troubleshooting.html#id4
# Try to remove the device as well in the hope that it will
# clear the disk cache of the device.
with contextlib.suppress(Exception):
async with asyncio_timeout(DISCONNECT_TIMEOUT):
await bus.call(
Message(
destination=defs.BLUEZ_SERVICE,
path=device.details["path"],
interface=defs.DEVICE_INTERFACE,
member="Disconnect",
)
)
bleak-retry-connector-3.8.1/src/bleak_retry_connector/py.typed 0000664 0000000 0000000 00000000000 14750422166 0024574 0 ustar 00root root 0000000 0000000 bleak-retry-connector-3.8.1/src/bleak_retry_connector/util.py 0000664 0000000 0000000 00000000430 14750422166 0024433 0 ustar 00root root 0000000 0000000 from __future__ import annotations
import sys
if sys.version_info[:2] < (3, 11):
from async_timeout import ( # noqa: F401 # pragma: no cover
timeout as asyncio_timeout,
)
else:
from asyncio import timeout as asyncio_timeout # noqa: F401 # pragma: no cover
bleak-retry-connector-3.8.1/tests/ 0000775 0000000 0000000 00000000000 14750422166 0017105 5 ustar 00root root 0000000 0000000 bleak-retry-connector-3.8.1/tests/__init__.py 0000664 0000000 0000000 00000000000 14750422166 0021204 0 ustar 00root root 0000000 0000000 bleak-retry-connector-3.8.1/tests/conftest.py 0000664 0000000 0000000 00000001504 14750422166 0021304 0 ustar 00root root 0000000 0000000 import logging
from unittest.mock import patch
import pytest
import bleak_retry_connector
@pytest.fixture(autouse=True)
def configure_test_logging(caplog):
caplog.set_level(logging.DEBUG)
@pytest.fixture()
def mock_linux():
with (
patch.object(bleak_retry_connector, "IS_LINUX", True),
patch.object(bleak_retry_connector.bluez, "IS_LINUX", True),
patch.object(bleak_retry_connector.bleak_manager, "IS_LINUX", True),
patch("bleak.backends.scanner.platform.system", return_value="Linux"),
):
yield
@pytest.fixture()
def mock_macos():
with (
patch.object(bleak_retry_connector, "IS_LINUX", False),
patch.object(bleak_retry_connector.bluez, "IS_LINUX", False),
patch.object(bleak_retry_connector.bleak_manager, "IS_LINUX", False),
):
yield
bleak-retry-connector-3.8.1/tests/test_bluez.py 0000664 0000000 0000000 00000046301 14750422166 0021643 0 ustar 00root root 0000000 0000000 from typing import Any
from unittest.mock import AsyncMock, patch
import pytest
from bleak.backends.bluezdbus import defs
from bleak.backends.bluezdbus.manager import DeviceWatcher
from bleak.backends.device import BLEDevice
import bleak_retry_connector
from bleak_retry_connector import (
AllocationChange,
AllocationChangeEvent,
Allocations,
BleakSlotManager,
device_source,
)
from bleak_retry_connector.bluez import (
adapter_path_from_device_path,
ble_device_from_properties,
path_from_ble_device,
wait_for_device_to_reappear,
)
pytestmark = pytest.mark.asyncio
async def test_slot_manager(mock_linux):
"""Test the slot manager"""
class FakeBluezManager:
def __init__(self):
self.watchers: set[DeviceWatcher] = set()
self._properties = {
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -30,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci1/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Connected": True,
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -79,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci2/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Connected": True,
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -80,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci3/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -31,
},
defs.GATT_SERVICE_INTERFACE: True,
},
}
def add_device_watcher(self, path: str, **kwargs: Any) -> DeviceWatcher:
"""Add a watcher for device changes."""
watcher = DeviceWatcher(path, **kwargs)
self.watchers.add(watcher)
return watcher
def remove_device_watcher(self, watcher: DeviceWatcher) -> None:
"""Remove a watcher for device changes."""
self.watchers.remove(watcher)
def is_connected(self, path: str) -> bool:
"""Check if device is connected."""
return False
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=FakeBluezManager()
)
bleak_retry_connector.bluez.defs = defs
slot_manager = BleakSlotManager()
await slot_manager.async_setup()
slot_manager.register_adapter("hci0", 1)
slot_manager.register_adapter("hci1", 2)
slot_manager.register_adapter("hci2", 1)
changes = []
def _failing_allocation_callback(event: AllocationChangeEvent) -> None:
raise Exception("Test")
def _allocation_callback(event: AllocationChangeEvent) -> None:
change = event.change
path = event.path
adapter = event.adapter
address = event.address
changes.append((change, path, adapter, address))
cancel_fail = slot_manager.register_allocation_callback(
_failing_allocation_callback
)
cancel = slot_manager.register_allocation_callback(_allocation_callback)
ble_device_hci2 = ble_device_from_properties(
"/org/bluez/hci2/dev_FA_23_9D_AA_45_45",
{
"Address": "FA:23:9D:AA:45:45",
"Alias": "FA:23:9D:AA:45:45",
"RSSI": -30,
},
)
ble_device_hci2_already_connected = ble_device_from_properties(
"/org/bluez/hci2/dev_FA_23_9D_AA_45_46",
{
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -30,
},
)
ble_device_hci0 = ble_device_from_properties(
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
{
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -30,
},
)
ble_device_hci0_2 = ble_device_from_properties(
"/org/bluez/hci0/dev_FA_23_9D_AA_45_47",
{
"Address": "FA:23:9D:AA:45:47",
"Alias": "FA:23:9D:AA:45:47",
"RSSI": -30,
},
)
assert slot_manager.allocate_slot(ble_device_hci2) is False
assert not changes
# Make sure we can allocate an already connected device
# since there is always a race condition between the
# slot manager and the device connecting
assert slot_manager.allocate_slot(ble_device_hci2_already_connected) is True
assert not changes
assert slot_manager.allocate_slot(ble_device_hci0) is True
assert changes == [
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
)
]
assert slot_manager._get_allocations("hci0") == [
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46"
]
assert slot_manager.get_allocations("hci0") == Allocations(
"hci0",
1,
0,
["FA:23:9D:AA:45:46"],
)
# Make sure we can allocate the same device again
assert slot_manager.allocate_slot(ble_device_hci0) is True
assert changes == [
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
]
assert slot_manager._get_allocations("hci0") == [
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46"
]
assert slot_manager.get_allocations("hci0") == Allocations(
"hci0",
1,
0,
["FA:23:9D:AA:45:46"],
)
assert slot_manager.allocate_slot(ble_device_hci0_2) is False
assert changes == [
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
]
assert slot_manager._get_allocations("hci0") == [
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46"
]
assert slot_manager.get_allocations("hci0") == Allocations(
"hci0",
1,
0,
["FA:23:9D:AA:45:46"],
)
watcher: DeviceWatcher = slot_manager._allocations_by_adapter["hci0"][
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46"
]
watcher.on_connected_changed(True)
assert slot_manager._get_allocations("hci0") == [
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46"
]
assert slot_manager.get_allocations("hci0") == Allocations(
"hci0",
1,
0,
["FA:23:9D:AA:45:46"],
)
assert changes == [
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
]
watcher.on_connected_changed(False)
assert changes == [
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.RELEASED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
]
assert slot_manager._get_allocations("hci0") == []
assert slot_manager.get_allocations("hci0") == Allocations(
"hci0",
1,
1,
[],
)
assert slot_manager.allocate_slot(ble_device_hci0) is True
assert slot_manager._get_allocations("hci0") == [
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46"
]
assert slot_manager.get_allocations("hci0") == Allocations(
"hci0",
1,
0,
["FA:23:9D:AA:45:46"],
)
assert changes == [
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.RELEASED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
]
assert slot_manager.diagnostics() == {
"adapter_slots": {"hci0": 1, "hci1": 2, "hci2": 1},
"allocations_by_adapter": {
"hci0": ["/org/bluez/hci0/dev_FA_23_9D_AA_45_46"],
"hci1": ["/org/bluez/hci1/dev_FA_23_9D_AA_45_46"],
"hci2": ["/org/bluez/hci2/dev_FA_23_9D_AA_45_46"],
},
"manager": True,
}
slot_manager.release_slot(ble_device_hci0)
assert changes == [
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.RELEASED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.RELEASED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
]
assert slot_manager._get_allocations("hci0") == []
assert slot_manager.get_allocations("hci0") == Allocations(
"hci0",
1,
1,
[],
)
assert slot_manager.allocate_slot(ble_device_hci0) is True
assert changes == [
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.RELEASED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.RELEASED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
]
assert slot_manager._get_allocations("hci0") == [
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46"
]
assert slot_manager.get_allocations("hci0") == Allocations(
"hci0",
1,
0,
["FA:23:9D:AA:45:46"],
)
slot_manager.remove_adapter("hci0")
assert changes == [
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.RELEASED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.RELEASED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
]
assert slot_manager.allocate_slot(ble_device_hci0) is True
assert changes == [
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.RELEASED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.RELEASED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
]
assert slot_manager.allocate_slot(ble_device_hci0_2) is True
assert changes == [
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.RELEASED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.RELEASED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
(
AllocationChange.ALLOCATED,
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"hci0",
"FA:23:9D:AA:45:46",
),
]
cancel_fail()
cancel()
async def test_slot_manager_mac_os():
"""Test the slot manager"""
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=None
)
bleak_retry_connector.bluez.defs = defs
slot_manager = BleakSlotManager()
await slot_manager.async_setup()
slot_manager.register_adapter("hci0", 1)
slot_manager.register_adapter("hci1", 2)
slot_manager.register_adapter("hci2", 1)
ble_device_hci0 = ble_device_from_properties(
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
{
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -30,
},
)
ble_device_hci0_2 = ble_device_from_properties(
"/org/bluez/hci0/dev_FA_23_9D_AA_45_47",
{
"Address": "FA:23:9D:AA:45:47",
"Alias": "FA:23:9D:AA:45:47",
"RSSI": -30,
},
)
assert slot_manager.allocate_slot(ble_device_hci0) is True
assert slot_manager._get_allocations("hci0") == []
assert slot_manager.allocate_slot(ble_device_hci0_2) is True
assert slot_manager._get_allocations("hci0") == []
assert slot_manager.allocate_slot(ble_device_hci0) is True
assert slot_manager._get_allocations("hci0") == []
slot_manager.release_slot(ble_device_hci0)
assert slot_manager._get_allocations("hci0") == []
slot_manager.remove_adapter("hci0")
def test_device_source():
ble_device_hci0_2 = BLEDevice(
"FA:23:9D:AA:45:46",
"FA:23:9D:AA:45:46",
{
"source": "aa:bb:cc:dd:ee:ff",
"path": "/org/bluez/hci0/dev_FA_23_9D_AA_45_47",
"props": {},
},
-127,
uuids=[],
manufacturer_data={},
)
assert device_source(ble_device_hci0_2) == "aa:bb:cc:dd:ee:ff"
def test_path_from_ble_device():
ble_device_hci0_2 = BLEDevice(
"FA:23:9D:AA:45:46",
"FA:23:9D:AA:45:46",
{
"source": "aa:bb:cc:dd:ee:ff",
"path": "/org/bluez/hci0/dev_FA_23_9D_AA_45_47",
"props": {},
},
-127,
uuids=[],
manufacturer_data={},
)
assert (
path_from_ble_device(ble_device_hci0_2)
== "/org/bluez/hci0/dev_FA_23_9D_AA_45_47"
)
async def test_wait_for_device_to_reappear(mock_linux):
class FakeBluezManager:
def __init__(self):
self.watchers: set[DeviceWatcher] = set()
self._properties = {
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -30,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci1/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Connected": True,
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -79,
},
defs.GATT_SERVICE_INTERFACE: True,
},
}
def add_device_watcher(self, path: str, **kwargs: Any) -> DeviceWatcher:
"""Add a watcher for device changes."""
watcher = DeviceWatcher(path, **kwargs)
self.watchers.add(watcher)
return watcher
def remove_device_watcher(self, watcher: DeviceWatcher) -> None:
"""Remove a watcher for device changes."""
self.watchers.remove(watcher)
def is_connected(self, path: str) -> bool:
"""Check if device is connected."""
return False
bluez_manager = FakeBluezManager()
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=bluez_manager
)
bleak_retry_connector.bluez.defs = defs
ble_device_hci0 = BLEDevice(
"FA:23:9D:AA:45:46",
"FA:23:9D:AA:45:46",
{
"source": "aa:bb:cc:dd:ee:ff",
"path": "/org/bluez/hci0/dev_FA_23_9D_AA_45_46",
"props": {},
},
-127,
uuids=[],
manufacturer_data={},
)
assert await wait_for_device_to_reappear(ble_device_hci0, 1) is True
del bluez_manager._properties["/org/bluez/hci0/dev_FA_23_9D_AA_45_46"]
assert await wait_for_device_to_reappear(ble_device_hci0, 1) is True
del bluez_manager._properties["/org/bluez/hci1/dev_FA_23_9D_AA_45_46"]
with patch.object(bleak_retry_connector.bluez, "REAPPEAR_WAIT_INTERVAL", 0.025):
assert await wait_for_device_to_reappear(ble_device_hci0, 0.1) is False
async def test_adapter_path_from_device_path(mock_linux):
assert (
adapter_path_from_device_path("/org/bluez/hci1/dev_FA_23_9D_AA_45_46")
== "/org/bluez/hci1"
)
bleak-retry-connector-3.8.1/tests/test_init.py 0000664 0000000 0000000 00000177326 14750422166 0021501 0 ustar 00root root 0000000 0000000 from __future__ import annotations
import asyncio
from typing import Any
from unittest.mock import AsyncMock, MagicMock, Mock, patch
import pytest
from bleak import BleakClient, BleakError
from bleak.backends.bluezdbus import defs
from bleak.backends.bluezdbus.manager import DeviceWatcher
from bleak.backends.device import BLEDevice
from bleak.backends.scanner import AdvertisementData
from bleak.backends.service import BleakGATTServiceCollection
from bleak.exc import BleakDBusError, BleakDeviceNotFoundError
import bleak_retry_connector
from bleak_retry_connector import (
BLEAK_BACKOFF_TIME,
BLEAK_DBUS_BACKOFF_TIME,
BLEAK_OUT_OF_SLOTS_BACKOFF_TIME,
BLEAK_TRANSIENT_BACKOFF_TIME,
BLEAK_TRANSIENT_LONG_BACKOFF_TIME,
BLEAK_TRANSIENT_MEDIUM_BACKOFF_TIME,
MAX_TRANSIENT_ERRORS,
BleakAbortedError,
BleakClientWithServiceCache,
BleakConnectionError,
BleakNotFoundError,
BleakOutOfConnectionSlotsError,
ble_device_description,
ble_device_has_changed,
calculate_backoff_time,
clear_cache,
close_stale_connections_by_address,
establish_connection,
get_connected_devices,
get_device,
get_device_by_adapter,
restore_discoveries,
retry_bluetooth_connection_error,
)
from bleak_retry_connector.bleak_manager import _reset_dbus_socket_cache
@pytest.mark.asyncio
async def test_establish_connection_works_first_time():
class FakeBleakClient(BleakClient):
async def connect(self, *args, **kwargs):
pass
async def disconnect(self, *args, **kwargs):
pass
client = await establish_connection(
FakeBleakClient, MagicMock(), "test", disconnected_callback=MagicMock()
)
assert isinstance(client, FakeBleakClient)
@pytest.mark.asyncio
async def test_establish_connection_with_cached_services():
class FakeBleakClient(BleakClient):
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
self._device_path = "/dev/test"
async def connect(self, *args, **kwargs):
return True
async def disconnect(self, *args, **kwargs):
pass
async def get_services(self, *args, **kwargs):
return []
class FakeBleakClientWithServiceCache(BleakClientWithServiceCache, FakeBleakClient):
"""Fake BleakClientWithServiceCache."""
async def get_services(self, *args, **kwargs):
return []
collection = BleakGATTServiceCollection()
class FakeBluezManager:
def __init__(self):
self._properties = {
"/dev/test/service/1": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.GATT_SERVICE_INTERFACE: True,
},
}
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=FakeBluezManager()
)
bleak_retry_connector.bluez.defs = defs
client = await establish_connection(
FakeBleakClientWithServiceCache,
MagicMock(),
"test",
disconnected_callback=MagicMock(),
cached_services=collection,
)
assert isinstance(client, FakeBleakClientWithServiceCache)
await client.get_services() is collection
@pytest.mark.asyncio
async def test_establish_connection_with_cached_services_that_have_vanished():
class FakeBleakClient(BleakClient):
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
self._device_path = "/dev/test"
async def connect(self, *args, **kwargs):
return True
async def disconnect(self, *args, **kwargs):
pass
async def get_services(self, *args, **kwargs):
return []
class FakeBleakClientWithServiceCache(BleakClientWithServiceCache, FakeBleakClient):
"""Fake BleakClientWithServiceCache."""
async def get_services(self, *args, **kwargs):
return []
collection = BleakGATTServiceCollection()
class FakeBluezManager:
def __init__(self):
self._properties = {}
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=FakeBluezManager()
)
bleak_retry_connector.bluez.defs = defs
client = await establish_connection(
FakeBleakClientWithServiceCache,
MagicMock(),
"test",
disconnected_callback=MagicMock(),
cached_services=collection,
)
assert isinstance(client, FakeBleakClientWithServiceCache)
await client.get_services() is collection
@pytest.mark.asyncio
async def test_establish_connection_can_cache_services_always_patched():
class FakeBleakClient(BleakClient):
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
self._device_path = "/dev/test"
async def connect(self, *args, **kwargs):
return True
async def disconnect(self, *args, **kwargs):
pass
async def get_services(self, *args, **kwargs):
return []
class FakeBleakClientWithServiceCache(BleakClientWithServiceCache, FakeBleakClient):
"""Fake BleakClientWithServiceCache."""
collection = BleakGATTServiceCollection()
class FakeBluezManager:
def __init__(self):
self._properties = {
"/dev/test/service/1": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.GATT_SERVICE_INTERFACE: True,
},
}
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=FakeBluezManager()
)
bleak_retry_connector.bluez.defs = defs
client = await establish_connection(
FakeBleakClientWithServiceCache,
MagicMock(),
"test",
disconnected_callback=MagicMock(),
cached_services=collection,
)
assert isinstance(client, FakeBleakClientWithServiceCache)
await client.get_services() is collection
@pytest.mark.asyncio
async def test_establish_connection_can_cache_services_services_missing():
class FakeBleakClient(BleakClient):
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
self._device_path = "/dev/test"
async def connect(self, *args, **kwargs):
return True
async def disconnect(self, *args, **kwargs):
pass
async def get_services(self, *args, **kwargs):
return []
class FakeBleakClientWithServiceCache(BleakClientWithServiceCache, FakeBleakClient):
"""Fake BleakClientWithServiceCache."""
collection = BleakGATTServiceCollection()
class FakeBluezManager:
def __init__(self):
self._properties = {
"/dev/test2/service/1": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
},
}
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=FakeBluezManager()
)
bleak_retry_connector.bluez.defs = defs
client = await establish_connection(
FakeBleakClientWithServiceCache,
MagicMock(),
"test",
disconnected_callback=MagicMock(),
cached_services=collection,
)
assert isinstance(client, FakeBleakClientWithServiceCache)
await client.get_services() is collection
@pytest.mark.asyncio
async def test_establish_connection_can_cache_services_newer_bleak():
class FakeBleakClient(BleakClient):
async def connect(self, *args, **kwargs):
return True
async def disconnect(self, *args, **kwargs):
pass
async def get_services(self, *args, **kwargs):
return []
class FakeBleakClientWithServiceCache(BleakClientWithServiceCache, FakeBleakClient):
"""Fake BleakClientWithServiceCache."""
collection = BleakGATTServiceCollection()
client = await establish_connection(
FakeBleakClientWithServiceCache,
MagicMock(),
"test",
disconnected_callback=MagicMock(),
cached_services=collection,
)
assert isinstance(client, FakeBleakClientWithServiceCache)
await client.get_services() is collection
@pytest.mark.asyncio
async def test_establish_connection_with_dangerous_use_cached_services():
class FakeBleakClient(BleakClient):
async def connect(self, *args, **kwargs):
return True
async def disconnect(self, *args, **kwargs):
pass
async def get_services(self, *args, **kwargs):
return []
class FakeBleakClientWithServiceCache(BleakClientWithServiceCache, FakeBleakClient):
"""Fake BleakClientWithServiceCache."""
client = await establish_connection(
FakeBleakClientWithServiceCache,
MagicMock(),
"test",
disconnected_callback=MagicMock(),
)
assert isinstance(client, FakeBleakClientWithServiceCache)
@pytest.mark.asyncio
async def test_establish_connection_without_dangerous_use_cached_services():
class FakeBleakClient(BleakClient):
async def connect(self, *args, **kwargs):
return True
async def disconnect(self, *args, **kwargs):
pass
async def get_services(self, *args, **kwargs):
return []
class FakeBleakClientWithServiceCache(BleakClientWithServiceCache, FakeBleakClient):
"""Fake BleakClientWithServiceCache."""
client = await establish_connection(
FakeBleakClientWithServiceCache,
MagicMock(),
"test",
disconnected_callback=MagicMock(),
)
assert isinstance(client, FakeBleakClientWithServiceCache)
@pytest.mark.asyncio
async def test_establish_connection_fails():
class FakeBleakClient(BleakClient):
def __init__(self, *args, **kwargs):
pass
async def connect(self, *args, **kwargs):
raise BleakError("test")
pass
async def disconnect(self, *args, **kwargs):
pass
with (
patch("bleak_retry_connector.calculate_backoff_time", return_value=0),
pytest.raises(BleakConnectionError),
):
await establish_connection(FakeBleakClient, MagicMock(), "test")
@pytest.mark.asyncio
async def test_establish_connection_times_out():
class FakeBleakClient(BleakClient):
def __init__(self, *args, **kwargs):
pass
async def connect(self, *args, **kwargs):
raise asyncio.TimeoutError()
async def disconnect(self, *args, **kwargs):
pass
with (
patch("bleak_retry_connector.calculate_backoff_time", return_value=0),
pytest.raises(BleakNotFoundError),
):
await establish_connection(FakeBleakClient, MagicMock(), "test")
@pytest.mark.asyncio
async def test_establish_connection_has_transient_error():
attempts = 0
class FakeBleakClient(BleakClient):
def __init__(self, *args, **kwargs):
pass
async def connect(self, *args, **kwargs):
nonlocal attempts
attempts += 1
if attempts < MAX_TRANSIENT_ERRORS:
raise BleakError("le-connection-abort-by-local")
pass
async def disconnect(self, *args, **kwargs):
pass
with patch("bleak_retry_connector.calculate_backoff_time", return_value=0):
client = await establish_connection(FakeBleakClient, MagicMock(), "test")
assert isinstance(client, FakeBleakClient)
assert attempts == 9
@pytest.mark.asyncio
async def test_establish_connection_has_transient_broken_pipe_error():
attempts = 0
class FakeBleakClient(BleakClient):
def __init__(self, *args, **kwargs):
pass
async def connect(self, *args, **kwargs):
nonlocal attempts
attempts += 1
if attempts < MAX_TRANSIENT_ERRORS:
raise BrokenPipeError
pass
async def disconnect(self, *args, **kwargs):
pass
client = await establish_connection(FakeBleakClient, MagicMock(), "test")
assert isinstance(client, FakeBleakClient)
assert attempts == 9
@pytest.mark.asyncio
async def test_establish_connection_services_changed():
attempts = 0
disconnect_calls = 0
clear_cache_calls = 0
class FakeBleakClient(BleakClientWithServiceCache):
def __init__(self, *args, **kwargs):
pass
async def connect(self, *args, **kwargs):
nonlocal attempts
attempts += 1
if attempts < MAX_TRANSIENT_ERRORS:
raise KeyError
async def disconnect(self, *args, **kwargs):
nonlocal disconnect_calls
disconnect_calls += 1
async def clear_cache(self) -> bool:
nonlocal clear_cache_calls
clear_cache_calls += 1
return True
client = await establish_connection(FakeBleakClient, MagicMock(), "test")
assert isinstance(client, FakeBleakClient)
assert attempts == 9
assert disconnect_calls == 8
assert clear_cache_calls == 8
@pytest.mark.asyncio
async def test_establish_connection_has_transient_error_had_advice():
class FakeBleakClient(BleakClient):
def __init__(self, *args, **kwargs):
pass
async def connect(self, *args, **kwargs):
raise BleakError("le-connection-abort-by-local")
async def disconnect(self, *args, **kwargs):
pass
with patch("bleak_retry_connector.calculate_backoff_time", return_value=0):
try:
await establish_connection(
FakeBleakClient,
BLEDevice(
"aa:bb:cc:dd:ee:ff",
"name",
{"path": "/org/bluez/hci2/dev_FA_23_9D_AA_45_46"},
-127,
),
"test",
)
except BleakError as e:
exc = e
assert isinstance(exc, BleakAbortedError)
assert str(exc) == (
"test - aa:bb:cc:dd:ee:ff: "
"Failed to connect after 9 attempt(s): "
"le-connection-abort-by-local: "
"Interference/range; "
"External Bluetooth adapter w/extension may help; "
"Extension cables reduce USB 3 port interference"
)
@pytest.mark.asyncio
async def test_establish_connection_out_of_slots_advice():
class FakeBleakClient(BleakClient):
def __init__(self, *args, **kwargs):
pass
async def connect(self, *args, **kwargs):
raise BleakError("out of connection slots")
async def disconnect(self, *args, **kwargs):
pass
with patch("bleak_retry_connector.calculate_backoff_time", return_value=0):
try:
await establish_connection(
FakeBleakClient,
BLEDevice(
"aa:bb:cc:dd:ee:ff", "name", {"source": "esphome_proxy_1"}, -127
),
"test",
)
except BleakError as e:
exc = e
assert isinstance(exc, BleakOutOfConnectionSlotsError)
assert str(exc) == (
"test - aa:bb:cc:dd:ee:ff: Failed to connect after 9 attempt(s): "
"out of connection slots: The proxy/adapter is "
"out of connection slots or the device is no "
"longer reachable; Add additional proxies "
"(https://esphome.github.io/bluetooth-proxies/) near this device"
)
@pytest.mark.asyncio
async def test_device_disappeared_error():
class FakeBleakClient(BleakClient):
def __init__(self, *args, **kwargs):
pass
async def connect(self, *args, **kwargs):
raise BleakError(
'[org.freedesktop.DBus.Error.UnknownObject] Method "Connect" with '
'signature "" on interface '
'"org.bluez.Device1" '
"doesn't exist"
)
async def disconnect(self, *args, **kwargs):
pass
with patch("bleak_retry_connector.calculate_backoff_time", return_value=0):
try:
await establish_connection(
FakeBleakClient,
BLEDevice(
"aa:bb:cc:dd:ee:ff",
"name",
{"path": "/org/bluez/hci2/dev_FA_23_9D_AA_45_46"},
-127,
),
"test",
)
except BleakError as e:
exc = e
assert isinstance(exc, BleakNotFoundError)
assert str(exc) == (
"test - aa:bb:cc:dd:ee:ff: "
"Failed to connect after 4 attempt(s): "
"[org.freedesktop.DBus.Error.UnknownObject] "
'Method "Connect" with signature "" on interface "org.bluez.Device1" '
"doesn't exist: The device disappeared; "
"Try restarting the scanner or moving the device closer"
)
@pytest.mark.asyncio
@patch.object(bleak_retry_connector.bluez, "IS_LINUX", True)
async def test_device_disappeared_and_reappears():
class FakeBluezManager:
def __init__(self):
self.watchers: set[DeviceWatcher] = set()
self._properties = {
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -30,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci1/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Connected": True,
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -79,
},
defs.GATT_SERVICE_INTERFACE: True,
},
}
def add_device_watcher(self, path: str, **kwargs: Any) -> DeviceWatcher:
"""Add a watcher for device changes."""
watcher = DeviceWatcher(path, **kwargs)
self.watchers.add(watcher)
return watcher
async def _wait_condition(self, *args: Any, **kwargs: Any) -> None:
"""Wait for a condition to be met."""
raise KeyError
def remove_device_watcher(self, watcher: DeviceWatcher) -> None:
"""Remove a watcher for device changes."""
self.watchers.remove(watcher)
def is_connected(self, path: str) -> bool:
"""Check if device is connected."""
return False
bluez_manager = FakeBluezManager()
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=bluez_manager
)
bleak_retry_connector.bluez.defs = defs
class FakeBleakClient(BleakClient):
def __init__(self, *args, **kwargs):
pass
async def connect(self, *args, **kwargs):
raise BleakDeviceNotFoundError(
'[org.freedesktop.DBus.Error.UnknownObject] Method "Connect" with '
'signature "" on interface '
'"org.bluez.Device1" '
"doesn't exist"
)
async def disconnect(self, *args, **kwargs):
pass
with (
patch("bleak_retry_connector.calculate_backoff_time", return_value=0.01),
patch.object(bleak_retry_connector.bluez, "REAPPEAR_WAIT_INTERVAL", 0.0025),
):
try:
await establish_connection(
FakeBleakClient,
BLEDevice(
"FA:23:9D:AA:45:46",
"name",
{"path": "/org/bluez/hci2/dev_FA_23_9D_AA_45_46"},
-127,
),
"test",
)
except BleakError as e:
exc = e
assert isinstance(exc, BleakNotFoundError)
assert str(exc) == (
"test - FA:23:9D:AA:45:46: "
"Failed to connect after 9 attempt(s): "
"BleakDeviceNotFoundError: "
"The device disappeared; "
"Try restarting the scanner or moving the device closer"
)
@pytest.mark.asyncio
async def test_establish_connection_has_one_unknown_error():
attempts = 0
class FakeBleakClient(BleakClient):
def __init__(self, *args, **kwargs):
pass
async def connect(self, *args, **kwargs):
nonlocal attempts
attempts += 1
if attempts == 1:
raise BleakError("unknown")
pass
async def disconnect(self, *args, **kwargs):
pass
client = await establish_connection(FakeBleakClient, MagicMock(), "test")
assert isinstance(client, FakeBleakClient)
assert attempts == 2
@pytest.mark.asyncio
async def test_establish_connection_has_one_many_error():
attempts = 0
class FakeBleakClient(BleakClient):
def __init__(self, *args, **kwargs):
pass
async def connect(self, *args, **kwargs):
nonlocal attempts
attempts += 1
if attempts < 10:
raise BleakError("unknown")
pass
async def disconnect(self, *args, **kwargs):
pass
with (
patch("bleak_retry_connector.calculate_backoff_time", return_value=0),
pytest.raises(BleakConnectionError),
):
await establish_connection(FakeBleakClient, MagicMock(), "test")
@pytest.mark.asyncio
async def test_bleak_connect_overruns_timeout():
class FakeBleakClient(BleakClient):
def __init__(self, *args, **kwargs):
pass
async def connect(self, *args, **kwargs):
await asyncio.sleep(40)
async def disconnect(self, *args, **kwargs):
pass
with (
patch("bleak_retry_connector.calculate_backoff_time", return_value=0),
patch.object(bleak_retry_connector, "BLEAK_SAFETY_TIMEOUT", 0),
pytest.raises(BleakNotFoundError),
):
await establish_connection(FakeBleakClient, MagicMock(), "test")
def test_ble_device_has_changed():
"""Test that the BLEDevice has changed when the underlying device has changed."""
assert not ble_device_has_changed(
BLEDevice("aa:bb:cc:dd:ee:ff", "name", {"path": "/dev/1"}, -127),
BLEDevice("aa:bb:cc:dd:ee:ff", "name", {"path": "/dev/1"}, -127),
)
assert ble_device_has_changed(
BLEDevice("aa:bb:cc:dd:ee:ff", "name", {"path": "/dev/1"}, -127),
BLEDevice("ab:bb:cc:dd:ee:ff", "name", {"path": "/dev/1"}, -127),
)
assert ble_device_has_changed(
BLEDevice("aa:bb:cc:dd:ee:ff", "name", {"path": "/dev/1"}, -127),
BLEDevice("aa:bb:cc:dd:ee:ff", "name", {"path": "/dev/2"}, -127),
)
@pytest.mark.asyncio
async def test_establish_connection_other_adapter_already_connected(mock_linux):
device: BLEDevice | None = None
class FakeBleakClient(BleakClient):
def __init__(self, ble_device_or_address, *args, **kwargs):
ble_device_or_address.metadata["delegate"] = 0
super().__init__(ble_device_or_address, *args, **kwargs)
nonlocal device
device = ble_device_or_address
self._device_path = "/org/bluez/hci2/dev_FA_23_9D_AA_45_46"
async def connect(self, *args, **kwargs):
return True
async def disconnect(self, *args, **kwargs):
pass
async def get_services(self, *args, **kwargs):
return []
class FakeBleakClientWithServiceCache(BleakClientWithServiceCache, FakeBleakClient):
"""Fake BleakClientWithServiceCache."""
async def get_services(self, *args, **kwargs):
return []
collection = BleakGATTServiceCollection()
class FakeBluezManager:
def __init__(self):
self._properties = {
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -30,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci1/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"Connected": True,
"RSSI": -79,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci2/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"Connected": False,
"RSSI": -80,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci3/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -31,
},
defs.GATT_SERVICE_INTERFACE: True,
},
}
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=FakeBluezManager()
)
bleak_retry_connector.bluez.defs = defs
client = await establish_connection(
FakeBleakClientWithServiceCache,
BLEDevice(
"aa:bb:cc:dd:ee:ff",
"name",
{"path": "/org/bluez/hci2/dev_FA_23_9D_AA_45_46"},
-80,
delegate=False,
),
"test",
disconnected_callback=MagicMock(),
cached_services=collection,
)
assert isinstance(client, FakeBleakClientWithServiceCache)
await client.get_services() is collection
assert device is not None
assert device.details["path"] == "/org/bluez/hci1/dev_FA_23_9D_AA_45_46"
@pytest.mark.asyncio
async def test_establish_connection_device_disappeared(mock_linux):
class FakeBleakClient(BleakClient):
def __init__(self, ble_device_or_address, *args, **kwargs):
ble_device_or_address.metadata["delegate"] = 0
super().__init__(ble_device_or_address, *args, **kwargs)
self._device_path = "/org/bluez/hci2/dev_FA_23_9D_AA_45_46"
async def connect(self, *args, **kwargs):
return True
async def disconnect(self, *args, **kwargs):
pass
async def get_services(self, *args, **kwargs):
return []
class FakeBleakClientWithServiceCache(BleakClientWithServiceCache, FakeBleakClient):
"""Fake BleakClientWithServiceCache."""
async def get_services(self, *args, **kwargs):
return []
collection = BleakGATTServiceCollection()
class FakeBluezManager:
def __init__(self):
self._properties = {
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "bob",
"RSSI": -30,
},
defs.GATT_SERVICE_INTERFACE: True,
},
}
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=FakeBluezManager()
)
bleak_retry_connector.bluez.defs = defs
with patch("bleak_retry_connector.calculate_backoff_time", return_value=0):
client = await establish_connection(
FakeBleakClientWithServiceCache,
BLEDevice(
"aa:bb:cc:dd:ee:ff",
"name",
{"path": "/org/bluez/hci2/dev_FA_23_9D_AA_45_46"},
-127,
delegate=False,
),
"test",
disconnected_callback=MagicMock(),
cached_services=collection,
)
assert isinstance(client, FakeBleakClientWithServiceCache)
await client.get_services() is collection
@pytest.mark.asyncio
async def test_get_device(mock_linux):
class FakeBluezManager:
def __init__(self):
self._properties = {
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -30,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci1/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -79,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci2/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -80,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci3/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -31,
},
defs.GATT_SERVICE_INTERFACE: True,
},
}
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=FakeBluezManager()
)
bleak_retry_connector.bluez.defs = defs
device = await get_device("FA:23:9D:AA:45:46")
assert device is not None
assert device.details["path"] == "/org/bluez/hci0/dev_FA_23_9D_AA_45_46"
@pytest.mark.asyncio
async def test_clear_cache(mock_linux):
class FakeBluezManager:
def __init__(self):
self._services_cache = {
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46": "test",
"/org/bluez/hci1/dev_FA_23_9D_AA_45_46": "test",
}
self._properties = {
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -30,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci1/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -79,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci2/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -80,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci3/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -31,
},
defs.GATT_SERVICE_INTERFACE: True,
},
}
bluez_manager = FakeBluezManager()
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=bluez_manager
)
bleak_retry_connector.bluez.defs = defs
device = await get_device("FA:23:9D:AA:45:46")
assert device is not None
assert device.details["path"] == "/org/bluez/hci0/dev_FA_23_9D_AA_45_46"
assert await clear_cache("FA:23:9D:AA:45:46")
assert bluez_manager._services_cache == {}
@pytest.mark.asyncio
async def test_get_device_mac_os(mock_macos):
class FakeBluezManager:
def __init__(self):
self._properties = {
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -30,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci1/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -79,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci2/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -80,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci3/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -31,
},
defs.GATT_SERVICE_INTERFACE: True,
},
}
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=FakeBluezManager()
)
bleak_retry_connector.bluez.defs = defs
device = await get_device("FA:23:9D:AA:45:46")
assert device is None
@pytest.mark.asyncio
async def test_get_device_already_connected(mock_linux):
class FakeBluezManager:
def __init__(self):
self._properties = {
"/org/bluez/hci1/dev_BD_24_6F_85_AA_61": {
"org.freedesktop.DBus.Introspectable": {},
"org.bluez.Device1": {
"Address": "BD:24:6F:85:AA:61",
"AddressType": "public",
"Name": "Dream~BD246F85AA61",
"Alias": "Dream~BD246F85AA61",
"Appearance": 962,
"Icon": "input-mouse",
"Paired": False,
"Trusted": False,
"Blocked": False,
"LegacyPairing": False,
"Connected": True,
"UUIDs": [
"00001800-0000-1000-8000-00805f9b34fb",
"00001801-0000-1000-8000-00805f9b34fb",
"0000180a-0000-1000-8000-00805f9b34fb",
"0000ffd0-0000-1000-8000-00805f9b34fb",
"0000ffd5-0000-1000-8000-00805f9b34fb",
],
"Modalias": "usb:v045Ep0040d0300",
"Adapter": "/org/bluez/hci1",
"ManufacturerData": {20808: bytearray(b"364656")},
"ServicesResolved": True,
},
"org.freedesktop.DBus.Properties": {},
}
}
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=FakeBluezManager()
)
bleak_retry_connector.bluez.defs = defs
device = await get_device("BD:24:6F:85:AA:61")
assert device is not None
assert device.details["path"] == "/org/bluez/hci1/dev_BD_24_6F_85_AA_61"
connected = await get_connected_devices(device)
assert len(connected) == 1
assert isinstance(connected[0], BLEDevice)
assert connected[0].details["path"] == "/org/bluez/hci1/dev_BD_24_6F_85_AA_61"
@pytest.mark.asyncio
async def test_get_device_not_there():
class FakeBluezManager:
def __init__(self):
self._properties = {
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -30,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci1/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -79,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci2/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -80,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci3/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -31,
},
defs.GATT_SERVICE_INTERFACE: True,
},
}
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=FakeBluezManager()
)
bleak_retry_connector.bluez.defs = defs
with patch.object(bleak_retry_connector.const, "IS_LINUX", True):
device = await get_device("00:00:00:00:00:00")
assert device is None
@pytest.mark.asyncio
async def test_establish_connection_better_rssi_available_already_connected_supported_different_adapter(
mock_linux,
):
device: BLEDevice | None = None
class FakeBleakClient(BleakClient):
def __init__(self, ble_device_or_address, *args, **kwargs):
ble_device_or_address.metadata["delegate"] = 0
super().__init__(ble_device_or_address, *args, **kwargs)
nonlocal device
device = ble_device_or_address
self._device_path = "/org/bluez/hci2/dev_FA_23_9D_AA_45_46"
async def connect(self, *args, **kwargs):
return True
async def disconnect(self, *args, **kwargs):
pass
async def get_services(self, *args, **kwargs):
return []
class FakeBleakClientWithServiceCache(BleakClientWithServiceCache, FakeBleakClient):
"""Fake BleakClientWithServiceCache."""
async def get_services(self, *args, **kwargs):
return []
collection = BleakGATTServiceCollection()
class FakeBluezManager:
def __init__(self):
self._properties = {
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -30,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci1/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Connected": True,
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -79,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci2/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Connected": True,
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -80,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci3/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -31,
},
defs.GATT_SERVICE_INTERFACE: True,
},
}
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=FakeBluezManager()
)
bleak_retry_connector.bluez.defs = defs
mock_device = BLEDevice(
"aa:bb:cc:dd:ee:ff",
"name",
{"path": "/org/bluez/hci2/dev_FA_23_9D_AA_45_46"},
-80,
delegate=False,
)
connected = await get_connected_devices(mock_device)
assert len(connected) == 2
assert isinstance(connected[0], BLEDevice)
assert connected[0].details["path"] == "/org/bluez/hci1/dev_FA_23_9D_AA_45_46"
assert connected[1].details["path"] == "/org/bluez/hci2/dev_FA_23_9D_AA_45_46"
with patch("bleak_retry_connector._disconnect_devices") as mock_disconnect_device:
client = await establish_connection(
FakeBleakClientWithServiceCache,
BLEDevice(
"FA:23:9D:AA:45:46",
"name",
{"path": "/org/bluez/hci2/dev_FA_23_9D_AA_45_46"},
-80,
delegate=False,
),
"test",
disconnected_callback=MagicMock(),
cached_services=collection,
)
assert isinstance(client, FakeBleakClientWithServiceCache)
await client.get_services() is collection
assert device is not None
assert device.details["path"] == "/org/bluez/hci1/dev_FA_23_9D_AA_45_46"
assert not mock_disconnect_device.mock_calls
@pytest.mark.asyncio
async def test_establish_connection_better_rssi_available_already_connected_supported_same_adapter(
mock_linux,
):
device: BLEDevice | None = None
class FakeBleakClient(BleakClient):
def __init__(self, ble_device_or_address, *args, **kwargs):
ble_device_or_address.metadata["delegate"] = 0
super().__init__(ble_device_or_address, *args, **kwargs)
nonlocal device
device = ble_device_or_address
self._device_path = "/org/bluez/hci2/dev_FA_23_9D_AA_45_46"
async def connect(self, *args, **kwargs):
return True
async def disconnect(self, *args, **kwargs):
pass
async def get_services(self, *args, **kwargs):
return []
class FakeBleakClientWithServiceCache(BleakClientWithServiceCache, FakeBleakClient):
"""Fake BleakClientWithServiceCache."""
async def get_services(self, *args, **kwargs):
return []
collection = BleakGATTServiceCollection()
class FakeBluezManager:
def __init__(self):
self._properties = {
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -30,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci1/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Connected": True,
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -79,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci2/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Connected": True,
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -80,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci3/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -31,
},
defs.GATT_SERVICE_INTERFACE: True,
},
}
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=FakeBluezManager()
)
bleak_retry_connector.bluez.defs = defs
mock_device = BLEDevice(
"aa:bb:cc:dd:ee:ff",
"name",
{"path": "/org/bluez/hci2/dev_FA_23_9D_AA_45_46"},
-80,
delegate=False,
)
connected = await get_connected_devices(mock_device)
assert len(connected) == 2
assert isinstance(connected[0], BLEDevice)
assert connected[0].details["path"] == "/org/bluez/hci1/dev_FA_23_9D_AA_45_46"
assert connected[1].details["path"] == "/org/bluez/hci2/dev_FA_23_9D_AA_45_46"
with (
patch("bleak_retry_connector._disconnect_devices") as mock_disconnect_device,
patch("bleak.get_platform_client_backend_type"),
):
client = await establish_connection(
FakeBleakClientWithServiceCache,
BLEDevice(
"FA:23:9D:AA:45:46",
"name",
{"path": "/org/bluez/hci1/dev_FA_23_9D_AA_45_46"},
-80,
delegate=False,
),
"test",
disconnected_callback=MagicMock(),
cached_services=collection,
)
assert isinstance(client, FakeBleakClientWithServiceCache)
await client.get_services() is collection
assert device is not None
assert device.details["path"] == "/org/bluez/hci1/dev_FA_23_9D_AA_45_46"
assert not mock_disconnect_device.mock_calls
@pytest.mark.asyncio
async def test_get_device_by_adapter(mock_linux):
class FakeBluezManager:
def __init__(self):
self._properties = {
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -30,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci1/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -79,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci2/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -80,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci3/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -31,
},
defs.GATT_SERVICE_INTERFACE: True,
},
}
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=FakeBluezManager()
)
bleak_retry_connector.bluez.defs = defs
device_hci0 = await get_device_by_adapter("FA:23:9D:AA:45:46", "hci0")
device_hci1 = await get_device_by_adapter("FA:23:9D:AA:45:46", "hci1")
assert device_hci0 is not None
assert device_hci0.details["path"] == "/org/bluez/hci0/dev_FA_23_9D_AA_45_46"
assert device_hci1 is not None
assert device_hci1.details["path"] == "/org/bluez/hci1/dev_FA_23_9D_AA_45_46"
def test_calculate_backoff_time():
"""Test that the backoff time is calculated correctly."""
assert calculate_backoff_time(Exception()) == BLEAK_BACKOFF_TIME
assert (
calculate_backoff_time(BleakDBusError(MagicMock(), MagicMock()))
== BLEAK_DBUS_BACKOFF_TIME
)
assert (
calculate_backoff_time(
BleakError(
"No backend with an available connection slot that can reach address EB:4A:D4:93:68:EF was found"
)
)
== BLEAK_OUT_OF_SLOTS_BACKOFF_TIME
)
assert (
calculate_backoff_time(BleakError("ESP_GATT_CONN_TERMINATE_PEER_USER"))
== BLEAK_TRANSIENT_BACKOFF_TIME
)
assert (
calculate_backoff_time(BleakError("ESP_GATT_CONN_FAIL_ESTABLISH"))
== BLEAK_TRANSIENT_MEDIUM_BACKOFF_TIME
)
assert (
calculate_backoff_time(BleakError("ESP_GATT_ERROR"))
== BLEAK_TRANSIENT_LONG_BACKOFF_TIME
)
assert (
calculate_backoff_time(BleakDeviceNotFoundError("Out of slots"))
== BLEAK_OUT_OF_SLOTS_BACKOFF_TIME
)
@pytest.mark.asyncio
async def test_retry_bluetooth_connection_error():
"""Test that the retry_bluetooth_connection_error decorator works correctly."""
@retry_bluetooth_connection_error()
async def test_function():
raise BleakDBusError(MagicMock(), MagicMock())
with patch(
"bleak_retry_connector.calculate_backoff_time"
) as mock_calculate_backoff_time:
mock_calculate_backoff_time.return_value = 0
with pytest.raises(BleakDBusError):
await test_function()
assert mock_calculate_backoff_time.call_count == 2
@pytest.mark.asyncio
async def test_retry_bluetooth_connection_error_non_default_max_attempts():
"""Test that the retry_bluetooth_connection_error decorator works correctly with a different number of retries."""
@retry_bluetooth_connection_error(4)
async def test_function():
raise BleakDBusError(MagicMock(), MagicMock())
with patch(
"bleak_retry_connector.calculate_backoff_time"
) as mock_calculate_backoff_time:
mock_calculate_backoff_time.return_value = 0
with pytest.raises(BleakDBusError):
await test_function()
assert mock_calculate_backoff_time.call_count == 4
@pytest.mark.asyncio
async def test_dbus_is_missing(mock_linux):
"""Test getting a device when dbus is missing."""
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
side_effect=FileNotFoundError("dbus not here")
)
bleak_retry_connector.bluez.defs = defs
with patch.object(bleak_retry_connector.const, "IS_LINUX", True):
device = await get_device("FA:23:9D:AA:45:46")
assert device is None
class FakeBluezManager:
def __init__(self):
self._properties = {
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -30,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci1/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -79,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci2/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -80,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci3/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -31,
},
defs.GATT_SERVICE_INTERFACE: True,
},
}
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=FakeBluezManager()
)
device = await get_device("FA:23:9D:AA:45:46")
assert device is None
_reset_dbus_socket_cache()
device = await get_device("FA:23:9D:AA:45:46")
assert device is not None
@pytest.mark.asyncio
async def test_ble_device_description():
device = BLEDevice(
"aa:bb:cc:dd:ee:ff",
"name",
{"path": "/org/bluez/hci2/dev_FA_23_9D_AA_45_46"},
-127,
)
assert (
ble_device_description(device) == "aa:bb:cc:dd:ee:ff - name -> /org/bluez/hci2"
)
device2 = BLEDevice(
"aa:bb:cc:dd:ee:ff",
"name",
{"path": "/org/bluez/hci2/dev_FA_23_9D_AA_45_46"},
-127,
)
assert (
ble_device_description(device2) == "aa:bb:cc:dd:ee:ff - name -> /org/bluez/hci2"
)
device3 = BLEDevice(
"aa:bb:cc:dd:ee:ff", "name", {"source": "esphome_proxy_1"}, -127
)
assert (
ble_device_description(device3) == "aa:bb:cc:dd:ee:ff - name -> esphome_proxy_1"
)
@pytest.mark.asyncio
@pytest.mark.skipif("not bleak_retry_connector.const.IS_LINUX")
async def test_restore_discoveries(mock_linux):
class FakeBluezManager:
def __init__(self):
self._properties = {
"/org/bluez/hci1/dev_BD_24_6F_85_AA_61": {
"org.freedesktop.DBus.Introspectable": {},
"org.bluez.Device1": {
"Address": "BD:24:6F:85:AA:61",
"AddressType": "public",
"Name": "Dream~BD246F85AA61",
"Alias": "Dream~BD246F85AA61",
"Appearance": 962,
"Icon": "input-mouse",
"Paired": False,
"Trusted": False,
"Blocked": False,
"LegacyPairing": False,
"Connected": True,
"UUIDs": [
"00001800-0000-1000-8000-00805f9b34fb",
"00001801-0000-1000-8000-00805f9b34fb",
"0000180a-0000-1000-8000-00805f9b34fb",
"0000ffd0-0000-1000-8000-00805f9b34fb",
"0000ffd5-0000-1000-8000-00805f9b34fb",
],
"Modalias": "usb:v045Ep0040d0300",
"Adapter": "/org/bluez/hci1",
"ManufacturerData": {20808: bytearray(b"364656")},
"ServicesResolved": True,
},
"org.freedesktop.DBus.Properties": {},
},
"/org/bluez/hci5/dev_BE_24_6F_85_AA_61": {
"org.freedesktop.DBus.Introspectable": {},
"org.bluez.Device1": {
"Address": "BE:24:6F:85:AA:61",
"AddressType": "public",
"Name": "Dream~BD246F85AA61",
"Alias": "Dream~BD246F85AA61",
"Appearance": 962,
"Icon": "input-mouse",
"Paired": False,
"Trusted": False,
"Blocked": False,
"LegacyPairing": False,
"Connected": True,
"UUIDs": [
"00001800-0000-1000-8000-00805f9b34fb",
"00001801-0000-1000-8000-00805f9b34fb",
"0000180a-0000-1000-8000-00805f9b34fb",
"0000ffd0-0000-1000-8000-00805f9b34fb",
"0000ffd5-0000-1000-8000-00805f9b34fb",
],
"Modalias": "usb:v045Ep0040d0300",
"Adapter": "/org/bluez/hci1",
"ManufacturerData": {20808: bytearray(b"364656")},
"ServicesResolved": True,
},
"org.freedesktop.DBus.Properties": {},
},
}
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=FakeBluezManager()
)
from bluetooth_adapters.history import load_history_from_managed_objects
bleak_retry_connector.load_history_from_managed_objects = (
load_history_from_managed_objects
)
bleak_retry_connector.bluez.defs = defs
seen_devices: dict[str, tuple[BLEDevice, AdvertisementData]] = {}
mock_backend = Mock(seen_devices=seen_devices)
mock_scanner = Mock(_backend=mock_backend)
await restore_discoveries(mock_scanner, "hci1")
assert len(seen_devices) == 1
@pytest.mark.asyncio
async def test_close_stale_connections_by_address(mock_linux):
class FakeBluezManager:
def __init__(self):
self._services_cache = {
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46": "test",
"/org/bluez/hci1/dev_FA_23_9D_AA_45_46": "test",
}
self._properties = {
"/org/bluez/hci0/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -30,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci1/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -79,
"Connected": True,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci2/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -80,
},
defs.GATT_SERVICE_INTERFACE: True,
},
"/org/bluez/hci3/dev_FA_23_9D_AA_45_46": {
"UUID": "service",
"Primary": True,
"Characteristics": [],
defs.DEVICE_INTERFACE: {
"Address": "FA:23:9D:AA:45:46",
"Alias": "FA:23:9D:AA:45:46",
"RSSI": -31,
},
defs.GATT_SERVICE_INTERFACE: True,
},
}
bluez_manager = FakeBluezManager()
bleak_retry_connector.bleak_manager.get_global_bluez_manager = AsyncMock(
return_value=bluez_manager
)
bleak_retry_connector.bluez.defs = defs
with patch.object(
bleak_retry_connector, "disconnect_devices", AsyncMock()
) as mock_disconnect_devices:
await close_stale_connections_by_address("FA:23:9D:AA:45:46")
assert len(mock_disconnect_devices.mock_calls) == 1
