tigrbl-core 0.4.5.dev1__tar.gz → 0.4.5.dev4__tar.gz

{tigrbl_core-0.4.5.dev1 → tigrbl_core-0.4.5.dev4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl-core
-Version: 0.4.5.dev1
+Version: 0.4.5.dev4
 Summary: Core Tigrbl framework specifications, decorators, schemas, hooks, operations, and primitives for schema-first APIs.
 License: Apache License
                                     Version 2.0, January 2004

{tigrbl_core-0.4.5.dev1 → tigrbl_core-0.4.5.dev4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tigrbl-core"
-version = "0.4.5.dev1"
+version = "0.4.5.dev4"
 description = "Core Tigrbl framework specifications, decorators, schemas, hooks, operations, and primitives for schema-first APIs."
 readme = "README.md"
 license = { file = "LICENSE" }

{tigrbl_core-0.4.5.dev1 → tigrbl_core-0.4.5.dev4}/tigrbl_core/_spec/op_spec.py

@@ -1,7 +1,9 @@
 from __future__ import annotations
 
 from dataclasses import dataclass, field
+from importlib import metadata as importlib_metadata
 import inspect
+import warnings
 from typing import (
     TYPE_CHECKING,
     Any,
@@ -59,6 +61,11 @@ TargetOp = Literal[
     "custom",
 ]
 
+_CANONICAL_OP_SPEC_ATTR = "__tigrbl_op_spec__"
+_LEGACY_OP_DECL_ATTR = "__tigrbl_op_decl__"
+_LEGACY_OP_DECL_FALLBACK_VERSION = "0.4.5.dev1"
+_LEGACY_OP_DECL_FAILS_IN = (0, 7)
+
 
 if TYPE_CHECKING:  # pragma: no cover
     from .._spec.engine_spec import EngineCfg
@@ -151,6 +158,46 @@ class OpSpec(SerdeMixin):
 
 
 _ALIAS_RE = __import__("re").compile(r"^[a-z][a-z0-9_]*$")
+_VERSION_RE = __import__("re").compile(r"^\s*(\d+)\.(\d+)")
+
+
+def _parse_major_minor(version: str) -> tuple[int, int]:
+    match = _VERSION_RE.match(version)
+    if match is None:
+        return (0, 0)
+    return (int(match.group(1)), int(match.group(2)))
+
+
+def _current_major_minor() -> tuple[int, int]:
+    try:
+        version = importlib_metadata.version("tigrbl-core")
+    except importlib_metadata.PackageNotFoundError:
+        version = _LEGACY_OP_DECL_FALLBACK_VERSION
+    return _parse_major_minor(version)
+
+
+def _warn_or_fail_legacy_op_decl() -> None:
+    if _current_major_minor() >= _LEGACY_OP_DECL_FAILS_IN:
+        raise RuntimeError(
+            "__tigrbl_op_decl__ is no longer supported; use "
+            "__tigrbl_op_spec__ for operation metadata."
+        )
+    warnings.warn(
+        "__tigrbl_op_decl__ is deprecated and will be removed in "
+        "tigrbl-core 0.7.0; use __tigrbl_op_spec__ instead.",
+        DeprecationWarning,
+        stacklevel=3,
+    )
+
+
+def _get_decorated_op_spec(func: Any) -> Optional["OpSpec"]:
+    op_spec: OpSpec | None = getattr(func, _CANONICAL_OP_SPEC_ATTR, None)
+    if op_spec is not None:
+        return op_spec
+    op_spec = getattr(func, _LEGACY_OP_DECL_ATTR, None)
+    if op_spec is not None:
+        _warn_or_fail_legacy_op_decl()
+    return op_spec
 
 
 def _ensure_spec_table(spec: Any, table: type) -> OpSpec:
@@ -484,9 +531,7 @@ def _mro_collect_decorated_ops(table: type) -> List["OpSpec"]:
             if name in seen:
                 continue
             func = _unwrap(attr)
-            op_spec: OpSpec | None = getattr(func, "__tigrbl_op_spec__", None)
-            if op_spec is None:
-                op_spec = getattr(func, "__tigrbl_op_decl__", None)
+            op_spec = _get_decorated_op_spec(func)
             if op_spec is None:
                 continue