kiba-core 0.5.3.dev80__tar.gz → 0.5.3.dev82__tar.gz

{kiba_core-0.5.3.dev80 → kiba_core-0.5.3.dev82}/.github/workflows/deploy.yml

@@ -10,7 +10,7 @@ jobs:
       PYPI_PUBLISH_TOKEN: ${{ secrets.PYPI_PUBLISH_TOKEN }}
     steps:
       - name: Check out the repo
-        uses: actions/checkout@v2
+        uses: actions/checkout@v7
         with:
           # NOTE(krishan711): need full history to calculate difference
           fetch-depth: 0

{kiba_core-0.5.3.dev80 → kiba_core-0.5.3.dev82}/.github/workflows/pull-request.yml

@@ -12,11 +12,11 @@ jobs:
       DOCKER_IMAGE: core
     steps:
       - name: Check out the repo
-        uses: actions/checkout@v2
+        uses: actions/checkout@v7
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v1
+        uses: docker/setup-buildx-action@v4
       - name: Build docker image
-        uses: docker/build-push-action@v2
+        uses: docker/build-push-action@v7
         with:
           context: .
           load: true

{kiba_core-0.5.3.dev80 → kiba_core-0.5.3.dev82}/CHANGELOG.md

@@ -8,6 +8,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 ## [Unreleased]
 
 ### Added
+- [MINOR] Added `UNDEFINED`, `Undefined` and `UpdateValue[T]` to `core.util.typing_util` for partial updates: `UpdateValue[T]` is `T` or the `UNDEFINED` sentinel, so an update can tell "not provided" apart from an explicit `None`. Use it as a pydantic field default (`title: UpdateValue[str | None] = UNDEFINED`); request input never validates to `UNDEFINED` (a JSON `"UNDEFINED"` stays a string), and `x is not UNDEFINED` narrows `x` to `T` for type checkers
 - [MINOR] Added `core.store.entity_repository.EntityRepository`, which reads and writes rows of a table as pydantic models: `create`, `update`, `upsert`, `upsert_many` (postgres and sqlite), `delete`, `list_many`, `get_first`, `get`, `get_one` and `get_one_or_none`. It exposes UUID columns as strings and datetimes as aware utc datetimes, dumps pydantic values in JSON columns, generates ids for UUID primary keys and stamps `createdDate`/`updatedDate` when the table has them; subclasses can override `_convert_value_from_db`/`_convert_value_to_db` for other columns
 - [MINOR] Added `UUIDFieldFilter` (accepts `uuid.UUID` or `str` values) and module-level `apply_orders`, `apply_field_filters` and `get_field_filters_conditions` (conditions usable on selects, updates and deletes) to `core.store.retriever`; `Retriever` now uses them
 - [PATCH] Updated `DateFieldFilter` to convert values to utc for the column (naive for columns without a timezone, aware otherwise) so aware datetimes in any timezone compare correctly

{kiba_core-0.5.3.dev80 → kiba_core-0.5.3.dev82}/PKG-INFO

@@ -1,19 +1,19 @@
 Metadata-Version: 2.4
 Name: kiba-core
-Version: 0.5.3.dev80
+Version: 0.5.3.dev82
 Summary: Kiba Labs' python utilities
 Project-URL: repository, https://github.com/kibalabs/core-py
 Requires-Python: <4,>=3.12
 Description-Content-Type: text/markdown
 Requires-Dist: aiofiles>=25.1.0
-Requires-Dist: pydantic>=2.13.5
-Requires-Dist: orjson>=3.12.0
+Requires-Dist: pydantic>=2.14.1
+Requires-Dist: orjson>=3.13.0
 Provides-Extra: api
-Requires-Dist: fastapi>=0.141.1; extra == "api"
-Requires-Dist: uvicorn[standard]>=0.53.0; extra == "api"
+Requires-Dist: fastapi>=0.143.0; extra == "api"
+Requires-Dist: uvicorn[standard]>=0.54.0; extra == "api"
 Provides-Extra: core-api
 Requires-Dist: starlette>=1.7.0; extra == "core-api"
