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

{python_corekit-0.1.1.dist-info → python_corekit-0.3.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.3.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.3.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
 
@@ -279,7 +284,7 @@ instead, which loses results silently and so is opt-in.
 ## HTTP clients
 
 ```python
-from corekit.http.client import BaseApiClient
+from corekit.http import BaseApiClient
 
 class GithubClient(BaseApiClient):
     """
@@ -296,7 +301,8 @@ response.data["login"]
 
 Retries 429 and 5xx with exponential backoff. Every response is a
 `BaseApiResponse`, so a non-JSON error page leaves `data` empty rather than
-raising. `async_get`, `async_post` and friends do the same without blocking.
+raising. The same methods are awaitable inside a running event loop:
+`await client.get(...)`.
 
 ## Serialization
 
@@ -346,7 +352,7 @@ Settings are grouped by concern, so `get_settings().concurrency.max_threads`
 says where a value belongs. Environment variables use a double underscore for
 the section: `COREKIT_CONCURRENCY__MAX_THREADS=16`.
 
-Environment variables use a `COREKIT_` prefix (`COREKIT_CRYPTO_SALT`). Empty
+Environment variables use a `COREKIT_` prefix (`COREKIT_CRYPTO__SALT`). Empty
 values are treated as unset, because container runtimes routinely pass `FOO=`
 for a variable that was never set.
 
@@ -370,23 +376,23 @@ Imports go downward only.
 ```
 corekit/
   config/                          settings, sources, loader
-  constants.py
 
   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
+  http/                            BaseHttpClient, 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.3.0.dist-info/RECORD

@@ -0,0 +1,145 @@
+corekit/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+corekit/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+corekit/api/__init__.py,sha256=44gtrMRkllhAQdwpfIKrkMuSl3qg61xRxgaTDldzmjg,688
+corekit/api/application.py,sha256=CDdJRHSbXFR6XLufg0idzNm_FFnsYl_0w8B5ArIN-KQ,12001
+corekit/api/handler.py,sha256=vYrao8_B5e6MZGI7GLm1Mr-e8NH8rYt8TNAcnoEuzRQ,2659
+corekit/api/lifespan.py,sha256=OLkiaDfQlhOz3p-gmDXywZgOsO6T-txNjhzeIN44NDk,8848
+corekit/api/middleware.py,sha256=6M5VPjRZTTPEfX5Hm7DHLoDwwWWAgmvWNiTuSykUA98,3168
+corekit/api/responses.py,sha256=bvADoj7snxqCKHIWFiU5rH8Mg5dmvi-ldxVLJbtVEQs,1258
+corekit/api/routers.py,sha256=j2DSkYTTIGd5qFEzYFlY5YM0qhdvhjUu8iFxWc9KM6o,7910
+corekit/concurrency/__init__.py,sha256=ovt0x-VqJhit2ygp0Y7j9gSc67xoQ6mJvQ8fNEF-HHY,348
+corekit/concurrency/decorators.py,sha256=vYnRb2xPTvmX-vmpLk7OL5H6uUYMtvX-pYc3KBV0VDw,3580
+corekit/concurrency/thread_local.py,sha256=8KA0JzX6kV1qjbRv5JZ8X2us8I0tdjS0TAvE-znh77E,3188
+corekit/concurrency/worker.py,sha256=V6wVrcYMTnSWUVTchP7F_ieReQTi6QP9tZDKUspaKSg,2280
+corekit/config/__init__.py,sha256=dw2Y2HvpHw1MXwLSVxdARGPYse9j6IteVN3q70c3Kic,1227
+corekit/config/loader.py,sha256=qjmOEJjO27U2vIgYBfsatNbZB73MkHJHZKbIKY03d2Q,6704
+corekit/config/settings.py,sha256=cmDNMPHkfdHGNmKlxPjFTWzO9fl3pKu7vCMFLP5QHSc,5283
+corekit/config/sources.py,sha256=kdeji29XnEOaDGRctiwEfp7bKuA2jBYGbvAdVEs21KE,3923
+corekit/connections/__init__.py,sha256=LipBfhpCyOG0JiQXqclIB1rUHJ18GMj_9ggpSykH-do,1167
+corekit/connections/connectable.py,sha256=WbNmfGUM9DYmD2daVKqAii_Vx4fs0CUCDDZsd1GOikg,8099
+corekit/connections/decorators.py,sha256=7xfmLuMr3kkceEkkxHxY_Pen2OakJEVukXtiOYAd-6Q,3606
+corekit/connections/registry.py,sha256=BR04dGthcGCtON2MxNsl-TlhRgbRlvGj0RLymDFBkGQ,3119
+corekit/connections/redis/__init__.py,sha256=BsWLZNqpKAqIoreHGLEtftnMqVw-ESK8jbexDAughag,174
+corekit/connections/redis/connection.py,sha256=H6r5WsDfXFgIQlp6vq3rKjp-oBFQoE5h_YaJXZEvHIs,9850
+corekit/connections/sql/__init__.py,sha256=WRBcQ9draDQSooYi4k4peWyuRTgSyEk_WwOYYOAN9K4,882
+corekit/connections/sql/connection.py,sha256=PvLhYXMmq6JneshWhoUb2WD2usGH7uOA9H_ZufybKgQ,12318
+corekit/connections/sql/query.py,sha256=8s5atIssmN2l9FCL2IHnIQqwxOk0fA_mPNh36koLhoE,233
+corekit/connections/sql/table.py,sha256=C7_QCRPd7C1JeH7aIByUBVWsx5qiEOFavWOo6c72djM,3125
+corekit/connections/sql/fields/__init__.py,sha256=2I-TCsvi321yQhesKNZgY1T77FtATZ6o7pw0MNHtbAo,184
+corekit/connections/sql/fields/jsonb.py,sha256=wGjtCP6v3i2bX73X-VVqBNuDNr0-MeWIosc6nvWyO9Q,2313
+corekit/connections/sql/migration/__init__.py,sha256=NBQyKdz84y6Y_QJVTJQVfHz0WrY1CXNoeko113GUoTg,1652
+corekit/connections/sql/migration/base.py,sha256=b-3ISuCRgt_HuLl4lWNPq2QiNC2_3fiNrd1dEgDd7pE,1344
+corekit/connections/sql/migration/operations.py,sha256=UIO0TPJceo0vtGsNQiATn7i7sEnseyli4TttLsSMpUw,15394
+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=PQSiEz79qd_bp29K7mOh4-qQA-_Wk_r4QfL4oo3hGPY,3286
+corekit/connections/sql/operations/statements.py,sha256=AuJyMM-a3Kiqky_jxi2lH40a6rCeHOaesRPKJuIOGrY,4888
+corekit/crypto/__init__.py,sha256=Qf_FCUoG_jb7Q9tnN4ctX8I6xyaeaJwk74ag_bSchAQ,87
+corekit/crypto/constants.py,sha256=m-uq7_EJ4XfUTSZxFv6h429UkKSrGTj3o_9DfRFGyvU,298
+corekit/crypto/enum.py,sha256=0csj06cATCYDPY_QTNy66j_hB16WCqcHg8tJOO0lMNU,212
+corekit/crypto/hasher.py,sha256=KkxBM8pwaFwdUV31D-LO7Pg8bFULI5Y8rtUDTWti08w,3184
+corekit/data/__init__.py,sha256=COGfw3-OBRp6KKWBSixid5vfaeasFVY5X4Wza0mB_kY,1977
+corekit/data/dataset.py,sha256=TK1yAs7bNCQpV7Z16YqCzYf2Q_Vpu2IbEs1sqMMbikM,12835
+corekit/data/record.py,sha256=EczoOvcxl-lHO1M92AjUh_5E9UQJ2qwBsiu6Yo-34gs,5233
+corekit/data/stats.py,sha256=cRnLGgUHEz66GS1Rs7c_wr2ZVvIJ8WbKq4ifBKR_t0U,4950
+corekit/data/expressions/__init__.py,sha256=_uOPah6QnbnT_W3DROD399b-TtjYQhsmnooD1pr62rE,1301
+corekit/data/expressions/comparison.py,sha256=teLuLEpZ-oohAaE9Oom6tdUSWGTGMDpTxJdWPKv6_7I,9374
+corekit/data/expressions/expression.py,sha256=J8EVyzRjh3VZvqiJyryjHZJfp5c2KwwENVYhZo8S2aw,2126
+corekit/data/expressions/operator.py,sha256=o_QFyiM9v9Ms83k2p2c6fhL3F05TIJ-gplhTk_t1LJk,893
+corekit/data/expressions/target.py,sha256=QSl7sH1qFVUc-mL7gsasTsCahWKhHqdo0bMHt--t2m8,470
+corekit/decorators/__init__.py,sha256=YrBcc_4wkSs7nEb3OjC7C7a8fNEvBk3RzOpD8QccHKM,83
+corekit/decorators/exception_handling.py,sha256=p86gfvdmsmC7_va042NSoGkWrJrbLLuw0ncE131wLWU,2326
+corekit/decorators/warnings.py,sha256=RS7AS6OS05VxiWaMjkj6kYky9FbpT4Z-Cb7TQoPOObk,1109
+corekit/docker/__init__.py,sha256=LtrmEvqorme1-YwL0jGNFLEASdgn69s0eYuh490anmg,104
+corekit/docker/watchdog.py,sha256=kAOF9x-h_oQmyKrkcc4eQ1_HIofRDyYyrfeAULyyBtQ,8855
+corekit/etl/__init__.py,sha256=KFuGv6xstJbEJHHYo_X5akEq_b7muDyKXCGdFeZ3_0M,1369
+corekit/etl/connection.py,sha256=_gWqR36x5f7qb5IYJjrc_7d_6oU2CXm1QeSNCCh0coo,1270
+corekit/etl/orchestrator.py,sha256=GkecTu8gKt17ePDM9PJBUuZTPYoPMdK1yYzBHjMdw3A,7959
+corekit/etl/schemas.py,sha256=3z0qZBintCO45BcxT6TY0Boi_ibrRa0z85wBJvLXNd4,385
+corekit/etl/extract/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+corekit/etl/extract/extractor.py,sha256=D_MmEVGUimPlFmNR1CIFOKii8d6y0XIr3MdXo8M0FU4,1434
+corekit/etl/extract/schemas.py,sha256=Hqse-GUwaCuN7eAW7Cacuj4k7Vy1dEu-NagruabiYWU,386
+corekit/etl/load/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+corekit/etl/load/loader.py,sha256=Oh8UZq1gRXFaO1a0poDxMNtdcnIayPsh06XuBQM9KjI,1579
+corekit/etl/load/schemas.py,sha256=c4hZrbjgN_zFKMBhDeNwaPARTiJdgnVFSIW8Lah4c3U,860
+corekit/etl/transform/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+corekit/etl/transform/schemas.py,sha256=_Kr8DAXQKZH6nIqYjXVpaeeA0shAsk1vjWOcEcAXly8,319
+corekit/etl/transform/transformer.py,sha256=foNmqhFq1dwWKfMN7hN9l8gMQaV1GBjhDcqu9MEkrY8,1040
+corekit/events/__init__.py,sha256=BrNQKcLnSs5zT1vjDJZ4UX_CD0g87dA5resmzKs0nQQ,1065
+corekit/events/enum.py,sha256=K7ziTjKDjZEZlDO8whjDph8X-bTT_ze2guTrYDGozYc,1342
+corekit/events/frames.py,sha256=ICuF9EKWQ1NqcSfkL0JFHvMB6zrikzkwoujP-292Q8k,1480
+corekit/events/models.py,sha256=faE-Z2qwggOaSBrzte-mBWXuomrzWMIl0gOEkjvPqLo,470
+corekit/events/publisher.py,sha256=70lHyEIEg0eXUWJ9k9eUNVBBmckm4rYBgvTZgRfbcl8,2598
+corekit/events/reader.py,sha256=HoJs6zb9N3VDD-nJV2fpks7ny2OI8UaAKQMBaXcK7_k,4994
+corekit/events/sse.py,sha256=lhF4KUQ_XrdExGLWbKYJghti2t6ExNzXYoA6dOZi9mA,4090
+corekit/events/websocket.py,sha256=S6CUh9duI5xHVrKqbHpss8FrnKKqnFHBFJpSkmgInN4,3858
+corekit/exceptions/__init__.py,sha256=8q9EX-0bzOiJI1FOzCbViQFwx53Ugs8NH482Cvpci6k,995
+corekit/exceptions/base.py,sha256=k0AfTfPrLWR6x-l2qvvjqD_sup0fiWhqu1OoNaNM-Lk,5596
+corekit/exceptions/enum.py,sha256=D-YL-cZXs-F2jS1GgRBhPWmuqBfX33B1QP61vAXdAes,324
+corekit/exceptions/types.py,sha256=rxhQ8sghV2TCHh_vB7tX6Yb6Vkyv1PF_0PLtalyFVxY,665
+corekit/exceptions/custom/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+corekit/exceptions/http/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+corekit/files/__init__.py,sha256=IllQEAWtcT72vVUdRaMwfF5VlhzMJ16VIKDhqvWG9Cw,612
+corekit/files/base.py,sha256=Ca2bhdlwntHh425PedaUG-UW2fEFZsPCss_3f7REsAE,4022
+corekit/files/enum.py,sha256=mcrQXcp-AizTAp4VoaVMLj9zu5D81XXMsnZwZqe6fz0,597
+corekit/files/json.py,sha256=pRYLKNjeVmkDQsgtjBboFFY5Ljx1Pwa3MFEeQBc4o-g,909
+corekit/files/toml.py,sha256=YFRwghMapbCRSl7srqcI7IhqaTQDyO56XRasGMu_Aug,1273
+corekit/http/__init__.py,sha256=cOZum0wNWuVGDB4PfX2OpWq01BurhV2dir3V0AcStfQ,1508
+corekit/http/api.py,sha256=L4iZ9TdCQH3klKWxIxFE3bEQzqMTDOwy-HKrvHXwsbI,784
+corekit/http/client.py,sha256=O7DSDQaiz1_NvBtT00LWsDqICEEIWGrUWKwgYA84AgQ,6603
+corekit/http/exceptions.py,sha256=etkKN6rgnhENctO7YNvaRAKsctK0PXKCxAe15l6mNwY,4252
+corekit/http/exponential_backoff.py,sha256=5jjGTspX_BC9aBKPr5Y5dNhJqXesmljsjJoQ6i2d4_I,3180
+corekit/http/response.py,sha256=rOcUEgPYxfmKXfGO5fQsMA8q4YJof8dNNGBf-nb7l8k,2375
+corekit/http/status.py,sha256=rZ-cdliG9EAvWMTzvxjqjipRkZRc6RgSzcBY4Kewdg0,2377
+corekit/jobs/__init__.py,sha256=vsv8o23ApT6MlOwOq-AFYeQW2NT1kjyvu89A5CL2PsY,880
+corekit/jobs/registry.py,sha256=cco6884eVuIYHEtSv6P62MICFjX-QhuSZIFkEJcQi_M,2557
+corekit/jobs/runner.py,sha256=KRzUIaeXVqLFekoIi2C5cnZ8F-5V5Oy_91xOPHjhjmY,2650
+corekit/jobs/task.py,sha256=tqr-QaQSHyfPjbyZscM5i-YgT-fl58cpd2FVxevtG_E,6112
+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=EiXVzPMdupbVOHoSFbagAyNhtdBf5jx_LlJqgQpoKqI,4999
+corekit/log_monitor/service.py,sha256=xGIaNYDfs8DZrJoKMMb5ZsUbdcmbHvn5OXvhFyZJl10,18606
+corekit/notifications/__init__.py,sha256=dLSyNnW7pOCgUNFsHRqTNzMRGYTItpwTWR3-wL7WxAI,255
+corekit/notifications/base.py,sha256=cAgENDk6EEeQNzaDPAitm9OybkC0i8gFjcrDh8TfCtg,1889
+corekit/notifications/models.py,sha256=cCAxNFCYCgzSclkUWHQL9O-uWdE058KUUaMewY5PL6M,646
+corekit/observability/__init__.py,sha256=DTUg9SQvUDRSG_3qOVaTXEk0jlqZzWXXMQdP8CH2Lzs,968
+corekit/observability/benchmarkable.py,sha256=VBO70x-UeBareVIBXRZRQX3TqAHhVYCjZWNyX19kcdo,993
+corekit/observability/loggable.py,sha256=VajvdhPB09QERyq585yItHMYTngvW-DWBv1sxkySlbc,1769
+corekit/observability/request_context.py,sha256=X2WDmp2fV-PJVILkWU2S0WksxW0BYD2nG4mDhEjPYNM,6698
+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=IPHCkoIWK-eBRlEOJSx92AU1YxbgLiww3_EKyFgONGY,1080
+corekit/registry/__init__.py,sha256=R67Jssr06Eyx2u5AbX1omm2LziWvwS_Sd7fExnNv9CM,681
+corekit/registry/ordered.py,sha256=_KS4mWzmLgFvODW2M0_ugxZIBW_dKhwwxrVrtNqLMfs,2506
+corekit/registry/registry.py,sha256=t1iwzxgvd-iyLIf_5wahg_P7eN9V1oumpupkAqi2GdQ,5601
+corekit/schemas/__init__.py,sha256=lpGVfqzXLpxpdP5ijS9uye_XfF1yNgjJ0Rt4m2EkwPE,298
+corekit/schemas/enum.py,sha256=gLc44kIXRfpDFkV51JoN4KT1CU92hnb529rd1b88fBM,2033
+corekit/schemas/types.py,sha256=AWIxZHXUiUjJRZjmOhAdCq3RIsRzL-Fy7RvYy4i5Ozo,1347
+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=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=ScP2ZQCR2qTWaqwjKl7lGvkTGSIeQBJ0yeNs79E47AA,1175
+corekit/serialization/__init__.py,sha256=RuS_bQmN1gz2-wg9HcyM03d_CU9MZO0QliIcnZGEq8I,830
+corekit/serialization/enum.py,sha256=pzHuAIXeonEF7-jyN1uYddJk-xvmQGuymDf1U6RWR5w,566
+corekit/serialization/pickle_file.py,sha256=dudKIxR8ueT3wx_IBxHJeoqnFeP1rT7dlTb_PXlSkd8,2251
+corekit/serialization/serializable.py,sha256=viF3ZCKRJ90hk6m4lbqIfo6ifsY2c4sXr4xZrn1Yz-Q,1999
+corekit/serialization/serializer.py,sha256=XlGE1Rq8M55Jl2a4F5MkvDcba2VI7lrh0v9kwL0DWG8,6617
+corekit/utils/__init__.py,sha256=n3feLbH1WrGqWZACyg-hChxkTrqfADFlFkxm5ie2JGo,1769
+corekit/utils/coercion.py,sha256=Aq63jrxQYg1ooWUFXHff2uepB_LoHm1izao8_3xkzEU,3650
+corekit/utils/collections.py,sha256=Kxjlw4ybNo3ClaJQamsZ1ZGRc_KpU2v1HXnR2me2zl8,4013
+corekit/utils/ids.py,sha256=BVniaYqewM-EosDxcJAT_S_7T9C1c5X8nsaVGs5up34,1731
+corekit/utils/payload.py,sha256=T7EgdVU0S5h8MAzvQsmkfRPMatWqUbxjHL9hmZdM9ho,3882
+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.3.0.dist-info/licenses/LICENSE,sha256=357LYxbxAQZ95q5cV-8JK6j-KNgiE6AteRodjEsm-kE,1072
+python_corekit-0.3.0.dist-info/METADATA,sha256=59HC-Dee9ORoSCa6YSxqd41jf4euLDkF9d6sE2ZzZZk,13167
+python_corekit-0.3.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+python_corekit-0.3.0.dist-info/top_level.txt,sha256=SDK4o8BoaI47E9tPbiNCbbWoc2y6N_wCjwnIEfr-GWI,8
+python_corekit-0.3.0.dist-info/RECORD,,

corekit/constants.py

@@ -1,45 +0,0 @@
-# Minutes
-ONE_MINUTE = 60
-TWO_MINUTES = ONE_MINUTE * 2
-THREE_MINUTES = ONE_MINUTE * 3
-FIVE_MINUTES = ONE_MINUTE * 5
-TEN_MINUTES = ONE_MINUTE * 10
-FIFTEEN_MINUTES = ONE_MINUTE * 15
-THIRTY_MINUTES = ONE_MINUTE * 30
-FORTY_FIVE_MINUTES = ONE_MINUTE * 45
-
-# Hours
-ONE_HOUR = ONE_MINUTE * 60
-TWO_HOURS = ONE_HOUR * 2
-THREE_HOURS = ONE_HOUR * 3
-FIVE_HOURS = ONE_HOUR * 5
-SIX_HOURS = ONE_HOUR * 6
-NINE_HOURS = ONE_HOUR * 9
-TWELVE_HOURS = ONE_HOUR * 12
-FIFTEEN_HOURS = ONE_HOUR * 15
-EIGHTEEN_HOURS = ONE_HOUR * 18
-
-# Days
-ONE_DAY = ONE_HOUR * 24
-TWO_DAYS = ONE_DAY * 2
-THREE_DAYS = ONE_DAY * 3
-FOUR_DAYS = ONE_DAY * 4
-FIVE_DAYS = ONE_DAY * 5
-SIX_DAYS = ONE_DAY * 6
-TEN_DAYS = ONE_DAY * 10
-FIFTEEN_DAYS = ONE_DAY * 15
-THIRTY_DAYS = ONE_DAY * 30
-FORTY_FIVE_DAYS = ONE_DAY * 45
-SIXTY_FIVE_DAYS = ONE_DAY * 60
-NINETY_FIVE_DAYS = ONE_DAY * 90
-ONE_HUNDRED_TWENTY_DAYS = ONE_DAY * 120
-ONE_HUNDRED_EIGHTY_DAYS = ONE_DAY * 180
-
-# Weeks
-ONE_WEEK = ONE_DAY * 7
-TWO_WEEKS = ONE_WEEK * 2
-THREE_WEEKS = ONE_WEEK * 3
-FOUR_WEEKS = ONE_WEEK * 4
-
-# Years
-ONE_YEAR = ONE_DAY * 365

corekit/exceptions/http/exceptions.py

@@ -1,37 +0,0 @@
-from typing import Any
-
-from fastapi import status
-
-from corekit.exceptions.base import CustomHTTPException
-
-
-# 400 Errors
-class UnauthorizedException(CustomHTTPException):
-    def __init__(self, **kwargs: Any) -> None:
-        super().__init__(status_code=status.HTTP_401_UNAUTHORIZED, **kwargs)
-
-
-class ForbiddenException(CustomHTTPException):
-    def __init__(self, **kwargs: Any) -> None:
-        super().__init__(status_code=status.HTTP_403_FORBIDDEN, **kwargs)
-
-
-class NotFoundException(CustomHTTPException):
-    def __init__(self, **kwargs: Any) -> None:
-        super().__init__(status_code=status.HTTP_404_NOT_FOUND, **kwargs)
-
-
-class ConflictErrorException(CustomHTTPException):
-    def __init__(self, **kwargs: Any) -> None:
-        super().__init__(status_code=status.HTTP_409_CONFLICT, **kwargs)
-
-
-class UnprocessableEntityException(CustomHTTPException):
-    def __init__(self, **kwargs: Any) -> None:
-        super().__init__(status_code=status.HTTP_422_UNPROCESSABLE_ENTITY, **kwargs)
-
-
-# 500 Errors
-class InternalServerErrorException(CustomHTTPException):
-    def __init__(self, **kwargs: Any) -> None:
-        super().__init__(status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, **kwargs)

corekit/files/pickle.py

@@ -1,12 +0,0 @@
-import pickle
-from typing import Any
-
-from corekit.files.base import FileContent, FileManager
-
-
-class PickleFileManager(FileManager):
-    def _serialize(self, content: Any) -> FileContent:
-        return pickle.dumps(content)
-
-    def _deserialize(self, content: FileContent) -> Any:
-        return pickle.loads(content)