python-corekit 0.1.1__py3-none-any.whl → 0.2.0__py3-none-any.whl

corekit/utils/text.py

@@ -0,0 +1,56 @@
+"""
+String assembly helpers.
+
+Small formatters for turning collections into text a human will read -- log
+lines, notification bodies, error messages -- plus filename sanitization.
+"""
+
+import re
+from typing import Any, Literal
+
+__all__ = ["join_lines", "list_to_english", "sanitize_filename"]
+
+FALLBACK_FILENAME = "unnamed"
+_UNSAFE_CHARS = re.compile(r"[^a-z0-9\-]")
+_REPEATED_HYPHENS = re.compile(r"-{2,}")
+
+
+def join_lines(*items: Any, prefix: str = "") -> str:
+    """
+    Join items with newlines, optionally prefixing each one.
+    """
+    return "\n".join(f"{prefix}{item}" for item in items)
+
+
+def list_to_english(items: list[str], ending: Literal["and", "or"] | None = None) -> str:
+    """
+    Join items into a readable list: ``"a, b, and c"``.
+
+    Without ``ending`` the final item is joined with a plain comma, which suits
+    a bare enumeration; pass ``"and"`` or ``"or"`` for prose.
+    """
+    if not items:
+        return ""
+
+    if len(items) == 1:
+        return items[0]
+
+    buffer = ", ".join(items[:-1])
+    last = items[-1]
+
+    if ending is None:
+        return f"{buffer}, {last}"
+    return f"{buffer}, {ending} {last}"
+
+
+def sanitize_filename(raw: str, fallback: str = FALLBACK_FILENAME) -> str:
+    """
+    Reduce a string to lowercase kebab-case safe for use as a filename stem.
+
+    Everything outside ``a-z0-9-`` becomes a hyphen, runs collapse, and the
+    result is trimmed. A string with nothing usable in it returns ``fallback``
+    rather than the empty string, which would produce a nameless file.
+    """
+    cleaned = _UNSAFE_CHARS.sub("-", raw.strip().lower())
+    cleaned = _REPEATED_HYPHENS.sub("-", cleaned).strip("-")
+    return cleaned or fallback

corekit/utils/time.py

@@ -1,21 +1,74 @@
-from datetime import UTC, datetime, timedelta
-
-
-def time_now() -> datetime:
-    """
-    Helper for getting the current UTC time
-    """
-    return datetime.now(UTC)
-
-
-def timedelta_now(delta_seconds: int | None = None, add_time: bool = False, **kwargs) -> datetime:
-    """
-    Helper for getting a quick timedelta
-    """
-    if delta_seconds is not None:
-        kwargs = {"seconds": delta_seconds}
-
-    delta = timedelta(**kwargs)
-    if add_time:
-        return time_now() + delta
-    return time_now() - delta
+"""
+Timezone-aware time helpers.
+
+Every function returns UTC. Naive datetimes are the usual source of "works on
+my machine" time bugs, so nothing here produces one.
+"""
+
+import re
+from datetime import UTC, datetime, timedelta
+from typing import Any
+
+__all__ = ["isoformat_now", "parse_docker_timestamp", "time_now", "timedelta_now", "timestamp_now"]
+
+# Docker reports nanosecond precision; fromisoformat accepts at most microseconds.
+_DOCKER_TS_PATTERN = re.compile(r"(\.\d{6})\d*")
+
+# Docker's zero value for "this never happened".
+_DOCKER_ZERO_TIME = "0001-01-01"
+
+
+def time_now() -> datetime:
+    """
+    Return the current UTC time, timezone-aware.
+    """
+    return datetime.now(UTC)
+
+
+def isoformat_now() -> str:
+    """
+    Return the current UTC time as an ISO 8601 string.
+    """
+    return time_now().isoformat()
+
+
+def timestamp_now() -> float:
+    """
+    Return the current UTC time as a Unix timestamp.
+    """
+    return time_now().timestamp()
+
+
+def timedelta_now(delta_seconds: int | None = None, add_time: bool = False, **kwargs: Any) -> datetime:
+    """
+    Return a time offset from now, in the past by default.
+
+    Pass ``delta_seconds`` for the common case, or any ``timedelta`` keyword
+    (``days``, ``hours``, ...) for the rest. ``add_time`` moves forward instead
+    of back.
+    """
+    if delta_seconds is not None:
+        kwargs = {"seconds": delta_seconds}
+
+    delta = timedelta(**kwargs)
+    if add_time:
+        return time_now() + delta
+    return time_now() - delta
+
+
+def parse_docker_timestamp(value: str | None) -> float | None:
+    """
+    Parse a docker API timestamp into a Unix timestamp, or ``None``.
+
+    Docker emits nanosecond-precision ISO 8601 (a container's ``State.StartedAt``,
+    for instance), which ``fromisoformat`` rejects. Returns ``None`` for empty
+    input, docker's zero timestamp, and anything unparseable, so a caller can
+    treat "no such time" and "bad time" the same way.
+    """
+    if not value or value.startswith(_DOCKER_ZERO_TIME):
+        return None
+    try:
+        trimmed = _DOCKER_TS_PATTERN.sub(r"\1", value.replace("Z", "+00:00"))
+        return datetime.fromisoformat(trimmed).timestamp()
+    except ValueError:
+        return None

