lakana-worker 0.12.0__tar.gz

lakana_worker-0.12.0/.gitignore

@@ -0,0 +1,25 @@
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+.env
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.import_linter_cache/
+.coverage
+coverage.json
+mutants/
+htmlcov/
+.DS_Store
+node_modules/
+.idea/
+.vscode/
+.superpowers/
+docs/superpowers/
+graphify-out/
+.worktrees/
+site-build/

lakana_worker-0.12.0/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.5
+Name: lakana-worker
+Version: 0.12.0
+Summary: Lakana's DuckDB query executor and dequeue loop.
+Project-URL: Homepage, https://github.com/chrschy/lakana
+Project-URL: Documentation, https://github.com/chrschy/lakana/tree/main/docs/site
+Project-URL: Repository, https://github.com/chrschy/lakana
+Project-URL: Issues, https://github.com/chrschy/lakana/issues
+Project-URL: Changelog, https://github.com/chrschy/lakana/blob/main/CHANGELOG.md
+Author: Christopher Schymura
+License-Expression: Apache-2.0
+Keywords: data-platform,duckdb,iceberg,lakehouse
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Database
+Requires-Python: >=3.11
+Requires-Dist: duckdb<2,>=1.1
+Requires-Dist: httpx<1,>=0.28
+Requires-Dist: lakana-core==0.12.0
+Description-Content-Type: text/markdown
+
+# lakana-worker
+
+> **Pre-beta.** Lakana is published as a 0.x pre-beta: the API and the data layout may change
+> between releases, and it is not ready for production data yet. See the
+> [project README](https://github.com/chrschy/lakana#readme).
+
+The DuckDB query executor and dequeue loop. The only Lakana package allowed to
+import `duckdb`. Never imports `lakana-server`; the queue table (`query_runs`,
+in `lakana-core`) is the only channel between the two.
+
+Part of [Lakana](https://github.com/chrschy/lakana). Installed with `pip install "lakana[server]"`.

lakana_worker-0.12.0/README.md

@@ -0,0 +1,11 @@
+# lakana-worker
+
+> **Pre-beta.** Lakana is published as a 0.x pre-beta: the API and the data layout may change
+> between releases, and it is not ready for production data yet. See the
+> [project README](https://github.com/chrschy/lakana#readme).
+
+The DuckDB query executor and dequeue loop. The only Lakana package allowed to
+import `duckdb`. Never imports `lakana-server`; the queue table (`query_runs`,
+in `lakana-core`) is the only channel between the two.
+
+Part of [Lakana](https://github.com/chrschy/lakana). Installed with `pip install "lakana[server]"`.

lakana_worker-0.12.0/hatch_build.py

@@ -0,0 +1,39 @@
+"""Hatchling metadata hook: pin `lakana-core` to this exact release.
+
+hatch-vcs resolves every workspace package's version from the same git tag
+(`raw-options.root = "../.."` in each package's `[tool.hatch.version]`), so
+`lakana-core` can be pinned to precisely this build's own version with no
+hand-edited version anywhere (rule 3): hatchling resolves `project.version`
+before any metadata hook's `update()` runs
+(`hatchling.metadata.core.ProjectMetadata.core`), so `metadata["version"]`
+below is already the real, resolved version. See
+`packages/lakana/hatch_build.py`'s `ServerExtraMetadataHook`, which pins
+`lakana-server`/`lakana-worker` inside `lakana`'s `server` extra the same way.
+
+`dependencies` is dynamic in `pyproject.toml`, so hatchling requires this
+hook to supply the *entire* list, not just the pinned addition. The other
+dependencies, with their explanatory comments, live under this hook's own
+config table (`[tool.hatch.metadata.hooks.custom]`) so they stay readable as
+ordinary TOML instead of being hard-coded here.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from hatchling.metadata.plugin.interface import MetadataHookInterface
+
+
+class CoreDependencyMetadataHook(MetadataHookInterface):
+    """Appends a `lakana-core==<version>` pin to the configured dependencies."""
+
+    def update(self, metadata: dict[str, Any]) -> None:
+        """Set `dependencies` to the configured list plus a `lakana-core` pin.
+
+        Parameters
+        ----------
+        metadata
+            The `project` table, mutated in place.
+        """
+        version = metadata["version"]
+        metadata["dependencies"] = [*self.config["dependencies"], f"lakana-core=={version}"]

lakana_worker-0.12.0/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[project]
+name = "lakana-worker"
+description = "Lakana's DuckDB query executor and dequeue loop."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "Apache-2.0"
+authors = [{ name = "Christopher Schymura" }]
+keywords = ["lakehouse", "duckdb", "iceberg", "data-platform"]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "License :: OSI Approved :: Apache Software License",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Database",
+]
+urls = { Homepage = "https://github.com/chrschy/lakana", Documentation = "https://github.com/chrschy/lakana/tree/main/docs/site", Repository = "https://github.com/chrschy/lakana", Issues = "https://github.com/chrschy/lakana/issues", Changelog = "https://github.com/chrschy/lakana/blob/main/CHANGELOG.md" }
+dynamic = ["version", "dependencies"]
+
+[project.scripts]
+lakana-worker = "lakana_worker.__main__:main"
+
+[tool.uv.sources]
+lakana-core = { workspace = true }
+
+[tool.hatch.version]
+source = "vcs"
+raw-options = { root = "../.." }
+
+[tool.hatch.metadata.hooks.custom]
+# Loads `hatch_build.py`'s `CoreDependencyMetadataHook`, which appends
+# `lakana-core==<this build's version>` to the `dependencies` list below,
+# pinning lakana-worker to exactly this release's lakana-core -- the
+# same hatch-vcs-resolved version pattern as `packages/lakana/hatch_build.py`'s
+# `ServerExtraMetadataHook`. `dependencies` lives here, not under
+# `[project]`, because hatchling requires the hook to supply the *entire*
+# list once `dependencies` is dynamic; keeping the other pins and their
+# comments in this table (rather than hard-coding them into hatch_build.py)
+# keeps them visible and editable as ordinary TOML.
+dependencies = [
+    # MIT. Capped below 2: on a DuckDB 2.0 development build, the tests of the
+    # query guard and of DuckDB's error texts fail. Lifted by issue #96.
+    "duckdb>=1.1,<2",
+    # BSD-3-Clause. Sends webhooks (`egress.py`); the lakana SDK already depends on it.
+    "httpx>=0.28,<1",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/lakana_worker"]

lakana_worker-0.12.0/src/lakana_worker/__init__.py

@@ -0,0 +1 @@
+"""Lakana's DuckDB query executor and dequeue loop."""