krons 0.1.1__py3-none-any.whl → 0.2.0__py3-none-any.whl

krons/enforcement/__init__.py

@@ -1,57 +0,0 @@
-# Copyright (c) 2025 - 2026, HaiyangLi <quantocean.li at gmail dot com>
-# SPDX-License-Identifier: Apache-2.0
-
-"""Enforcement module - Validation and policy protocols.
-
-Provides:
-- Rule: Base validation rule with auto-correction support
-- Validator: Validates data against Spec/Operable using rules
-- RuleRegistry: Maps types to validation rules
-- Policy protocols: Abstract contracts for policy evaluation
-
-Mental model:
-    Rule = validation (is data valid?) - with optional auto-fix
-    Policy = external evaluation protocol (implementations in domain libs)
-
-Usage:
-    from krons.enforcement import Rule, Validator, RuleRegistry
-
-    # Register rules
-    registry = RuleRegistry()
-    registry.register(str, StringRule(min_length=1))
-
-    # Validate
-    validator = Validator(registry=registry)
-    result = await validator.validate_spec(spec, value)
-"""
-
-from .context import QueryFn, RequestContext
-from .policy import EnforcementLevel, PolicyEngine, PolicyResolver, ResolvedPolicy
-from .registry import RuleRegistry, get_default_registry
-from .rule import Rule, RuleParams, RuleQualifier, ValidationError
-from .service import ActionMeta, KronConfig, KronService, action, get_action_meta
-from .validator import Validator
-
-__all__ = (
-    # Rule system
-    "Rule",
-    "RuleParams",
-    "RuleQualifier",
-    "RuleRegistry",
-    "ValidationError",
-    "Validator",
-    "get_default_registry",
-    # Policy protocols
-    "EnforcementLevel",
-    "PolicyEngine",
-    "PolicyResolver",
-    "ResolvedPolicy",
-    # Service
-    "ActionMeta",
-    "KronConfig",
-    "KronService",
-    "QueryFn",
-    "RequestContext",
-    "action",
-    "get_action_meta",
-)

krons/operations/registry.py

@@ -1,92 +0,0 @@
-# Copyright (c) 2025 - 2026, HaiyangLi <quantocean.li at gmail dot com>
-# SPDX-License-Identifier: Apache-2.0
-
-"""Per-session operation factory registry.
-
-Maps operation names to async factory functions. Instantiated per-Session
-for isolation, testability, and per-session customization.
-"""
-
-from __future__ import annotations
-
-from collections.abc import Awaitable, Callable
-from typing import Any
-
-__all__ = ("OperationRegistry",)
-
-OperationFactory = Callable[..., Awaitable[Any]]
-"""Factory signature: async (session, branch, parameters) -> result"""
-
-
-class OperationRegistry:
-    """Map operation names to async factory functions.
-
-    Per-session registry (not global) for isolation and testability.
-
-    Example:
-        registry = OperationRegistry()
-        registry.register("chat", chat_factory)
-        factory = registry.get("chat")
-        result = await factory(session, branch, params)
-    """
-
-    def __init__(self):
-        """Initialize empty registry."""
-        self._factories: dict[str, OperationFactory] = {}
-
-    def register(
-        self,
-        operation_name: str,
-        factory: OperationFactory,
-        *,
-        override: bool = False,
-    ) -> None:
-        """Register factory for operation name.
-
-        Args:
-            operation_name: Lookup key.
-            factory: Async (session, branch, params) -> result.
-            override: Allow replacing existing. Default False.
-
-        Raises:
-            ValueError: If name exists and override=False.
-        """
-        if operation_name in self._factories and not override:
-            raise ValueError(
-                f"Operation '{operation_name}' already registered. Use override=True to replace."
-            )
-        self._factories[operation_name] = factory
-
-    def get(self, operation_name: str) -> OperationFactory:
-        """Get factory by name. Raises KeyError with available names if not found."""
-        if operation_name not in self._factories:
-            raise KeyError(
-                f"Operation '{operation_name}' not registered. Available: {self.list_names()}"
-            )
-        return self._factories[operation_name]
-
-    def has(self, operation_name: str) -> bool:
-        """Check if name is registered."""
-        return operation_name in self._factories
-
-    def unregister(self, operation_name: str) -> bool:
-        """Remove registration. Returns True if existed."""
-        if operation_name in self._factories:
-            del self._factories[operation_name]
-            return True
-        return False
-
-    def list_names(self) -> list[str]:
-        """Return all registered operation names."""
-        return list(self._factories.keys())
-
-    def __contains__(self, operation_name: str) -> bool:
-        """Support 'name in registry' syntax."""
-        return operation_name in self._factories
-
-    def __len__(self) -> int:
-        """Count of registered operations."""
-        return len(self._factories)
-
-    def __repr__(self) -> str:
-        return f"OperationRegistry(operations={self.list_names()})"

