truss-image 0.4.0

Image toolkit with a shared Rust core across the CLI, HTTP server, and WASM demo.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150

# truss — image transformation tool and server
#
# Run `just` with no arguments to see available recipes.
# Run `just --list` for a compact overview.

set shell := ["bash", "-euo", "pipefail", "-c"]

# Default recipe: show available tasks
default:
    @just --list

# ---------------------------------------------------------------------------
# Development
# ---------------------------------------------------------------------------

# Run unit tests and doc tests (use `just integration` for Docker-based tests)
test:
    cargo test --all-targets
    cargo test --doc

# Run only unit tests (fast, no integration)
test-unit:
    cargo test --lib

# Run clippy linter with strict warnings
lint:
    cargo clippy --all-targets -- -D warnings

# Check code formatting (does not modify files)
fmt-check:
    cargo fmt --all -- --check

# Format all source files
fmt:
    cargo fmt --all

# Build documentation with strict warnings
doc:
    RUSTDOCFLAGS="-D warnings" cargo doc --no-deps

# Run security audit (requires cargo-audit)
audit:
    cargo audit

# Run all CI checks locally (test + lint + fmt + doc + audit)
ci: test lint fmt-check doc audit

# ---------------------------------------------------------------------------
# Build
# ---------------------------------------------------------------------------

# Build debug binary
build:
    cargo build

# Build release binary
build-release:
    cargo build --release --locked

# Build Docker image
docker-build:
    docker build -t truss .

# ---------------------------------------------------------------------------
# Coverage
# ---------------------------------------------------------------------------

# Run code coverage (requires cargo-llvm-cov)
coverage:
    cargo llvm-cov --workspace --all-targets --summary-only

# Run code coverage with HTML report
coverage-html:
    cargo llvm-cov --workspace --all-targets --html
    @echo "Report: target/llvm-cov/html/index.html"

# ---------------------------------------------------------------------------
# Integration tests (Docker-based)
# ---------------------------------------------------------------------------

# Run CLI integration tests with ShellSpec in Docker
integration-cli:
    docker build -t truss-cli-test -f integration/cli/Dockerfile .
    docker run --rm truss-cli-test

# Run API server integration tests with runn in Docker Compose
integration-api:
    cd integration/api && docker compose up --build --abort-on-container-exit --exit-code-from runn

# Clean up API integration test containers
integration-api-clean:
    cd integration/api && docker compose down --volumes --remove-orphans

# Run S3 backend integration tests (runn → nginx → truss → s3mock)
integration-s3:
    cd integration/s3 && docker compose up --build --abort-on-container-exit --exit-code-from runn

# Clean up S3 integration test containers
integration-s3-clean:
    cd integration/s3 && docker compose down --volumes --remove-orphans

# Run all integration tests
integration: integration-cli integration-api integration-s3

# ---------------------------------------------------------------------------
# WASM
# ---------------------------------------------------------------------------

# Build WASM demo for GitHub Pages
wasm-build:
    ./scripts/build-wasm-demo.sh

# Check WASM feature slice compiles
wasm-check:
    cargo check --no-default-features --features wasm --lib

# Lint WASM feature slice
wasm-lint:
    cargo clippy --no-default-features --features wasm --lib -- -D warnings

# ---------------------------------------------------------------------------
# Server
# ---------------------------------------------------------------------------

# Start development server (cargo run)
serve *ARGS:
    cargo run -- serve {{ARGS}}

# Start development server with Docker Compose
serve-docker:
    docker compose up --build

# ---------------------------------------------------------------------------
# Utility
# ---------------------------------------------------------------------------

# Generate integration test fixture images (requires ImageMagick 7 + Python 3)
generate-fixtures:
    ./scripts/generate-fixtures.sh

# Remove build artifacts
clean:
    cargo clean

# Install development tools
setup:
    cargo install cargo-audit cargo-llvm-cov
    rustup component add llvm-tools-preview
    @echo "Optional: cargo install wasm-bindgen-cli --version 0.2.114"
    @echo "Optional: rustup target add wasm32-unknown-unknown"