formwork 0.1.0__tar.gz

formwork-0.1.0/.env.example

@@ -0,0 +1,15 @@
+# Copy to .env and fill in. .env is gitignored; this file is not.
+#
+# Only the live tests and the benchmark read these. The library core never
+# touches the environment — adapters take an explicit api_key, and fall back
+# to os.environ only when you let them.
+
+# https://aistudio.google.com/apikey
+GEMINI_API_KEY=
+
+# Optional. Unset falls back to DEFAULT_MODEL in formwork/providers/gemini.py.
+GEMINI_MODEL=gemini-2.5-flash
+
+# Optional. 0 disables Gemini's thinking tokens, which keeps token accounting
+# comparable across benchmark arms. Leave unset to use the model default.
+GEMINI_THINKING_BUDGET=0

formwork-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,46 @@
+name: ci
+
+# Triggered only by push and pull_request, and nothing in this workflow
+# interpolates event data (titles, branch names, commit messages) into a shell.
+# The only expression used is the static matrix value below.
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+# Least privilege: the jobs only need to read the checkout.
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Lint
+        run: ruff check src tests examples bench scripts
+
+      - name: Types
+        run: mypy
+
+      - name: Tests
+        run: pytest -q
+
+      - name: Example runs
+        run: python examples/workout.py > /dev/null

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

@@ -0,0 +1,60 @@
+name: release
+
+# Publishes to PyPI when a version tag is pushed.
+#
+# Authentication is Trusted Publishing (OIDC): PyPI is configured to accept
+# releases from this repository and workflow, so no API token is stored
+# anywhere. The publish job is the only place that gets id-token: write.
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build
+        run: |
+          python -m pip install --upgrade pip build twine
+          python -m build
+          python -m twine check dist/*
+
+      # The tag is the release's only input, and nothing else checks that it
+      # agrees with the package. Tagging v0.2.0 while __init__.py still says
+      # 0.1.0 would otherwise publish 0.1.0 under a 0.2.0 tag, once, forever.
+      # The tag reaches the shell through the environment, never interpolated.
+      - name: Tag must match the package version
+        env:
+          TAG: ${{ github.ref_name }}
+        run: |
+          BUILT=$(ls dist/*.tar.gz | sed -E 's|.*/formwork-(.*)\.tar\.gz|\1|')
+          echo "tag=${TAG#v}  built=$BUILT"
+          test "${TAG#v}" = "$BUILT"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

formwork-0.1.0/.gitignore

@@ -0,0 +1,40 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Environments
+.venv/
+venv/
+env/
+
+# Tooling caches
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+
+# Editors / OS
+.vscode/
+.idea/
+.DS_Store
+Thumbs.db
+
+# Secrets
+.env
+.env.*
+!.env.example
+
+# Benchmark output is a local artifact by default. Published runs — the ones the
+# README quotes — are committed explicitly so the numbers can be re-scored.
+bench/results/*
+!bench/results/pilot-*.jsonl
+
+# Local notes for coding assistants
+CLAUDE.md
+AGENTS.md
+.claude/

formwork-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ekber Gulpinar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.