bdo-toolkit 1.0.0__tar.gz → 1.0.1__tar.gz

{bdo_toolkit-1.0.0/src/bdo_toolkit.egg-info → bdo_toolkit-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bdo-toolkit
-Version: 1.0.0
+Version: 1.0.1
 Summary: Passive, read-only BDO packet parsing toolkit for app developers.
 Author: bdo-toolkit contributors
 License-Expression: MIT
@@ -12,9 +12,10 @@ Keywords: bdo,packets,parse,pcap,passive
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Typing :: Typed
-Requires-Python: >=3.10
+Requires-Python: >=3.14
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: scapy>=2.5
@@ -27,7 +28,7 @@ Dynamic: license-file
 # bdo-toolkit
 
 [![CI](https://img.shields.io/github/actions/workflow/status/ychwu/bdo-toolkit/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/ychwu/bdo-toolkit/actions/workflows/ci.yml)
-[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-3776AB?style=flat-square&logo=python&logoColor=white)](https://github.com/ychwu/bdo-toolkit/blob/main/pyproject.toml)
+[![Python 3.14+](https://img.shields.io/badge/python-3.14%2B-3776AB?style=flat-square&logo=python&logoColor=white)](https://github.com/ychwu/bdo-toolkit/blob/main/pyproject.toml)
 ![Tested on NA/EU](https://img.shields.io/badge/tested-NA%2FEU-5b61a8?style=flat-square)
 [![Package: Stable](https://img.shields.io/badge/package-stable-2f855a?style=flat-square)](https://ychwu.github.io/bdo-toolkit/#stability)
 [![License: MIT](https://img.shields.io/badge/license-MIT-2f855a?style=flat-square)](https://github.com/ychwu/bdo-toolkit/blob/main/LICENSE)
@@ -62,7 +63,7 @@ services is unknown.
 python -m pip install bdo-toolkit
 ```
 
-Python 3.10 or newer is required. Before live capture, complete
+Python 3.14 or newer is required. Before live capture, complete
 [Installation & setup](https://ychwu.github.io/bdo-toolkit/#capture-foundation),
 including Npcap on Windows and permission to capture on the selected interface.
 Offline PCAP and PCAPNG replay does not require Npcap.
@@ -134,7 +135,7 @@ python -m pip wheel . --no-deps --wheel-dir dist
 ```
 
 CI runs tests, type checking, wheel construction, and a CLI smoke test on
-Ubuntu and Windows with Python 3.10 and 3.14. Tests that require private
+Ubuntu and Windows with Python 3.14. Tests that require private
 game-session captures skip when those local fixtures are absent.
 
 ## License

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/README.md

@@ -1,7 +1,7 @@
 # bdo-toolkit
 
 [![CI](https://img.shields.io/github/actions/workflow/status/ychwu/bdo-toolkit/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/ychwu/bdo-toolkit/actions/workflows/ci.yml)
-[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-3776AB?style=flat-square&logo=python&logoColor=white)](https://github.com/ychwu/bdo-toolkit/blob/main/pyproject.toml)
+[![Python 3.14+](https://img.shields.io/badge/python-3.14%2B-3776AB?style=flat-square&logo=python&logoColor=white)](https://github.com/ychwu/bdo-toolkit/blob/main/pyproject.toml)
 ![Tested on NA/EU](https://img.shields.io/badge/tested-NA%2FEU-5b61a8?style=flat-square)
 [![Package: Stable](https://img.shields.io/badge/package-stable-2f855a?style=flat-square)](https://ychwu.github.io/bdo-toolkit/#stability)
 [![License: MIT](https://img.shields.io/badge/license-MIT-2f855a?style=flat-square)](https://github.com/ychwu/bdo-toolkit/blob/main/LICENSE)
@@ -36,7 +36,7 @@ services is unknown.
 python -m pip install bdo-toolkit
 ```
 
-Python 3.10 or newer is required. Before live capture, complete
+Python 3.14 or newer is required. Before live capture, complete
 [Installation & setup](https://ychwu.github.io/bdo-toolkit/#capture-foundation),
 including Npcap on Windows and permission to capture on the selected interface.
 Offline PCAP and PCAPNG replay does not require Npcap.
@@ -108,7 +108,7 @@ python -m pip wheel . --no-deps --wheel-dir dist
 ```
 
 CI runs tests, type checking, wheel construction, and a CLI smoke test on
-Ubuntu and Windows with Python 3.10 and 3.14. Tests that require private
+Ubuntu and Windows with Python 3.14. Tests that require private
 game-session captures skip when those local fixtures are absent.
 
 ## License

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/pyproject.toml

@@ -7,7 +7,7 @@ name = "bdo-toolkit"
 dynamic = ["version"]
 description = "Passive, read-only BDO packet parsing toolkit for app developers."
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.14"
 dependencies = [
   "scapy>=2.5",
 ]
@@ -21,6 +21,7 @@ classifiers = [
   "Development Status :: 5 - Production/Stable",
   "Operating System :: OS Independent",
   "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.14",
   "Programming Language :: Python :: 3 :: Only",
   "Typing :: Typed",
 ]
@@ -47,6 +48,9 @@ where = ["src"]
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 
+[tool.mypy]
+python_version = "3.14"
+
 [tool.setuptools.package-data]
 bdo_toolkit = ["py.typed"]
 

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/src/bdo_toolkit/_async_sessions.py

@@ -14,7 +14,7 @@ from concurrent.futures import ThreadPoolExecutor
 from functools import partial
 from pathlib import Path
 from types import TracebackType
-from typing import AsyncIterator, Callable, Optional, TypeVar
+from typing import AsyncIterator, Callable, Optional
 
 from ._capture_runtime import CaptureEndpoint, _attach_cleanup_owner
 from ._capture_options import LiveCaptureOptions, PacketCaptureOptions
@@ -33,10 +33,7 @@ from .origin_learning import CompanionObservation
 from .profiles import OpcodeProfile
 
 
-T = TypeVar("T")
-
-
-async def _wait_ignoring_cancellation(future: asyncio.Future[T]) -> T:
+async def _wait_ignoring_cancellation[T](future: asyncio.Future[T]) -> T:
     """Wait for an already-started operation, even after caller cancellation."""
 
     while not future.done():
@@ -51,14 +48,14 @@ async def _wait_ignoring_cancellation(future: asyncio.Future[T]) -> T:
     return future.result()
 
 
-async def _await_preserving_future(future: asyncio.Future[T]) -> T:
+async def _await_preserving_future[T](future: asyncio.Future[T]) -> T:
     """Await without cancelling or wrapping the submitted worker future."""
 
     await asyncio.wait((future,))
     return future.result()
 
 
-def _thread_task(function: Callable[[], T]) -> asyncio.Task[T]:
+def _thread_task[T](function: Callable[[], T]) -> asyncio.Task[T]:
     return asyncio.create_task(asyncio.to_thread(function))
 
 
@@ -143,7 +140,7 @@ class AsyncLiveCaptureSession:
 
         self._session.raise_if_failed()
 
-    def _submit(self, function: Callable[[], T]) -> asyncio.Future[T]:
+    def _submit[T](self, function: Callable[[], T]) -> asyncio.Future[T]:
         if self._executor_closed:
             raise RuntimeError("async live capture session is already closed")
         loop = asyncio.get_running_loop()
@@ -380,11 +377,10 @@ class AsyncLiveCaptureSession:
                     self,
                     context="async live item capture context",
                 )
-            if hasattr(exc_value, "add_note"):
-                exc_value.add_note(
-                    "async live item capture context cleanup also failed: "
-                    f"{cleanup_error!r}"
-                )
+            exc_value.add_note(
+                "async live item capture context cleanup also failed: "
+                f"{cleanup_error!r}"
+            )
 
 
 class AsyncCalibrationSession:
@@ -644,8 +640,7 @@ class AsyncCalibrationSession:
                     self,
                     context="async live calibration context",
                 )
-            if hasattr(exc_value, "add_note"):
-                exc_value.add_note(
-                    "async live calibration context cleanup also failed: "
-                    f"{cleanup_error!r}"
-                )
+            exc_value.add_note(
+                "async live calibration context cleanup also failed: "
+                f"{cleanup_error!r}"
+            )

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/src/bdo_toolkit/_capture_runtime.py

@@ -64,18 +64,17 @@ def _attach_cleanup_owner(
         # Built-in and ordinary application exceptions expose __dict__. Keep
         # the original failure identity even for an exotic immutable subtype.
         pass
-    if hasattr(error, "add_note"):
-        if attached:
-            error.add_note(
-                f"{context} cleanup is incomplete; retry stop() on "
-                "exception.cleanup_owner"
-            )
-        else:
-            error.add_note(
-                f"{context} cleanup is incomplete; this exception subtype "
-                "cannot expose cleanup_owner, so retain and stop the original "
-                "session object"
-            )
+    if attached:
+        error.add_note(
+            f"{context} cleanup is incomplete; retry stop() on "
+            "exception.cleanup_owner"
+        )
+    else:
+        error.add_note(
+            f"{context} cleanup is incomplete; this exception subtype "
+            "cannot expose cleanup_owner, so retain and stop the original "
+            "session object"
+        )
 
 
 @dataclass(frozen=True)
@@ -456,11 +455,10 @@ class LivePacketCapture:
                     # Startup remains the primary failure, but incomplete
                     # cleanup must be explicit in its traceback and remains
                     # retryable through stop().
-                    if hasattr(exc, "add_note"):
-                        exc.add_note(
-                            "live capture startup cleanup also failed: "
-                            f"{cleanup_error!r}"
-                        )
+                    exc.add_note(
+                        "live capture startup cleanup also failed: "
+                        f"{cleanup_error!r}"
+                    )
                 if not self._cleanup_incomplete:
                     self._capture = None
                     self._capture_socket = None

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/src/bdo_toolkit/_framing.py

@@ -18,7 +18,7 @@ from ._protocol import (
 _TRANSFER_RECORD_MARKER = b"\x00" * 4 + b"\xff" * 8
 _TRANSFER_RECORD_MARKER_DELTA = 8
 
-MessageObserver = Callable[
+type MessageObserver = Callable[
     [int, int, str, int, PacketContext, Optional[int]],
     object,
 ]

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/src/bdo_toolkit/_protocol.py

@@ -330,7 +330,7 @@ class LootEvent:
     storage_operation: Optional[str] = None
 
 
-EventCallback = Callable[[LootEvent, bytes], None]
+type EventCallback = Callable[[LootEvent, bytes], None]
 
 
 @dataclass(frozen=True)

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/src/bdo_toolkit/_storage_hydration.py

@@ -11,7 +11,7 @@ from typing import Callable, Optional
 from .events import BDOEvent, Flow
 
 
-_HydrationKey = tuple[Flow, int]
+type _HydrationKey = tuple[Flow, int]
 
 
 def _hydration_key(event: BDOEvent) -> _HydrationKey:

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/src/bdo_toolkit/_version.py

@@ -1,3 +1,3 @@
 """Single source of truth for the BDO Toolkit release version."""
 
-__version__ = "1.0.0"
+__version__ = "1.0.1"

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/src/bdo_toolkit/calibration.py

@@ -1021,11 +1021,10 @@ class CalibrationSession:
                 try:
                     manager.finish()
                 except BaseException as cleanup_error:
-                    if hasattr(exc, "add_note"):
-                        exc.add_note(
-                            "calibration flow cleanup also failed: "
-                            f"{cleanup_error!r}"
-                        )
+                    exc.add_note(
+                        "calibration flow cleanup also failed: "
+                        f"{cleanup_error!r}"
+                    )
                 self._manager = None
                 self._capture = None
                 raise
@@ -1187,11 +1186,10 @@ class CalibrationSession:
                         self,
                         context="live calibration context",
                     )
-                if hasattr(exc_value, "add_note"):
-                    exc_value.add_note(
-                        "calibration context cleanup also failed: "
-                        f"{cleanup_error!r}"
-                    )
+                exc_value.add_note(
+                    "calibration context cleanup also failed: "
+                    f"{cleanup_error!r}"
+                )
 
 
 def calibrate_live(
@@ -3029,7 +3027,7 @@ def _calibration_source(options: _Options, action: str) -> str:
 
 def _iso_timestamp(timestamp: float) -> str:
     return (
-        dt.datetime.fromtimestamp(timestamp, tz=dt.timezone.utc)
+        dt.datetime.fromtimestamp(timestamp, tz=dt.UTC)
         .isoformat(timespec="seconds")
         .replace("+00:00", "Z")
     )
@@ -3037,7 +3035,7 @@ def _iso_timestamp(timestamp: float) -> str:
 
 def _utc_now_text() -> str:
     return (
-        dt.datetime.now(tz=dt.timezone.utc)
+        dt.datetime.now(tz=dt.UTC)
         .isoformat(timespec="seconds")
         .replace("+00:00", "Z")
     )
@@ -3173,7 +3171,7 @@ def _profile_dedupe_keys(data: dict[str, Any]) -> set[tuple[object, ...]]:
 def _backup_path(path: Path) -> Path:
     backup_dir = path.parent / "opcodes_backups"
     backup_dir.mkdir(parents=True, exist_ok=True)
-    stamp = dt.datetime.now(tz=dt.timezone.utc).strftime("%Y%m%d%H%M%S%f")
+    stamp = dt.datetime.now(tz=dt.UTC).strftime("%Y%m%d%H%M%S%f")
     candidate = backup_dir / f"{path.name}.bak.{stamp}"
     suffix = 1
     while candidate.exists():

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/src/bdo_toolkit/capture.py

@@ -52,9 +52,9 @@ from .profiles import (
 
 _PACKET_WORKER_STOP = object()
 _TARGET_FRAME_HISTORY_LIMIT = 4096
-_TargetFrameKey = tuple[FlowKey, int, Optional[int], float, int, int]
+type _TargetFrameKey = tuple[FlowKey, int, Optional[int], float, int, int]
 _INVENTORY_BOUNDARY_COHORT_LIMIT = 64
-_InventoryBoundaryKey = tuple[FlowKey, int, int]
+type _InventoryBoundaryKey = tuple[FlowKey, int, int]
 
 
 @dataclass
@@ -1111,11 +1111,10 @@ class LiveCaptureSession:
             with self._state_lock:
                 self._cleanup_incomplete = True
             for failure in cleanup_failures:
-                if hasattr(error, "add_note"):
-                    error.add_note(
-                        "live item capture startup cleanup also failed: "
-                        f"{failure!r}"
-                    )
+                error.add_note(
+                    "live item capture startup cleanup also failed: "
+                    f"{failure!r}"
+                )
             _attach_cleanup_owner(
                 error,
                 self,
@@ -1124,11 +1123,10 @@ class LiveCaptureSession:
             return
 
         for failure in cleanup_failures:
-            if hasattr(error, "add_note"):
-                error.add_note(
-                    "live item capture startup cleanup reported a fully "
-                    f"released error: {failure!r}"
-                )
+            error.add_note(
+                "live item capture startup cleanup reported a fully "
+                f"released error: {failure!r}"
+            )
         self._reset_after_failed_start()
 
     def _reset_after_failed_start(self) -> None:
@@ -1586,11 +1584,10 @@ class LiveCaptureSession:
                         self,
                         context="live item capture context",
                     )
-                if hasattr(exc_value, "add_note"):
-                    exc_value.add_note(
-                        "live item capture context cleanup also failed: "
-                        f"{cleanup_error!r}"
-                    )
+                exc_value.add_note(
+                    "live item capture context cleanup also failed: "
+                    f"{cleanup_error!r}"
+                )
 
 
 def capture_live(
@@ -1651,11 +1648,10 @@ def capture_live(
                         session,
                         context="timed live item capture startup",
                     )
-                if hasattr(exc, "add_note"):
-                    exc.add_note(
-                        "timed live item capture startup cleanup also "
-                        f"failed: {cleanup_error!r}"
-                    )
+                exc.add_note(
+                    "timed live item capture startup cleanup also "
+                    f"failed: {cleanup_error!r}"
+                )
             raise
     try:
         while True:

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/src/bdo_toolkit/character_state.py

@@ -3244,11 +3244,10 @@ class CharacterLoadSession:
                         self,
                         context="character-load capture context",
                     )
-                if hasattr(exc_value, "add_note"):
-                    exc_value.add_note(
-                        "character-load context cleanup also failed: "
-                        f"{cleanup_error!r}"
-                    )
+                exc_value.add_note(
+                    "character-load context cleanup also failed: "
+                    f"{cleanup_error!r}"
+                )
 
 
 def format_character_state(

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/src/bdo_toolkit/events.py

@@ -121,7 +121,7 @@ class BDOEvent:
     def timestamp_iso(self) -> str:
         """Deterministic UTC ISO-8601 timestamp for serialization."""
         return (
-            dt.datetime.fromtimestamp(self.timestamp, tz=dt.timezone.utc)
+            dt.datetime.fromtimestamp(self.timestamp, tz=dt.UTC)
             .isoformat(timespec="milliseconds")
             .replace("+00:00", "Z")
         )

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/src/bdo_toolkit/filters.py

@@ -3,14 +3,11 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
-from typing import Iterable, Optional, TypeVar
+from typing import Iterable, Optional
 
 from .events import BDOEvent
 
 
-T = TypeVar("T")
-
-
 _ACTIVITY_EVENT_TYPES = frozenset(
     {"loot_preview", "item_received", "storage_delta"}
 )
@@ -19,7 +16,7 @@ _SNAPSHOT_RECORD_EVENT_TYPES = frozenset(
 )
 
 
-def _freeze(values: Optional[Iterable[T]]) -> Optional[frozenset[T]]:
+def _freeze[T](values: Optional[Iterable[T]]) -> Optional[frozenset[T]]:
     if values is None:
         return None
     if isinstance(values, (str, bytes)):

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/src/bdo_toolkit/origin_learning.py

@@ -46,9 +46,9 @@ def _opcode_text(opcode: int) -> str:
 
 def _utc_text(timestamp: Optional[float] = None) -> str:
     value = (
-        dt.datetime.fromtimestamp(timestamp, tz=dt.timezone.utc)
+        dt.datetime.fromtimestamp(timestamp, tz=dt.UTC)
         if timestamp is not None
-        else dt.datetime.now(tz=dt.timezone.utc)
+        else dt.datetime.now(tz=dt.UTC)
     )
     return value.isoformat(timespec="seconds").replace("+00:00", "Z")
 
@@ -752,7 +752,7 @@ def promote_origin_candidates(
 def _unique_backup_path(path: Path) -> Path:
     backup_dir = path.parent / "opcodes_backups"
     backup_dir.mkdir(parents=True, exist_ok=True)
-    stamp = dt.datetime.now(tz=dt.timezone.utc).strftime("%Y%m%d%H%M%S%f")
+    stamp = dt.datetime.now(tz=dt.UTC).strftime("%Y%m%d%H%M%S%f")
     return backup_dir / f"{path.name}.bak.{stamp}"
 
 

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/src/bdo_toolkit/remote_profiles.py

@@ -339,7 +339,7 @@ def _is_sha256(value: str) -> bool:
 def _next_backup_path(path: Path) -> Path:
     backup_dir = path.parent / "opcodes_backups"
     backup_dir.mkdir(parents=True, exist_ok=True)
-    stamp = dt.datetime.now(tz=dt.timezone.utc).strftime("%Y%m%d%H%M%S%f")
+    stamp = dt.datetime.now(tz=dt.UTC).strftime("%Y%m%d%H%M%S%f")
     candidate = backup_dir / f"{path.name}.bak.{stamp}"
     suffix = 1
     while candidate.exists():

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/src/bdo_toolkit/solare/_discovery.py

@@ -25,7 +25,7 @@ from ._constants import (
 )
 
 
-_FamilyKey = tuple[FlowKey, int, int, int]
+type _FamilyKey = tuple[FlowKey, int, int, int]
 
 
 def _family_key(frame: BDOFrame) -> _FamilyKey:

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/src/bdo_toolkit/solare/async_session.py

@@ -8,7 +8,7 @@ from concurrent.futures import ThreadPoolExecutor
 from functools import partial
 from pathlib import Path
 from types import TracebackType
-from typing import AsyncIterator, Callable, Optional, TypeVar
+from typing import AsyncIterator, Callable, Optional
 
 from bdo_toolkit._capture_options import PacketCaptureOptions
 from bdo_toolkit._capture_runtime import _attach_cleanup_owner
@@ -22,14 +22,7 @@ from .models import (
 from .session import LiveSolareSession, _validate_timeout
 
 
-T = TypeVar("T")
-
-# Stay above the 15.625 ms monotonic-clock quantum used by Windows CPython
-# 3.10 so terminal cleanup polling yields instead of busy-spinning.
-_TERMINAL_SHUTDOWN_POLL_SECONDS = 0.05
-
-
-async def _settle(future: asyncio.Future[T]) -> T:
+async def _settle[T](future: asyncio.Future[T]) -> T:
     while not future.done():
         try:
             await asyncio.wait((future,))
@@ -38,7 +31,7 @@ async def _settle(future: asyncio.Future[T]) -> T:
     return future.result()
 
 
-async def _await_preserving_future(future: asyncio.Future[T]) -> T:
+async def _await_preserving_future[T](future: asyncio.Future[T]) -> T:
     """Await a worker future without cancelling it or creating a shield."""
 
     await asyncio.wait((future,))
@@ -114,7 +107,7 @@ class AsyncLiveSolareSession:
     def raise_if_failed(self) -> None:
         self._session.raise_if_failed()
 
-    def _submit(self, function: Callable[[], T]) -> asyncio.Future[T]:
+    def _submit[T](self, function: Callable[[], T]) -> asyncio.Future[T]:
         if self._closed:
             raise RuntimeError("async live Solare session is already closed")
         return asyncio.get_running_loop().run_in_executor(self._executor, function)
@@ -131,7 +124,7 @@ class AsyncLiveSolareSession:
 
         async def close_after_worker_and_calls_settle() -> None:
             while not self._session.stopped and not self._closed:
-                await asyncio.sleep(_TERMINAL_SHUTDOWN_POLL_SECONDS)
+                await asyncio.sleep(0.01)
             while not self._closed and (
                 self._start_active
                 or self._poll_active
@@ -141,7 +134,7 @@ class AsyncLiveSolareSession:
                     and not self._stop_future.done()
                 )
             ):
-                await asyncio.sleep(_TERMINAL_SHUTDOWN_POLL_SECONDS)
+                await asyncio.sleep(0.01)
             self._shutdown()
 
         self._terminal_shutdown_task = asyncio.create_task(
@@ -434,11 +427,10 @@ class AsyncLiveSolareSession:
                             self,
                             context="async live Solare context",
                         )
-                    if hasattr(exc_value, "add_note"):
-                        exc_value.add_note(
-                            "async live Solare context cleanup also failed: "
-                            f"{cleanup_error!r}"
-                        )
+                    exc_value.add_note(
+                        "async live Solare context cleanup also failed: "
+                        f"{cleanup_error!r}"
+                    )
         finally:
             if not self._session.cleanup_incomplete:
                 self._shutdown()

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/src/bdo_toolkit/solare/models.py

@@ -445,7 +445,7 @@ class SolareLeaderboardSnapshot:
     @property
     def observed_at_iso(self) -> str:
         return (
-            dt.datetime.fromtimestamp(self.observed_at, tz=dt.timezone.utc)
+            dt.datetime.fromtimestamp(self.observed_at, tz=dt.UTC)
             .isoformat(timespec="milliseconds")
             .replace("+00:00", "Z")
         )

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/src/bdo_toolkit/solare/session.py

@@ -980,11 +980,10 @@ class LiveSolareSession:
                     self,
                     context="live Solare context",
                 )
-            if hasattr(exc_value, "add_note"):
-                exc_value.add_note(
-                    "live Solare context cleanup also failed: "
-                    f"{cleanup_error!r}"
-                )
+            exc_value.add_note(
+                "live Solare context cleanup also failed: "
+                f"{cleanup_error!r}"
+            )
 
 
 def capture_solare_snapshot(
@@ -1043,7 +1042,7 @@ def capture_solare_snapshot(
                         session,
                         context="live Solare convenience wrapper",
                     )
-                if cleanup_error is not exc and hasattr(exc, "add_note"):
+                if cleanup_error is not exc:
                     exc.add_note(
                         "live Solare convenience cleanup also failed: "
                         f"{cleanup_error!r}"

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1/src/bdo_toolkit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bdo-toolkit
-Version: 1.0.0
+Version: 1.0.1
 Summary: Passive, read-only BDO packet parsing toolkit for app developers.
 Author: bdo-toolkit contributors
 License-Expression: MIT
@@ -12,9 +12,10 @@ Keywords: bdo,packets,parse,pcap,passive
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Typing :: Typed
-Requires-Python: >=3.10
+Requires-Python: >=3.14
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: scapy>=2.5
@@ -27,7 +28,7 @@ Dynamic: license-file
 # bdo-toolkit
 
 [![CI](https://img.shields.io/github/actions/workflow/status/ychwu/bdo-toolkit/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/ychwu/bdo-toolkit/actions/workflows/ci.yml)
-[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-3776AB?style=flat-square&logo=python&logoColor=white)](https://github.com/ychwu/bdo-toolkit/blob/main/pyproject.toml)
+[![Python 3.14+](https://img.shields.io/badge/python-3.14%2B-3776AB?style=flat-square&logo=python&logoColor=white)](https://github.com/ychwu/bdo-toolkit/blob/main/pyproject.toml)
 ![Tested on NA/EU](https://img.shields.io/badge/tested-NA%2FEU-5b61a8?style=flat-square)
 [![Package: Stable](https://img.shields.io/badge/package-stable-2f855a?style=flat-square)](https://ychwu.github.io/bdo-toolkit/#stability)
 [![License: MIT](https://img.shields.io/badge/license-MIT-2f855a?style=flat-square)](https://github.com/ychwu/bdo-toolkit/blob/main/LICENSE)
@@ -62,7 +63,7 @@ services is unknown.
 python -m pip install bdo-toolkit
 ```
 
-Python 3.10 or newer is required. Before live capture, complete
+Python 3.14 or newer is required. Before live capture, complete
 [Installation & setup](https://ychwu.github.io/bdo-toolkit/#capture-foundation),
 including Npcap on Windows and permission to capture on the selected interface.
 Offline PCAP and PCAPNG replay does not require Npcap.
@@ -134,7 +135,7 @@ python -m pip wheel . --no-deps --wheel-dir dist
 ```
 
 CI runs tests, type checking, wheel construction, and a CLI smoke test on
-Ubuntu and Windows with Python 3.10 and 3.14. Tests that require private
+Ubuntu and Windows with Python 3.14. Tests that require private
 game-session captures skip when those local fixtures are absent.
 
 ## License

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/tests/test_async_sessions.py

@@ -1015,10 +1015,7 @@ def test_async_calibration_cancelled_reuse_exposes_current_run_for_retry(
         with pytest.raises(asyncio.CancelledError) as cancelled:
             await starting
 
-        # CPython 3.10 reconstructs CancelledError when it crosses the Task
-        # boundary, which necessarily drops custom exception attributes.
-        if hasattr(asyncio.CancelledError, "add_note"):
-            assert cancelled.value.cleanup_owner is session
+        assert cancelled.value.cleanup_owner is session
         assert session.cleanup_incomplete
         assert session.running
         assert session.result is None

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/tests/test_calibration_lifecycle.py

@@ -521,11 +521,10 @@ def test_context_cleanup_failure_is_retained_without_masking_block_error(
 
     assert caught.value is block_failure
     assert session.error is _RaisingStopSniffer.failure
-    if hasattr(BaseException, "add_note"):
-        assert any(
-            "context cleanup also failed" in note
-            for note in caught.value.__notes__
-        )
+    assert any(
+        "context cleanup also failed" in note
+        for note in caught.value.__notes__
+    )
     assert not session.running
 
 

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/tests/test_capture_runtime.py

@@ -513,11 +513,10 @@ def test_startup_failure_retains_an_unstopped_backend_for_cleanup_retry(
     assert capture.running
     assert capture._capture is sniffer
     assert thread.join_calls == [runtime._CAPTURE_JOIN_TIMEOUT_SECONDS]
-    if hasattr(BaseException, "add_note"):
-        assert any(
-            "startup cleanup also failed" in note
-            for note in startup.value.__notes__
-        )
+    assert any(
+        "startup cleanup also failed" in note
+        for note in startup.value.__notes__
+    )
 
     thread.alive = False
     sniffer.running = False

{bdo_toolkit-1.0.0 → bdo_toolkit-1.0.1}/tests/test_solare_session.py

@@ -426,11 +426,7 @@ def test_capture_convenience_exposes_hidden_owner_on_incomplete_cleanup(
 
     assert failed.value is primary_failure
     assert primary_failure.cleanup_owner is IncompleteSession.instances[-1]
-    if hasattr(BaseException, "add_note"):
-        assert any(
-            "cleanup also failed" in note
-            for note in primary_failure.__notes__
-        )
+    assert any("cleanup also failed" in note for note in primary_failure.__notes__)
 
 
 def test_capture_convenience_allows_explicit_infinite_wait(
@@ -1677,10 +1673,10 @@ def test_async_finished_poll_closes_executor_after_callback_returns(
         assert not session._closed
         assert not session.stopped
         release_callback.set()
-        assert await asyncio.to_thread(session._session._stopped.wait, 2.0)
-        terminal_shutdown = session._terminal_shutdown_task
-        assert terminal_shutdown is not None
-        await asyncio.wait_for(asyncio.shield(terminal_shutdown), timeout=2.0)
+        for _ in range(200):
+            if session.stopped and session._closed:
+                break
+            await asyncio.sleep(0.01)
         assert session.stopped
         assert session._closed
 
@@ -2061,15 +2057,16 @@ def test_async_cancellation_returns_after_bounded_incomplete_cleanup(
             assert preserved.kind is SolareUpdateKind.FINISHED
 
         release_callback.set()
-        assert await asyncio.to_thread(session._session._stopped.wait, 2.0)
+        for _ in range(200):
+            if session.stopped:
+                break
+            await asyncio.sleep(0.01)
         assert session.stopped
         if operation == "poll":
-            terminal_shutdown = session._terminal_shutdown_task
-            assert terminal_shutdown is not None
-            await asyncio.wait_for(
-                asyncio.shield(terminal_shutdown),
-                timeout=2.0,
-            )
+            for _ in range(200):
+                if session._closed:
+                    break
+                await asyncio.sleep(0.01)
             assert session._closed
         with pytest.raises(RuntimeError, match="worker cleanup is incomplete"):
             await session.stop()