mise.toml

[tools]
python = "3.14"
uv = "latest"

##### Settings and environment variables #####

[settings]
python.uv_venv_auto = "create|source"

[env]
JSII_SILENCE_WARNING_UNTESTED_NODE_VERSION = true  # silence warning about untested Node.js versions in CDK

##### Shell aliases #####

[shell_alias]
# Project-specific shortcuts
n = "mise run new"
i = "mise run install"
u = "mise run update"
l = "mise run lint"
t = "mise run test"
d = "mise run deploy"
D = "mise run destroy"
v = "mise run verify"
c = "mise run clean"
m = "mise run"

# Common utility aliases
ll = "ls -la"
la = "ls -A"
gs = "git status"
ga = "git add"
gc = "git commit"
gp = "git push"
gco = "git checkout"
gb = "git branch"
g  = "git"

##### Scripts #####

[tasks.new]
description = "Create new Lambda function template"
usage = """
arg "<template>" help="Template name"
"""
run = "uv run new -n $usage_template"
alias = "n"

[tasks.init]
description = "Initialize project (run once)"
usage = """
flag "--name <name>" help="Project new name"
flag "--description <description>" help="Project short description"
flag "--author <author>" help="Author name"
flag "--email <email>" help="Author email"
flag "--github <github>" help="GitHub username"
"""
run = "uv run init"

##### Dev setup and maintenance #####

[tasks.install]
description = "Install dependencies and project"
run = "uv sync"
alias = "i"

[tasks.update]
description = "Update dependencies"
run = "uv lock --upgrade"
alias = "u"

[tasks.precommit]
description = "Install pre-commit hooks"
run = "uv run pre-commit autoupdate && uv run pre-commit install"

[tasks.dev]
description = "Set up dev environment"
depends = ["precommit"]

[tasks.lint]
description = "Format and lint code"
run = """
uv run ruff format
uv run ruff check --fix
uv run ruff format
# uv run pyright
"""
alias = "l"

[tasks.test]
description = "Run tests with coverage"
run = """
uv run coverage run -m pytest .
uv run coverage report -m
uv run coverage xml
"""
alias = "t"

[tasks.verify]
description = "Run lint, test, and infra synth"
depends = ["lint", "test", "infra:synth"]
alias = "v"

[tasks.clean]
description = "Clean up build artifacts and temporary files"
run = """rm -rf cdk.out .coverage coverage.xml .pytest_cache .ruff_cache .hypothesis .localstack node_modules"""
alias = "c"

##### Docs #####

[tasks.install-docs]
description = "Install documentation dependencies"
run = "uv sync --group docs"
hide = true
tools = { node = "latest" }

[tasks.docs]
description = "Build and deploy documentation to GitHub pages"
run = "uv run mkdocs gh-deploy --force"
depends = ["install-docs"]

[tasks.docs-local]
description = "Serve documentation on a local server"
run = "uv run mkdocs serve"

##### Infra #####

[tasks."infra:setup"]
description = "Install CDK dependencies"
run = "uv sync --group infra"
hide = true

[tasks."infra:synth"]
description = "Synthesize CDK stack(s)"
usage = """
arg "[stack]" help="CDK stack to synthesize"
"""
run = "STACK=${usage_stack:-all} npx aws-cdk synth"
alias = ["synth", "s"]
depends = ["infra:setup"]

[tasks."infra:deploy"]
description = "Deploy a CDK stack"
usage = """
arg "<stack>" help="CDK stack to deploy"
flag "-p --profile <profile>" help="AWS profile to use"
"""
run = "STACK=$usage_stack npx aws-cdk deploy ${usage_profile:+--profile $usage_profile}"
alias = ["d", "deploy"]
depends = ["infra:synth"]

[tasks."infra:destroy"]
description = "Destroy a deployed CDK stack"
usage = """
arg "<stack>" help="CDK stack to destroy"
flag "-p --profile <profile>" help="AWS profile to use"
"""
run = "STACK=$usage_stack npx aws-cdk destroy --force ${usage_profile:+--profile $usage_profile}"
alias = ["destroy", "D"]
depends = ["infra:setup"]

[tasks."local:setup"]
description = "Install CDK dependencies in local environment"
run = "pnpm i"
hide = true
tools = { node = "latest" }
depends = ["infra:setup"]

[tasks."local:deploy"]
description = "Deploy a CDK stack to LocalStack"
usage = """
arg "<stack>" env=STACK help="CDK stack to deploy"
"""
run = "STACK=$usage_stack pnpm run deploy"
alias = ["local"]
depends = ["local:setup", "local:up"]

[tasks."local:destroy"]
description = "Destroy a deployed CDK stack from LocalStack"
usage = """
arg "<stack>" env=STACK help="CDK stack to destroy"
"""
run = "STACK=$usage_stack pnpm run destroy"
depends = ["local:setup"]

[tasks."local:up"]
description = "Start LocalStack via docker compose"
run = "docker compose up -d --wait localstack"

[tasks."local:down"]
description = "Stop LocalStack via docker compose"
run = "docker compose down localstack"

[tasks."local:deploy".env]
_.file = ".env.local"

[tasks."local:destroy".env]
_.file = ".env.local"