Calm Calatheas

calm-calatheas/.devcontainer/devcontainer.json

@@ -0,0 +1,93 @@
+{
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "bierner.markdown-mermaid",
+                "charliermarsh.ruff",
+                "DavidAnson.vscode-markdownlint",
+                "esbenp.prettier-vscode",
+                "GitHub.vscode-pull-request-github",
+                "tamasfe.even-better-toml",
+                "-ms-python.autopep8"
+            ],
+            "settings": {
+                "[json]": {
+                    "editor.defaultFormatter": "esbenp.prettier-vscode"
+                },
+                "[markdown]": {
+                    "editor.defaultFormatter": "esbenp.prettier-vscode"
+                },
+                "[python]": {
+                    "editor.defaultFormatter": "charliermarsh.ruff"
+                },
+                "[toml]": {
+                    "editor.defaultFormatter": "esbenp.prettier-vscode"
+                },
+                "[yaml]": {
+                    "editor.defaultFormatter": "esbenp.prettier-vscode"
+                },
+                "editor.formatOnSave": true,
+                "editor.formatOnSaveMode": "file",
+                "files.exclude": {
+                    "**/.pytest_cache": true,
+                    "**/.ruff_cache": true,
+                    "**/__pycache__": true,
+                    ".venv": true,
+                    "node_modules": true,
+                    "site": true
+                },
+                "files.insertFinalNewline": true,
+                "files.watcherExclude": {
+                    "**/.pytest_cache": true,
+                    "**/.ruff_cache": true,
+                    "**/__pycache__": true,
+                    "**/dist": true,
+                    ".git/objects/**": true,
+                    ".git/subtree-cache/**": true,
+                    ".venv": true,
+                    "node_modules": true,
+                    "site": true
+                },
+                "python.analysis.typeCheckingMode": "standard",
+                "python.defaultInterpreterPath": "${containerWorkspaceFolder}/.venv/bin/python",
+                "python.testing.pytestEnabled": true,
+                "python.testing.unittestEnabled": false
+            }
+        }
+    },
+    "features": {
+        "ghcr.io/devcontainers-extra/features/apt-packages": {
+            "packages": ["gnupg2", "graphviz"]
+        },
+        "ghcr.io/devcontainers/features/docker-in-docker:2": {},
+        "ghcr.io/devcontainers/features/node:1": {
+            "version": "lts"
+        },
+        "ghcr.io/devcontainers/features/python:1": {
+            "toolsToInstall": ["uv"],
+            "version": "3.13"
+        }
+    },
+    "forwardPorts": [8000, 9000],
+    "image": "mcr.microsoft.com/devcontainers/base:noble",
+    "name": "Calm Calatheas 🪴",
+    "onCreateCommand": {
+        "npm": "bash .devcontainer/npm.sh",
+        "uv": "bash .devcontainer/uv.sh"
+    },
+    "portsAttributes": {
+        "8000": {
+            "label": "Development Server",
+            "onAutoForward": "notify"
+        },
+        "9000": {
+            "label": "Documentation Server",
+            "onAutoForward": "notify"
+        }
+    },
+    "postCreateCommand": {
+        "playwright": "bash .devcontainer/playwright.sh",
+        "pre-commit": "bash .devcontainer/pre-commit.sh"
+    },
+    "runArgs": ["--gpus", "all"]
+}

calm-calatheas/.devcontainer/npm.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+
+# Install or update dependencies
+npm install

calm-calatheas/.devcontainer/playwright.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+
+# Install playwright dependencies
+uv run playwright install --with-deps

calm-calatheas/.devcontainer/pre-commit.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+
+# Mark the current directory as safe for Git operations
+git config --global --add safe.directory $PWD
+
+# Install pre-commit hooks using uv
+uv run pre-commit install

calm-calatheas/.devcontainer/uv.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+
+# Install Python dependencies using uv
+uv venv --allow-existing
+uv sync

calm-calatheas/.envrc

@@ -0,0 +1,3 @@
+source_url "https://raw.githubusercontent.com/cachix/devenv/82c0147677e510b247d8b9165c54f73d32dfd899/direnvrc" "sha256-7u4iDd1nZpxL4tCzmPG0dQgC5V+/44Ba+tHkPob1v2k="
+
+use devenv

calm-calatheas/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

calm-calatheas/.github/workflows/lint.yaml

@@ -0,0 +1,57 @@
+name: Lint
+
+on:
+    push:
+        branches:
+            - main
+    pull_request:
+
+concurrency: lint-${{ github.sha }}
+
+jobs:
+    lint:
+        runs-on: ubuntu-latest
+
+        env:
+            PYTHON_VERSION: "3.13"
+
+        steps:
+            - name: Checkout repository
+              uses: actions/checkout@v4
+
+            - name: Set up Python ${{ env.PYTHON_VERSION }}
+              uses: actions/setup-python@v5
+              with:
+                  python-version: ${{ env.PYTHON_VERSION }}
+
+            - name: Install uv
+              run: python -m pip install uv
+
+            - name: Cache the virtualenv
+              uses: actions/cache@v4
+              with:
+                  path: ./.venv
+                  key: ${{ runner.os }}-venv-${{ hashFiles('**/uv.lock') }}
+
+            - name: Install Python dependencies
+              run: uv venv --allow-existing && uv sync
+
+            - name: Update GITHUB_PATH
+              run: echo "$(uv python find)" >> $GITHUB_PATH
+
+            - name: Setup Node.js and dependencies
+              uses: actions/setup-node@v4
+              with:
+                  node-version: 20
+                  cache: npm
+                  registry-url: "https://npm.pkg.github.com"
+
+            - name: Install Node.js dependencies
+              run: npm install
+              shell: bash
+
+            - name: Run pre-commit hooks
+              uses: pre-commit/action@v3.0.1
+
+            - name: Build the documentation
+              run: uv run task build-docs

calm-calatheas/.github/workflows/publish-docs.yaml

@@ -0,0 +1,50 @@
+name: Publish Documentation
+
+concurrency:
+    group: "docs"
+
+on:
+    push:
+        branches:
+            - main
+
+jobs:
+    publish:
+        runs-on: ubuntu-latest
+
+        permissions:
+            contents: write
+            pages: write
+
+        env:
+            PYTHON_VERSION: "3.13"
+
+        steps:
+            - name: Checkout code
+              uses: actions/checkout@v4
+              with:
+                  fetch-depth: 0
+
+            - run: git config --global user.email "calm-calatheas@github.com"
+            - run: git config --global user.name "Calm Calatheas"
+
+            - name: Set up Python ${{ env.PYTHON_VERSION }}
+              uses: actions/setup-python@v5
+              with:
+                  python-version: ${{ env.PYTHON_VERSION }}
+
+            - name: Install uv
+              run: python -m pip install uv
+
+            - name: Cache the virtualenv
+              uses: actions/cache@v4
+              with:
+                  path: ./.venv
+                  key: ${{ runner.os }}-venv-${{ hashFiles('**/uv.lock') }}
+
+            - name: Install Python dependencies
+              run: uv venv --allow-existing && uv sync
+
+            - name: Publish documentation
+              run: uv run mkdocs gh-deploy
+              shell: bash