cantrip 0.1.0__tar.gz

cantrip-0.1.0/.coveragerc

@@ -0,0 +1,37 @@
+# .coveragerc to control coverage.py
+[run]
+branch = True
+source = cantrip
+# omit = bad_file.py
+
+[paths]
+source =
+    src/
+    */site-packages/
+
+[report]
+# Regexes for lines to exclude from consideration
+exclude_lines =
+    # Have to re-enable the standard pragma
+    pragma: no cover
+
+    # Don't complain about missing debug-only code:
+    def __repr__
+    if self\.debug
+
+    # Don't complain if tests don't hit defensive assertion code:
+    raise AssertionError
+    raise NotImplementedError
+
+    # Don't complain if non-runnable code isn't run:
+    if 0:
+    if __name__ == "__main__":
+
+    # Ignore importlib backport
+    from importlib
+
+    # Protocol
+    \.\.\.
+
+fail_under = 100
+show_missing = True

cantrip-0.1.0/.github/workflows/integration.yml

@@ -0,0 +1,113 @@
+# Integration tests — requires secrets, so only runs on pushes to main
+# or PRs from the same repo (never from forks).
+
+name: Integration
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  postgres:
+    name: PostgreSQL + PostGIS
+    runs-on: ubuntu-latest
+    if: >-
+      github.event_name == 'push'
+      || github.event.pull_request.head.repo.full_name == github.repository
+
+    services:
+      postgres:
+        image: imresamu/postgis:16-3.4
+        env:
+          POSTGRES_PASSWORD: test
+          POSTGRES_DB: cantrip_test
+        ports:
+          - 5433:5432
+        options: >-
+          --health-cmd "pg_isready -U postgres"
+          --health-interval 2s
+          --health-timeout 5s
+          --health-retries 10
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: >-
+          uv run --extra postgres pytest -vv
+          --with-integration --with-slow-integration
+          tests/implementations/postgres_integration_test.py
+          tests/implementations/postgres_spatial_integration_test.py
+        env:
+          CANTRIP_POSTGRES_URL: postgresql+psycopg2://postgres:test@localhost:5433/cantrip_test
+
+  duckdb:
+    name: DuckDB
+    runs-on: ubuntu-latest
+    if: >-
+      github.event_name == 'push'
+      || github.event.pull_request.head.repo.full_name == github.repository
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: >-
+          uv run --extra duckdb pytest -vv
+          --with-integration --with-slow-integration
+          tests/implementations/duckdb_integration_test.py
+          tests/implementations/duckdb_spatial_integration_test.py
+
+  sqlite:
+    name: SQLite + SpatiaLite
+    runs-on: ubuntu-latest
+    if: >-
+      github.event_name == 'push'
+      || github.event.pull_request.head.repo.full_name == github.repository
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: sudo apt-get update && sudo apt-get install -y libsqlite3-mod-spatialite
+      - run: >-
+          uv run pytest -vv
+          --with-integration --with-slow-integration
+          tests/implementations/sqlite_spatial_integration_test.py
+          tests/implementations/partition_integration_test.py
+
+  bigquery:
+    name: BigQuery
+    runs-on: ubuntu-latest
+    if: >-
+      github.event_name == 'push'
+      || github.event.pull_request.head.repo.full_name == github.repository
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - uses: google-github-actions/auth@v2
+        with:
+          credentials_json: ${{ secrets.GCP_SA_KEY }}
+      - run: >-
+          uv run --extra bigquery pytest -vv
+          --with-integration --with-slow-integration
+          tests/implementations/bigquery_integration_test.py
+          tests/implementations/bigquery_spatial_integration_test.py
+
+  snowflake:
+    name: Snowflake
+    runs-on: ubuntu-latest
+    if: >-
+      github.event_name == 'push'
+      || github.event.pull_request.head.repo.full_name == github.repository
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: >-
+          uv run --extra snowflake pytest -vv
+          --with-integration --with-slow-integration
+          tests/implementations/snowflake_integration_test.py
+          tests/implementations/snowflake_spatial_integration_test.py
+        env:
+          CANTRIP_SNOWFLAKE_URL: ${{ secrets.SNOWFLAKE_URL }}

