vgi-python 0.8.0__tar.gz

vgi_python-0.8.0/.gitattributes

@@ -0,0 +1,5 @@
+
+# Use bd merge for beads JSONL files
+
+# Use bd merge for beads JSONL files
+.beads/issues.jsonl merge=beads

vgi_python-0.8.0/.github/workflows/ci.yml

@@ -0,0 +1,144 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+# Least-privilege default for all jobs — none need write access. (The release
+# workflow grants id-token: write per-job for OIDC publishing; CI needs read.)
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Python ${{ matrix.python-version }} on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.13", "3.14"]
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.2.0
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run tests
+        run: uv run pytest
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.2.0
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Check formatting
+        run: uv run ruff format --check .
+
+      - name: Check linting
+        run: uv run ruff check .
+
+      - name: Type check (mypy)
+        run: uv run mypy vgi/
+
+      # ty is pre-1.0 and its inference drifts release-to-release; keep it
+      # visible as a signal but don't gate CI on it (mypy is the blocking
+      # type gate).
+      - name: Type check (ty, non-blocking)
+        run: uv run ty check vgi/
+        continue-on-error: true
+
+  s3-offload-localstack:
+    name: S3 Offload Tests (LocalStack)
+    runs-on: ubuntu-latest
+    services:
+      localstack:
+        image: localstack/localstack:3.0
+        ports:
+          - 4566:4566
+        env:
+          SERVICES: s3
+          AWS_DEFAULT_REGION: us-east-1
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Checkout vgi-rpc
+        uses: actions/checkout@v5
+        with:
+          repository: Query-farm/vgi-rpc-python
+          path: vgi-rpc
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.2.0
+
+      - name: Set up Python 3.13
+        run: uv python install 3.13
+
+      - name: Install test dependencies
+        run: |
+          # Project env first (vgi + fixtures + dev tools), then overlay the
+          # local vgi-rpc checkout with the s3/external extras plus boto3.
+          # Subsequent uv run calls must pass --no-sync or uv re-syncs the
+          # env to the lockfile and drops the overlay.
+          uv sync --all-extras --python 3.13
+          uv pip install './vgi-rpc[http,s3,external]' boto3
+
+      - name: Create test bucket in LocalStack
+        env:
+          AWS_ACCESS_KEY_ID: test
+          AWS_SECRET_ACCESS_KEY: test
+          AWS_DEFAULT_REGION: us-east-1
+        run: |
+          uv run --no-sync python - <<'PY'
+          import time
+          import boto3
+          from botocore.exceptions import EndpointConnectionError
+
+          endpoint = "http://127.0.0.1:4566"
+          s3 = boto3.client(
+              "s3",
+              endpoint_url=endpoint,
+              aws_access_key_id="test",
+              aws_secret_access_key="test",
+              region_name="us-east-1",
+          )
+
+          for _ in range(30):
+              try:
+                  s3.list_buckets()
+                  break
+              except EndpointConnectionError:
+                  time.sleep(1)
+          else:
+              raise RuntimeError("LocalStack S3 did not become ready in time")
+
+          s3.create_bucket(Bucket="vgi-offload-test")
+          PY
+
+      - name: Run HTTP S3 offload tests
+        env:
+          AWS_ACCESS_KEY_ID: test
+          AWS_SECRET_ACCESS_KEY: test
+          AWS_DEFAULT_REGION: us-east-1
+          VGI_RUN_S3_HTTP_TESTS: "1"
+          VGI_HTTP_S3_BUCKET: vgi-offload-test
+          VGI_HTTP_S3_ENDPOINT_URL: http://127.0.0.1:4566
+          PYTHONPATH: ${{ github.workspace }}
+        run: uv run --no-sync pytest tests/test_http_s3_offload_output.py tests/test_http_s3_offload_input.py -q

vgi_python-0.8.0/.github/workflows/release.yml

@@ -0,0 +1,97 @@
+name: Release
+
+# Publishes both distributions to PyPI when a GitHub Release is published:
+#   - vgi-python     (sdist + universal wheel)        — the public package
+#   - vgi-fixtures   (universal wheel only)           — example/test workers
+#
+# vgi-fixtures is wheel-only on purpose: its source lives at the repo root in
+# vgi/_test_fixtures/, which the wheel force-includes but an sdist cannot reach
+# (see packages/vgi-fixtures/pyproject.toml). It is a pure-python py3-none-any
+# wheel, so the wheel alone installs everywhere.
+#
+# Auth is PyPI Trusted Publishing (OIDC) — no API tokens. Before the first run,
+# configure a Trusted Publisher on PyPI for BOTH projects (vgi-python,
+# vgi-fixtures) pointing at:
+#   owner:       Query-farm
+#   repository:  vgi-python
+#   workflow:    release.yml
+#   environment: pypi
+# The `vgi-python` and `vgi-fixtures` versions must match the released tag.
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.2.0
+
+      - name: Build vgi (sdist + wheel)
+        run: uv build --sdist --wheel --out-dir dist-vgi .
+
+      - name: Build vgi-fixtures (wheel only)
+        run: uv build --wheel --out-dir dist-fixtures packages/vgi-fixtures
+
+      - name: Validate metadata
+        run: uvx twine check dist-vgi/* dist-fixtures/*
+
+      - name: Upload vgi artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist-vgi
+          path: dist-vgi/
+
+      - name: Upload vgi-fixtures artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist-fixtures
+          path: dist-fixtures/
+
+  publish-vgi:
+    name: Publish vgi to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write # required for Trusted Publishing
+    steps:
+      - name: Download vgi artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist-vgi
+          path: dist/
+
+      - name: Publish vgi
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  publish-vgi-fixtures:
+    name: Publish vgi-fixtures to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    # Disabled until a Trusted Publisher exists for the `vgi-fixtures`
+    # project on PyPI (blocked on a PyPI new-project limit). The wheel is
+    # still built + metadata-checked above; only the upload is skipped, so
+    # vgi-python releases cleanly. Re-enable (delete this `if`) once the
+    # publisher is configured.
+    if: false
+    permissions:
+      id-token: write # required for Trusted Publishing
+    steps:
+      - name: Download vgi-fixtures artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist-fixtures
+          path: dist/
+
+      - name: Publish vgi-fixtures
+        uses: pypa/gh-action-pypi-publish@release/v1

vgi_python-0.8.0/.gitignore

@@ -0,0 +1,49 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Mypy reports
+mypy-reports/
+mypy-html-report/
+
+# Coverage artifacts
+.coverage
+.coverage.*
+htmlcov/
+test-data/v.parquet
+
+# IDE / editor
+.vscode/
+.idea/
+*.swp
+
+# Claude Code agent state
+.claude/
+
+# Playwright MCP
+.playwright-mcp/
+
+# beads (local tool state — see commit 9cf33e2)
+.beads/
+
+# wrangler files
+.wrangler
+.dev.vars*
+!.dev.vars.example
+.env*
+!.env.example
+
+# Cloudflare Worker scaffolding
+cloudflare/vgi-storage/node_modules/
+
+# Local scratch / experiment artifacts (not part of the package)
+/test.json
+/client-tests/
+/docs/time-travel-init-plan.md

vgi_python-0.8.0/.python-version

@@ -0,0 +1 @@
+3.14