tigrbl-core 0.4.4.dev8__tar.gz → 0.4.5.dev4__tar.gz

{tigrbl_core-0.4.4.dev8 → tigrbl_core-0.4.5.dev4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl-core
-Version: 0.4.4.dev8
+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
@@ -275,13 +275,6 @@ Framework maintainers, extension authors, and advanced users composing Tigrbl fr
 
 It owns a narrow layer in the split workspace and is consumed by higher-level packages through explicit dependencies.
 
-## Certification Status
-
-- Package status: governed package in the `tigrbl/tigrbl` workspace.
-- Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
-- Release evidence: [publish workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml) validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
-- Local certification guard: `pkgs/core/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
-- Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
 
 ## Install
 
@@ -473,6 +466,14 @@ Choose `tigrbl-core` when the quick-answer table matches your use case. Choose [
 
 This file is a package-local distribution entry point. This README is the package-local distribution entry point for `tigrbl-core`. It answers install, usage, API, ownership, and certification-orientation questions for this package. Broader architectural decisions, release status, and cross-package proof chains remain in the repository-level docs and SSOT registry.
 
+## Certification Status
+
+- Package status: governed package in the `tigrbl/tigrbl` workspace.
+- Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
+- Release evidence: [publish workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml) validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
+- Local certification guard: `pkgs/core/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
+- Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
+
 ## License
 
 Licensed under the Apache License, Version 2.0. See `LICENSE`, `NOTICE`, and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).

{tigrbl_core-0.4.4.dev8 → tigrbl_core-0.4.5.dev4}/README.md

@@ -35,13 +35,6 @@ Framework maintainers, extension authors, and advanced users composing Tigrbl fr
 
 It owns a narrow layer in the split workspace and is consumed by higher-level packages through explicit dependencies.
 
-## Certification Status
-
-- Package status: governed package in the `tigrbl/tigrbl` workspace.
-- Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
-- Release evidence: [publish workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml) validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
-- Local certification guard: `pkgs/core/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
-- Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
 
 ## Install
 
@@ -233,6 +226,14 @@ Choose `tigrbl-core` when the quick-answer table matches your use case. Choose [
 
 This file is a package-local distribution entry point. This README is the package-local distribution entry point for `tigrbl-core`. It answers install, usage, API, ownership, and certification-orientation questions for this package. Broader architectural decisions, release status, and cross-package proof chains remain in the repository-level docs and SSOT registry.
 
+## Certification Status
+
+- Package status: governed package in the `tigrbl/tigrbl` workspace.
+- Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
+- Release evidence: [publish workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml) validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
+- Local certification guard: `pkgs/core/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
+- Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
+
 ## License
 
 Licensed under the Apache License, Version 2.0. See `LICENSE`, `NOTICE`, and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).

{tigrbl_core-0.4.4.dev8 → tigrbl_core-0.4.5.dev4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tigrbl-core"
-version = "0.4.4.dev8"
+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.4.dev8 → 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