corekit/utils/validators.py

@@ -1,15 +1,15 @@
-from typing import Any
-
-
-def true_validator(*args: Any, **kwargs: Any) -> bool:
-    """
-    Generic placeholder validator function that always returns True
-    """
-    return True
-
-
-def false_validator(*args: Any, **kwargs: Any) -> bool:
-    """
-    Generic placeholder validator function that always returns False
-    """
-    return False
+from typing import Any
+
+
+def true_validator(*args: Any, **kwargs: Any) -> bool:
+    """
+    Generic placeholder validator function that always returns True
+    """
+    return True
+
+
+def false_validator(*args: Any, **kwargs: Any) -> bool:
+    """
+    Generic placeholder validator function that always returns False
+    """
+    return False

corekit/utils/void.py

@@ -1,8 +1,8 @@
-from typing import Any
-
-
-def void(ex: Exception, *args: Any, **kwargs: Any) -> None:
-    """
-    Generic callback function that does nothing and returns nothing
-    """
-    pass
+from typing import Any
+
+
+def void(ex: Exception, *args: Any, **kwargs: Any) -> None:
+    """
+    Generic callback function that does nothing and returns nothing
+    """
+    pass

{python_corekit-0.1.1.dist-info → python_corekit-0.2.0.dist-info}/METADATA

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: python-corekit
-Version: 0.1.1
-Summary: Shared foundations for Python projects: logging, benchmarking, registries, FastAPI routers/handlers, data stores, and ETL
+Version: 0.2.0
+Summary: Shared foundations for Python projects: logging, benchmarking, registries, FastAPI application and routers, SQL statements and migrations, background tasks, and ETL
 Author: Steven Jacobsen
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/stevejaker/corekit
 Project-URL: Issues, https://github.com/stevejaker/corekit/issues
-Keywords: fastapi,etl,homelab,logging,benchmarking
+Keywords: fastapi,etl,logging,benchmarking,sqlmodel,migrations
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3.11
@@ -36,8 +36,8 @@ Dynamic: license-file
 # corekit
 
 Shared foundations for Python projects: structured logging, benchmarking,
-registries, FastAPI routers with built-in handlers, an in-memory record store,
-and ETL scaffolding.
+registries, a FastAPI application with routers and handlers, SQL statements and
+migrations, background tasks, an in-memory record store, and ETL scaffolding.
 
 Requires Python 3.11+.
 
@@ -55,7 +55,7 @@ extras to remember, and no import that fails because something was left out.
 Pin a compatible release rather than tracking whatever is newest:
 
 ```
-python-corekit~=0.1.0
+python-corekit~=0.2.0
 ```
 
 Before 1.0, the minor version carries breaking changes.
@@ -88,6 +88,57 @@ class Report(Benchmarkable):
         self.timing("queried")   # logs the time since the previous split
 ```
 
+## Assembling an application
+
+`Application` is a plain `FastAPI` subclass — every constructor argument,
+including `lifespan`, passes straight through. What it adds is a short set of
+assembly steps, each of which logs what it did.
+
+```python
+from corekit.api import Application, Lifespan
+from app.backend import routers
+
+lifespan = Lifespan()
+lifespan.add("cache", startup=cache.connect, shutdown=cache.disconnect)
+
+app = Application(lifespan=lifespan)
+app.discover_routers(routers)
+```
+
+`discover_routers` imports every module under the package so each router can
+register itself. It raises if it finds none: passing a package is a statement
+that routers live there, and an app that silently serves nothing is worse than
+one that refuses to start.
+
+Lifespan steps start in the order added and shut down in reverse, the way
+nested `with` blocks unwind. If a step fails on the way up, the steps that
+already started are still torn down. A shutdown hook runs only if its own
+startup completed, so it may assume the state that startup builds — and a hook
+that raises cannot stop the unwind.
+
+### Middleware
+
+Middleware order is a security property: a host check that reads a client
+address before the proxy-header layer has rewritten it is checking the proxy,
+not the client. So middleware is never auto-discovered, and corekit installs
+none by default. A stack is declared in one place, outermost first — the order
+a request actually meets the layers.
+
+```python
+from corekit.api import MiddlewareStack
+
+stack = (
+    MiddlewareStack()
+    .add(ProxyHeadersMiddleware, trusted_hosts="*")
+    .add(TrustedHostMiddleware, allowed_hosts=HOSTS)
+    .add(CORSMiddleware, allow_origins=ORIGINS, allow_credentials=True)
+)
+app.add_middleware_stack(stack)
+```
+
+Reading top to bottom gives the order a request travels, which is the property
+you need when reviewing it.
+
 ## Routers and handlers
 
 A router and the handler holding its business logic travel together. Declare the
@@ -147,113 +198,67 @@ people.get_record("Ada").age            # O(1) lookup by id
 
 Stores pickle cleanly, including their dynamically generated record class.
 
-## Homelab pieces
+## SQL statements
 
-### Container control
+Select, insert, update and delete are objects you build and then execute, so a
+statement can be assembled in pieces and passed around before it runs.
 
 ```python
