kiba-core 0.5.3.dev79__tar.gz → 0.5.3.dev81__tar.gz

kiba_core-0.5.3.dev81/.github/workflows/publish.yml

@@ -0,0 +1,29 @@
+name: Publish
+on:
+  push:
+    tags: ["v*"]
+jobs:
+  deploy-package:
+    runs-on: ubuntu-latest
+    env:
+      DOCKER_IMAGE: build
+      PYPI_PUBLISH_TOKEN: ${{ secrets.PYPI_PUBLISH_TOKEN }}
+    steps:
+      - name: Check out the repo
+        uses: actions/checkout@v7
+      - name: Build docker image
+        run: docker build --tag $DOCKER_IMAGE .
+      - name: Publish package to pypi
+        run: docker run -e UV_PUBLISH_TOKEN=$PYPI_PUBLISH_TOKEN $DOCKER_IMAGE /bin/bash -c " make publish"
+  create-release:
+    needs: deploy-package
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Check out the repo
+        uses: actions/checkout@v7
+      - name: Create Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: gh release create ${{ github.ref_name }} --title "Release ${{ github.ref_name }}" --generate-notes

kiba_core-0.5.3.dev81/.github/workflows/release.yml

@@ -0,0 +1,34 @@
+name: Release
+on:
+  workflow_dispatch:
+concurrency:
+  group: release
+jobs:
+  push-version-tag:
+    runs-on: ubuntu-latest
+    # NOTE(krishan711): the release environment only allows main and holds the deploy key, the only thing allowed to push version tags. Unlike the GITHUB_TOKEN, a push with it starts the workflows that publish the tag.
+    environment: release
+    permissions:
+      contents: read
+    steps:
+      - name: Check out the repo
+        uses: actions/checkout@v7
+        with:
+          ssh-key: ${{ secrets.RELEASE_DEPLOY_KEY }}
+      - name: Push the version tag
+        run: |
+          version="v$(python3 -c "import tomllib; print(tomllib.load(open('pyproject.toml', 'rb'))['project']['version'])")"
+          if [[ ! "$version" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "::error::pyproject.toml version $version is not X.Y.Z"
+            exit 1
+          fi
+          existingSha="$(git ls-remote origin "refs/tags/$version" | cut -f1)"
+          if [[ "$existingSha" == "$GITHUB_SHA" ]]; then
+            echo "$version is already tagged on this commit; if publishing failed, re-run the workflow run for the tag"
+          elif [[ -n "$existingSha" ]]; then
+            echo "::error::$version already exists on $existingSha, bump the version in pyproject.toml"
+            exit 1
+          else
+            git tag "$version"
+            git push origin "refs/tags/$version"
+          fi

{kiba_core-0.5.3.dev79 → kiba_core-0.5.3.dev81}/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.dev79 → kiba_core-0.5.3.dev81}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kiba-core
-Version: 0.5.3.dev79
+Version: 0.5.3.dev81
 Summary: Kiba Labs' python utilities
 Project-URL: repository, https://github.com/kibalabs/core-py
 Requires-Python: <4,>=3.12

kiba_core-0.5.3.dev81/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.dev79 → kiba_core-0.5.3.dev81}/kiba_core.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kiba-core
-Version: 0.5.3.dev79
+Version: 0.5.3.dev81
 Summary: Kiba Labs' python utilities
 Project-URL: repository, https://github.com/kibalabs/core-py
 Requires-Python: <4,>=3.12

{kiba_core-0.5.3.dev79 → kiba_core-0.5.3.dev81}/kiba_core.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ pyproject.toml
 uv.lock
 .github/pull_request_template.md
 .github/workflows/deploy.yml
+.github/workflows/publish.yml
 .github/workflows/pull-request.yml
 .github/workflows/release.yml
 core/__init__.py

{kiba_core-0.5.3.dev79 → kiba_core-0.5.3.dev81}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kiba-core"
-version = "0.5.3.dev79"
+version = "0.5.3.dev81"
 description = "Kiba Labs' python utilities"
 readme = "README.md"
 requires-python = ">=3.12, <4"

kiba_core-0.5.3.dev79/.github/workflows/release.yml

@@ -1,39 +0,0 @@
-name: Release
-on:
-  push:
-    tags: ["v*"]
-jobs:
-  deploy-package:
-    runs-on: ubuntu-latest
-    env:
-      DOCKER_IMAGE: build
-      PYPI_PUBLISH_TOKEN: ${{ secrets.PYPI_PUBLISH_TOKEN }}
-    steps:
-      - name: Check out the repo
-        uses: actions/checkout@v2
-      - name: Check the package version is the same as the tag
-        run: |
-          version=$(python3 setup.py --version)
-          if [ "${{ github.ref }}" != "refs/tags/v${version}" ]; then
-            echo "version in setup.py (v${version}) is different to the given tag (${{ github.ref }})"
-            exit 1;
-          fi
-      - name: Build docker image
-        run: docker build --tag $DOCKER_IMAGE .
-      - name: Publish package to pypi
-        run: docker run -e UV_PUBLISH_TOKEN=$PYPI_PUBLISH_TOKEN $DOCKER_IMAGE /bin/bash -c " make publish"
-  create-release:
-    needs: deploy-package
-    runs-on: ubuntu-latest
-    env:
-      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-    steps:
-      - name: Check out the repo
-        uses: actions/checkout@v2
-      - name: Create Release
-        uses: actions/create-release@v1
-        with:
-          tag_name: ${{ github.ref }}
-          release_name: Release ${{ github.ref }}
-          draft: false
-          prerelease: false

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

@@ -1,7 +0,0 @@
-from collections.abc import Mapping
-from collections.abc import Sequence
-
-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']