krons/services/__init__.py

@@ -1,81 +0,0 @@
-# Copyright (c) 2025 - 2026, HaiyangLi <quantocean.li at gmail dot com>
-# SPDX-License-Identifier: Apache-2.0
-
-"""Services module: iModel, ServiceBackend, hooks, and registry.
-
-Core exports:
-- iModel: Unified service interface with rate limiting and hooks
-- ServiceBackend/Endpoint: Backend abstractions for API calls
-- HookRegistry/HookEvent/HookPhase: Lifecycle hook system
-- ServiceRegistry: O(1) name-based service lookup
-
-Uses lazy loading for fast import.
-"""
-
-from __future__ import annotations
-
-from typing import TYPE_CHECKING
-
-# Lazy import mapping
-_LAZY_IMPORTS: dict[str, tuple[str, str]] = {
-    "Calling": ("krons.services.backend", "Calling"),
-    "NormalizedResponse": ("krons.services.backend", "NormalizedResponse"),
-    "ServiceBackend": ("krons.services.backend", "ServiceBackend"),
-    "ServiceConfig": ("krons.services.backend", "ServiceConfig"),
-    "ServiceRegistry": ("krons.services.registry", "ServiceRegistry"),
-    "iModel": ("krons.services.imodel", "iModel"),
-    "Endpoint": ("krons.services.endpoint", "Endpoint"),
-    "EndpointConfig": ("krons.services.endpoint", "EndpointConfig"),
-    "APICalling": ("krons.services.endpoint", "APICalling"),
-    "HookRegistry": ("krons.services.hook", "HookRegistry"),
-    "HookEvent": ("krons.services.hook", "HookEvent"),
-    "HookPhase": ("krons.services.hook", "HookPhase"),
-}
-
-_LOADED: dict[str, object] = {}
-
-
-def __getattr__(name: str) -> object:
-    """Lazy import attributes on first access."""
-    if name in _LOADED:
-        return _LOADED[name]
-
-    if name in _LAZY_IMPORTS:
-        from importlib import import_module
-
-        module_name, attr_name = _LAZY_IMPORTS[name]
-        module = import_module(module_name)
-        value = getattr(module, attr_name)
-        _LOADED[name] = value
-        return value
-
-    raise AttributeError(f"module 'krons.services' has no attribute {name!r}")
-
-
-def __dir__() -> list[str]:
-    """Return all available attributes for autocomplete."""
-    return list(__all__)
-
-
-# TYPE_CHECKING block for static analysis
-if TYPE_CHECKING:
-    from .backend import Calling, NormalizedResponse, ServiceBackend, ServiceConfig
-    from .endpoint import APICalling, Endpoint, EndpointConfig
-    from .hook import HookEvent, HookPhase, HookRegistry
-    from .imodel import iModel
-    from .registry import ServiceRegistry
-
-__all__ = (
-    "APICalling",
-    "Calling",
-    "Endpoint",
-    "EndpointConfig",
-    "HookEvent",
-    "HookPhase",
-    "HookRegistry",
-    "NormalizedResponse",
-    "ServiceBackend",
-    "ServiceConfig",
-    "ServiceRegistry",
-    "iModel",
-)

