stel 0.9.0__py3-none-any.whl

stel/__init__.py

@@ -0,0 +1,3 @@
+from ._distribution import distribution_version
+
+__version__ = distribution_version()

stel/_distribution.py

@@ -0,0 +1,34 @@
+"""The installed distribution's name and version.
+
+`DISTRIBUTION_NAME` must equal `[project] name` in pyproject.toml. Asking
+`importlib.metadata` for a name that is not installed does not raise here — it
+degrades to `"unknown"`, because a source checkout has no distribution metadata
+and that must not break `--help`. The same tolerance means a stale name is
+invisible: every lookup keeps working and just reports `"unknown"`.
+
+That matters because the value is durable. It is written into run_results
+metadata, into every extracted row's parser identity, and into the `runtime`
+block of every fitted classic-ML artifact — where it is validated on load. Four
+call sites each performed this lookup independently; one of them drifting would
+silently change what those artifacts record. Hence one definition, and
+`tests/test_frozen_names.py` asserting the resolved version is not `"unknown"`.
+
+Not memoized: the lookup keeps `importlib.metadata`'s exact semantics so this
+module changes no behavior.
+"""
+
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError, version
+
+DISTRIBUTION_NAME = "stel"
+
+UNKNOWN_VERSION = "unknown"
+
+
+def distribution_version() -> str:
+    """The installed stel version, or `"unknown"` outside an installation."""
+    try:
+        return version(DISTRIBUTION_NAME)
+    except PackageNotFoundError:
+        return UNKNOWN_VERSION

stel/adapters/__init__.py

@@ -0,0 +1,77 @@
+from . import (
+    bigquery,  # noqa: F401  # side-effect: registers BigQueryAdapter
+    duckdb,  # noqa: F401  # side-effect: registers DuckDBAdapter
+)
+from .base import (
+    AdapterCapabilityError,
+    AdapterConfigError,
+    AdapterError,
+    LegacyWarehouseNamesError,
+    ReadOrdering,
+    ReadPredicate,
+    ReadPredicateOperator,
+    SchemaChangePlan,
+    StaleStateFenceError,
+    StateAbsenceProbe,
+    StatePage,
+    StatePageReader,
+    StatePageRecord,
+    StateRecord,
+    StateScope,
+    StateScopeFence,
+    StateValue,
+    TableReadRequest,
+    TableReadSnapshot,
+    WarehouseAdapter,
+    WarehouseCapability,
+)
+from .migration import (
+    MigrationConflictError,
+    TableRename,
+    apply_name_migration,
+    plan_name_migration,
+)
+from .registry import (
+    UnknownAdapterError,
+    adapter_capabilities,
+    create_adapter,
+    list_adapter_types,
+    parse_warehouse_config,
+    prepare_warehouse_profile_input,
+    register,
+)
+
+__all__ = [
+    "AdapterCapabilityError",
+    "AdapterConfigError",
+    "AdapterError",
+    "LegacyWarehouseNamesError",
+    "MigrationConflictError",
+    "ReadOrdering",
+    "ReadPredicate",
+    "ReadPredicateOperator",
+    "SchemaChangePlan",
+    "StaleStateFenceError",
+    "StateAbsenceProbe",
+    "StatePage",
+    "StatePageReader",
+    "StatePageRecord",
+    "StateRecord",
+    "StateScope",
+    "StateScopeFence",
+    "StateValue",
+    "TableReadRequest",
+    "TableReadSnapshot",
+    "TableRename",
+    "UnknownAdapterError",
+    "WarehouseAdapter",
+    "WarehouseCapability",
+    "adapter_capabilities",
+    "apply_name_migration",
+    "create_adapter",
+    "list_adapter_types",
+    "parse_warehouse_config",
+    "plan_name_migration",
+    "prepare_warehouse_profile_input",
+    "register",
+]