-from corekit.docker import Watchdog
+from corekit.connections.sql import SQLConnection, Select, Insert, Update, Delete
+from corekit.data import Field
 
-watchdog = Watchdog(enforce_label=True)
-watchdog.restart_container_by_name("minecraft")
-watchdog.find_and_stop(label="app", value="staging")
-```
+conn = SQLConnection("sqlite:///app.db")
 
-`enforce_label` limits the blast radius: with it on, only containers carrying
-the `watchdog=true` label can be started, stopped or paused, so a mistyped name
-cannot take down something unrelated. Leave it on unless the watchdog is meant
-to control everything on the host.
-
-### Reacting to logs
-
-Describe what to watch for and what to do about it:
-
-```yaml
-# config.yaml
-containers:
-  - name: "minecraft-.*"
-    rules:
-      - name: "out of memory"
-        pattern: "java.lang.OutOfMemoryError"
-        severity: critical
-        send_notification: true
-        actions:
-          - type: restart_container
-            max_restarts: 3
-            restart_window: 3600
-advanced:
-  ignore_patterns:
-    - "healthcheck"
-  rate_limits:
-    restart_container:
-      count: 5
-      period: hour
-```
+conn.execute(Insert(table=User, rows=[{"name": "Ada", "age": 36}]).add(name="Bob", age=17))
 
-```python
-from corekit.log_monitor import LogMonitor
+adults = conn.fetch(Select(table=User).where(User.age >= 18).order_by(User.name).limit(10))
 
-LogMonitor.run("config.yaml")
+conn.execute(Update(table=User).where(User.name == "Bob").set(age=18))
+conn.execute(Delete(table=User).where(User.age < 13))
 ```
 
-Restarts are capped per container, so a crash loop cannot become a restart loop.
-
-### Notifications
+`where` accepts a SQLAlchemy expression or a `corekit.data` one, so the same
+predicate language that filters a `Dataset` also filters a table:
 
 ```python
-from corekit.notifications import BaseNotificationService, Notification, NotificationType
-
-class DiscordNotifier(BaseNotificationService):
-    """
-    Sends notifications to a Discord channel.
-    """
-
-    def _send(self, message: str) -> None:
-        discord.post(message)
-
-notifier.notify(Notification(message="disk full", type=NotificationType.ERROR))
+Select(table=User).where(Field("age") >= 18)
 ```
 
-Override `_send`, not `send`. `notify()` formats the message and calls `_send`,
-so an override with any other name is silently ignored.
+Update and delete compile to a single statement rather than fetching rows and
+looping, which matters most over a network, where fetch-and-loop pays a round
+trip per row.
 
-### Real-time updates
+A `Delete` or `Update` with no condition raises rather than running:
 
-Publish from wherever the work happens:
-
-```python
-from corekit.events import EventPublisher
-
-publisher = EventPublisher.for_resource("minecraft", "server", "survival")
-publisher.publish("backup_finished", {"size": "4.2GB"})
+```
+Delete on User needs a condition; use truncate to empty a table
 ```
 
-Stream it to the browser:
+## Background tasks
 
