Files
newproject/templates.py
T
2026-09-08 20:41:37 +02:00

128 lines
4.8 KiB
Python

# /// script
# requires-python = ">=3.12"
# dependencies = ["copier>=9.10", "questionary>=2.1"]
# ///
import argparse
import os
import re
import subprocess
import sys
from pathlib import Path
import questionary
from copier import run_copy, run_update
SOURCE = os.environ.get("TEMPLATES_DIR", "https://git.kotikot.com/templates")
REF = os.environ.get("TEMPLATES_REF")
BACKENDS = {"python": "backend-python"}
FRONTENDS = {"svelte": "frontend-svelte"}
SERVE = ["bun", "static", "api"]
def template(name: str) -> str:
local = Path(SOURCE) / name
return str(local) if local.is_dir() else f"{SOURCE}/{name}.git"
def git_config(key: str) -> str:
result = subprocess.run(["git", "config", key], capture_output=True, text=True, check=False)
return result.stdout.strip()
def interactive() -> bool:
return sys.stdin.isatty()
def ask_text(prompt: str, default: str) -> str:
return questionary.text(prompt, default=default).unsafe_ask() if interactive() else default
def ask_select(prompt: str, choices: list[str], default: str) -> str:
if not interactive():
return default
return questionary.select(prompt, choices=choices, default=default).unsafe_ask()
def ask_checkbox(prompt: str, choices: list[str], default: list[str]) -> list[str]:
if not interactive():
return default
items = [questionary.Choice(c, checked=c in default) for c in choices]
return questionary.checkbox(prompt, choices=items).unsafe_ask()
def slugify(name: str) -> str:
return re.sub(r"[^a-z0-9]", "_", name.lower())
def new(args: argparse.Namespace) -> None:
dest = Path(args.dest).resolve()
name = args.name or ask_text("Project name", dest.name)
slug = args.slug or ask_text("Slug", slugify(name))
parts = args.parts.split(",") if args.parts else ask_checkbox("Parts", ["backend", "frontend", "caddy"], ["backend", "frontend", "caddy"])
backend = frontend = None
if "backend" in parts:
backend = args.backend or ask_select("Backend", list(BACKENDS), "python")
if "frontend" in parts:
frontend = args.frontend or ask_select("Frontend", list(FRONTENDS), "svelte")
serve = "bun"
if frontend:
options = SERVE if backend else SERVE[:-1]
serve = args.serve or ask_select("Frontend served by", options, "bun")
stack = [p for p in ("backend", "frontend") if p in parts]
single = len(stack) == 1
routes = [r for r, ok in (("api", backend), ("frontend", frontend and serve != "api")) if ok]
def copy(name: str, data: dict) -> None:
run_copy(template(name), dest, data=data, unsafe=True, defaults=args.defaults, vcs_ref=REF)
dest.mkdir(parents=True, exist_ok=True)
copy("infra", {"layout": "single" if single else "parts", "parts": [] if single else stack})
layout = "root" if single else "part"
identity = {"project_name": name, "project_slug": slug}
if backend:
copy(BACKENDS[backend], {**identity, "layout": layout, "serve_spa": serve == "api",
"author_name": git_config("user.name"), "author_email": git_config("user.email")})
if frontend:
copy(FRONTENDS[frontend], {**identity, "layout": layout, "serve": serve})
if "caddy" in parts:
copy("caddy", {"project_slug": slug, "routes": routes})
if (dest / "Makefile").is_file():
subprocess.run(["make", "env"], cwd=dest, check=True)
def update(args: argparse.Namespace) -> None:
answers = sorted(Path(".copier").glob("*.yml"))
if args.parts:
answers = [Path(".copier") / f"{p}.yml" for p in args.parts]
if not answers:
sys.exit("no .copier/*.yml here")
for file in answers:
run_update(".", answers_file=str(file), unsafe=True, overwrite=True,
skip_answered=not args.ask, defaults=args.defaults, vcs_ref=REF)
def main() -> None:
parser = argparse.ArgumentParser(prog="templates")
sub = parser.add_subparsers(dest="command", required=True)
n = sub.add_parser("new", help="Compose a project from templates")
n.add_argument("dest")
n.add_argument("--name")
n.add_argument("--slug")
n.add_argument("--parts", help="comma-separated: backend,frontend,caddy")
n.add_argument("--backend", choices=list(BACKENDS))
n.add_argument("--frontend", choices=list(FRONTENDS))
n.add_argument("--serve", choices=SERVE)
n.add_argument("--defaults", action="store_true", help="accept template defaults without asking")
n.set_defaults(func=new)
u = sub.add_parser("update", help="Update every part from its template")
u.add_argument("parts", nargs="*", help="parts to update, default all")
u.add_argument("--ask", action="store_true", help="ask every question again")
u.add_argument("--defaults", action="store_true")
u.set_defaults(func=update)
args = parser.parse_args()
args.func(args)
if __name__ == "__main__":
main()