-Requires-Dist: uvicorn[standard]>=0.53.0; extra == "core-api"
+Requires-Dist: uvicorn[standard]>=0.54.0; extra == "core-api"
 Provides-Extra: storage
 Requires-Dist: aiobotocore>=3.9.2; extra == "storage"
 Provides-Extra: queues
@@ -25,10 +25,10 @@ Requires-Dist: azure-storage-queue[aio]>=12.18.0; extra == "queue-aqs"
 Provides-Extra: queue-cosmos
 Requires-Dist: azure-cosmos>=4.17.1; extra == "queue-cosmos"
 Provides-Extra: database-psql
-Requires-Dist: sqlalchemy[asyncio]>=2.1.3; extra == "database-psql"
-Requires-Dist: asyncpg>=0.31.0; extra == "database-psql"
+Requires-Dist: sqlalchemy[asyncio]>=2.1.4; extra == "database-psql"
+Requires-Dist: asyncpg>=0.32.0; extra == "database-psql"
 Provides-Extra: database-sqlite
-Requires-Dist: sqlalchemy[asyncio]>=2.1.3; extra == "database-sqlite"
+Requires-Dist: sqlalchemy[asyncio]>=2.1.4; extra == "database-sqlite"
 Requires-Dist: aiosqlite>=0.22.1; extra == "database-sqlite"
 Provides-Extra: requester
 Requires-Dist: httpx2>=2.13.1; extra == "requester"

{kiba_core-0.5.3.dev80 → kiba_core-0.5.3.dev82}/core/api/request_context.py

@@ -30,7 +30,7 @@ class RequestContextHolder[RequestContextType: RequestContext]:
         return value
 
     @contextmanager
-    def use_value(self, value: RequestContextType) -> typing.Iterator[RequestContextType]:
+    def use_value(self, value: RequestContextType) -> typing.Generator[RequestContextType]:
         token = self._valueContext.set(value)
         try:
             yield value

{kiba_core-0.5.3.dev80 → kiba_core-0.5.3.dev82}/core/locks/lock.py

@@ -2,7 +2,7 @@ import abc
 import asyncio
 import contextlib
 from abc import ABC
-from collections.abc import AsyncIterator
+from collections.abc import AsyncGenerator
 
 from core import logging
 from core.exceptions import LockedException
@@ -55,7 +55,7 @@ class Lock(ABC):
                 return
 
     @contextlib.asynccontextmanager
-    async def with_lock(self, name: str, ttlSeconds: int = 60, maxWaitSeconds: float = 0) -> AsyncIterator[LockLease]:
+    async def with_lock(self, name: str, ttlSeconds: int = 60, maxWaitSeconds: float = 0) -> AsyncGenerator[LockLease]:
         lease = await self.acquire(name=name, ttlSeconds=ttlSeconds, maxWaitSeconds=maxWaitSeconds)
         keepAliveTask = asyncio.create_task(self._keep_alive(lease=lease))
         try:

{kiba_core-0.5.3.dev80 → kiba_core-0.5.3.dev82}/core/store/database.py

@@ -3,7 +3,7 @@ import contextvars
 import datetime
 import typing
 import weakref
-from collections.abc import AsyncIterator
+from collections.abc import AsyncGenerator
 from typing import TypeVarTuple
 
 import sqlalchemy
@@ -80,7 +80,7 @@ class Database:
         raise InternalServerErrorException(message=f'Database.now does not support dialect: {dialectName}')
 
     @contextlib.asynccontextmanager
-    async def create_transaction(self) -> AsyncIterator[DatabaseConnection]:
+    async def create_transaction(self) -> AsyncGenerator[DatabaseConnection]:
         if not self._engine:
             raise InternalServerErrorException(message='Engine has not been established. Please called collect() first.')
         async with self._engine.begin() as connection:
@@ -102,7 +102,7 @@ class Database:
     # uncaught exception raised whilst parallel queries are running.
     # We have the forced reconnect at the bottom just to catch for this wierd case.
     @contextlib.asynccontextmanager
-    async def create_context_connection(self) -> AsyncIterator[DatabaseConnection]:
+    async def create_context_connection(self) -> AsyncGenerator[DatabaseConnection]:
         if not self._engine:
             raise InternalServerErrorException(message='Engine has not been established. Please called collect() first.')
         if self._get_context_connection() is not None:
@@ -128,7 +128,7 @@ class Database:
     # transaction's uncommitted writes and will block forever on rows the outer transaction has written, so
     # callers must commit their writes before entering. Violations are logged (with the caller's stack) for now.
     @contextlib.asynccontextmanager
-    async def create_isolated_context_connection(self) -> AsyncIterator[DatabaseConnection]:
+    async def create_isolated_context_connection(self) -> AsyncGenerator[DatabaseConnection]:
         if not self._engine:
             raise InternalServerErrorException(message='Engine has not been established. Please called collect() first.')
         outerConnection = self._get_context_connection()

{kiba_core-0.5.3.dev80 → kiba_core-0.5.3.dev82}/core/store/saver.py

@@ -1,5 +1,5 @@
 import contextlib
-from collections.abc import AsyncIterator
+from collections.abc import AsyncGenerator
 from typing import TYPE_CHECKING
 from typing import Any
 
@@ -35,7 +35,7 @@ class Saver:
         self.database = database
 
     @contextlib.asynccontextmanager
-    async def create_transaction(self) -> AsyncIterator[DatabaseConnection]:
+    async def create_transaction(self) -> AsyncGenerator[DatabaseConnection]:
         async with self.database.create_transaction() as connection:
             yield connection
 

kiba_core-0.5.3.dev82/core/util/typing_util.py

