circfirm 4.0.1__py3-none-any.whl → 5.0.0__py3-none-any.whl

circfirm/__init__.py

@@ -1,5 +1,4 @@
 # SPDX-FileCopyrightText: 2022 Alec Delaney, for Adafruit Industries
-#
 # SPDX-License-Identifier: MIT
 
 """Shared functionality for the tool.

circfirm/backend/__init__.py

@@ -1,5 +1,4 @@
 # SPDX-FileCopyrightText: 2022 Alec Delaney, for Adafruit Industries
-#
 # SPDX-License-Identifier: MIT
 
 """Shared backend functionality.

circfirm/backend/cache.py

@@ -1,5 +1,4 @@
 # SPDX-FileCopyrightText: 2024 Alec Delaney, for Adafruit Industries
-#
 # SPDX-License-Identifier: MIT
 
 """Backend functionality for the working with the cache.
@@ -9,7 +8,6 @@ Author(s): Alec Delaney
 
 import os
 import pathlib
-from typing import Optional
 
 import packaging.version
 import requests
@@ -55,7 +53,7 @@ def download_uf2(board_id: str, version: str, language: str = "en_US") -> None:
         uf2file.write(response.content)
 
 
-def get_sorted_boards(board_id: Optional[str]) -> dict[str, dict[str, set[str]]]:
+def get_sorted_boards(board_id: str | None) -> dict[str, dict[str, set[str]]]:
     """Get a sorted collection of boards, versions, and languages."""
     boards: dict[str, dict[str, set[str]]] = {}
     for board_folder in sorted(os.listdir(circfirm.UF2_ARCHIVE)):

circfirm/backend/device.py

@@ -1,5 +1,4 @@
 # SPDX-FileCopyrightText: 2024 Alec Delaney, for Adafruit Industries
-#
 # SPDX-License-Identifier: MIT
 
 """Backend functionality for the working with the connected devices.
@@ -9,7 +8,6 @@ Author(s): Alec Delaney
 
 import pathlib
 import re
-from typing import Optional
 
 import psutil
 
@@ -35,7 +33,7 @@ def get_board_info(device_path: str) -> tuple[str, str]:
     return board_match[1], version_match[1]
 
 
-def _find_device(filename: str) -> Optional[str]:
+def _find_device(filename: str) -> str | None:
     """Find a specific connected device."""
     for partition in psutil.disk_partitions():
         try:
@@ -47,11 +45,11 @@ def _find_device(filename: str) -> Optional[str]:
     return None
 
 
-def find_circuitpy() -> Optional[str]:
+def find_circuitpy() -> str | None:
     """Find CircuitPython device in non-bootloader mode."""
     return _find_device(circfirm.BOOTOUT_FILE)
 
 
-def find_bootloader() -> Optional[str]:
+def find_bootloader() -> str | None:
     """Find CircuitPython device in bootloader mode."""
     return _find_device(circfirm.UF2INFO_FILE)

circfirm/backend/github.py

@@ -1,5 +1,4 @@
 # SPDX-FileCopyrightText: 2024 Alec Delaney, for Adafruit Industries
-#
 # SPDX-License-Identifier: MIT
 
 """Backend functionality for the working with CircuitPython GitHub repository.

circfirm/backend/s3.py

@@ -1,5 +1,4 @@
 # SPDX-FileCopyrightText: 2024 Alec Delaney, for Adafruit Industries
-#
 # SPDX-License-Identifier: MIT
 
 """Backend functionality for the working with the CircuitPython firmware S3 bucket.
@@ -8,7 +7,6 @@ Author(s): Alec Delaney
 """
 
 import re
-from typing import Optional
 
 import boto3
 import botocore
@@ -25,7 +23,7 @@ BUCKET = S3_RESOURCE.Bucket(BUCKET_NAME)
 
 
 def get_board_versions(
-    board_id: str, language: str = "en_US", *, regex: Optional[str] = None
+    board_id: str, language: str = "en_US", *, regex: str | None = None
 ) -> list[str]:
     """Get a list of CircuitPython versions for a given board."""
     prefix = f"bin/{board_id}/{language}"
@@ -50,7 +48,7 @@ def get_board_versions(
 
 def get_latest_board_version(
     board_id: str, language: str, pre_release: bool
-) -> Optional[str]:
+) -> str | None:
     """Get the latest version for a board in a given language."""
     versions = get_board_versions(board_id, language)
     if not pre_release:

circfirm/cli/__init__.py

@@ -1,5 +1,4 @@
 # SPDX-FileCopyrightText: 2022 Alec Delaney, for Adafruit Industries
-#
 # SPDX-License-Identifier: MIT
 
 """Main CLI functionality for the tool.
