sr-robot3 2025.0.1__tar.gz → 2026.0.2__tar.gz

{sr_robot3-2025.0.1 → sr_robot3-2026.0.2}/.github/workflows/test_build.yml

@@ -10,16 +10,16 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest]
-        py_version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+        py_version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
         include:
           - os: windows-latest
-            py_version: "3.8"
+            py_version: "3.9"
           - os: windows-latest
-            py_version: "3.12"
+            py_version: "3.13"
           - os: macos-latest
-            py_version: "3.8"
+            py_version: "3.9"
           - os: macos-latest
-            py_version: "3.12"
+            py_version: "3.13"
     runs-on: ${{ matrix.os }}
     steps:
     - uses: actions/checkout@v4
@@ -55,10 +55,10 @@ jobs:
     - uses: actions/checkout@v4
       with:
         fetch-depth: 0
-    - name: Set up Python 3.8
+    - name: Set up Python 3.10
       uses: actions/setup-python@v5
       with:
-        python-version: "3.8"
+        python-version: "3.10"
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip build

{sr_robot3-2025.0.1 → sr_robot3-2026.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: sr-robot3
-Version: 2025.0.1
+Version: 2026.0.2
 Summary: Student Robotics API for Python 3
 Author-email: Student Robotics <kit-team@studentrobotics.org>
 License: MIT License
@@ -34,11 +34,11 @@ Classifier: Operating System :: OS Independent
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Typing :: Typed
 Classifier: Topic :: Education
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pyserial<4,>=3
-Requires-Dist: april_vision==2.2.0
+Requires-Dist: april_vision==3.0.0
 Requires-Dist: paho-mqtt<3,>=2
 Requires-Dist: pydantic<2,>=1.9.1
 Requires-Dist: typing-extensions; python_version < "3.10"
@@ -46,15 +46,15 @@ Requires-Dist: tomli<3,>=2.0.1; python_version < "3.11"
 Provides-Extra: dev
 Requires-Dist: flake8; extra == "dev"
 Requires-Dist: isort; extra == "dev"
-Requires-Dist: mypy==1.10.0; python_version < "3.9" and extra == "dev"
-Requires-Dist: mypy<2,>=1.7; python_version >= "3.9" and extra == "dev"
+Requires-Dist: mypy<2,>=1.7; extra == "dev"
 Requires-Dist: build; extra == "dev"
 Requires-Dist: types-pyserial; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
 Requires-Dist: paho-mqtt<3,>=2; extra == "dev"
 Provides-Extra: vision
-Requires-Dist: opencv-python-headless<5,>=4; extra == "vision"
+Requires-Dist: opencv-python-headless<5,>=4.10; extra == "vision"
+Dynamic: license-file
 
 # sr-robot3
 

{sr_robot3-2025.0.1 → sr_robot3-2026.0.2}/pyproject.toml

@@ -23,6 +23,7 @@ check_untyped_defs = true
 atomic = true
 balanced_wrapping = true
 known_first_party = "sr.robot3"
+skip_gitignore = true
 
 # hanging grid grouped indent style wrapping
 multi_line_output = 5
@@ -50,10 +51,10 @@ authors = [{name = "Student Robotics", email =  "kit-team@studentrobotics.org"}]
 readme = "README.md"
 license = {file = "LICENSE"}
 dynamic = ["version"]
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 dependencies = [
     "pyserial >=3,<4",
-    "april_vision==2.2.0",
+    "april_vision==3.0.0",
     "paho-mqtt >=2,<3",
     "pydantic >=1.9.1,<2",
     "typing-extensions; python_version<'3.10'",
@@ -76,12 +77,11 @@ Documentation = "https://docs.studentrobotics.org"
 dev = [
     "flake8",
     "isort",
-    "mypy==1.10.0; python_version<'3.9'",
-    "mypy>=1.7,<2; python_version>='3.9'",
+    "mypy>=1.7,<2",
     "build",
     "types-pyserial",
     "pytest",
     "pytest-cov",
     "paho-mqtt >=2,<3"
 ]
-vision = ["opencv-python-headless >=4,<5"]
+vision = ["opencv-python-headless >=4.10,<5"]

sr_robot3-2026.0.2/sr/robot3/_version.py

@@ -0,0 +1,34 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
+else:
+    VERSION_TUPLE = object
+    COMMIT_ID = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
+
+__version__ = version = '2026.0.2'
+__version_tuple__ = version_tuple = (2026, 0, 2)
+
+__commit_id__ = commit_id = 'ge8189a502'

{sr_robot3-2025.0.1 → sr_robot3-2026.0.2}/sr/robot3/robot.py

@@ -8,7 +8,7 @@ import time
 from pathlib import Path
 from socket import socket
 from types import MappingProxyType
-from typing import Mapping, Optional
+from typing import Mapping, Optional, final
 
 from . import game_specific, timeout
 from ._version import __version__
@@ -23,12 +23,15 @@ from .power_board import Note, PowerBoard
 from .raw_serial import RawSerial
 from .servo_board import ServoBoard
 from .simulator.time_server import TimeServer
-from .utils import IN_SIMULATOR, ensure_atexit_on_term, obtain_lock, singular
+from .utils import (
+    IN_SIMULATOR, FinalMeta, ensure_atexit_on_term, obtain_lock, singular,
+)
 
 logger = logging.getLogger(__name__)
 
 
-class Robot:
+@final
+class Robot(metaclass=FinalMeta):
     """
     The main robot class that provides access to all the boards.
 
@@ -444,7 +447,7 @@ class Robot:
             self.power_board._run_led.flash()
         self.kch._flash_start()
 
-        while not start_button_pressed() or remote_start_pressed():
+        while not (start_button_pressed() or remote_start_pressed()):
             self.sleep(0.1)
         logger.info("Start signal received; continuing.")
         if not self._no_powerboard:

{sr_robot3-2025.0.1 → sr_robot3-2026.0.2}/sr/robot3/serial_wrapper.py

@@ -6,6 +6,7 @@ and for handling port timeouts and disconnections.
 """
 from __future__ import annotations
 
+import atexit
 import logging
 import sys
 import threading
@@ -106,6 +107,8 @@ class SerialWrapper:
             do_not_open=True,
         )
 
+        atexit.register(self._disconnect, quiet=True)
+
     def start(self) -> None:
         """
         Helper method to open the serial port.
@@ -230,7 +233,7 @@ class SerialWrapper:
         )
         return True
 
-    def _disconnect(self) -> None:
+    def _disconnect(self, quiet: bool = False) -> None:
         """
         Close the class's serial port.
 
@@ -238,9 +241,10 @@ class SerialWrapper:
         The serial port will be reopened on the next message.
         """
         self.serial.close()
-        logger.warning(
-            f'Board {self.identity.board_type}:{self.identity.asset_tag} disconnected'
-        )
+        if not quiet:
+            logger.warning(
+                f'Board {self.identity.board_type}:{self.identity.asset_tag} disconnected'
+            )
 
     def set_identity(self, identity: BoardIdentity) -> None:
         """

{sr_robot3-2025.0.1 → sr_robot3-2026.0.2}/sr/robot3/simulator/camera.py

@@ -1,3 +1,4 @@
+import atexit
 import struct
 
 import cv2
@@ -39,6 +40,8 @@ class WebotsRemoteCameraSource(FrameSource):
         self.image_size = tuple(map(int, response.split(b":")))
         assert len(self.image_size) == 2, f"Invalid image dimensions: {self.image_size}"
 
+        atexit.register(self.close)
+
     def read(self, fresh: bool = True) -> NDArray:
         """
         The method for getting a new frame.

{sr_robot3-2025.0.1 → sr_robot3-2026.0.2}/sr/robot3/utils.py

@@ -7,7 +7,7 @@ import signal
 import socket
 from abc import ABC, abstractmethod
 from types import FrameType
-from typing import Any, Mapping, NamedTuple, Optional, TypeVar
+from typing import Any, Mapping, NamedTuple, Optional, Type, TypeVar
 
 from serial.tools.list_ports import comports
 from serial.tools.list_ports_common import ListPortInfo
@@ -77,6 +77,18 @@ class Board(ABC):
         pass  # pragma: no cover
 
 
+class FinalMeta(type):
+    """
+    A meta class which ensures a given class cannot be subclassed.
+
+    It's recommended to additionally use typing.final.
+    """
+    def __new__(cls, name: str, bases: tuple, classdict: dict) -> Type:
+        if bases:
+            raise TypeError(f"{name} cannot be sub-classed.")
+        return super().__new__(cls, name, bases, dict(classdict))
+
+
 def map_to_int(
         x: float,
         in_min: float,

{sr_robot3-2025.0.1 → sr_robot3-2026.0.2}/sr_robot3.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: sr-robot3
-Version: 2025.0.1
+Version: 2026.0.2
 Summary: Student Robotics API for Python 3
 Author-email: Student Robotics <kit-team@studentrobotics.org>
 License: MIT License
@@ -34,11 +34,11 @@ Classifier: Operating System :: OS Independent
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Typing :: Typed
 Classifier: Topic :: Education
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pyserial<4,>=3
-Requires-Dist: april_vision==2.2.0
+Requires-Dist: april_vision==3.0.0
 Requires-Dist: paho-mqtt<3,>=2
 Requires-Dist: pydantic<2,>=1.9.1
 Requires-Dist: typing-extensions; python_version < "3.10"
@@ -46,15 +46,15 @@ Requires-Dist: tomli<3,>=2.0.1; python_version < "3.11"
 Provides-Extra: dev
 Requires-Dist: flake8; extra == "dev"
 Requires-Dist: isort; extra == "dev"
-Requires-Dist: mypy==1.10.0; python_version < "3.9" and extra == "dev"
-Requires-Dist: mypy<2,>=1.7; python_version >= "3.9" and extra == "dev"
+Requires-Dist: mypy<2,>=1.7; extra == "dev"
 Requires-Dist: build; extra == "dev"
 Requires-Dist: types-pyserial; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
 Requires-Dist: paho-mqtt<3,>=2; extra == "dev"
 Provides-Extra: vision
-Requires-Dist: opencv-python-headless<5,>=4; extra == "vision"
+Requires-Dist: opencv-python-headless<5,>=4.10; extra == "vision"
+Dynamic: license-file
 
 # sr-robot3
 

{sr_robot3-2025.0.1 → sr_robot3-2026.0.2}/sr_robot3.egg-info/requires.txt

@@ -1,5 +1,5 @@
 pyserial<4,>=3
-april_vision==2.2.0
+april_vision==3.0.0
 paho-mqtt<3,>=2
 pydantic<2,>=1.9.1
 
@@ -12,17 +12,12 @@ tomli<3,>=2.0.1
 [dev]
 flake8
 isort
+mypy<2,>=1.7
 build
 types-pyserial
 pytest
 pytest-cov
 paho-mqtt<3,>=2
 
-[dev:python_version < "3.9"]
-mypy==1.10.0
-
-[dev:python_version >= "3.9"]
-mypy<2,>=1.7
-
 [vision]
-opencv-python-headless<5,>=4
+opencv-python-headless<5,>=4.10

{sr_robot3-2025.0.1 → sr_robot3-2026.0.2}/tests/test_sr_robot.py

@@ -139,3 +139,9 @@ def test_robot_discovery() -> None:
     assert robot.power_board == robot.boards[power_asset_tag]
     assert robot.servo_board == robot.boards[servo_asset_tag]
     assert robot.motor_board == robot.boards[motor_asset_tag]
+
+
+def test_cannot_subclass() -> None:
+    with pytest.raises(TypeError, match="Robot cannot be sub-classed"):
+        class MyRobot(Robot):
+            pass

sr_robot3-2025.0.1/sr/robot3/_version.py

@@ -1,16 +0,0 @@
-# file generated by setuptools_scm
-# don't change, don't track in version control
-TYPE_CHECKING = False
-if TYPE_CHECKING:
-    from typing import Tuple, Union
-    VERSION_TUPLE = Tuple[Union[int, str], ...]
-else:
-    VERSION_TUPLE = object
-
-version: str
-__version__: str
-__version_tuple__: VERSION_TUPLE
-version_tuple: VERSION_TUPLE
-
-__version__ = version = '2025.0.1'
-__version_tuple__ = version_tuple = (2025, 0, 1)