Just：轻量Rust命令运行器，替代Make简化项目命令管理与自动化任务

cargo install just

brew install just

apt install just

choco install just

## 这是一个注释
build:
  # 构建项目
  cargo build --release

test:
  # 运行测试
  cargo test -- --nocapture

## 带参数的命令
deploy environment="production":
  @echo "部署到 {{environment}} 环境..."
  ./deploy.sh {{environment}}

## 运行第一个命令（默认）
just

## 运行指定命令
just test

## 运行带参数的命令
just deploy staging

## 带参数和默认值的命令
backup directory=".", retention_days=7:
  @echo "备份 {{directory}}，保留 {{retention_days}} 天..."
  rsync -av {{directory}} /backups/
  find /backups/ -mtime +{{retention_days}} -delete

## 使用默认参数
just backup

## 指定参数
just backup ./docs 30

## 依赖关系：部署前先构建和测试
deploy: build test
  @echo "部署应用..."
  ./deploy.sh

build:
  cargo build --release

test:
  cargo test

## 加载.env文件
set dotenv-load

## 显式设置环境变量
export API_URL := "https://api.example.com"

## 使用环境变量
fetch-data:
  curl {{API_URL}}/data --header "Authorization: Bearer $TOKEN"

[unix]
serve:
  ./server --port 8080

[windows]
serve:
  .\server.exe --port 8080

## 日期时间函数
log-file := "logs/app-{{datetime_utc('YYYY-MM-DD')}}.log"

## 文件操作函数
backup:
  @if [ {{path_exists(log-file)}} ]; then
    echo "日志文件已存在"
  fi
  cp {{log-file}} {{log-file}}.bak

## 字符串处理
greet name:
  @echo "Hello, {{capitalize(name)}}!"

## 前端项目justfile示例
set shell := ["bash", "-euo", "pipefail"]

install:
  npm install

dev:
  npm run dev

build:
  npm run build

test:
  npm run test -- --coverage

lint:
  npm run lint

format:
  npm run format

## 组合命令
ci: lint test build

## 后端服务justfile示例
set dotenv-load

## 数据库相关命令
db-migrate:
  sqlx migrate run

db-seed:
  sqlx migrate run
  cargo run --bin seed

db-reset:
  sqlx database drop -y
  sqlx database create
  sqlx migrate run
  cargo run --bin seed

## 开发环境
dev:
  cargo watch -x run

## 构建与部署
build:
  cargo build --release

deploy: build
  scp target/release/api user@server:~/api
  ssh user@server "sudo systemctl restart api"

## 多语言项目justfile示例
set shell := ["bash", "-euo", "pipefail"]

## 前端命令
frontend-install:
  cd frontend && npm install

frontend-dev:
  cd frontend && npm run dev

## 后端命令
backend-install:
  cd backend && cargo build

backend-dev:
  cd backend && cargo watch -x run

## 统一开发命令
dev: frontend-dev backend-dev

## 数据库命令
db-up:
  docker-compose up -d postgres

db-down:
  docker-compose down postgres

## 全流程测试
test:
  cd frontend && npm test
  cd backend && cargo test
  @echo "所有测试通过！"

## 项目管理命令
## ==============

## 初始化项目
init:
  git init
  cargo init
  touch README.md

## 提交代码
commit message:
  git add .
  git commit -m "{{message}}"

## 开发命令
## ========

[group("开发")]
## 启动开发服务器
dev:
  cargo watch -x run

[group("开发")]
## 运行代码检查
check:
  cargo fmt --check
  cargo clippy

$ just --list
可用命令:
    init           # 初始化项目
    commit message # 提交代码

    [开发]
    dev            # 启动开发服务器
    check          # 运行代码检查

## 主justfile
import "./commands/build.just"
import "./commands/test.just"
import "./commands/deploy.just"

## 组合命令
all: build test deploy

## 条件执行示例
publish:
  @if [ {{os()}} = "macos" ]; then
    echo "在macOS上发布"
    ./publish-macos.sh
  elif [ {{os()}} = "linux" ]; then
    echo "在Linux上发布"
    ./publish-linux.sh
  else
    echo "不支持的操作系统"
    exit 1
  fi