Makefile và just làm task runner

.PHONY: help install lint test run image deploy clean
.DEFAULT_GOAL := help
SHELL := bash
.SHELLFLAGS := -eu -o pipefail -c
 
PY ?= uv run
IMAGE := netinv
TAG ?= $(shell git rev-parse --short HEAD 2>/dev/null || echo dev)
SRC := $(wildcard app/*.py)
export APP_ENV ?= dev
 
help: ## Liệt kê target
	@grep -E '^[a-zA-Z_-]+:.*?## ' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "%-12s %s\n", $$1, $$2}'
 
install: ## Cài dependency
	uv sync
 
lint: ## ruff + mypy
	$(PY) ruff check .
	$(PY) mypy
 
test: lint ## Chạy test (sau lint)
	$(PY) pytest -q $(ARGS)
 
run:
	$(PY) fastapi dev app/main.py
 
image:
	docker build -t $(IMAGE):$(TAG) .
 
deploy: test image
	@echo "deploy $(IMAGE):$(TAG) env=$$APP_ENV"
 
clean:
	-rm -rf .pytest_cache .ruff_cache
 
out/report.txt: $(SRC)
	mkdir -p $(@D)
	echo $^ > $@

set dotenv-load
set shell := ["bash", "-euo", "pipefail", "-c"]
 
image := "netinv"
tag := `git rev-parse --short HEAD 2>/dev/null || echo dev`
env := env("APP_ENV", "dev")
 
# Liệt kê recipe (recipe đầu tiên là mặc định)
default:
    @just --list
 
# Cài dependency
install:
    uv sync
 
# ruff + mypy
lint:
    uv run ruff check .
    uv run mypy
 
# Chạy test, truyền thêm tham số: just test -k vlan
test *args: lint
    uv run pytest -q {{args}}
 
# Build image, tag tuỳ chọn: just image v1.2.0
image t=tag:
    docker build -t {{image}}:{{t}} .
 
# Deploy, hỏi xác nhận trước
[confirm("Deploy lên production?")]
deploy: test (image tag)
    echo "deploy {{image}}:{{tag}} env={{env}}"
 
# Script nhiều dòng chạy trong một shell
backup host:
    #!/usr/bin/env bash
    set -euo pipefail
    mkdir -p out
    echo "backup {{host}}" > out/{{host}}.txt