koebelt-dash-scripts 1.3.0b2__tar.gz → 1.3.0b3__tar.gz

{koebelt_dash_scripts-1.3.0b2 → koebelt_dash_scripts-1.3.0b3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: koebelt-dash-scripts
-Version: 1.3.0b2
+Version: 1.3.0b3
 Summary: Control drones, robots and test rigs connected in the koebelt/dash app from Python.
 Author-email: Thomas Koebel <contact@koebelt.com>
 License-Expression: MIT

{koebelt_dash_scripts-1.3.0b2 → koebelt_dash_scripts-1.3.0b3}/koebelt_dash_scripts/__init__.py

@@ -6,7 +6,7 @@
         dev.sticks(throttle=0.3)
 """
 
-__version__ = "1.3.0b2"
+__version__ = "1.3.0b3"
 
 from .camera import Camera, CameraError, decode_jpeg  # noqa: E402
 from .client import Device, Released, ScriptError, Setting, Telemetry, connect, every, wait  # noqa: E402

{koebelt_dash_scripts-1.3.0b2 → koebelt_dash_scripts-1.3.0b3}/koebelt_dash_scripts/client.py

@@ -526,11 +526,34 @@ def connect(device: Optional[str] = None, *, url: Optional[str] = None, token: O
         ws.close()
         raise ScriptError("E0012", {"reason": welcome.get("why") or "no reason given"})
     dev = Device(ws, welcome, name)
+    _check_version(welcome.get("app"))
     dev._use(device)
     _current = dev
     return dev
 
 
+def _version_key(v: str):
+    """1.3.0b2 or 1.3.0-beta.2 → a sortable tuple (a release after its betas)."""
+    import re
+    m = re.match(r"^(\d+)\.(\d+)\.(\d+)(?:-?(a|alpha|b|beta|rc)\.?(\d+))?", v or "")
+    if not m:
+        return None
+    stage = {"a": 0, "alpha": 0, "b": 1, "beta": 1, "rc": 2}.get(m.group(4) or "", 3)
+    return (int(m.group(1)), int(m.group(2)), int(m.group(3)), stage, int(m.group(5) or 0))
+
+
+def _check_version(app: Optional[str]) -> None:
+    """Warns once when this library is older than the dash it talks to."""
+    from . import __version__
+    have, want = _version_key(__version__), _version_key(app or "")
+    if have is None or want is None or have >= want:
+        return
+    # The package is released with the app, at its version: ask for at least that one.
+    major, minor, patch, stage, n = want
+    pep = f"{major}.{minor}.{patch}" + ("" if stage == 3 else f"{['a', 'b', 'rc'][stage]}{n}")
+    warn_once("W0102", "version", {"have": __version__, "app": app, "spec": f">={pep},<2"})
+
+
 def every(seconds: float) -> Iterator[int]:
     """A steady loop: ``for i in every(0.05): ...`` runs the body every 50 ms
     (or as fast as it can), and reports the real rate to dash."""

{koebelt_dash_scripts-1.3.0b2 → koebelt_dash_scripts-1.3.0b3}/koebelt_dash_scripts/errors.py

@@ -139,6 +139,9 @@ CATALOG: Dict[str, Tuple[str, str, str]] = {
 }
 
 WARNINGS: Dict[str, Tuple[str, str, str]] = {
+    "W0102": ("koebelt-dash-scripts {have} is older than koebelt dash {app}",
+              "a newer library may fix bugs or add what this dash offers; this one still works with it",
+              "pip install --upgrade \"koebelt-dash-scripts{spec}\"   (in dash: the script's panel > Update)"),
     "W0201": ("{name}={value} is outside −1…1: dash uses {clamped}",
               "sticks go from −1 to 1",
               "clamp it yourself (koebelt_dash_scripts.clamp) to silence this"),

{koebelt_dash_scripts-1.3.0b2 → koebelt_dash_scripts-1.3.0b3}/koebelt_dash_scripts.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: koebelt-dash-scripts
-Version: 1.3.0b2
+Version: 1.3.0b3
 Summary: Control drones, robots and test rigs connected in the koebelt/dash app from Python.
 Author-email: Thomas Koebel <contact@koebelt.com>
 License-Expression: MIT

{koebelt_dash_scripts-1.3.0b2 → koebelt_dash_scripts-1.3.0b3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "koebelt-dash-scripts"
-version = "1.3.0b2"
+version = "1.3.0b3"
 description = "Control drones, robots and test rigs connected in the koebelt/dash app from Python."
 readme = "README.md"
 requires-python = ">=3.9"

{koebelt_dash_scripts-1.3.0b2 → koebelt_dash_scripts-1.3.0b3}/tests/test_errors.py

@@ -89,3 +89,13 @@ def test_an_uncaught_error_prints_rust_style_without_the_librarys_traceback(tmp_
     assert "--> my_script.py:4" in r.stderr and "k.connect()" in r.stderr
     assert "called from: my_script.py:6 <module>()" in r.stderr
     assert "Traceback" not in r.stderr and "client.py" not in r.stderr
+
+
+def test_warns_when_older_than_dash(dash, capsys):  # noqa: F811
+    from koebelt_dash_scripts import client
+    client._check_version("9.0.0")
+    assert "warning[W0102]: koebelt-dash-scripts" in capsys.readouterr().err
+    client._check_version("0.1.0")
+    client._check_version(k.__version__)
+    assert capsys.readouterr().err == "", "not older: no warning"
+    assert client._version_key("1.3.0b2") < client._version_key("1.3.0-beta.3") < client._version_key("1.3.0rc1") < client._version_key("1.3.0")