openstatspec 0.6.0__tar.gz → 0.7.1__tar.gz

{openstatspec-0.6.0 → openstatspec-0.7.1}/.github/workflows/ci.yml

@@ -20,7 +20,7 @@ jobs:
         uses: actions/checkout@v7
         with: &specification-checkout
           repository: OpenStatSpec/specification
-          ref: f2fdf687d8cb32b944ca55a3e9e7215ffc603019
+          ref: cd8f198c68b849eb8ed018a894670a0904c2181d
           path: openstatspec-specification
       - name: Checkout required SPSS engine
         uses: actions/checkout@v7

openstatspec-0.7.1/.github/workflows/release.yml

@@ -0,0 +1,204 @@
+name: Release
+
+env:
+  OPENSTATSPEC_SPECIFICATION_DIR: ${{ github.workspace }}/openstatspec-specification
+  OPENSTATSPEC_SPECIFICATION_PACKAGE_DIR: ${{ github.workspace }}/openstatspec-specification-package
+  OPENSTATSPEC_SPECIFICATION_PACKAGE_REF: 2778b784afcb63868ce3c3235a5f1fa190100f9d
+  OPENSTATSPEC_SPECIFICATION_PACKAGE_VERSION: 0.1.0
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      release_ref:
+        description: "Existing release tag to rebuild and publish idempotently"
+        required: true
+        type: string
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          ref: refs/tags/${{ inputs.release_ref || github.ref_name }}
+          fetch-depth: 0
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.13"
+      - name: Verify release tag exists and targets this package version
+        env:
+          RELEASE_TAG: ${{ inputs.release_ref || github.ref_name }}
+        run: |
+          set -eu
+          git fetch --force --no-tags origin "refs/tags/${RELEASE_TAG}:refs/tags/${RELEASE_TAG}"
+          python .github/verify_release_ref.py
+      - run: python -m pip install --upgrade pip build twine pytest
+      - name: Verify required SPSS engine is publicly installable
+        run: >-
+          python -m pip download --only-binary=:all: --no-deps
+          --dest /tmp/openstatspec-engine-release
+          openstatspec-pyspssio==0.5.1.post2
+      - name: Checkout normative specification fixtures
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          repository: OpenStatSpec/specification
+          ref: cd8f198c68b849eb8ed018a894670a0904c2181d
+          path: openstatspec-specification
+      - name: Checkout specification package source
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          repository: OpenStatSpec/specification
+          ref: ${{ env.OPENSTATSPEC_SPECIFICATION_PACKAGE_REF }}
+          path: openstatspec-specification-package
+      - name: Verify specification package source
+        env:
+          SPECIFICATION_PACKAGE_DIR: ${{ env.OPENSTATSPEC_SPECIFICATION_PACKAGE_DIR }}
+          SPECIFICATION_PACKAGE_REF: ${{ env.OPENSTATSPEC_SPECIFICATION_PACKAGE_REF }}
+          SPECIFICATION_PACKAGE_VERSION: ${{ env.OPENSTATSPEC_SPECIFICATION_PACKAGE_VERSION }}
+        run: |
+          python - <<'PY'
+          import os
+          import subprocess
+          import tomllib
+          from pathlib import Path
+
+          source = Path(os.environ["SPECIFICATION_PACKAGE_DIR"])
+          expected_ref = os.environ["SPECIFICATION_PACKAGE_REF"]
+          actual_ref = subprocess.check_output(
+              ["git", "rev-parse", "HEAD"], cwd=source, text=True,
+          ).strip()
+          if actual_ref != expected_ref:
+              raise SystemExit(
+                  f"specification package ref {actual_ref!r} does not match "
+                  f"expected {expected_ref!r}"
+              )
+          project = tomllib.loads(
+              (source / "pyproject.toml").read_text(encoding="utf-8")
+          )["project"]
+          if project["name"] != "openstatspec-specification":
+              raise SystemExit("unexpected specification package name")
+          expected_version = os.environ["SPECIFICATION_PACKAGE_VERSION"]
+          if project["version"] != expected_version:
+              raise SystemExit(
+                  f"specification package version {project['version']!r} does "
+                  f"not match expected {expected_version!r}"
+              )
+          for required in (
+              "pyproject.toml",
+              "src/openstatspec_specification/dolt.py",
+              "sql/dolt-adapter-declaration-schema.json",
+          ):
+              if not (source / required).is_file():
+                  raise SystemExit(f"missing specification package resource: {required}")
+          PY
+      - name: Verify specification package tests and repository
+        run: |
+          python -m pip install -e "$OPENSTATSPEC_SPECIFICATION_PACKAGE_DIR"
+          python -m pytest -q "$OPENSTATSPEC_SPECIFICATION_PACKAGE_DIR/tests/test_dolt_declarations.py"
+          python "$OPENSTATSPEC_SPECIFICATION_PACKAGE_DIR/tools/validate_repository.py"
+      - name: Build clean release distributions
+        run: |
+          rm -rf dist /tmp/openstatspec-release-dists
+          mkdir -p dist/openstatspec dist/openstatspec-specification \
+            /tmp/openstatspec-release-dists/openstatspec \
+            /tmp/openstatspec-release-dists/specification
+          python -m build --outdir /tmp/openstatspec-release-dists/openstatspec .
+          python -m build --outdir /tmp/openstatspec-release-dists/specification "$OPENSTATSPEC_SPECIFICATION_PACKAGE_DIR"
+          python -m twine check \
+            /tmp/openstatspec-release-dists/openstatspec/* \
+            /tmp/openstatspec-release-dists/specification/*
+          python - <<'PY'
+          from pathlib import Path
+          from shutil import copy2
+
+          sources = {
+              "openstatspec": (
+                  Path("/tmp/openstatspec-release-dists/openstatspec"),
+                  Path("dist/openstatspec"),
+              ),
+              "openstatspec_specification": (
+                  Path("/tmp/openstatspec-release-dists/specification"),
+                  Path("dist/openstatspec-specification"),
+              ),
+          }
+          copied = []
+          for normalized_name, (source, destination_dir) in sources.items():
+              destination_dir.mkdir(parents=True, exist_ok=True)
+              files = sorted(path for path in source.iterdir() if path.is_file())
+              if len(files) != 2 or {path.suffix for path in files} != {".whl", ".gz"}:
+                  raise SystemExit(
+                      f"expected one wheel and one sdist for {normalized_name}, got "
+                      f"{[path.name for path in files]}"
+                  )
+              for path in files:
+                  normalized_artifact = path.name.replace("-", "_").lower()
+                  if not normalized_artifact.startswith(normalized_name + "_"):
+                      raise SystemExit(
+                          f"unexpected artifact name for {normalized_name}: {path.name}"
+                      )
+                  destination = destination_dir / path.name
+                  copy2(path, destination)
+                  copied.append(destination)
+          if len(copied) != 4:
+              raise SystemExit(f"expected four release artifacts, got {len(copied)}")
+          print("release artifacts:", ", ".join(path.name for path in copied))
+          PY
+      - name: Checkout required SPSS engine
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          repository: TonisOrmisson/pyspssio
+          ref: e069adf33c70bcd9e8e6ee495106479463a84fa2
+          path: openstatspec-pyspssio
+      - run: python -m pip install ./openstatspec-pyspssio
+      - run: python -m pip install -e ".[dev]"
+      - run: python -m pytest -m "not services"
+      - run: python -m venv /tmp/openstatspec-release-smoke
+      - run: /tmp/openstatspec-release-smoke/bin/python -m pip install ./openstatspec-pyspssio
+      - run: /tmp/openstatspec-release-smoke/bin/python -m pip install dist/openstatspec/openstatspec-*.whl
+      - run: /tmp/openstatspec-release-smoke/bin/openstatspec capabilities
+      - name: Smoke-test specification wheel
+        run: |
+          python -m venv /tmp/openstatspec-specification-release-smoke
+          /tmp/openstatspec-specification-release-smoke/bin/python -m pip install dist/openstatspec-specification/openstatspec_specification-*.whl
+          /tmp/openstatspec-specification-release-smoke/bin/python - <<'PY'
+          from openstatspec_specification import DoltDeclarationSource
+
+          source = DoltDeclarationSource.packaged()
+          schema = source.read_json("sql/dolt-adapter-declaration-schema.json")
+          if schema.get("schema_id") != "openstatspec-dolt-adapter-declaration-v1":
+              raise SystemExit("packaged specification schema has the wrong identifier")
+          PY
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: python-distributions
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/openstatspec
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: python-distributions
+          path: dist/
+      - name: Publish openstatspec to PyPI
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
+        with:
+          packages-dir: dist/openstatspec/
+          skip-existing: true
+      - name: Publish openstatspec-specification to PyPI
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
+        with:
+          packages-dir: dist/openstatspec-specification/
+          skip-existing: true

{openstatspec-0.6.0 → openstatspec-0.7.1}/CHANGELOG.md

@@ -6,6 +6,24 @@ All notable changes to this reference implementation are documented here.
 
 _No unreleased changes._
 
+## 0.7.1 - 2026-08-12
+
+### Changed
+
+- Pinned capability declarations, conformance fixtures, and release validation
+  to the published OpenStatSpec specification `v0.3.0` at exact commit
+  `cd8f198c68b849eb8ed018a894670a0904c2181d`.
+
+## 0.7.0 - 2026-08-11
+
+### Added
+
+- Added root release workflow support for publishing the normative
+  `openstatspec-specification` companion distribution, with independent
+  artifact validation, smoke tests, and PyPI publishing.
+- Carried the complete 0.6.0 transformation, PostgreSQL, and documentation
+  work forward into the versioned 0.7.0 release from `main`.
+
 ## 0.6.0 - 2026-08-05
 
 ### Added

{openstatspec-0.6.0 → openstatspec-0.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: openstatspec
-Version: 0.6.0
+Version: 0.7.1
 Summary: Reference adapter for the OpenStatSpec relational contract
 Author: OpenStatSpec
 License: Apache-2.0
@@ -87,6 +87,7 @@ implemented capability boundary.
 ## SPSS-like transformation frontend
 
 The bounded SPSS-like frontend lowers `RECODE`, sequential `COMPUTE` and `IF`,
+`STRING` declarations, and `DELETE VARIABLES`,
 `VARIABLE LABELS`, `VALUE LABELS`, numeric `FORMATS`, `VARIABLE LEVEL`, and
 `EXECUTE` into a language-neutral typed canonical plan. Conditions support
 parentheses, variable and numeric literal operands, comparisons, `AND`, and

{openstatspec-0.6.0 → openstatspec-0.7.1}/README.md

@@ -68,6 +68,7 @@ implemented capability boundary.
 ## SPSS-like transformation frontend
 
 The bounded SPSS-like frontend lowers `RECODE`, sequential `COMPUTE` and `IF`,
+`STRING` declarations, and `DELETE VARIABLES`,
 `VARIABLE LABELS`, `VALUE LABELS`, numeric `FORMATS`, `VARIABLE LEVEL`, and
 `EXECUTE` into a language-neutral typed canonical plan. Conditions support
 parentheses, variable and numeric literal operands, comparisons, `AND`, and

{openstatspec-0.6.0 → openstatspec-0.7.1}/docs/release-readiness.md

@@ -1,4 +1,4 @@
-# 0.5.0 release readiness
+# 0.7.1 release readiness
 
 This page records the expected release contract, not a publication event.
 Creating a version tag remains a separate maintainer action.
@@ -69,6 +69,8 @@ The gate must prove that:
   plan hash and in-place result;
 - the exact bounded `COMPUTE`/`IF` program compiles to all seven ordered
   operations without dropping `FORMATS`, `VARIABLE LEVEL`, or `EXECUTE`;
+- bounded `STRING` declarations and `DELETE VARIABLES` operations preserve
+  the resulting schema and physical-column identity on supported profiles;
 - boolean data results match the equivalent expression and the target's label,
   0/1 value labels, `F1.0` print/write format, and nominal level exist in the
   normative catalog;
@@ -112,12 +114,10 @@ capability claim, or implied support.
 4. Build with `python -m build` and install the generated wheel in a clean
    environment.
 5. Confirm `openstatspec capabilities` reflects the intended support boundary.
-6. Confirm CI, release fixtures, and capabilities use the untagged OpenStatSpec
-   specification release candidate at exact commit
-   `f2fdf687d8cb32b944ca55a3e9e7215ffc603019`, publish
-   `specification_status=release_candidate`, and leave
-   `specification_release` null. If that exact commit receives a stable tag
-   before this package is tagged, update the identity and re-run every gate.
+6. Confirm CI, release fixtures, and capabilities use the published OpenStatSpec
+   specification `v0.3.0` at exact commit
+   `cd8f198c68b849eb8ed018a894670a0904c2181d`, publish
+   `specification_status=stable`, and set `specification_release` to `v0.3.0`.
 7. Review this document, the README, and CHANGELOG for accurate scope.
 
 The tag-triggered release workflow repeats the non-service test suite, builds

openstatspec-0.7.1/docs/superpowers/plans/2026-08-12-python-v071-stable-pin.md

@@ -0,0 +1,158 @@
+# Python 0.7.1 Stable Specification Pin Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Release Python adapter `0.7.1` with stable, exact provenance for specification `v0.3.0`.
+
+**Architecture:** Keep the provenance values centralized in `src/openstatspec/sql/capabilities.py`; tests and capability declarations consume those values. CI and release-readiness documentation pin the same immutable specification commit, while the package version changes only in packaging metadata.
+
+**Tech Stack:** Python 3.11–3.14, pytest, GitHub Actions, `python -m build`, Twine, PyPI Trusted Publishing.
+
+## Global Constraints
+
+- Specification commit: `cd8f198c68b849eb8ed018a894670a0904c2181d`.
+- Specification status: `stable`.
+- Specification release: `v0.3.0`.
+- Package version: `0.7.1`.
+- Keep the SPSS engine pin, companion package pin, SQL profile matrix, and runtime behavior unchanged.
+- Do not publish or change the normative specification package in this task.
+
+---
+
+### Task 1: Update provenance contract tests first
+
+**Files:**
+- Modify: `tests/test_cli.py:44-48`
+- Modify: `tests/test_sql_profiles.py:32-40`
+
+**Interfaces:**
+- Consumes: public `openstatspec.capability_matrix()` and SQL profile declarations.
+- Produces: executable expectations for stable `v0.3.0` provenance.
+
+- [ ] **Step 1: Change the assertions to the stable identity**
+
+Replace the candidate expectations with:
+
+```python
+assert matrix["specification_status"] == "stable"
+assert matrix["specification_release"] == "v0.3.0"
+assert matrix["specification_commit"] == "cd8f198c68b849eb8ed018a894670a0904c2181d"
+```
+
+Apply the same three values to each profile declaration assertion.
+
+- [ ] **Step 2: Run the focused tests and confirm the expected red state**
+
+Run:
+
+```bash
+python -m pytest -q tests/test_cli.py::test_capability_matrix_is_public_and_cli_matches_engine_boundary tests/test_sql_profiles.py::test_profile_declarations_publish_stable_specification_provenance
+```
+
+Expected: both tests fail because production constants still expose the old release-candidate identity.
+
+- [ ] **Step 3: Commit the failing-test update**
+
+```bash
+git add tests/test_cli.py tests/test_sql_profiles.py
+git commit -m "test: expect stable specification v0.3.0"
+```
+
+### Task 2: Bind production provenance and release metadata
+
+**Files:**
+- Modify: `src/openstatspec/sql/capabilities.py:20-23`
+- Modify: `pyproject.toml:7`
+- Modify: `.github/workflows/ci.yml:23`
+- Modify: `.github/workflows/release.yml:51`
+- Modify: `docs/release-readiness.md:1,116-123`
+- Modify: `CHANGELOG.md` after the `Unreleased` section
+
+**Interfaces:**
+- Consumes: the exact specification commit from the published `v0.3.0` tag.
+- Produces: capability output and release automation identifying `stable`, `v0.3.0`, and `cd8f198c...`.
+
+- [ ] **Step 1: Update the centralized capability constants**
+
+Set the declarations to:
+
+```python
+SPECIFICATION_COMMIT = "cd8f198c68b849eb8ed018a894670a0904c2181d"
+SPECIFICATION_STATUS = "stable"
+SPECIFICATION_RELEASE: str | None = "v0.3.0"
+```
+
+- [ ] **Step 2: Bump the package and CI fixture pin**
+
+Set `project.version` in `pyproject.toml` to `0.7.1`. Replace the old specification checkout ref in both workflows with the exact commit `cd8f198c68b849eb8ed018a894670a0904c2181d`; leave the companion package ref unchanged.
+
+- [ ] **Step 3: Update release documentation and changelog**
+
+Rename the readiness heading to `0.7.1 release readiness`, change its specification checklist to the stable commit/release identity, and add a dated `0.7.1` entry explaining that the adapter now pins published specification `v0.3.0`.
+
+- [ ] **Step 4: Run focused tests and confirm green**
+
+Run the focused command from Task 1. Expected: both tests pass.
+
+- [ ] **Step 5: Commit the implementation and metadata**
+
+```bash
+git add src/openstatspec/sql/capabilities.py pyproject.toml .github/workflows/ci.yml .github/workflows/release.yml docs/release-readiness.md CHANGELOG.md
+git commit -m "release: pin Python adapter to specification v0.3.0"
+```
+
+### Task 3: Verify the complete Python release candidate
+
+**Files:**
+- Verify: all tracked files in the Python repository.
+
+- [ ] **Step 1: Check the diff and stale current references**
+
+Run:
+
+```bash
+git diff --check
+rg -n 'f2fdf687d8cb32b944ca55a3e9e7215ffc603019|specification_status.*release_candidate|specification_release.*None|version = "0\.7\.0"' src tests .github docs pyproject.toml
+```
+
+Expected: no stale current references; historical changelog entries may retain their original release evidence.
+
+- [ ] **Step 2: Run the non-service test suite**
+
+```bash
+python -m pytest -m "not services"
+```
+
+Expected: zero failures.
+
+- [ ] **Step 3: Build and smoke-test the package**
+
+```bash
+rm -rf /tmp/openstatspec-v071-dist /tmp/openstatspec-v071-smoke
+python -m build --outdir /tmp/openstatspec-v071-dist
+python -m twine check /tmp/openstatspec-v071-dist/*
+python -m venv /tmp/openstatspec-v071-smoke
+/tmp/openstatspec-v071-smoke/bin/python -m pip install ./openstatspec-pyspssio
+/tmp/openstatspec-v071-smoke/bin/python -m pip install /tmp/openstatspec-v071-dist/openstatspec-0.7.1-*.whl
+/tmp/openstatspec-v071-smoke/bin/openstatspec capabilities
+```
+
+Expected: build and Twine checks pass, and capabilities reports `stable`, `v0.3.0`, and the exact commit.
+
+### Task 4: Review, publish, and release
+
+- [ ] **Step 1: Run the local review loop and fix every actionable finding**
+
+Review the complete branch diff against `origin/main`; repeat the tests after each fix until no actionable findings remain.
+
+- [ ] **Step 2: Push the branch and open a draft PR**
+
+Push `agent/stable-spec-v071` to `OpenStatSpec/python`, open a PR targeting `main`, mark it ready for review, and add `@codex review`.
+
+- [ ] **Step 3: Iterate on GitHub review and CI**
+
+Inspect every Codex review finding and failing check, fix actionable issues locally, push, and repeat until the review and required checks are clean.
+
+- [ ] **Step 4: After merge, create and push annotated tag `v0.7.1`**
+
+Verify the tag targets the merge commit and wait for tag-context CI to pass before relying on the existing PyPI workflow.

openstatspec-0.7.1/docs/superpowers/specs/2026-08-12-python-stable-specification-pin-design.md

@@ -0,0 +1,35 @@
+# Python 0.7.1 stable specification pin
+
+## Goal
+
+Publish the Python adapter's first patch release after Python adapter `v0.7.0`
+with its capability declarations and conformance fixtures bound to the
+published OpenStatSpec specification `v0.3.0`.
+
+## Scope
+
+- Bump the Python distribution from `0.7.0` to `0.7.1`.
+- Replace the release-candidate specification identity with:
+  - commit `cd8f198c68b849eb8ed018a894670a0904c2181d`;
+  - status `stable`;
+  - release `v0.3.0`.
+- Update unit expectations, CI fixture checkouts, release-readiness guidance,
+  and the changelog so every release surface carries the same identity.
+- Keep the required SPSS engine pin, specification companion package pin,
+  database version matrix, and runtime behavior unchanged.
+- Separately update the specification repository roadmap to mark the completed
+  `v0.3.0` release gates and current public release.
+
+## Release and verification
+
+The Python change is reviewed through a pull request. Before tagging `v0.7.1`,
+run the non-service suite, package build and wheel smoke test, and the full
+GitHub CI matrix. The annotated `v0.7.1` tag must target the merged release
+commit; its tag-context workflow must pass before the existing trusted-PyPI
+workflow publishes the package artifacts.
+
+## Non-goals
+
+This work does not add transformation behavior, change SQL dialect support,
+modify the normative specification, or publish a new specification package
+version.

{openstatspec-0.6.0 → openstatspec-0.7.1}/docs/transformations.md

@@ -4,9 +4,10 @@ OpenStatSpec separates transformation syntax, canonical meaning, and database
 mutation. This lets multiple language frontends produce the same plan without
 coupling the executor to any one language.
 
-The implemented bounded SPSS-like frontend accepts `RECODE`, sequential
-`COMPUTE` and `IF`, `VARIABLE LABELS`, `VALUE LABELS`, numeric `FORMATS`,
-`VARIABLE LEVEL`, and `EXECUTE`. Predicates support typed variable/literal
+The implemented bounded SPSS-like frontend accepts bounded `STRING`
+declarations, `RECODE`, sequential `COMPUTE` and `IF`, `DELETE VARIABLES`,
+`VARIABLE LABELS`, `VALUE LABELS`, numeric `FORMATS`, `VARIABLE LEVEL`, and
+`EXECUTE`. Predicates support typed variable/literal
 operands, parentheses, numeric comparisons, `AND`, and `OR`. String comparison
 and v0.2 string assignment fail closed until exact profile-independent
 collation and explicit-width semantics are available; arbitrary SPSS, Python,

openstatspec-0.7.1/openstatspec-specification/.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  specification:
+    runs-on: ubuntu-latest
+    steps:
+      # v7.0.1: https://github.com/actions/checkout/commit/3d3c42e5aac5ba805825da76410c181273ba90b1
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+        with:
+          persist-credentials: false
+      # v7.0.0: https://github.com/actions/setup-python/commit/5fda3b95a4ea91299a34e894583c3862153e4b97
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97
+        with:
+          python-version: "3.13"
+      - run: python tools/validate_repository.py

openstatspec-0.7.1/openstatspec-specification/.github/workflows/release.yml

@@ -0,0 +1,108 @@
+name: Publish Python specification package
+
+on:
+  push:
+    tags:
+      - "package-v*"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build and verify distribution
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Set up Python
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.13"
+
+      - name: Build distribution
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build twine pytest
+          python -m pip install -e .
+          python -m pytest -q tests/test_dolt_declarations.py
+          python tools/validate_repository.py
+          python -m build
+
+      - name: Verify distribution metadata
+        run: python -m twine check dist/*
+
+      - name: Verify release tag version
+        if: startsWith(github.ref, 'refs/tags/package-v')
+        env:
+          RELEASE_TAG: ${{ github.ref_name }}
+        run: |
+          python - <<'PY'
+          import os
+          import tomllib
+          from pathlib import Path
+
+          project = tomllib.loads(Path("pyproject.toml").read_text())
+          version = project["project"]["version"]
+          tag = os.environ["RELEASE_TAG"]
+          if tag != f"package-v{version}":
+              raise SystemExit(
+                  f"release tag {tag!r} does not match project version package-v{version}"
+              )
+          PY
+
+      - name: Store distribution artifacts
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: python-package-distributions
+          path: dist/
+          if-no-files-found: error
+
+  publish-testpypi:
+    name: Publish to TestPyPI
+    if: github.event_name == 'workflow_dispatch'
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/openstatspec-specification
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download distribution artifacts
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish distribution to TestPyPI
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  publish-pypi:
+    name: Publish to PyPI
+    if: startsWith(github.ref, 'refs/tags/package-v')
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/openstatspec-specification
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download distribution artifacts
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish distribution to PyPI
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2

openstatspec-0.7.1/openstatspec-specification/.gitignore

@@ -0,0 +1,5 @@
+__pycache__/
+*.py[cod]
+dist/
+build/
+*.egg-info/