Type annotations update (#303)

### Added
- `Calculator` now can be used as a context manager

### Changed
- `Calculator` - improved initialisation and type annotations
- engines `__init__` signature adjusted for consistency

### Fixed
- Type annotations fix in `unit.py`
- `EngineProtocol` - type annotations fix
- `Calculator` - type annotations fix
- Type annotations modernized to Python 3.10+ style (PEP 604, PEP 585)
  - `Optional[X]` → `X | None`
  - `Union[X, Y]` → `X | Y`
  - `List[X]` → `list[X]`, `Dict[K, V]` → `dict[K, V]`, `Tuple[X, Y]` → `tuple[X, Y]`
  - Removed unused typing imports
  - Updated .pyi stub files for Cython extensions
  - Added type guards in `uconv.py`

Author: o-murphy

.github/workflows/pypi-publish.yml

@@ -86,7 +86,7 @@ jobs:
           cibuildwheel py_ballisticcalc.exts --output-dir dist --platform auto --archs ${{ matrix.cibw_archs }}
         shell: bash
 
-      - name: List ./dist
+      - name: list ./dist
         run: ls ./dist
         shell: bash
 
@@ -117,7 +117,7 @@ jobs:
           find ./all-dist -type f -exec cp {} dist/ \;
         shell: bash
 
-      - name: List ./dist
+      - name: list ./dist
         run: ls ./dist
         shell: bash
 

CHANGELOG.md

@@ -7,6 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.2.8] - 2026-01-26
+[:simple-github: GitHub release][2.2.8]
+
+### Added
+- `Calculator` now can be used as a context manager
+
+### Changed
+- `Calculator` - improved initialisation and type annotations
+- engines `__init__` signature adjusted for consistency
+
+### Fixed
+- Type annotations fix in `unit.py`
+- `EngineProtocol` - type annotations fix
+- `Calculator` - type annotations fix
+- Type annotations modernized to Python 3.10+ style (PEP 604, PEP 585)
+  - `Optional[X]` → `X | None`
+  - `Union[X, Y]` → `X | Y`
+  - `List[X]` → `list[X]`, `Dict[K, V]` → `dict[K, V]`, `Tuple[X, Y]` → `tuple[X, Y]`
+  - Removed unused typing imports
+  - Updated .pyi stub files for Cython extensions
+  - Added type guards in `uconv.py`
+
 ## [2.2.7] - 2025-12-26
 [:simple-github: GitHub release][2.2.7]
 
@@ -500,7 +522,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Issue #141
 - Trajectories that bend backwards
 
-[Unreleased]: https://github.com/o-murphy/py-ballisticcalc/compare/v2.2.7...HEAD
+[Unreleased]: https://github.com/o-murphy/py-ballisticcalc/compare/v2.2.8...HEAD
+[2.2.8]: https://github.com/o-murphy/py-ballisticcalc/releases/tag/v2.2.8
 [2.2.7]: https://github.com/o-murphy/py-ballisticcalc/releases/tag/v2.2.7
 [2.2.6.post1]: https://github.com/o-murphy/py-ballisticcalc/releases/tag/v2.2.6.post1
 [2.2.6]: https://github.com/o-murphy/py-ballisticcalc/releases/tag/v2.2.6

examples/aerial_target/aerial_target.py

@@ -2,7 +2,7 @@
 import math
 from dataclasses import dataclass, field
 
-from typing_extensions import Union, NamedTuple, Tuple
+from typing import Union, NamedTuple
 
 from py_ballisticcalc import *
 
@@ -88,7 +88,7 @@ def __repr__(self):
         fields = ', '.join(f"{k}={v!r}" for k, v in preferred.items())
         return f"AerialTarget({fields})"
 
-    def at_time(self, time_of_flight: float) -> Tuple['AerialTarget', AerialTargetPosition]:
+    def at_time(self, time_of_flight: float) -> tuple['AerialTarget', AerialTargetPosition]:
         [
             velocity_fps,
             slant_distance_ft,

examples/performance_check.py

@@ -131,7 +131,7 @@ def run_check(calc_: Calculator, number: int):
     print(f"Total time: {total_time:.6f} seconds")
     print(f"Execution rate: {rate:.2f} calls per second")
 
-    if calc_._engine_class.__name__.lower().startswith("cythonized"):
+    if calc_._engine_factory.__name__.lower().startswith("cythonized"):
         key_attribute = 'position.x'
         target_value = shot_distance._feet