cantrip-0.1.0/.github/workflows/pr.yml

@@ -0,0 +1,29 @@
+# Pre-commit checks and unit tests — runs on every PR (including forks).
+# No secrets required.
+
+name: PR
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+  check:
+    name: Pre-commit
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - uses: pre-commit/action@v3.0.1
+
+  test:
+    name: Unit tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv run --extra duckdb pytest -vv --cov=src/cantrip --integration-cover tests/

cantrip-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,46 @@
+# Build and publish a release when a v* tag is pushed.
+#
+# Usage:
+#   git tag v0.1.0
+#   git push origin v0.1.0
+#
+# Or trigger manually from the Actions tab.
+
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Tag to release (e.g. v0.1.0)"
+        required: true
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write  # required for trusted PyPI publishing
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.tag || github.ref }}
+
+      - uses: astral-sh/setup-uv@v4
+
+      - name: Build package
+        run: uv build
+
+      - name: Create GitHub release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ inputs.tag || github.ref_name }}
+          files: dist/*
+          generate_release_notes: true
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

cantrip-0.1.0/.gitignore

@@ -0,0 +1,5 @@
+__pycache__
+.coverage
+.python-version
+*.db
+.env

cantrip-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,44 @@
+repos:
+  # Linting & formatting with Ruff (includes import sorting via I001)
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  rev: v0.6.9
+  hooks:
+    - id: ruff
+      args: [--fix]
+
+  # Black for code formatting
+- repo: https://github.com/psf/black
+  rev: 23.9.1
+  hooks:
+    - id: black
+      args: [--quiet]
+
+  # Enforce type checking
+- repo: https://github.com/pre-commit/mirrors-mypy
+  rev: v1.11.2
+  hooks:
+    - id: mypy
+      additional_dependencies:
+        - types-requests
+        - types-python-dateutil
+        - types-PyYAML
+        - types-tabulate
+
+  # Upgrade syntax to modern Python
+- repo: https://github.com/asottile/pyupgrade
+  rev: v3.17.0
+  hooks:
+    - id: pyupgrade
+      args: [--py39-plus]
+
+  # Trim trailing whitespace, fix line endings, ensure final newline, and validate data files
+- repo: https://github.com/pre-commit/pre-commit-hooks
+  rev: v5.0.0
+  hooks:
+    - id: end-of-file-fixer
+    - id: trailing-whitespace
+    - id: mixed-line-ending
+      args: [--fix=auto]
+    - id: check-json
+    - id: check-xml
+    - id: check-yaml

cantrip-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,30 @@
+# Contributing to Cantrip
+
+Thank you for your interest in contributing! This document explains how to get involved and what to expect.
+
+## Contributor License Agreement (CLA)
+
+To protect both you and the project, I ask all contributors to sign a Contributor License Agreement before I can merge your work. The CLA lets you keep the copyright to your contribution while granting me the rights needed to distribute and, if necessary, relicense the project.
+
+**Individual contributors:** When you open your first pull request, a bot will automatically prompt you to sign the CLA. It takes about a minute — you'll review the agreement and confirm via GitHub.
+
+**Corporate contributors (contributing on behalf of your employer):** Please email me at contact@robida.net before opening a pull request so we can arrange signing the Entity CLA. Your employer retains rights to their contributions; I just need the appropriate agreement in place first.
+
+## My Licensing Commitment
+
+Cantrip is currently licensed under AGPL-3.0. I may relicense it in the future — for example, to MIT or Apache 2.0 — but I commit to the following:
+
+> **If I ever relicense Cantrip, it will only become more permissive, never less. I will never take this project fully closed-source.**
+
+The CLA's broad outbound license grant exists to give me that flexibility. I appreciate the trust contributors place in me by signing it.
+
+## How to Contribute
+
+1. Fork the repository and create a branch for your change.
+2. Make your changes, with clear commit messages.
+3. Open a pull request. The CLA bot will guide you through signing if you haven't already.
+4. I'll review your PR and get back to you.
+
+## Questions?
+
+Feel free to open an issue or reach out at contact@robida.net.