Bootstrap testdown as a typed Python library with uv, strict ruff, mypy, pytest, and CI/CD workflows

.github/workflows/pull_request.yaml

@@ -0,0 +1,48 @@
+name: pull_request
+
+on:
+  pull_request:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  quality:
+    name: Quality Checks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: "pyproject.toml"
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "lts/*"
+
+      - name: Prettier format check
+        run: npx prettier --check .
+
+      - name: Lint and format check
+        run: |
+          uvx ruff check .
+          uvx ruff format --check .
+
+      - name: Type check
+        run: uv run mypy testdown
+
+      - name: Run tests with coverage
+        run: uv run pytest

.github/workflows/release.yaml

@@ -0,0 +1,37 @@
+name: release
+
+on:
+  push:
+    tags:
+      - "v[0-9]+.[0-9]+.[0-9]+"
+
+jobs:
+  release:
+    name: Build and Publish
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: "pyproject.toml"
+
+      - name: Set version from tag
+        run: |
+          TAG="${GITHUB_REF_NAME}"
+          VERSION="${TAG#v}"
+          uv version "$VERSION"
+
+      - name: Build wheel and sdist
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

.gitignore

@@ -98,7 +98,7 @@ ipython_config.py
 #   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
 #   This is especially recommended for binary packages to ensure reproducibility, and is more
 #   commonly ignored for libraries.
-#uv.lock
+uv.lock
 
 # poetry
 #   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
@@ -182,9 +182,9 @@ cython_debug/
 .abstra/
 
 # Visual Studio Code
-#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
 #  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
-#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  and can be added to the global gitignore or merged into this file. However, if you prefer,
 #  you could uncomment the following to ignore the entire vscode folder
 # .vscode/
 
@@ -196,12 +196,14 @@ cython_debug/
 
 # Cursor
 #  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
-#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
-#  refer to https://docs.cursor.com/context/ignore-files
+#  exclude from AI features like autocomplete and code analysis. Recommended for
+#  sensitive data refer to https://docs.cursor.com/context/ignore-files
 .cursorignore
 .cursorindexingignore
 
 # Marimo
 marimo/_static/
 marimo/_lsp/
 __marimo__/
+.claude/
+*.local.*

.prettierignore

@@ -0,0 +1,3 @@
+.venv/
+uv.lock
+.claude/

.prettierrc

@@ -0,0 +1,12 @@
+{
+  "proseWrap": "always",
+  "overrides": [
+    {
+      "files": ["*.yaml", "*.yml"],
+      "options": {
+        "printWidth": 88,
+        "tabWidth": 2
+      }
+    }
+  ]
+}

AGENTS.md

@@ -0,0 +1,6 @@
+- Format code with `uvx ruff format`
+- Always validate changes using `uvx ruff check`
+- Test using `uv run pytest ...`
+- Project must always have 100% code coverage results.
+- Format non-python files with `npx prettier --write ...`
+- Lint non-python (md, yaml) files with `npx prettier --check`