@@ -0,0 +1,28 @@
+import enum
+import typing
+from collections.abc import Mapping
+from collections.abc import Sequence
+
+from pydantic import GetCoreSchemaHandler
+from pydantic_core import core_schema
+
+JsonBaseType = str | int | float | bool | None
+type Json = dict[str, 'Json'] | Mapping[str, 'Json'] | list['Json'] | Sequence['Json'] | JsonBaseType
+type JsonObject = dict[str, 'Json']
+type JsonList = list['Json']
+
+
+class Undefined(enum.Enum):
+    UNDEFINED = 'UNDEFINED'
+
+    def __repr__(self) -> str:
+        return 'UNDEFINED'
+
+    @classmethod
+    def __get_pydantic_core_schema__(cls, sourceType: typing.Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:  # type: ignore[explicit-any]
+        # NOTE(krishan711): only the default can be UNDEFINED, input values (e.g. "UNDEFINED" in json) must never validate to it
+        return core_schema.is_instance_schema(cls)
+
+
+UNDEFINED: typing.Final = Undefined.UNDEFINED
+type UpdateValue[T] = T | Undefined

{kiba_core-0.5.3.dev80 → kiba_core-0.5.3.dev82}/kiba_core.egg-info/PKG-INFO

@@ -1,19 +1,19 @@
 Metadata-Version: 2.4
 Name: kiba-core
-Version: 0.5.3.dev80
+Version: 0.5.3.dev82
 Summary: Kiba Labs' python utilities
 Project-URL: repository, https://github.com/kibalabs/core-py
 Requires-Python: <4,>=3.12
 Description-Content-Type: text/markdown
 Requires-Dist: aiofiles>=25.1.0
-Requires-Dist: pydantic>=2.13.5
-Requires-Dist: orjson>=3.12.0
+Requires-Dist: pydantic>=2.14.1
+Requires-Dist: orjson>=3.13.0
 Provides-Extra: api
-Requires-Dist: fastapi>=0.141.1; extra == "api"
-Requires-Dist: uvicorn[standard]>=0.53.0; extra == "api"
+Requires-Dist: fastapi>=0.143.0; extra == "api"
+Requires-Dist: uvicorn[standard]>=0.54.0; extra == "api"
 Provides-Extra: core-api
 Requires-Dist: starlette>=1.7.0; extra == "core-api"
-Requires-Dist: uvicorn[standard]>=0.53.0; extra == "core-api"
+Requires-Dist: uvicorn[standard]>=0.54.0; extra == "core-api"
 Provides-Extra: storage
 Requires-Dist: aiobotocore>=3.9.2; extra == "storage"
 Provides-Extra: queues
@@ -25,10 +25,10 @@ Requires-Dist: azure-storage-queue[aio]>=12.18.0; extra == "queue-aqs"
 Provides-Extra: queue-cosmos
 Requires-Dist: azure-cosmos>=4.17.1; extra == "queue-cosmos"
 Provides-Extra: database-psql
-Requires-Dist: sqlalchemy[asyncio]>=2.1.3; extra == "database-psql"
-Requires-Dist: asyncpg>=0.31.0; extra == "database-psql"
+Requires-Dist: sqlalchemy[asyncio]>=2.1.4; extra == "database-psql"
+Requires-Dist: asyncpg>=0.32.0; extra == "database-psql"
 Provides-Extra: database-sqlite
-Requires-Dist: sqlalchemy[asyncio]>=2.1.3; extra == "database-sqlite"
+Requires-Dist: sqlalchemy[asyncio]>=2.1.4; extra == "database-sqlite"
 Requires-Dist: aiosqlite>=0.22.1; extra == "database-sqlite"
 Provides-Extra: requester
 Requires-Dist: httpx2>=2.13.1; extra == "requester"

{kiba_core-0.5.3.dev80 → kiba_core-0.5.3.dev82}/kiba_core.egg-info/requires.txt

@@ -1,24 +1,24 @@
 aiofiles>=25.1.0
-pydantic>=2.13.5
-orjson>=3.12.0
+pydantic>=2.14.1
+orjson>=3.13.0
 
 [api]
-fastapi>=0.141.1
-uvicorn[standard]>=0.53.0
+fastapi>=0.143.0
+uvicorn[standard]>=0.54.0
 
 [core-api]
 starlette>=1.7.0
-uvicorn[standard]>=0.53.0
+uvicorn[standard]>=0.54.0
 
 [cron]
 apscheduler<4,>=3.11.3
 
 [database-psql]
-sqlalchemy[asyncio]>=2.1.3
-asyncpg>=0.31.0
+sqlalchemy[asyncio]>=2.1.4
+asyncpg>=0.32.0
 
 [database-sqlite]
-sqlalchemy[asyncio]>=2.1.3
+sqlalchemy[asyncio]>=2.1.4
 aiosqlite>=0.22.1
 
 [queue-aqs]

{kiba_core-0.5.3.dev80 → kiba_core-0.5.3.dev82}/pyproject.toml

@@ -1,23 +1,23 @@
 [project]
 name = "kiba-core"
-version = "0.5.3.dev80"
+version = "0.5.3.dev82"
 description = "Kiba Labs' python utilities"
 readme = "README.md"
 requires-python = ">=3.12, <4"
 dependencies = [
     "aiofiles>=25.1.0",
-    "pydantic>=2.13.5",
-    "orjson>=3.12.0",
+    "pydantic>=2.14.1",
+    "orjson>=3.13.0",
 ]
 
 [project.optional-dependencies]
 api = [
-    "fastapi>=0.141.1",
-    "uvicorn[standard]>=0.53.0",
+    "fastapi>=0.143.0",
+    "uvicorn[standard]>=0.54.0",
 ]
 core-api = [
     "starlette>=1.7.0",
-    "uvicorn[standard]>=0.53.0",
+    "uvicorn[standard]>=0.54.0",
 ]
 storage = [
     "aiobotocore>=3.9.2",
@@ -36,11 +36,11 @@ queue-cosmos = [
     "azure-cosmos>=4.17.1",
 ]
 database-psql = [
-    "sqlalchemy[asyncio]>=2.1.3",
-    "asyncpg>=0.31.0",
+    "sqlalchemy[asyncio]>=2.1.4",
+    "asyncpg>=0.32.0",
 ]
 database-sqlite = [
-    "sqlalchemy[asyncio]>=2.1.3",
+    "sqlalchemy[asyncio]>=2.1.4",
     "aiosqlite>=0.22.1",
 ]
 requester = [
@@ -59,7 +59,7 @@ types = [
 
 [dependency-groups]
 dev = [
-    "kiba-build==0.1.11.dev15",
+    "kiba-build==0.1.11.dev17",
 ]
 
 [project.urls]