justfile

#!/usr/bin/env just --justfile

# Common aliases for faster development
alias b := build
alias br := build-release
alias t := test
alias tf := test-fast
alias l := lint
alias f := format
alias fc := fmt-check
alias a := audit
alias c := check
alias tc := test-coverage
alias d := docs
alias cl := change

export RUST_BACKTRACE := "1"

set windows-shell := ["powershell.exe", "-NoLogo", "-Command"]

# Default recipe - list available commands
default:
    @just --list

# ============================================
# Build Commands
# ============================================

# Build the project in debug mode
build *ARGS='':
    cargo build {{ARGS}}

# Build the project in release mode
build-release *ARGS='':
    cargo build --release {{ARGS}}

# ============================================
# Test Commands
# ============================================

# Run all tests
test *ARGS='':
    cargo test {{ARGS}}

# Run tests with nextest (faster parallel execution)
test-fast *ARGS='':
    cargo nextest run {{ARGS}}

# Run tests with coverage (generates lcov.info)
test-coverage:
    #!/usr/bin/env bash
    set -euo pipefail
    source <(cargo llvm-cov show-env --export-prefix)
    cargo build --all-features
    cargo llvm-cov --no-clean --all-features --lcov --output-path lcov.info

# Generate HTML coverage report
coverage-html:
    cargo llvm-cov nextest --all-features --html --output-dir coverage

# Open coverage report in browser
coverage-report: coverage-html
    open coverage/html/index.html || xdg-open coverage/html/index.html 2>/dev/null || echo "Open coverage/html/index.html manually"

# ============================================
# Lint & Format Commands
# ============================================

# Run clippy lints
lint *ARGS='':
    cargo clippy {{ARGS}} -- -D warnings

# Format code
format *ARGS='':
    cargo fmt --all -- {{ARGS}}

# Check formatting without changes
fmt-check:
    cargo fmt --all -- --check

# Run all checks (format, lint, test)
check: fmt-check lint test

# ============================================
# Security Commands
# ============================================

# Security audit
audit:
    cargo audit
    cargo deny check

# ============================================
# Documentation Commands
# ============================================

# Build documentation
docs:
    RUSTDOCFLAGS="-D warnings" cargo doc --no-deps --all-features

# Open documentation in browser
docs-open: docs
    cargo doc --no-deps --all-features --open

# ============================================
# Changelog Commands
# ============================================

# Create a new changelog entry
change:
    changie new

# Preview the next version changelog
changelog-preview:
    changie batch auto --dry-run

# ============================================
# Binary Size Commands (Linux only)
# ============================================

# Run cargo-bloat on examples, save to metrics/ (Linux only)
[linux]
bloat:
    #!/usr/bin/env bash
    set -euo pipefail
    mkdir -p metrics
    echo "=== native-tls ===" | tee metrics/bloat-native-tls.txt
    cargo bloat --release --example size_check --crates | tee -a metrics/bloat-native-tls.txt
    echo ""
    echo "=== rustls ===" | tee metrics/bloat-rustls.txt
    cargo bloat --release --example size_check_rustls --no-default-features --features rustls --crates | tee -a metrics/bloat-rustls.txt

# Record release binary size to metrics/binary-size.txt
[linux]
record-size:
    #!/usr/bin/env bash
    set -euo pipefail
    cargo build --release --example size_check
    cargo build --release --example size_check_rustls --no-default-features --features rustls
    VERSION=$(cargo metadata --no-deps --format-version 1 | jq -r '.packages[0].version')
    DATE=$(date +%Y-%m-%d)
    mkdir -p metrics

    # native-tls
    SIZE=$(stat --format="%s" "target/release/examples/size_check")
    HUMAN=$(numfmt --to=iec --suffix=B "$SIZE")
    echo "$DATE v$VERSION native-tls $SIZE $HUMAN" >> metrics/binary-size.txt
    echo "Recorded: $DATE v$VERSION native-tls $SIZE ($HUMAN)"

    # rustls
    SIZE=$(stat --format="%s" "target/release/examples/size_check_rustls")
    HUMAN=$(numfmt --to=iec --suffix=B "$SIZE")
    echo "$DATE v$VERSION rustls $SIZE $HUMAN" >> metrics/binary-size.txt
    echo "Recorded: $DATE v$VERSION rustls $SIZE ($HUMAN)"

# ============================================
# Watch Commands
# ============================================

# Watch for changes and run tests
watch-test:
    cargo watch -x test

# Watch for changes and run clippy
watch-lint:
    cargo watch -x clippy

# ============================================
# CI & Release Commands
# ============================================

# Run all CI checks locally
ci: fmt-check lint test audit build

# PR checks (mimics CI workflow)
pr: fmt-check lint test-coverage audit build

# ============================================
# Utility Commands
# ============================================

# Clean build artifacts
clean:
    cargo clean

# Install the binary locally
install:
    cargo install --path .

# Update dependencies
update:
    cargo update