krons-0.1.1.dist-info/RECORD

@@ -1,101 +0,0 @@
-krons/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-krons/errors.py,sha256=qzedv7hxB66-1hxNZYooetp-x-Yo71g_NquJH931YsQ,4038
-krons/protocols.py,sha256=J7mMmBIk-sS5CPwYk1tPo-W8UAnau8_v6wruDhDelbs,15239
-krons/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-krons/core/__init__.py,sha256=cR62yVsNyF8lu3gkiHJMnvew1Jj8HqnMBzA7rFzlVzs,4187
-krons/core/broadcaster.py,sha256=oSfr1ESB8DJdCnzwDmOuVr2QKtisFxQh7OldVzwPKKI,3965
-krons/core/element.py,sha256=ouSNYvryb7TzgRuwW-ETVOvrfomTlrVp8AqLQ8NEJSg,7533
-krons/core/event.py,sha256=hOXOjrug9C8GqMAdT44iQVC3oSRnXFnOx7-TEbNcaKs,10601
-krons/core/eventbus.py,sha256=cSi2PGRIUh9t2RpN92fjP73mDoIinngBYDbEbA3bv4s,3731
-krons/core/flow.py,sha256=h2Ug-u7DWNDgLOYwSjIZjNVLI4iuNzV1wZ4RSdp6ba0,12271
-krons/core/graph.py,sha256=hk8pp5vt_aI6L-PLopzd3tGrV4XnyYqzDPWQ58VK0E8,15797
-krons/core/node.py,sha256=3DEIsNVrR5WOnh_JZzShSPbX0dNnUo02pxngJgZ4cTM,34330
-krons/core/pile.py,sha256=MiTyajAOVNtv1bFcZQYX2P4PL07kTWZDBATr2DFm034,20893
-krons/core/processor.py,sha256=O4Fv7gQzytD4Fmjw8JHdSfuPA85r30z9RfcB021nn0E,18484
-krons/core/progression.py,sha256=85Dy-cMLy2UGFr5eZxqiuBh53lKaCQYjIyCZdyQ690M,9806
-krons/enforcement/__init__.py,sha256=Y1V7OCqYQF3S02VHt0mRcjktLYNFH_ef-71u7hh4IDg,1653
-krons/enforcement/context.py,sha256=b5f653m55NhxqYEDqKT5ZdEqIyqdSWdbGFwMw-cIt7c,4239
-krons/enforcement/policy.py,sha256=GYTbSG8ibo2x1eeGr_ot8wGRZBURd9wjyHuUZb6tcGE,2132
-krons/enforcement/registry.py,sha256=JFdwcIVtysntj6wMY3bO7-hqwNU7QIoIbEQuhsy5O4U,4742
-krons/enforcement/rule.py,sha256=ks2nHFmcwCwPn306k8ra_WFpdj5R3a3W3pyO1fpNeMk,9466
-krons/enforcement/service.py,sha256=x5xClQ2uysKYepAZti7ICqrWXTbYjGYtFaC6tzsY_CI,11849
-krons/enforcement/validator.py,sha256=mipoSCpk57vOiPDx0UzReYyp2QuD5tOjH_muLnaDWgc,6759
-krons/enforcement/common/__init__.py,sha256=U0rEcHOxLftR4-xJNuuXMSDYFAvbs0KzwV3GhlZcUrY,1026
-krons/enforcement/common/boolean.py,sha256=vUmOpCMr7kW0tkS5zdvmgY6RouJ_8Xl9Yd0MTCbItz8,2614
-krons/enforcement/common/choice.py,sha256=hbziQjfc60Azq-4P5PSEw3KYWm80JPhBg6rgVl3MXaE,3190
-krons/enforcement/common/mapping.py,sha256=Loq54MNEtwpnHN0aypTjFOqwoOKLEysddHh-JESedvs,3824
-krons/enforcement/common/model.py,sha256=xmM6coEThf_fgIiqJiyDgvdfib_FpVeY6LgWPVcWSwU,3026
-krons/enforcement/common/number.py,sha256=_WM_LGSsU1D-HHE6O0nd4tRV20tTw06sOyhaevwoZu4,3132
-krons/enforcement/common/string.py,sha256=PAknCSgCPTld1niSsZjljc5_j-cDZVr8S3OvNYFEXJM,4992
-krons/operations/__init__.py,sha256=ARzm5ywMn3YzW8vIWfKcy8CeN5DSxi_mGxtyxty03gk,917
-krons/operations/builder.py,sha256=wtnlcCpngE5tK0pnwCNjniCi3HFJrWtwpULGzMcddIg,7774
-krons/operations/flow.py,sha256=QstfNqntodU7MaVyHva89Rlu1xbdThZwlIqYtLmQVjE,14696
-krons/operations/node.py,sha256=499BVq2BnCBM4hLEmYrBsUuWmDhtISgMelUQlEvOtCM,3166
-krons/operations/registry.py,sha256=kEE484Q3J4CvcOuP-1AUPQg5i-ff8WcSjQntOXhgqgg,3046
-krons/services/__init__.py,sha256=ltUHcKZIWXMk5T11HRJrf_-XjX3eZdwEx02qrID44Nc,2574
-krons/services/backend.py,sha256=txvySl_7NLbBJy0b_ZlkxaMhRfPQ1x2_NVrarkxhmew,10251
-krons/services/endpoint.py,sha256=FCn3fn9bNZ_lohL8wHPRKYVh3cGbsDE9Un75VXaCE0c,22076
-krons/services/hook.py,sha256=Ni1kIe-D-cbb6isjK2_jsy3X2AH0WFXgXOcq75aTRJM,16910
-krons/services/imodel.py,sha256=qPd77SAbN3PX0e5dcm-A6UK8fn2eWTAIJ6mBqduQXnQ,18190
-krons/services/registry.py,sha256=uHlHJZEYFrV3fL8V61eYAG0geUm3VmT3Be1oJaF8KbY,3788
-krons/services/utilities/__init__.py,sha256=-ycdoYgtXrliJwbtQGMHBRvZL0qX2xLzooL3RNV99x4,1013
-krons/services/utilities/header_factory.py,sha256=WZCCZMh9EJVi8tnY7dJD07FcTOrrUMvecJmzy8P65Os,2992
-krons/services/utilities/rate_limited_executor.py,sha256=KSAYvVce24O7B0BlOgCX6jnYTpGwzjnPHLvbNZ5IvHo,9650
-krons/services/utilities/rate_limiter.py,sha256=lquGaLRjQGIIcTysUtsJJ6ZJEqFQyUmbAP7JBCIT93E,5957
-krons/services/utilities/resilience.py,sha256=LpcUSx4zGkWECkrgoSKJKyTFkirpoknrgbD1zjwYuco,14239
-krons/session/__init__.py,sha256=EZDOlXoGcJ5VT9NPpx5fV_vIpRF_DsavQPcmeG7xiFQ,1210
-krons/session/exchange.py,sha256=uE7d2ai5zom64bIA-RmAZy6SUpydCHwZc1e0eROLN6c,9025
-krons/session/message.py,sha256=eVP2-4xwMTBaRtATfG7SD4UkdooN-FlRSx0hKsjkFNM,1993
-krons/session/session.py,sha256=lWy5ACVFDaUiuFPUSR4kSbcpDB7GI2x4CXP5VoRnL3I,14245
-krons/specs/__init__.py,sha256=F6QOVdo1EK5jK6b17rgQqX8i8PWURUxkFzBSz3g0L0A,631
-krons/specs/factory.py,sha256=R0vp4ATRZAHhinBFcldyGp1Tt6I44tp-r2GznrxTWZs,3337
-krons/specs/operable.py,sha256=lhQ4K3mpHeHPgSSLODnhzJhTYEjSRkxOSqESxVpUBRk,11043
-krons/specs/phrase.py,sha256=Zyx-u1vySLHFL5PP1bkHL4AQq7jVa3wag6kDucPT1ck,15125
-krons/specs/protocol.py,sha256=ugYVjN6kV-rjXqvxdoTSaQmK9AP_8rXzKY4gN26xfyk,4365
-krons/specs/spec.py,sha256=6aB_XGPF6zQfn0g-Pn0IBweC-6xQUqGB1RVhSq-TsBw,18512
-krons/specs/adapters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-krons/specs/adapters/_utils.py,sha256=ChWH-C2LRXaXiWM3n7P0DZ8Oci5dSDq59DIJtHx2h-g,1365
-krons/specs/adapters/dataclass_field.py,sha256=2mdmqdn5aUV1Y8i1q6IQErmdo4NRP-002y3ZKK424BI,8678
-krons/specs/adapters/factory.py,sha256=_LoSMCtHNkK5kNL5LUDjHvJJ2BtDHAaW1gly5LpNPXQ,1572
-krons/specs/adapters/pydantic_adapter.py,sha256=L5e0Kg_picNiGyxdvbJil96zAzNGIoHUHTuxcQmcXZk,10360
-krons/specs/adapters/sql_ddl.py,sha256=HxvZDYri4GzUgSFf6SDsdI_5w44SOZSRMkqD23LDLVg,31332
-krons/specs/catalog/__init__.py,sha256=Sdxl3HDK5LpjDZ0Cf-eBsErPLEGYJRiigMky719lRYY,1221
-krons/specs/catalog/_audit.py,sha256=YYrIvEBsAHmRXiIUQrrp_qE6NmnUJq5rexxD5r3radw,1250
-krons/specs/catalog/_common.py,sha256=-LyBKV1MMEE0QlrKjlqs9JBmJi_kCehB2Cr743jl94I,1197
-krons/specs/catalog/_content.py,sha256=aG01G_X_AHPyYMg7ELdgVUPFLDjqM2BIuaxjKR3zDAs,1952
-krons/specs/catalog/_enforcement.py,sha256=NmBwqXQxojBNkIECvPSy1kg1375sijhOXezwCPTa6LM,2111
-krons/types/__init__.py,sha256=pJ6kuop7vSLZp5jMBs-CQ7CHRjvUuO8kHhpZ34KM85I,1049
-krons/types/_sentinel.py,sha256=QJGyRAYNkJ2ylw6dhxPHJNgmxqBdorBd-xx7pNrUykw,8855
-krons/types/base.py,sha256=1wE3Sjxt46cTkqgDT_35Go_1nM2qwVQGv-HJ58e8ATM,12307
-krons/types/db_types.py,sha256=78nH6N5hwlwZv69jgBR5bVwpZx82P0mi893THebG-Gg,8126
-krons/types/identity.py,sha256=Ccb5oJArC1PEzdzNPlLi_oK87uKx7BFevX9rvY9y-14,1949
-krons/utils/__init__.py,sha256=BUQLqQoZ6Bz9eA0nEz9urPTVVS-FSOUWXZe3LMbhEj4,847
-krons/utils/_hash.py,sha256=W2Ma9v8-INPaGkur7GTtbF8KwuXSJNSwk8DCNPRvx8Q,6859
-krons/utils/_json_dump.py,sha256=rpBmr0NCmIKRdmpgn1nSWIHI3FTsGYsQjOa3YTxCi3M,12482
-krons/utils/_lazy_init.py,sha256=bCx_W3dfzirB5KnAt6_jmbnwOk2xbU7-kgOhMQqzW70,1806
-krons/utils/_to_list.py,sha256=LmGMwAhxP0RRr-pEYG01_nWVvb7ei95xn_ZlAJUquqc,6031
-krons/utils/_to_num.py,sha256=NyyIL9Az1EaW6QFh9R7AeJdaUPoSRBNVBX9yj78wpok,3102
-krons/utils/_utils.py,sha256=533D_1yTDURzn5QrnADT99_AEvK4P5g4FUYs3Ohkx6M,11089
-krons/utils/concurrency/__init__.py,sha256=1HD-aY4Hevde0Hm0-VYa0eheT5OiwhlnDJtofIuV9wk,6754
-krons/utils/concurrency/_async_call.py,sha256=T1YN7hh2vvG9hdheRlEVvXsGRU0p3v0GTisoMeLzx7g,10206
-krons/utils/concurrency/_cancel.py,sha256=b9f6yT8gObS6Y3EWKoGzNfYxqM1ZrN_8ctfyIjT1m1U,3326
-krons/utils/concurrency/_errors.py,sha256=tmszbwq7NPy3VTqJpvXxQ_2IVE024KkCqC27Bsoo4ZU,2597
-krons/utils/concurrency/_patterns.py,sha256=OGCLd5ndMV7fZxKxTT6lPJTIgwu8euEBbhopIt6_Ijs,11534
-krons/utils/concurrency/_primitives.py,sha256=D1Rl1hujXXPdL4Mw6eW5EN8utM3bh8vmmFtXmuvsDw0,9024
-krons/utils/concurrency/_priority_queue.py,sha256=wGi6ESS6AIZ0QNRBQR5UwcSQI5GhKjATBC_aEw6c0aQ,4342
-krons/utils/concurrency/_resource_tracker.py,sha256=hTn0PmxWbQ0uwTGB1YuPUKhtso2VyY7SVWtl4dkzZSU,3151
-krons/utils/concurrency/_run_async.py,sha256=A_vuPi9-wWRr3oXiAMnv3l7MV2B76jkBXoVztX_Vcgo,1940
-krons/utils/concurrency/_task.py,sha256=4ivkiUUbutheoYZ-G8-mTfHX4YgWguGIy1v5hSU871w,2528
-krons/utils/concurrency/_utils.py,sha256=CyH_z4prYFeCFgwk4Pc3q0m5NRzDB2TP-G2oxdM_-C0,2136
-krons/utils/fuzzy/__init__.py,sha256=0dZRhC7sgH0b3oiNFdnUpPq7Jgsb84sFXtCsxCFkdss,354
-krons/utils/fuzzy/_extract_json.py,sha256=6Y-QEfXrTBdaNmlbMfVm6xJPBKI0RBbr_t0VYGE7nMo,2922
-krons/utils/fuzzy/_fuzzy_json.py,sha256=hV6v9YkQpGxwOnhpLM6jkrG5fZKYluMTxgdqsk5sTew,9151
-krons/utils/fuzzy/_fuzzy_match.py,sha256=rL_YuoAUVbnLxFCAZlXgPxeCmKjxH90r06mzuZ-jXk4,4855
-krons/utils/fuzzy/_string_similarity.py,sha256=ZwAerTdXDen-6Q3Kg46ckXF_T69xFLYBEVdt8EZq95M,6141
-krons/utils/fuzzy/_to_dict.py,sha256=ORQy-_6snt6TmVJZI-MHDoDO7jFYg-xlaxU_pBbfk7s,12911
-krons/utils/sql/__init__.py,sha256=yNjm9Dr-ZjrZSD3Lext7fPR80qX5svGT2PnXqlb5qXs,264
-krons/utils/sql/_sql_validation.py,sha256=smxNU3HjPhQuRK5ehG9Fl4DeljKK9tqUQIvRUopgvc8,4229
-krons-0.1.1.dist-info/METADATA,sha256=88PmVejjLNnaSX-xRgqkSaP15gpLiladDaE6XvhbJiE,1997
-krons-0.1.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-krons-0.1.1.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-krons-0.1.1.dist-info/RECORD,,