tigrbl-typing 0.4.5.dev4__tar.gz → 0.4.5.dev6__tar.gz

{tigrbl_typing-0.4.5.dev4 → tigrbl_typing-0.4.5.dev6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl-typing
-Version: 0.4.5.dev4
+Version: 0.4.5.dev6
 Summary: Typing protocols, aliases, generics, and shared type helpers for Tigrbl framework packages and extensions.
 License: Apache License
                                     Version 2.0, January 2004
@@ -230,7 +230,7 @@ Project-URL: Discord, https://discord.gg/K4YTAPapjR
 Project-URL: Homepage, https://github.com/tigrbl/tigrbl
 Project-URL: Issues, https://github.com/tigrbl/tigrbl/issues
 Project-URL: Organization, https://github.com/tigrbl
-Project-URL: Repository, https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_typing
+Project-URL: Repository, https://github.com/tigrbl/tigrbl/tree/master/pkgs/00_typing/tigrbl_typing
 Description-Content-Type: text/markdown
 
 <div align="center">
@@ -240,7 +240,7 @@ Description-Content-Type: text/markdown
 <a href="https://pypi.org/project/tigrbl-typing/"><img src="https://img.shields.io/pypi/v/tigrbl-typing?label=PyPI" alt="PyPI version for tigrbl-typing"/></a>
 <a href="https://pypi.org/project/tigrbl-typing/"><img src="https://static.pepy.tech/badge/tigrbl-typing" alt="Downloads for tigrbl-typing"/></a>
 <a href="https://discord.gg/K4YTAPapjR"><img src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white" alt="Discord community for tigrbl-typing"/></a>
-<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_typing/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_typing/README.md.svg?label=hits" alt="Repository hits for tigrbl-typing README"/></a>
+<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/00_typing/tigrbl_typing/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/00_typing/tigrbl_typing/README.md.svg?label=hits" alt="Repository hits for tigrbl-typing README"/></a>
 <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
 <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-3776ab" alt="Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl-typing"/></a>
 <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-core-1f6feb" alt="Workspace group for tigrbl-typing"/></a>
@@ -264,7 +264,7 @@ Framework maintainers, extension authors, and advanced users composing Tigrbl fr
 
 ## Where does tigrbl-typing fit?
 
-`tigrbl-typing` lives at `pkgs/core/tigrbl_typing` and serves a focused layer in the split Tigrbl framework.
+`tigrbl-typing` lives at `pkgs/00_typing/tigrbl_typing` and serves a focused layer in the split Tigrbl framework.
 
 ## How does tigrbl-typing work?
 
@@ -286,7 +286,7 @@ pip install tigrbl-typing
 | Surface | Value |
 |---|---|
 | PyPI package | [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/) |
-| Repository path | [`pkgs/core/tigrbl_typing`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_typing) |
+| Repository path | [`pkgs/00_typing/tigrbl_typing`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/00_typing/tigrbl_typing) |
 | Python import root | `tigrbl_typing` |
 | Console scripts | none declared |
 | Entry points | none declared |
@@ -375,7 +375,7 @@ Choose `tigrbl-typing` when the quick-answer table matches your use case. Choose
 
 - Community: [Discord](https://discord.gg/K4YTAPapjR).
 - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
-- Repository: [pkgs/core/tigrbl_typing](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_typing).
+- Repository: [pkgs/00_typing/tigrbl_typing](https://github.com/tigrbl/tigrbl/tree/master/pkgs/00_typing/tigrbl_typing).
 
 ## Package-local Boundary
 
@@ -386,7 +386,7 @@ This README is the package-local distribution entry point for `tigrbl-typing`. I
 - 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`.
+- Local certification guard: `pkgs/97_tests/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

{tigrbl_typing-0.4.5.dev4 → tigrbl_typing-0.4.5.dev6}/README.md

@@ -5,7 +5,7 @@
 <a href="https://pypi.org/project/tigrbl-typing/"><img src="https://img.shields.io/pypi/v/tigrbl-typing?label=PyPI" alt="PyPI version for tigrbl-typing"/></a>
 <a href="https://pypi.org/project/tigrbl-typing/"><img src="https://static.pepy.tech/badge/tigrbl-typing" alt="Downloads for tigrbl-typing"/></a>
 <a href="https://discord.gg/K4YTAPapjR"><img src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white" alt="Discord community for tigrbl-typing"/></a>
-<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_typing/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_typing/README.md.svg?label=hits" alt="Repository hits for tigrbl-typing README"/></a>
+<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/00_typing/tigrbl_typing/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/00_typing/tigrbl_typing/README.md.svg?label=hits" alt="Repository hits for tigrbl-typing README"/></a>
 <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
 <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-3776ab" alt="Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl-typing"/></a>
 <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-core-1f6feb" alt="Workspace group for tigrbl-typing"/></a>
@@ -29,7 +29,7 @@ Framework maintainers, extension authors, and advanced users composing Tigrbl fr
 
 ## Where does tigrbl-typing fit?
 
-`tigrbl-typing` lives at `pkgs/core/tigrbl_typing` and serves a focused layer in the split Tigrbl framework.
+`tigrbl-typing` lives at `pkgs/00_typing/tigrbl_typing` and serves a focused layer in the split Tigrbl framework.
 
 ## How does tigrbl-typing work?
 
@@ -51,7 +51,7 @@ pip install tigrbl-typing
 | Surface | Value |
 |---|---|
 | PyPI package | [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/) |
-| Repository path | [`pkgs/core/tigrbl_typing`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_typing) |
+| Repository path | [`pkgs/00_typing/tigrbl_typing`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/00_typing/tigrbl_typing) |
 | Python import root | `tigrbl_typing` |
 | Console scripts | none declared |
 | Entry points | none declared |
@@ -140,7 +140,7 @@ Choose `tigrbl-typing` when the quick-answer table matches your use case. Choose
 
 - Community: [Discord](https://discord.gg/K4YTAPapjR).
 - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
-- Repository: [pkgs/core/tigrbl_typing](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_typing).
+- Repository: [pkgs/00_typing/tigrbl_typing](https://github.com/tigrbl/tigrbl/tree/master/pkgs/00_typing/tigrbl_typing).
 
 ## Package-local Boundary
 
@@ -151,7 +151,7 @@ This README is the package-local distribution entry point for `tigrbl-typing`. I
 - 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`.
+- Local certification guard: `pkgs/97_tests/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

{tigrbl_typing-0.4.5.dev4 → tigrbl_typing-0.4.5.dev6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tigrbl-typing"
-version = "0.4.5.dev4"
+version = "0.4.5.dev6"
 description = "Typing protocols, aliases, generics, and shared type helpers for Tigrbl framework packages and extensions."
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -49,7 +49,7 @@ dependencies = [
 Organization = "https://github.com/tigrbl"
 Discord = "https://discord.gg/K4YTAPapjR"
 Homepage = "https://github.com/tigrbl/tigrbl"
-Repository = "https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_typing"
+Repository = "https://github.com/tigrbl/tigrbl/tree/master/pkgs/00_typing/tigrbl_typing"
 Issues = "https://github.com/tigrbl/tigrbl/issues"
 
 [build-system]
@@ -68,4 +68,5 @@ dev = [
     "pytest-asyncio>=0.24.0",
     "pytest-timeout>=2.3.1",
     "ruff>=0.9",
+    "sqlalchemy>=2.0",
 ]

{tigrbl_typing-0.4.5.dev4 → tigrbl_typing-0.4.5.dev6}/tigrbl_typing/types/__init__.py

@@ -1,13 +1,16 @@
 # ── Standard Library ─────────────────────────────────────────────────────
+from importlib.metadata import version as distribution_version
 from types import MethodType, SimpleNamespace
 from uuid import uuid4, UUID
+import warnings
 
 # ── Third-party Dependencies (via deps module) ───────────────────────────
 from ..vendor.sqlalchemy import (
     # Core SQLAlchemy
     Boolean,
-    Column,
+    Column as _SQLAlchemyColumn,
     _DateTime,
+    Float,
     SAEnum,
     Text,
     ForeignKey,
@@ -27,11 +30,11 @@ from ..vendor.sqlalchemy import (
     JSONB,
     TSVECTOR,
     # ORM
-    Mapped,
+    Mapped as _SQLAlchemyMapped,
     declarative_mixin,
     declared_attr,
     foreign,
-    mapped_column,
+    mapped_column as _sqlalchemy_mapped_column,
     relationship,
     remote,
     column_property,
@@ -57,6 +60,7 @@ from ..status.exceptions import StatusDetailError
 
 # ── Local Package ─────────────────────────────────────────────────────────
 from .channel import OpChannel, OpChannelFamily, OpChannelKind, OpChannelSubevent
+from ._datetime import tzutcnow, tzutcnow_plus_day
 from .op import _Op, _SchemaVerb
 from .uuid import PgUUID, SqliteUUID
 from .authn_abc import AuthNProvider
@@ -66,6 +70,39 @@ DateTime = _DateTime(timezone=False)
 TZDateTime = _DateTime(timezone=True)
 
 
+DEPRECATED_EXPORTS_CUTOFF = (0, 7)
+
+_DEPRECATED_EXPORTS = {
+    "Column": _SQLAlchemyColumn,
+    "Mapped": _SQLAlchemyMapped,
+    "mapped_column": _sqlalchemy_mapped_column,
+}
+_DEPRECATED_EXPORTS_MESSAGE = (
+    "{name} is deprecated in tigrbl_typing.types and will no longer be exported "
+    "starting with tigrbl-typing 0.7. Import Column from 'tigrbl_concrete', or "
+    "use 'tigrbl_concrete.factories.makeColumn', 'makeVirtualColumn', 'acol', or "
+    "'vcol'. For SQLAlchemy declarative typing, import Mapped and mapped_column "
+    "from 'sqlalchemy.orm'."
+)
+
+
+def _major_minor(value: str) -> tuple[int, int]:
+    release = value.split("+", 1)[0].split(".dev", 1)[0]
+    major, minor, *_ = release.split(".")
+    return int(major), int(minor)
+
+
+def _deprecated_export_names_for(
+    current_major_minor: tuple[int, int],
+) -> list[str]:
+    if current_major_minor >= DEPRECATED_EXPORTS_CUTOFF:
+        return []
+    return list(_DEPRECATED_EXPORTS)
+
+
+_CURRENT_MAJOR_MINOR = _major_minor(distribution_version("tigrbl-typing"))
+
+
 # ── Public Re-exports (Backwards Compatibility) ──────────────────────────
 __all__: list[str] = [
     # local
@@ -85,9 +122,11 @@ __all__: list[str] = [
     "UUID",
     # sqlalchemy core (from deps.sqlalchemy)
     "Boolean",
-    "Column",
     "DateTime",
     "TZDateTime",
+    "tzutcnow",
+    "tzutcnow_plus_day",
+    "Float",
     "Text",
     "SAEnum",
     "ForeignKey",
@@ -108,11 +147,9 @@ __all__: list[str] = [
     "PgUUID",
     "TSVECTOR",
     # sqlalchemy.orm (from deps.sqlalchemy)
-    "Mapped",
     "declarative_mixin",
     "declared_attr",
     "foreign",
-    "mapped_column",
     "column_property",
     "hybrid_property",
     "relationship",
@@ -132,3 +169,22 @@ __all__: list[str] = [
     # status
     "StatusDetailError",
 ]
+
+__all__.extend(_deprecated_export_names_for(_CURRENT_MAJOR_MINOR))
+
+
+def __getattr__(name: str):
+    value = _DEPRECATED_EXPORTS.get(name)
+    if value is None:
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+    if _CURRENT_MAJOR_MINOR >= DEPRECATED_EXPORTS_CUTOFF:
+        raise AttributeError(
+            f"{name} is no longer exported by tigrbl_typing.types as of "
+            "tigrbl-typing 0.7. " + _DEPRECATED_EXPORTS_MESSAGE.format(name=name)
+        )
+    warnings.warn(
+        _DEPRECATED_EXPORTS_MESSAGE.format(name=name),
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return value

tigrbl_typing-0.4.5.dev6/tigrbl_typing/types/_datetime.py

@@ -0,0 +1,11 @@
+from datetime import datetime, timedelta, timezone
+
+
+def tzutcnow() -> datetime:
+    """Return the current time as a timezone-aware UTC datetime."""
+    return datetime.now(timezone.utc)
+
+
+def tzutcnow_plus_day() -> datetime:
+    """Return a timezone-aware UTC datetime one day in the future."""
+    return tzutcnow() + timedelta(days=1)

{tigrbl_typing-0.4.5.dev4 → tigrbl_typing-0.4.5.dev6}/tigrbl_typing/vendor/sqlalchemy.py

@@ -6,6 +6,7 @@ from sqlalchemy import (
     Column,
     DateTime as _DateTime,
     Enum as SAEnum,
+    Float,
     ForeignKey,
     Index,
     Integer,
@@ -48,6 +49,7 @@ __all__ = [
     "Column",
     "_DateTime",
     "SAEnum",
+    "Float",
     "Text",
     "ForeignKey",
     "Index",