@@ -13,8 +12,8 @@ import pkgutil
 import shutil
 import sys
 import time
-from collections.abc import Iterable
-from typing import Any, Callable, Optional, TypeVar
+from collections.abc import Callable, Iterable
+from typing import Any, TypeVar
 
 import click
 import click_spinner
@@ -44,9 +43,9 @@ def maybe_support(msg: str) -> None:
 
 
 def get_board_id(
-    circuitpy: Optional[str],
-    bootloader: Optional[str],
-    board: Optional[str],
+    circuitpy: str | None,
+    bootloader: str | None,
+    board: str | None,
     timeout: int = -1,
 ) -> tuple[str, str]:
     """Get the board ID of a device via CLI."""
@@ -75,7 +74,7 @@ def get_board_id(
     return bootloader, board
 
 
-def get_connection_status() -> tuple[Optional[str], Optional[str]]:
+def get_connection_status() -> tuple[str | None, str | None]:
     """Get the status of a connectted CircuitPython device as a CIRCUITPY and bootloader location."""
     circuitpy = circfirm.backend.device.find_circuitpy()
     bootloader = circfirm.backend.device.find_bootloader()
@@ -86,7 +85,7 @@ def get_connection_status() -> tuple[Optional[str], Optional[str]]:
     return circuitpy, bootloader
 
 
-def ensure_bootloader_mode(bootloader: Optional[str]) -> None:
+def ensure_bootloader_mode(bootloader: str | None) -> None:
     """Ensure the connected device is in bootloader mode."""
     if not bootloader:
         if circfirm.backend.device.find_circuitpy():
@@ -130,7 +129,7 @@ def announce_and_await(
     msg: str,
     func: Callable[..., _T],
     args: Iterable = (),
-    kwargs: Optional[dict[str, Any]] = None,
+    kwargs: dict[str, Any] | None = None,
     *,
     use_spinner: bool = True,
 ) -> _T:

circfirm/cli/about.py

@@ -1,5 +1,4 @@
 # SPDX-FileCopyrightText: 2024 Alec Delaney, for Adafruit Industries
-#
 # SPDX-License-Identifier: MIT
 
 """CLI functionality for the about subcommand.

circfirm/cli/cache.py

@@ -1,5 +1,4 @@
 # SPDX-FileCopyrightText: 2024 Alec Delaney, for Adafruit Industries
-#
 # SPDX-License-Identifier: MIT
 
 """CLI functionality for the cache subcommand.
@@ -11,7 +10,6 @@ import os
 import pathlib
 import re
 import shutil
-from typing import Optional
 
 import botocore.exceptions
 import click
@@ -40,9 +38,9 @@ def cli():
     help="The board ID, version, and language options represent regex patterns",
 )
 def clear(  # noqa: PLR0913
-    board_id: Optional[str],
-    version: Optional[str],
-    language: Optional[str],
+    board_id: str | None,
+    version: str | None,
+    language: str | None,
     regex: bool,
 ) -> None:
     """Clear the cache, either entirely or for a specific board/version."""
@@ -91,7 +89,7 @@ def clear(  # noqa: PLR0913
 
 @cli.command(name="list")
 @click.option("-b", "--board-id", default=None, help="CircuitPython board ID")
-def cache_list(board_id: Optional[str]) -> None:
+def cache_list(board_id: str | None) -> None:
     """List all the boards/versions cached."""
     board_list = os.listdir(circfirm.UF2_ARCHIVE)
 

circfirm/cli/config.py

@@ -1,6 +1,5 @@
 # SPDX-FileCopyrightText: 2024 Alec Delaney, for Adafruit Industries
 # Based on code from circlink (Authored by Alec Delaney, licensed under MIT license)
-#
 # SPDX-License-Identifier: MIT
 
 """CLI functionality for the config subcommand.

circfirm/cli/current.py

@@ -1,5 +1,4 @@
 # SPDX-FileCopyrightText: 2024 Alec Delaney, for Adafruit Industries
-#
 # SPDX-License-Identifier: MIT
 
 """CLI functionality for the current subcommand.

circfirm/cli/detect.py

@@ -1,5 +1,4 @@
 # SPDX-FileCopyrightText: 2024 Alec Delaney, for Adafruit Industries
-#
 # SPDX-License-Identifier: MIT
 
 """CLI functionality for the detect subcommand.
@@ -7,7 +6,6 @@
 Author(s): Alec Delaney
 """
 
-
 import click
 
 import circfirm.backend.device

circfirm/cli/install.py

@@ -1,5 +1,4 @@
 # SPDX-FileCopyrightText: 2024 Alec Delaney, for Adafruit Industries
-#
 # SPDX-License-Identifier: MIT
 
 """CLI functionality for the install subcommand.
@@ -7,8 +6,6 @@
 Author(s): Alec Delaney
 """
 
-from typing import Optional
-
 import click
 
 import circfirm.cli
@@ -29,7 +26,7 @@ import circfirm.cli
     default=-1,
     help="Set a timeout in seconds for the switch to bootloader mode",
 )
