Release/0.21.0

.github/pull_request_template.md

@@ -6,7 +6,7 @@ Before you submit a pull request, check that it meets these guidelines:
 1. If the pull request adds functionality, the docs should be updated.
 2. Modify the `CHANGELOG.rst`, describing your changes as is specified by the
    guidelines in that document.
-3. The pull request should work for Python 3.7+ on the following platforms:
+3. The pull request should work for Python 3.8+ on the following platforms:
     - Windows 10, version 16299 (Fall Creators Update) and greater
     - Linux distributions with BlueZ >= 5.43
     - OS X / macOS >= 10.11

.github/workflows/build_and_test.yml

@@ -14,7 +14,7 @@ jobs:
             fail-fast: false
             matrix:
                 os: [ubuntu-latest, windows-latest, macos-latest]
-                python-version: ['3.7', '3.8', '3.9', '3.10', '3.11']
+                python-version: ['3.8', '3.9', '3.10', '3.11']
         steps:
             -   uses: actions/checkout@v3
             -   name: Set up Python ${{ matrix.python-version }}

.gitignore

@@ -1,5 +1,4 @@
 examples/notcommit/
-.vscode/
 
 .idea/
 .vs/

.vscode/extensions.json

@@ -0,0 +1,13 @@
+{
+    // See https://go.microsoft.com/fwlink/?LinkId=827846 to learn about workspace recommendations.
+    // Extension identifier format: ${publisher}.${name}. Example: vscode.csharp
+    // List of extensions which should be recommended for users of this workspace.
+    "recommendations": [
+        "ms-python.python",
+        "ms-python.black-formatter",
+        "ms-python.isort",
+        "ms-python.flake8"
+    ],
+    // List of extensions recommended by VS Code that should not be recommended for users of this workspace.
+    "unwantedRecommendations": []
+}

.vscode/settings.json

@@ -0,0 +1,13 @@
+{
+    "[python]": {
+        "editor.defaultFormatter": "ms-python.black-formatter",
+        "editor.formatOnSave": true,
+        "editor.codeActionsOnSave": {
+            "source.organizeImports": true
+        },
+      },
+      "black-formatter.importStrategy": "fromEnvironment",
+      "isort.importStrategy": "fromEnvironment",
+      "isort.args":["--profile", "black"],
+      "flake8.importStrategy": "fromEnvironment"
+}

AUTHORS.rst

@@ -20,6 +20,7 @@ Contributors
 * Jonathan Soto <[email protected]>
 * Kyle J. Williams <[email protected]>
 * Edward Betts <[email protected]>
+* Robbe Gaeremynck <[email protected]>
 
 Sponsors
 --------

CHANGELOG.rst

@@ -10,14 +10,52 @@ and this project adheres to `Semantic Versioning <https://semver.org/spec/v2.0.0
 `Unreleased`_
 =============
 
+`0.21.0`_ (2023-09-02)
+======================
+
+Added
+-----
+* Added ``bleak.uuids.normalize_uuid_16()`` function.
+* Added ``bleak.uuids.normalize_uuid_32()`` function.
+* Added ``advertisement_data()`` async iterator method to ``BleakScanner``. Merged #1361.
+* Added type hints for kwargs on ``BleakScanner`` class methods.
+* Added support for Python 3.12.
+
+Changed
+-------
+* Improved error messages when failing to get services in WinRT backend.
+* Improved error messages with enum values in WinRT backend. Fixes #1284.
+* Scanner backends modified to allow multiple advertisement callbacks. Merged #1367.
+* Changed default handling of the ``response`` argument in ``BleakClient.write_gatt_char``.
+  Fixes #909.
+* Bleak recipe now automatically installs bleak from GitHub release in Kivy example.
+* Changed `BlueZManager` methods to raise `BleakError` when device is not in BlueZ.
+* Optimized BlueZ backend device watchers and condition callbacks to avoid linear searches.
+* Changed type hint for buffer protocol to ``collections.abc.Buffer``.
+
+Fixed
+-----
+* Fixed handling all access denied errors when enumerating characteristics on Windows. Fixes #1291.
+* Added support for 32bit UUIDs. Fixes #1314.
+* Fixed typing for ``BaseBleakScanner`` detection callback.
+* Fixed possible crash in ``_stopped_handler()`` in WinRT backend. Fixes #1330.
+* Reduced expensive logging in the BlueZ backend. Merged #1376.
+* Fixed race condition with ``"InterfaceRemoved"`` when getting services in BlueZ backend.
+* Fixed missing permissions and requirements in android Kivy example. Fixes #1184.
+* Fixed WinRT backend sometimes hanging forever when a device goes out of range during connection. Fixes #1359.
+
+Removed
+-------
+Dropped support for Python 3.7.
+
 `0.20.2`_ (2023-04-19)
 ======================
 
 Fixed
 -----
-- Fixed ``org.bluez.Error.InProgress`` in characteristic and descriptor read and
+* Fixed ``org.bluez.Error.InProgress`` in characteristic and descriptor read and
   write methods in BlueZ backend.
-- Fixed ``OSError: [WinError -2147483629] The object has been closed`` when
+* Fixed ``OSError: [WinError -2147483629] The object has been closed`` when
   connecting on Windows. Fixes #1280.
 
 `0.20.1`_ (2023-03-24)
@@ -940,7 +978,8 @@ Fixed
 * Bleak created.
 
 
-.. _Unreleased: https://github.com/hbldh/bleak/compare/v0.20.2...develop
+.. _Unreleased: https://github.com/hbldh/bleak/compare/v0.21.0...develop
+.. _0.21.0: https://github.com/hbldh/bleak/compare/v0.20.2...v0.21.0
 .. _0.20.2: https://github.com/hbldh/bleak/compare/v0.20.1...v0.20.2
 .. _0.20.1: https://github.com/hbldh/bleak/compare/v0.20.0...v0.20.1
 .. _0.20.0: https://github.com/hbldh/bleak/compare/v0.19.5...v0.20.0

CONTRIBUTING.rst

@@ -101,7 +101,7 @@ Before you submit a pull request, check that it meets these guidelines:
 1. If the pull request adds functionality, the docs should be updated.
 2. Modify the ``CHANGELOG.rst``, describing your changes as is specified by the
    guidelines in that document.
-3. The pull request should work for Python 3.7+ on the following platforms:
+3. The pull request should work for Python 3.8+ on the following platforms:
     - Windows 10, version 16299 (Fall Creators Update) and greater
     - Linux distributions with BlueZ >= 5.43
     - OS X / macOS >= 10.11

README.rst

@@ -79,7 +79,7 @@ Connect to a Bluetooth device and read its model number:
     from bleak import BleakClient
 
     address = "24:71:89:cc:09:05"
-    MODEL_NBR_UUID = "00002a24-0000-1000-8000-00805f9b34fb"
+    MODEL_NBR_UUID = "2A24"
 
     async def main(address):
         async with BleakClient(address) as client: