Initial commit

Author: jpvelez

.devcontainer/devcontainer.json

@@ -0,0 +1,23 @@
+{
+  "name": "Switchbox Copier Template",
+  "image": "mcr.microsoft.com/devcontainers/python:1-3.13-bookworm",
+  "features": {
+    "ghcr.io/guiyomh/features/just:0.1.0": { "version": "1.42.4" }
+  },
+  "postCreateCommand": "./.devcontainer/postCreateCommand.sh",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "ms-python.python",
+        "tamasfe.even-better-toml",
+        "charliermarsh.ruff",
+        "nefrob.vscode-just-syntax"
+      ],
+      "settings": {
+        "python.testing.pytestArgs": ["tests"],
+        "python.testing.unittestEnabled": false,
+        "python.testing.pytestEnabled": true
+      }
+    }
+  }
+}

.devcontainer/postCreateCommand.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+
+# Install uv
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Install Dependencies (project + dev)
+uv sync --group dev
+
+# Install pre-commit hooks
+uv run pre-commit install --install-hooks

.github/workflows/ci.yml

@@ -0,0 +1,25 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: 'true'
+      - name: Install deps
+        run: uv sync --group dev
+      - name: Run tests
+        run: uv run pytest -q

.gitignore

@@ -0,0 +1,11 @@
+.venv/
+.uv/
+.pytest_cache/
+.ruff_cache/
+*.pyc
+__pycache__/
+site/
+dist/
+build/
+.DS_Store
+tmp/

.pre-commit-config.yaml

@@ -0,0 +1,17 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: check-case-conflict
+      - id: check-merge-conflict
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+      - id: check-json
+      - id: check-toml
+      - id: check-yaml
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.7
+    hooks:
+      - id: ruff-check
+        args: [--exit-non-zero-on-fix]
+      - id: ruff-format

CONTRIBUTING.md

@@ -0,0 +1,28 @@
+# Contributing
+
+Thanks for your interest in contributing! This repo contains a Copier template; contributions typically change files under `template/` or the template config `copier.yml`.
+
+## Dev setup
+
+```bash
+uv sync --group dev
+uv run pre-commit install --install-hooks
+```
+
+## Run tests
+
+```bash
+uv run pytest -q
+```
+
+## Docs
+
+```bash
+uv run mkdocs serve
+```
+
+## PR guidelines
+
+- Keep changes minimal and Copier-native (prefer conditional paths over post-gen scripts)
+- Add/adjust tests if conditionals change
+- Ensure CI is green (pytest + pre-commit)

README.md

@@ -0,0 +1,85 @@
+# Switchbox Copier Template
+
+This is a standalone Copier template for Switchbox projects. It supports:
+
+- Python-focused development with modern tooling
+- Optional features: Data science tools, package publishing, GitHub Actions, AWS CLI
+- Python stack options: type checker (mypy/ty), always includes deptry and devcontainers
+- Conditional files and directories via Copier-native templated paths, no post-gen cleanup
+
+## Quick start
+
+Install Copier:
+
+```bash
+pipx install copier  # or: uv tool install copier
+```
+
+Generate a project (example: Python + Data Science tools):
+
+```bash
+copier copy --defaults --force \
+  --data python_data_science="y" --data python_package="y" \
+  . /path/to/new-project
+```
+
+See `copier/copier.yml` for all questions and defaults.
+
+## Development
+
+- Install dev deps with uv:
+
+```bash
+uv sync --group dev
+```
+
+- Run tests (pytest runs copier to generate scenarios and asserts outputs):
+
+```bash
+uv run pytest -q
+```
+
+- Lint/format:
+
+```bash
+uv run pre-commit run -a
+```
+
+## Docs
+
+This repo ships MkDocs. To serve locally:
+
+```bash
+uv run mkdocs serve
+```
+
+## Using the Template
+
+To create a new project from this template:
+
+```bash
+# Install copier
+uv tool install copier
+
+# Create a new project (requires --trust for git initialization)
+copier copy --trust https://github.com/your-org/copier-sb.git my-new-project
+```
+
+The template will:
+- 🔧 Initialize a git repository
+- 📁 Add all generated files to git
+- 💾 Create an initial commit
+- 🚀 Set up your development environment
+
+### Project Types
+
+You can select one or more of these project types:
+- **Python Data Science**: Includes polars, pyarrow, seaborn, numpy, Quarto notebooks
+- **Python Package**: Includes build tools, twine, MkDocs documentation
+- **R Data Science**: Includes R, renv, Quarto, R extensions
+
+**Note**: You must select at least one project type.
+
+## License
+
+MIT

copier-helper.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TEMPLATE_DIR="$(cd "$(dirname "$0")" && pwd)"
+OUT_DIR="${1:-$TEMPLATE_DIR/tmp/generated}"
+
+# Clean up existing output directory
+rm -rf "$OUT_DIR"
+mkdir -p "$OUT_DIR"
+
+uvx copier copy --defaults --force --trust \
+  --data author="Switchbox" \
+  --data email="hello@switch.box" \
+  --data author_github_handle="switchbox-data" \
+  --data project_name="example-project" \
+  --data project_slug="example_project" \
+  --data project_description="Example" \
+  --data python_data_science="y" \
+  --data python_package="y" \
+  --data r_data_science="n" \
+  --data use_github="y" \
+  --data open_source_license="MIT license" \
+  --data aws="n" \
+  "$TEMPLATE_DIR/copier" "$OUT_DIR"
+
+echo "Generated at: $OUT_DIR"

copier/copier.yml

@@ -0,0 +1,93 @@
+_min_copier_version: "9.0.0"
+_answers_file: .copier-answers.yml
+_subdirectory: template
+_exclude:
+  - ".copierignore"
+_templates_suffix: .jinja
+
+author:
+  type: str
+  default: "Florian Maas"
+  help: Your full name
+
+email:
+  type: str
+  default: "fpgmaas@gmail.com"
+  help: Your email address
+
+author_github_handle:
+  type: str
+  default: "fpgmaas"
+  help: Your GitHub handle (without @)
+
+project_name:
+  type: str
+  default: "example-project"
+  help: Project name (also used for repo name)
+
+project_slug:
+  type: str
+  default: "[[ project_name|lower|replace('-', '_') ]]"
+  help: Importable Python package name
+
+project_description:
+  type: str
+  default: "This is a template repository for Python projects that use uv for their dependency management."
+
+type_checker:
+  type: str
+  choices: ["mypy", "ty"]
+  default: "ty"
+  when: "{{ python == 'y' }}"
+
+python_data_science:
+  type: str
+  choices: ["y", "n"]
+  default: "y"
+  help: "Include Python data science tools (polars, pyarrow, seaborn, numpy, quarto, notebooks) - At least one of: python_data_science, python_package, or r_data_science must be selected"
+
+python_package:
+  type: str
+  choices: ["y", "n"]
+  default: "y"
+  help: "Include Python package publishing tools (build, twine, mkdocs documentation) - At least one of: python_data_science, python_package, or r_data_science must be selected"
+
+r_data_science:
+  type: str
+  choices: ["y", "n"]
+  default: "n"
+  help: "Include R data science tools (R, renv, Quarto, R extensions) - At least one of: python_data_science, python_package, or r_data_science must be selected"
+
+use_github:
+  type: str
+  choices: ["y", "n"]
+  default: "y"
+  help: Include GitHub Actions and issue templates
+
+open_source_license:
+  type: str
+  choices:
+    - "MIT license"
+    - "BSD license"
+    - "ISC license"
+    - "Apache Software License 2.0"
+    - "GNU General Public License v3"
+    - "Not open source"
+  default: "MIT license"
+
+aws:
+  type: str
+  choices: ["y", "n"]
+  default: "y"
+
+# Computed variables
+python: "{{ 'y' if (python_data_science == 'y' or python_package == 'y') else 'n' }}"
+
+# Post-generation tasks
+_tasks:
+  - command: git init
+    description: "🔧 Initialize git repository"
+  - command: git add .
+    description: "📁 Add all files to git staging"
+  - command: git commit -m "🎉 Initial commit from copier template"
+    description: "💾 Create initial commit"