-```python
-from corekit.api import SSEResponse
-from corekit.events import SSEStream
+Tasks describe work and register themselves by name. Nothing here imports a
+queue library, so the same task runs under RQ, Celery, a cron entry, or a test
+with no queue at all.
 
-@router.get("/events")
-async def events(channel: str) -> SSEResponse:
-    return SSEResponse(SSEStream(channel, keepalive_interval=15))
-```
+```python
+from corekit.jobs import Task, run_task
+from corekit.utils import encode_payload
 
-The browser side is three lines, and reconnects on its own:
+class SendDigest(Task):
+    def task_function(self, user: str) -> None:
+        ...
 
-```javascript
-const source = new EventSource("/events?channel=minecraft:server:survival");
-source.addEventListener("backup_finished", e => console.log(JSON.parse(e.data)));
+# a worker, holding only a name and a JSON string
+run_task("SendDigest", encode_payload(["ada"]))
 ```
 
-`SSEStream` sends a `connected` frame on subscribe, an optional `initial_state`
-so a client arriving late renders immediately, and a comment frame every
-`keepalive_interval` seconds so proxies do not close an idle connection. For
-WebSockets, `WebSocketBridge` relays the same channel and stops on a terminal
-status.
+Arguments cross the queue as JSON, never as a serialized object. `pickle` and
+`dill` execute code while loading, so a queue holding objects turns write
+access to the queue into code execution in a worker. `encode_payload` and
+`decode_payload` live in `corekit.utils`, since crossing a process boundary as
+data is not specific to queues.
 
-Publishing never raises: an event that cannot be delivered should not take down
-the operation that produced it. `publish` returns whether it worked.
+`ScheduledTask` adds an `interval` for tasks a scheduler should repeat.
 
 ## Parallel work
 
@@ -375,18 +380,19 @@ corekit/
   exceptions/                      error types
 
   observability/                   Loggable, Benchmarkable, Timer
-  registry/  schemas/  utils/      SmartRegistry, enums and fields, helpers
+  registry/  schemas/  utils/      registries, enums and fields, helpers
   data/                            Dataset and its filter expressions
+  jobs/                            queue-independent background tasks
   crypto/  files/  serialization/
   concurrency/                     ThreadLocalRegistry, ThreadWorker
   decorators/
 
   connections/                     the Connectable lifecycle and @connect
-    sql/                           SQLConnection, queries, migrations
+    sql/                           SQLConnection, statements, migrations
     redis/                         RedisConnection
   http/                            BaseApiClient, retries, responses
 
-  api/                             handlers, routers, responses
+  api/                             Application, lifespan, middleware, routers
   docker/  notifications/  etl/
 
   events/  log_monitor/            built on the capabilities above

{python_corekit-0.1.1.dist-info → python_corekit-0.2.0.dist-info}/RECORD

@@ -1,14 +1,17 @@
 corekit/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-corekit/constants.py,sha256=18_SbFpb5EaY_T32yLvYqz6WAzxzJsaykUL3hggPm8w,1098
+corekit/constants.py,sha256=lVuBLu6JCZ8yYt2N36jlVLbkRPYHdTI06XdsXDABXjk,1053
 corekit/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-corekit/api/__init__.py,sha256=02s3b1UKPDcFLIc6NgW7oalZb9cwClpUCONuASbpSEI,288
+corekit/api/__init__.py,sha256=44gtrMRkllhAQdwpfIKrkMuSl3qg61xRxgaTDldzmjg,688
+corekit/api/application.py,sha256=VIcohNNPW5VDseILWrUS3Uchz8i0KWsDNUF7XA7aRGI,10038
 corekit/api/handler.py,sha256=vYrao8_B5e6MZGI7GLm1Mr-e8NH8rYt8TNAcnoEuzRQ,2659
+corekit/api/lifespan.py,sha256=_gFQwIMcrvYfsEfUg6PrwmAJYRU2dsFksrXhzuuj6Qg,7873
+corekit/api/middleware.py,sha256=6M5VPjRZTTPEfX5Hm7DHLoDwwWWAgmvWNiTuSykUA98,3168
 corekit/api/responses.py,sha256=bvADoj7snxqCKHIWFiU5rH8Mg5dmvi-ldxVLJbtVEQs,1258
-corekit/api/routers.py,sha256=bT2mNIfwhRhU8EWHNMxUBsL36V4JftiWamJMPaLPIWs,3902
+corekit/api/routers.py,sha256=j2DSkYTTIGd5qFEzYFlY5YM0qhdvhjUu8iFxWc9KM6o,7910
 corekit/concurrency/__init__.py,sha256=MjdyVTaBzhYqn_cVumM43oGidiUMhIjVQQKVrXZQvok,322
 corekit/concurrency/decorators.py,sha256=6Yn95QN3g06NPDP1Q4yZSF7uNnVQ91HCUa8GaL77UvQ,2656
 corekit/concurrency/thread_local.py,sha256=Kh_bWuHzUwJ2jUr0JUCxaUSdahpBt8HvOwpgg7qmpOA,3206
-corekit/concurrency/worker.py,sha256=QAwgucT9tadelFmb8io7J509zpQqlOvByHcVUVpveAM,1969
+corekit/concurrency/worker.py,sha256=osdtvG1rjnGKTFYVKuceSDTvZaF6cclwvKoYd1ECpwo,1904
 corekit/config/__init__.py,sha256=dw2Y2HvpHw1MXwLSVxdARGPYse9j6IteVN3q70c3Kic,1227
 corekit/config/loader.py,sha256=KeEAgN0ZPcOQOwjzPQBFZXhhSI1tw9VAiFRWylFTtGY,5041
 corekit/config/settings.py,sha256=Z-GB5Cj-gl23AbYT_3HHBfeWFXMQL9XX11p9gqWvcqk,4822
@@ -19,35 +22,40 @@ corekit/connections/decorators.py,sha256=7xfmLuMr3kkceEkkxHxY_Pen2OakJEVukXtiOYA
 corekit/connections/registry.py,sha256=BR04dGthcGCtON2MxNsl-TlhRgbRlvGj0RLymDFBkGQ,3119
 corekit/connections/redis/__init__.py,sha256=BsWLZNqpKAqIoreHGLEtftnMqVw-ESK8jbexDAughag,174
 corekit/connections/redis/connection.py,sha256=5ZziF-P8AuE_4s7hrQTflcnAQ5iVdrn2bD4KKlG7QBA,7846
-corekit/connections/sql/__init__.py,sha256=nsxphRJnzN-Vs94kY1_1YM-uAQM8sCPfecf2Qe8pieI,435
-corekit/connections/sql/connection.py,sha256=-b2LLnw06cKsCPpXmiASZwKByfK-FV-UCpiXFlU213Y,10613
-corekit/connections/sql/query.py,sha256=_o5tVmengCjZDWSgoPw41K9mdY5PcAl-xVpSS_IceeM,1774
-corekit/connections/sql/table.py,sha256=B3DiCbISDj83W2HEvBCcX-1e4c5ne7ZPOrStgW9RfaY,2663
+corekit/connections/sql/__init__.py,sha256=_o9AGqb9fvCIP5cLng8BKSRGLkklKPh9qPv3r4LxRR4,844
+corekit/connections/sql/connection.py,sha256=OLEiFd-Ce2gZLdAKo6GPqG2kwBESZg3boA-T5Nqj8o4,11276
+corekit/connections/sql/query.py,sha256=8s5atIssmN2l9FCL2IHnIQqwxOk0fA_mPNh36koLhoE,233
+corekit/connections/sql/table.py,sha256=qsx_2LhcRP6eXIKo-B6CKGLYV9h4bRANIxYNMEHjxgk,3612
 corekit/connections/sql/fields/__init__.py,sha256=cqY_OdBkesDOAjx_mgrnXjPR0htXipX84EI8Njpc0eM,150
 corekit/connections/sql/fields/jsonb.py,sha256=tj2qXh1TaU1llsA995ZeJfAgDSHlN6kpGFh0oQ1rdMI,2051
-corekit/connections/sql/migration/__init__.py,sha256=1LhYawqBvxjzWCo5JmvOV-BYJhtYqi6bOX4P5RwWZzg,1537
-corekit/connections/sql/migration/base.py,sha256=0faFzUuXGHesfhDPlkvo1VetGgOHkCNZy4Xbowq5mmc,1317
-corekit/connections/sql/migration/operations.py,sha256=iO3Qq4K3TBxS-K6I77w8BnIJ2rKHGvrVlvaPUwV-N3I,11759
-corekit/connections/sql/migration/registry.py,sha256=_S3kFGJVGqwZFpy_ls3uYc9Q5yTODLmlpXF_GmMfTEY,6710
+corekit/connections/sql/migration/__init__.py,sha256=68ZYG4MgYHXW1kKpMSNXXEjtVEbNPME30nSfCVS5FaQ,1582
+corekit/connections/sql/migration/base.py,sha256=b-3ISuCRgt_HuLl4lWNPq2QiNC2_3fiNrd1dEgDd7pE,1344
+corekit/connections/sql/migration/operations.py,sha256=SxNpEGQw-fPgg9uW1YmSsvV2wNO47YfqSSeZ-2nsTU8,13107
+corekit/connections/sql/migration/registry.py,sha256=M1iS7v7aKYfgyf_grvF-6Ogn4KfQ1EEWbA1MO02CiB0,6728
 corekit/connections/sql/migration/table.py,sha256=CpOkJl-4rcG2hTZYq-Yt7OvGTpVhVJ42IrubVO3BUvs,666
+corekit/connections/sql/operations/__init__.py,sha256=f6fnAbD3k8ALXwcwJ31fIHQwkvud_WqmUod_apTErpY,480
+corekit/connections/sql/operations/base.py,sha256=VU5LeK6rT4GUo7hd0gMSw2nM47ilBDDIZSFakDFlBKc,2907
+corekit/connections/sql/operations/statements.py,sha256=H_VYBT7npttTabpb7v1-fxjsINmU8cOFJvEGDowVU6Q,4318
 corekit/crypto/__init__.py,sha256=dtu06iE3reJWRp99gOvV7QQ6iw5V8F7e4kU1CR8ppos,27
 corekit/crypto/constants.py,sha256=0rSSEpVKi9kBeza6Tq-5XK4LoWhEUyhrkKdcidZUEnc,299
 corekit/crypto/enum.py,sha256=0csj06cATCYDPY_QTNy66j_hB16WCqcHg8tJOO0lMNU,212
 corekit/crypto/hasher.py,sha256=qiJgeUsI2EeRLRPRf7YPY3ylZkRx3ZXfzsUk5Wg9uW4,2930
-corekit/data/__init__.py,sha256=y3VOJJwL4WKYxJcWIQooqCBjGV0xNAl_nKIDQYthN5w,1845
+corekit/data/__init__.py,sha256=COGfw3-OBRp6KKWBSixid5vfaeasFVY5X4Wza0mB_kY,1977
 corekit/data/dataset.py,sha256=aRozqHF4nGmHQgOGxooTnKWZOymyvW76H_3T9S3gYKY,12623
-corekit/data/record.py,sha256=y-tPj6zbzWGTosuqIfG7xXRLhcyzUxif2ckQZLNAgJc,5380
-corekit/data/stats.py,sha256=EsmApb7ryjaVOOxU7l9S9CgfjLrV1VLynXMyyMzHBaQ,4915
-corekit/data/expressions/__init__.py,sha256=2H-c-SvJGnGUT6FNMI5vLLtYp6teKnwHe3g1KpA59Gc,972
-corekit/data/expressions/comparison.py,sha256=3e7MqJ5ISRmhbXX3HVzX002jnVKUhjMUJFEZqMkSB2U,9433
-corekit/data/expressions/expression.py,sha256=CP-potcEhym7F8XwgqKxqPcQ9wo3jFH3xl4jN1E8ZFA,3492
-corekit/decorators/__init__.py,sha256=R1RE9t0uZhSPi0L2NAC_EbY9vWnmSpoKV9iDW3yoJOM,85
-corekit/decorators/exception_handling.py,sha256=W6JSrJ_nKVpbwudb4-MpcJoENg11fC0ZA0uVbMaDTLk,1561
+corekit/data/record.py,sha256=EczoOvcxl-lHO1M92AjUh_5E9UQJ2qwBsiu6Yo-34gs,5233
+corekit/data/stats.py,sha256=N6Wn9JfrCBhwPWb56ByJ6HEwS6fB43WFkGg7vNOwqn0,4811
+corekit/data/expressions/__init__.py,sha256=1H_HkgxDSF7Br8LaZ9Nrde_zDAJ2Pxeo4vVINGDov2o,1320
+corekit/data/expressions/comparison.py,sha256=mG61TbjbC_lb3pKA-B-Nx1EEJi-SkPRuWGSQC_RntvQ,12408
+corekit/data/expressions/expression.py,sha256=FdvbsGS4IhOHyzdjxK-hFu-3rlUfAngRX8jyXQGQU3U,3539
+corekit/data/expressions/operator.py,sha256=0ViIdJs6kE5t9QLzQa6stcnL86EfVUtZRbHu2W9Vx4M,1415
+corekit/data/expressions/target.py,sha256=QSl7sH1qFVUc-mL7gsasTsCahWKhHqdo0bMHt--t2m8,470
+corekit/decorators/__init__.py,sha256=YrBcc_4wkSs7nEb3OjC7C7a8fNEvBk3RzOpD8QccHKM,83
+corekit/decorators/exception_handling.py,sha256=VrdNs4HLiOVlXPTwgzsOBHZuVSWzAeK93W0CaaD1_ww,1589
 corekit/decorators/warnings.py,sha256=RS7AS6OS05VxiWaMjkj6kYky9FbpT4Z-Cb7TQoPOObk,1109
 corekit/docker/__init__.py,sha256=LtrmEvqorme1-YwL0jGNFLEASdgn69s0eYuh490anmg,104
 corekit/docker/watchdog.py,sha256=yreDLBQCMJYA-1IZzF2lHTmkQvvgF69zplPeS1L2NNA,7949
 corekit/etl/__init__.py,sha256=0agaPi5Lv8q8hTAC5JKj2Dm73vW52l9ZQRnb8JLu5oQ,1341
-corekit/etl/connection.py,sha256=DBFP_2mrB0wtauWnibTTCW4yqPrpCl-DbG0KqS74s84,1279
+corekit/etl/connection.py,sha256=dhfeHMUijodEpfOGr54K0rJlWV8WhAAUmhTQ_8GSKlU,1235
 corekit/etl/orchestrator.py,sha256=4hPPHYQ-mzaBWLFZNlGe-7Rpkw4ZIzckE2NSVEDvyW0,7208
 corekit/etl/schemas.py,sha256=L0FN-jfRuWKgWllKL3trgo3IDJzu7HgN3VfRzbOYh8M,395
 corekit/etl/extract/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -66,8 +74,8 @@ corekit/events/models.py,sha256=faE-Z2qwggOaSBrzte-mBWXuomrzWMIl0gOEkjvPqLo,470
 corekit/events/publisher.py,sha256=3CcmFm1WuZfgsLVMkT8IchTvwpuTEzGCT33arfWKhsg,2559
 corekit/events/reader.py,sha256=ZKLEiQIcrv2jhQlUqRWJr4DgA4_Gh9E2S90xKF_zK4A,4449
 corekit/events/sse.py,sha256=xEU7weQZQe3vq5s6M-T1iLeWROjpse0qfC2qKPD__i4,3868
-corekit/events/websocket.py,sha256=EVz844LkULzRJ3L1K74qjne8uwLmaClJjPZrK3H0dxs,3217
-corekit/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+corekit/events/websocket.py,sha256=9dwmQ2BXvYLJrwHtGpspraRG30ls95Sj0D5tv2oDvsg,3283
+corekit/exceptions/__init__.py,sha256=EJqMvijcOKDs59-PsSnHaodwxo2wDyXzkyFUSCAaarU,587
 corekit/exceptions/base.py,sha256=C7wLXmo3O0kIz2cUQgmfQL3vZkppk9hEQ7acI8VAxNU,1194
 corekit/exceptions/types.py,sha256=ossPkVSUdq8MOnCKLO_p7KsYA07cum-Yq94Zdfh_uEY,691
 corekit/exceptions/custom/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -79,10 +87,14 @@ corekit/files/enum.py,sha256=L-_KPW8ilNnSIxNBGgvYgS7H686peNbEyIxOyKBTUPU,688
 corekit/files/json.py,sha256=oLrDbGFtMogsIz26yBpSxFGxHDuwmVDLi3POxyPjdPc,324
 corekit/files/pickle.py,sha256=qzVWJgtEdz8SgTDc5aBjXuktlCkktR1umQaCBbZmCNg,321
 corekit/files/toml.py,sha256=YFRwghMapbCRSl7srqcI7IhqaTQDyO56XRasGMu_Aug,1273
-corekit/http/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+corekit/http/__init__.py,sha256=DLdi_Ul0ZagEYuGu7KbS_9kAaDLeiXdSbVaOqfdS4hs,488
 corekit/http/client.py,sha256=cmBQCUN3GR3EpFYjeXtmVkKgPCBUOBOufnktGvQCjA8,5925
 corekit/http/exponential_backoff.py,sha256=5jjGTspX_BC9aBKPr5Y5dNhJqXesmljsjJoQ6i2d4_I,3180
 corekit/http/response.py,sha256=A_DOsAW9BLwGJJV3ea_9RutEUpqSaoX9Trbp4mPVWZE,423
+corekit/jobs/__init__.py,sha256=vsv8o23ApT6MlOwOq-AFYeQW2NT1kjyvu89A5CL2PsY,880
+corekit/jobs/registry.py,sha256=cco6884eVuIYHEtSv6P62MICFjX-QhuSZIFkEJcQi_M,2557
+corekit/jobs/runner.py,sha256=6RSjfDKKR82uvPcU5-7avHnPvo4OtZpV7m0OKjD6uYw,2215
+corekit/jobs/task.py,sha256=kOqY0202HQ9b-DcS6AjLHQ7BuXm1CduEHQoEnx95vUU,5050
 corekit/log_monitor/__init__.py,sha256=uuXTQdI8EMeFbdt69G-2K8dKh5Nt-h9SzBEsOGcu0lo,371
 corekit/log_monitor/constants.py,sha256=8nzIzU3Qit9h7_stZLWW1Q_0DTnYglw_j5bQUsF586g,230
 corekit/log_monitor/models.py,sha256=GwGEhIHh7pVVEqtqhc5VsmbpX3D-cWqPGaDlwOuyb4A,4803
@@ -90,36 +102,42 @@ corekit/log_monitor/service.py,sha256=ey7Tjyfw-Pem_9D3lZavbbWS6wLA0mQaRwgh0u_JZ9
 corekit/notifications/__init__.py,sha256=dLSyNnW7pOCgUNFsHRqTNzMRGYTItpwTWR3-wL7WxAI,255
 corekit/notifications/base.py,sha256=G0QDPdvGpnsYPWnwm2cYnZkojdL1qskUXisgGE6YDYw,1457
 corekit/notifications/models.py,sha256=cCAxNFCYCgzSclkUWHQL9O-uWdE058KUUaMewY5PL6M,646
-corekit/observability/__init__.py,sha256=Hpmtty__RRKwkUXPji-jS7zxIeYzB5yYiS5G4jCHQVg,701
+corekit/observability/__init__.py,sha256=bz36f-8NmOgssevTSegs0TRTQptHztNHx8ZSjQ6gsQE,895
 corekit/observability/benchmarkable.py,sha256=6grDn_4ug7koFPn7I5IqkarP1LIbWSz3jmNj0zA16cs,394
 corekit/observability/loggable.py,sha256=UebpEwHaLNVUI5CO4ftuHD-gep7sAIddhcpD7KvkBrg,919
+corekit/observability/request_context.py,sha256=CaKs3JEGh7ZbMiuSemEHpXs-iAZJYOD9-pPp-nKlDKg,4591
 corekit/observability/timing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 corekit/observability/timing/constants.py,sha256=Cv6h98NHzJiTJJufVQBVMBpdI0_fNMTnxAZF0j0vrsg,22
 corekit/observability/timing/split.py,sha256=qoITQnLLKfXe6NdCRvpL4ch8C9f_9G6a-P4bSQFYGYw,528
 corekit/observability/timing/timer.py,sha256=IWG2UcNyWZnOZGLVNbd6DxZ7GESWBx-1ma_exvWJVg8,914
-corekit/registry/__init__.py,sha256=uSehk6Mi3THRihOGeHHPAyKnxNpWw2l0GJ5uQv47epM,422
+corekit/registry/__init__.py,sha256=lMIcmjnGDRfBfVSaxWv_EwqMktOIKNdsyuWrmnoBXGA,649
+corekit/registry/ordered.py,sha256=_KS4mWzmLgFvODW2M0_ugxZIBW_dKhwwxrVrtNqLMfs,2506
 corekit/registry/registry.py,sha256=_rOKhEp7cmoOdjDWnXhfUK7xMIdmmNRSnxk_Fplt6dc,4202
-corekit/schemas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-corekit/schemas/enum.py,sha256=r7grhcxqUVDOJoOOwsr1tLbDnmsz8e1vZG7N9PaZyiE,1409
-corekit/schemas/types.py,sha256=dgtjHPmmBXM-OXiREwvyoOjOPBSY3hZxnaH-2ks8JVc,1159
+corekit/schemas/__init__.py,sha256=lpGVfqzXLpxpdP5ijS9uye_XfF1yNgjJ0Rt4m2EkwPE,298
+corekit/schemas/enum.py,sha256=nlXOX6L6XN_YcskqUIE0nMDtpJRk_N9QTFwxsJg1vnM,1360
+corekit/schemas/types.py,sha256=z6GxKd-rUcQ4ySyzgh7xpN2g7SR1fedFoCdOAyqHtrU,1119
 corekit/schemas/dataclasses/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 corekit/schemas/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-corekit/schemas/models/arbitrary.py,sha256=m2TCrc3nIsgSSGwZ8ziPIMn9MNaUgMqYhqowPsjMJmw,407
+corekit/schemas/models/arbitrary.py,sha256=L2Uqxo_twPAmzoly3Lyo5rzYhDzReSB_U-oAuRgWubg,396
 corekit/schemas/models/date_models.py,sha256=UOlSLVsWqgr_jnHfxVRgSl4nVVdfbe6zPBYveOgRcIg,399
 corekit/schemas/pydantic/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-corekit/schemas/pydantic/fields.py,sha256=MLCmVKDnqWQN1w5FpeEbAbQE7ml3xp6vcw4WcJvR-hA,1210
-corekit/serialization/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+corekit/schemas/pydantic/fields.py,sha256=ScP2ZQCR2qTWaqwjKl7lGvkTGSIeQBJ0yeNs79E47AA,1175
+corekit/serialization/__init__.py,sha256=qZ1zUOjJ7NqasJZ3jb_RQKJM7O7NZjX9wtdPTqZqFrc,741
 corekit/serialization/enum.py,sha256=pzHuAIXeonEF7-jyN1uYddJk-xvmQGuymDf1U6RWR5w,566
 corekit/serialization/serializable.py,sha256=07JuTDHrefkSeTtdLgku43oZYd9jnPyEC0I7XYZfr5M,1271
-corekit/serialization/serializer.py,sha256=oIvBqVENfDNLhL_4ENTV1cbG-nI2UlYy-gOAaPz5FaU,6203
-corekit/utils/__init__.py,sha256=mCULFy5sjSjN3mHkRjhpcpLpGYyLWe1Uu4bdVS-o2t4,190
-corekit/utils/ids.py,sha256=OST_qafowMk4kl8Z5P9AoAg3Og9XSRRc6_hrL6HU0Gc,76
-corekit/utils/raise_exc.py,sha256=pcG5rHUd96S4dG1IzoiDn9QD3pWEDbVv5ra_vha_aoA,183
-corekit/utils/time.py,sha256=070yexi-nMqsMyx6yaTNPm5pvonsWUvJj8mheFwUR1c,536
-corekit/utils/validators.py,sha256=EBRSIpVhuw_B-hJ9UVQU7W-nzPP49EkUE3mXCLhH2YE,355
-corekit/utils/void.py,sha256=qMyZ2jRsaH7C8M9eGXqmIdRmSFeontnsH-T7rBiT2BY,186
-python_corekit-0.1.1.dist-info/licenses/LICENSE,sha256=357LYxbxAQZ95q5cV-8JK6j-KNgiE6AteRodjEsm-kE,1072
-python_corekit-0.1.1.dist-info/METADATA,sha256=x6nMXzukrlJb_FTnRamfMiRtGa13ERzJJFG-38e0gzw,11972
-python_corekit-0.1.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-python_corekit-0.1.1.dist-info/top_level.txt,sha256=SDK4o8BoaI47E9tPbiNCbbWoc2y6N_wCjwnIEfr-GWI,8
-python_corekit-0.1.1.dist-info/RECORD,,
+corekit/serialization/serializer.py,sha256=F8rTw54ruDqWAOONhE1skRyqcbmq-YIAwrZrUUrzC7I,6204
+corekit/utils/__init__.py,sha256=n3feLbH1WrGqWZACyg-hChxkTrqfADFlFkxm5ie2JGo,1769
+corekit/utils/coercion.py,sha256=Aq63jrxQYg1ooWUFXHff2uepB_LoHm1izao8_3xkzEU,3650
+corekit/utils/collections.py,sha256=IqCv_3CCC9T-KmDZCA6l5OHUqe6NOyl0F9Q5RAcMgRM,3617
+corekit/utils/ids.py,sha256=BVniaYqewM-EosDxcJAT_S_7T9C1c5X8nsaVGs5up34,1731
+corekit/utils/payload.py,sha256=DN2wyxnSDDByituR20rYHLBLM4qfFhwiMpIkcr5SFg0,3528
+corekit/utils/raise_exc.py,sha256=cz7ljc6ZW90AGQussKuANN8PLsDLUhl-E8FZ0Ipsw-0,175
+corekit/utils/text.py,sha256=54maLM4jsS8cjVXRQCNVFzVszGimuzgaNzudhZzZeio,1694
+corekit/utils/time.py,sha256=-iPaETXcgDu7J39Kwe938JyZKhPVjl6a572BBqsqcDQ,2215
+corekit/utils/validators.py,sha256=_HVKo3y264KGNaZ-1RyM1x46VPvu7XKcQkrHWDC9uxs,340
+corekit/utils/void.py,sha256=eXDb2QynuguiSgHGJLdgE08MuRnxBdYebRdMD7s1m9o,178
+python_corekit-0.2.0.dist-info/licenses/LICENSE,sha256=357LYxbxAQZ95q5cV-8JK6j-KNgiE6AteRodjEsm-kE,1072
+python_corekit-0.2.0.dist-info/METADATA,sha256=4i3O12D1eLCzZdoX7kSR9r_v3EPxnTF2K8tl3CQDQ74,13155
+python_corekit-0.2.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+python_corekit-0.2.0.dist-info/top_level.txt,sha256=SDK4o8BoaI47E9tPbiNCbbWoc2y6N_wCjwnIEfr-GWI,8
+python_corekit-0.2.0.dist-info/RECORD,,