pybricksdev: replace Union with | for type hints

Replace typing.Union with the | operator for type hints. This is
possible now that we require Python 3.10 or later.

Author: dlech

docs/conf.py

@@ -65,7 +65,6 @@
     ("py:class", "bleak.backends.device.BLEDevice"),
     ("py:exc", "asyncio.TimeoutError"),
     ("py:class", "bleak.BleakClient"),
-    ("py:obj", "typing.Union"),
     ("py:class", "os.PathLike"),
     ("py:obj", "typing.BinaryIO"),
     ("py:class", "BinaryIO"),  # yes, we need both!

pybricksdev/ble/lwp3/bytecodes.py

@@ -11,7 +11,6 @@
 """
 
 from enum import IntEnum, IntFlag, unique
-from typing import Union
 
 
 def _create_pseudo_member_(cls: type[IntEnum], value: int) -> IntEnum:
@@ -122,7 +121,7 @@ class BluetoothAddress(bytes):
     identifying individual Bluetooth devices instead of network cards.
     """
 
-    def __new__(cls, value: Union[str, bytes]) -> "BluetoothAddress":
+    def __new__(cls, value: str | bytes) -> "BluetoothAddress":
         if isinstance(value, str):
             # if it is a string, assume the format "XX:XX:XX:XX:XX:XX"
             value = [int(x, 16) for x in value.split(":")]

pybricksdev/ble/lwp3/messages.py

@@ -13,7 +13,7 @@
 import abc
 import struct
 from enum import IntEnum
-from typing import Any, NamedTuple, Union, overload
+from typing import Any, NamedTuple, overload
 
 from pybricksdev.ble.lwp3.bytecodes import (
     MAX_NAME_SIZE,
@@ -1211,7 +1211,7 @@ def __repr__(self) -> str:
 
 
 class PortValueMessage(AbstractMessage):
-    def __init__(self, port: PortID, fmt: str, *values: Union[int, float]) -> None:
+    def __init__(self, port: PortID, fmt: str, *values: int | float) -> None:
         super().__init__(4 + struct.calcsize(fmt), MessageKind.PORT_VALUE)
 
         self._data[3] = port
@@ -1221,7 +1221,7 @@ def __init__(self, port: PortID, fmt: str, *values: Union[int, float]) -> None:
     def port(self) -> PortID:
         return PortID(self._data[3])
 
-    def unpack(self, fmt: str) -> tuple[Union[int, float], ...]:
+    def unpack(self, fmt: str) -> tuple[int | float, ...]:
         return struct.unpack_from(fmt, self._data, 4)
 
     def __repr__(self) -> str:
@@ -1232,7 +1232,7 @@ def __repr__(self) -> str:
 
 class PortValueComboMessage(AbstractMessage):
     def __init__(
-        self, port: PortID, modes: list[int], fmt: str, *values: Union[int, float]
+        self, port: PortID, modes: list[int], fmt: str, *values: int | float
     ) -> None:
         super().__init__(6 + struct.calcsize(fmt), MessageKind.PORT_VALUE_COMBO)
 
@@ -1253,7 +1253,7 @@ def modes(self) -> list[int]:
         (flags,) = struct.unpack_from("<H", self._data, 4)
         return [m for m in range(16) if flags & (1 << m)]
 
-    def unpack(self, fmt: str) -> tuple[Union[int, float], ...]:
+    def unpack(self, fmt: str) -> tuple[int | float, ...]:
         return struct.unpack_from(fmt, self._data, 6)
 
     def __repr__(self) -> str:
@@ -1450,7 +1450,7 @@ def __init__(
         end: EndInfo,
         mode: int,
         fmt: str,
-        *values: Union[int, float],
+        *values: int | float,
     ) -> None:
         super().__init__(
             7 + struct.calcsize(fmt),
@@ -1467,7 +1467,7 @@ def __init__(
     def mode(self) -> int:
         return self._data[6]
 
-    def unpack(self, fmt: str) -> tuple[Union[int, float], ...]:
+    def unpack(self, fmt: str) -> tuple[int | float, ...]:
         return struct.unpack_from(fmt, self._data, 7)
 
     def __repr__(self) -> str:
@@ -1577,7 +1577,7 @@ class _Lookup(NamedTuple):
     index: int
     """The index of the bytecode that determines the type."""
 
-    value: Union[dict[IntEnum, type[AbstractMessage]], dict[IntEnum, "_Lookup"]]
+    value: dict[IntEnum, type[AbstractMessage]] | dict[IntEnum, "_Lookup"]
     """
     A dictionary mapping a bytecode to the cooresponding Python type if the type can be determined or
     a dictionary mapping a bytecode to another lookup if more discrimination is required.

pybricksdev/compile.py

@@ -5,7 +5,6 @@
 import logging
 import os
 from modulefinder import ModuleFinder
-from typing import Union
 
 import mpy_cross_v5
 import mpy_cross_v6
@@ -81,7 +80,7 @@ async def compile_file(
         return mpy
 
 
-async def compile_multi_file(path: str, abi: Union[int, tuple[int, int]]):
+async def compile_multi_file(path: str, abi: int | tuple[int, int]):
     """Compiles a Python file and its dependencies with ``mpy-cross``.
 
     On the hub, all dependencies behave as independent modules. Any (leading)

pybricksdev/firmware.py

@@ -11,7 +11,7 @@
 import struct
 import sys
 import zipfile
-from typing import BinaryIO, Literal, TypedDict, Union
+from typing import BinaryIO, Literal, TypedDict
 
 if sys.version_info < (3, 10):
     from typing_extensions import TypeGuard
@@ -98,17 +98,17 @@ class FirmwareMetadataV210(
     """
 
 
-AnyFirmwareV1Metadata = Union[FirmwareMetadataV100, FirmwareMetadataV110]
+AnyFirmwareV1Metadata = FirmwareMetadataV100 | FirmwareMetadataV110
 """
 Type for data contained in ``firmware.metadata.json`` files of any 1.x version.
 """
 
-AnyFirmwareV2Metadata = Union[FirmwareMetadataV200, FirmwareMetadataV210]
+AnyFirmwareV2Metadata = FirmwareMetadataV200 | FirmwareMetadataV210
 """
 Type for data contained in ``firmware.metadata.json`` files of any 2.x version.
 """
 
-AnyFirmwareMetadata = Union[AnyFirmwareV1Metadata, AnyFirmwareV2Metadata]
+AnyFirmwareMetadata = AnyFirmwareV1Metadata | AnyFirmwareV2Metadata
 """
 Type for data contained in ``firmware.metadata.json`` files of any version.
 """
@@ -233,7 +233,7 @@ async def _create_firmware_v2(
 
 
 async def create_firmware_blob(
-    firmware_zip: Union[str, os.PathLike, BinaryIO], name: str | None = None
+    firmware_zip: str | os.PathLike | BinaryIO, name: str | None = None
 ) -> tuple[bytes, AnyFirmwareMetadata, str]:
     """Creates a firmware blob from base firmware and an optional custom name.