-def cli(version: str, language: str, board_id: Optional[str], timeout: int) -> None:
+def cli(version: str, language: str, board_id: str | None, timeout: int) -> None:
     """Install the specified version of CircuitPython."""
     circuitpy, bootloader = circfirm.cli.get_connection_status()
     try:

circfirm/cli/query.py

@@ -1,5 +1,4 @@
 # SPDX-FileCopyrightText: 2024 Alec Delaney, for Adafruit Industries
-#
 # SPDX-License-Identifier: MIT
 
 """CLI functionality for the query subcommand.
@@ -51,7 +50,7 @@ def query_board_ids(regex: str) -> None:
             boards = circfirm.backend.github.get_board_id_list(gh_token)
     except ValueError as err:
         raise click.ClickException(err.args[0])
-    except requests.ConnectionError as err:
+    except requests.ConnectionError:
         print("Triggered!")
         raise click.ClickException(
             "Issue with requesting information from git repository, check network connection"

circfirm/cli/update.py

@@ -1,5 +1,4 @@
 # SPDX-FileCopyrightText: 2024 Alec Delaney, for Adafruit Industries
-#
 # SPDX-License-Identifier: MIT
 
 """CLI functionality for the update subcommand.
@@ -7,8 +6,6 @@
 Author(s): Alec Delaney
 """
 
-from typing import Optional
-
 import botocore.exceptions
 import click
 import packaging.version
@@ -53,7 +50,7 @@ import circfirm.backend.s3
     help="Upgrade up to patch version updates",
 )
 def cli(  # noqa: PLR0913
-    board_id: Optional[str],
+    board_id: str | None,
     language: str,
     timeout: int,
     pre_release: bool,

circfirm/startup.py

@@ -1,5 +1,4 @@
 # SPDX-FileCopyrightText: 2022 Alec Delaney, for Adafruit Industries
-#
 # SPDX-License-Identifier: MIT
 
 """Basic startup functionality for the tools.

{circfirm-4.0.1.dist-info → circfirm-5.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: circfirm
-Version: 4.0.1
+Version: 5.0.0
 Summary: CLI tool for install firmware for CircuitPython boards
 Author-email: Alec Delaney <tekktrik@gmail.com>
 License: MIT
@@ -15,37 +15,37 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Natural Language :: English
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Operating System :: Unix
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: MacOS
 Classifier: Typing :: Typed
-Requires-Python: >=3.9.0
+Requires-Python: >=3.10.0
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 License-File: NOTICE
 License-File: NOTICE.license
-Requires-Dist: boto3~=1.35
-Requires-Dist: click~=8.1
-Requires-Dist: click-spinner~=0.1
-Requires-Dist: packaging~=24.2
-Requires-Dist: psutil~=6.1
-Requires-Dist: pyyaml~=6.0
-Requires-Dist: requests~=2.32
-Requires-Dist: boto3-stubs[essential]~=1.35
+Requires-Dist: boto3==1.42.42
+Requires-Dist: boto3-stubs[essential]==1.42.42
+Requires-Dist: click==8.3.1
+Requires-Dist: click-spinner==0.1.10
+Requires-Dist: packaging==24.2
+Requires-Dist: psutil==6.1.1
+Requires-Dist: pyyaml==6.0.3
+Requires-Dist: requests==2.32.5
 Provides-Extra: dev
-Requires-Dist: build~=1.2; extra == "dev"
-Requires-Dist: coverage~=7.6; extra == "dev"
-Requires-Dist: pre-commit~=4.0; extra == "dev"
-Requires-Dist: pytest~=8.3; extra == "dev"
-Requires-Dist: sphinx~=7.4; extra == "dev"
-Requires-Dist: sphinx-tabs~=3.4; extra == "dev"
-Requires-Dist: sphinx-rtd-theme~=3.0; extra == "dev"
+Requires-Dist: build==1.4.0; extra == "dev"
+Requires-Dist: coverage==7.13.3; extra == "dev"
+Requires-Dist: pre-commit==4.5.1; extra == "dev"
+Requires-Dist: pytest==8.4.2; extra == "dev"
+Requires-Dist: sphinx==7.4.7; extra == "dev"
+Requires-Dist: sphinx-tabs==3.4.7; extra == "dev"
+Requires-Dist: sphinx-rtd-theme==3.1.0; extra == "dev"
 Dynamic: license-file
 
 ..

circfirm-5.0.0.dist-info/RECORD

@@ -0,0 +1,27 @@
+circfirm/__init__.py,sha256=p6ON2S-WFdtxOBTXUZbeh7qq-PFealnOUHmNCovg8B0,717
+circfirm/py.typed,sha256=F2H7kdQErBIQUjr5WG2gdwj35iaUHi4Eyc2hovaLTMA,97
+circfirm/startup.py,sha256=EESDlom97BWDaahPqUzTAO1LmnGkMPDDobWCcvGeIeA,1944
+circfirm/backend/__init__.py,sha256=x_ZM50hQwljWLV4mcu8FtybXsFl12mi1RXyGEd6XukU,1856
+circfirm/backend/cache.py,sha256=uVz8F-ksoi-wgwgZP5U3PY60yBqNtUWgE7I4Rnz_kJE,2874
+circfirm/backend/device.py,sha256=sii80sAKFKtLscgbhaTIOKElGiLOG161iEQitMzBlUs,1737
+circfirm/backend/github.py,sha256=xuJxeRjYsrQXearlQnoES0gLGs-xTjrbGeTtGeGtOw4,2088
+circfirm/backend/s3.py,sha256=waz4Uq21tuvcWTk3ORaCKYooCsNmNG0iNXY-J8ceoJ4,2109
+circfirm/cli/__init__.py,sha256=xsFUD69Md_Vhg4rvUBH2844JCRCCeAqjzDZ8B3tQzaw,6421
+circfirm/cli/about.py,sha256=h5Ud5AKVHBmPqb0d4bQwPSBqtIR1aHLG-6V-H3bNqHU,338
+circfirm/cli/cache.py,sha256=ctjbuwyG_Q3FLO8NGUb5Hp7lTcccK2Gch666A3xG9b4,5388
+circfirm/cli/config.py,sha256=bYzIHzO0LQZhzoBGS9xKnbxPgxS8htWKMrUDaXw8fhg,3120
+circfirm/cli/current.py,sha256=fx7z65oXUAmGZvp4L5nVrixNbft0-chM0jLiE_lMPyM,1032
+circfirm/cli/detect.py,sha256=CJL9yeYH0YP2jHDYpfFbbze4i80uPFX-W_8m4fuRGEM,941
+circfirm/cli/install.py,sha256=ajuGWO5touE8tg-5iOK4wpw-SBrFH7CwFKhENfGQMf0,1219
+circfirm/cli/query.py,sha256=wL29qaFBt6lnWstkzNO6aPIy5lktI2DNewABSm9b_hU,3624
+circfirm/cli/update.py,sha256=8EK5t8q-B237uIMDEffG0A4hrsG4C9PztDoIMqnmqI8,3525
+circfirm/templates/settings.yaml,sha256=SM1zjXvZg1jikzn9TjgOufl0Pn9KBbrw8sIcJ01BRhQ,69
+circfirm/templates/settings.yaml.license,sha256=F2H7kdQErBIQUjr5WG2gdwj35iaUHi4Eyc2hovaLTMA,97
+circfirm-5.0.0.dist-info/licenses/LICENSE,sha256=6pPP6gJ00tqCkxg5gABHDwWUiXZ_mBzH94xxPOqwGj4,1069
+circfirm-5.0.0.dist-info/licenses/NOTICE,sha256=-iTImDmAffekkp_kj8De0_pvckHvXAHLPAJTWOgQsiw,2956
+circfirm-5.0.0.dist-info/licenses/NOTICE.license,sha256=FIvC5TnLXwPBj-dgEV4FBwAlJxzMXhgl50TXLv2d88o,96
+circfirm-5.0.0.dist-info/METADATA,sha256=cQQ8ohzNydQOtgEXkQwaDqhqPLjFKHRBMEkoRHlgAM4,4734
+circfirm-5.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+circfirm-5.0.0.dist-info/entry_points.txt,sha256=33qZTmSuXz8dgi29yjSyb8VsEA8HyhWuhn2MNcjatGQ,46
+circfirm-5.0.0.dist-info/top_level.txt,sha256=qA2407wap3My6jGA5uchH2JjUM7qn73oBPwALN7GR5k,9
+circfirm-5.0.0.dist-info/RECORD,,

circfirm-4.0.1.dist-info/RECORD

@@ -1,27 +0,0 @@
-circfirm/__init__.py,sha256=Uk6XRo7aFQcwUOMfst4GVt8tuXbMRnDIsPRrWeBtxLQ,719
-circfirm/py.typed,sha256=F2H7kdQErBIQUjr5WG2gdwj35iaUHi4Eyc2hovaLTMA,97
-circfirm/startup.py,sha256=HoeMpISAJswKTFn-sHhtoCD5yISHW5z8ZPW7WgSr2xg,1946
-circfirm/backend/__init__.py,sha256=fzxooHsys60iPrj6q6l-t3m2iGAC6FEIinP1UFgGHKE,1858
-circfirm/backend/cache.py,sha256=WZwBP-c9KkTX5IpkRovj46FUzk6JJdFB8-FIWC3--5k,2907
-circfirm/backend/device.py,sha256=t_g4iPJ4C2Qg5xKUr1AI6XPu5-ULTDZ4e3qAZVSfJs8,1776
-circfirm/backend/github.py,sha256=ePHXTCxqGcJOyVsutdbsL80MaxIYBdNIV9Yzz8aG4Yg,2090
-circfirm/backend/s3.py,sha256=rFxR4XcP9njGcAe3FikJmcvaJHmgFFCqGRSqHD3lqDE,2145
-circfirm/cli/__init__.py,sha256=TBJxvMqzTXQNEv2jKTZHqxeTTvGoQ9sz4o4R91Qe4Kg,6454
-circfirm/cli/about.py,sha256=_QNqXtbyerlxewPVieCdOvQ6BZWqdgvncBIzj39zpCU,340
-circfirm/cli/cache.py,sha256=fpwktpS7e0Ikg8qekUoC40qHHARcShiLuxSW7ZIqg5I,5430
-circfirm/cli/config.py,sha256=9ye3jQhgXaOMAXIlJWHp8PhBEtjUTJSL9szTXCQU2Cg,3122
-circfirm/cli/current.py,sha256=3kjvAQ5oFuXxey8RtU6T5GJPnTmIy2saEpyYoqVOTU8,1034
-circfirm/cli/detect.py,sha256=hXOIFjQAylx5kDT1chU2HJXqIv14scDJheO5-XUioeI,944
-circfirm/cli/install.py,sha256=z0pT7J_n4A3dJn-ocZk-uYcKkOZ3iUHbId-f-k97cg0,1253
-circfirm/cli/query.py,sha256=hZMzxojZUNr7eNCj5dz9WY2u9DTXov21PnRcYcPhkQ4,3633
-circfirm/cli/update.py,sha256=ZXLjUmpaJCvEI19rafCzGIco3wJZ-zCB4YpYxb7Iciw,3559
-circfirm/templates/settings.yaml,sha256=SM1zjXvZg1jikzn9TjgOufl0Pn9KBbrw8sIcJ01BRhQ,69
-circfirm/templates/settings.yaml.license,sha256=F2H7kdQErBIQUjr5WG2gdwj35iaUHi4Eyc2hovaLTMA,97
-circfirm-4.0.1.dist-info/licenses/LICENSE,sha256=6pPP6gJ00tqCkxg5gABHDwWUiXZ_mBzH94xxPOqwGj4,1069
-circfirm-4.0.1.dist-info/licenses/NOTICE,sha256=-iTImDmAffekkp_kj8De0_pvckHvXAHLPAJTWOgQsiw,2956
-circfirm-4.0.1.dist-info/licenses/NOTICE.license,sha256=FIvC5TnLXwPBj-dgEV4FBwAlJxzMXhgl50TXLv2d88o,96
-circfirm-4.0.1.dist-info/METADATA,sha256=trxEBd0QhzT8ETbp7ce6R_8J0E1pHRUKjIx-_9TvY24,4700
-circfirm-4.0.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-circfirm-4.0.1.dist-info/entry_points.txt,sha256=33qZTmSuXz8dgi29yjSyb8VsEA8HyhWuhn2MNcjatGQ,46
-circfirm-4.0.1.dist-info/top_level.txt,sha256=qA2407wap3My6jGA5uchH2JjUM7qn73oBPwALN7GR5k,9
-circfirm-4.0.1.dist-info/RECORD,,