zengif 0.3.0

Server-side GIF codec with zero-trust design, memory bounds, streaming, and full animation transparency support
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

# zengif build commands

# Default recipe
default: check

# Full check: format, clippy, test
check: fmt clippy test

# Format code
fmt:
    cargo fmt

# Run clippy with all targets and features
clippy:
    cargo clippy --all-targets --all-features -- -D warnings

# Run tests
test:
    cargo test --all-features

# Check dependency versions
outdated:
    cargo outdated

# Generate documentation
doc:
    cargo doc --no-deps --all-features

# Run benchmarks
bench:
    cargo bench --all-features

# Run specific benchmark group
bench-group GROUP:
    cargo bench --all-features -- {{GROUP}}

# Build release
build-release:
    cargo build --release --all-features

# Clean build artifacts
clean:
    cargo clean

# Check for security vulnerabilities
audit:
    cargo audit

# Run with all features for CI
ci: fmt
    cargo clippy --all-targets --all-features -- -D warnings
    cargo test --all-features
    cargo doc --no-deps --all-features

# === Fuzzing (requires nightly: rustup install nightly) ===

# Run decode fuzzer (main target)
fuzz:
    cargo +nightly fuzz run fuzz_decode -- -dict=fuzz/gif.dict

# Run decode fuzzer with seed corpus
fuzz-seeded:
    cargo +nightly fuzz run fuzz_decode fuzz/corpus/seed/ -- -dict=fuzz/gif.dict

# Run streaming decode fuzzer
fuzz-streaming:
    cargo +nightly fuzz run fuzz_decode_streaming -- -dict=fuzz/gif.dict

# Run roundtrip fuzzer
fuzz-roundtrip:
    cargo +nightly fuzz run fuzz_roundtrip -- -dict=fuzz/gif.dict

# Run limits fuzzer
fuzz-limits:
    cargo +nightly fuzz run fuzz_limits

# List available fuzz targets
fuzz-list:
    cargo +nightly fuzz list

# Run fuzzer for a specific duration (e.g., just fuzz-timed 3600 for 1 hour)
fuzz-timed SECONDS:
    cargo +nightly fuzz run fuzz_decode -- -max_total_time={{SECONDS}} -dict=fuzz/gif.dict

# Download external fuzzing corpora
fuzz-download-corpus:
    ./fuzz/download_corpus.sh

# Generate coverage report from fuzzing
fuzz-coverage:
    cargo +nightly fuzz coverage fuzz_decode
    @echo "Coverage report: fuzz/coverage/fuzz_decode/"

# Build all fuzz targets (useful for CI)
fuzz-build:
    cargo +nightly fuzz build

# === Profiling ===

# Run allocation sweep profiler (content types × sizes × quantizers)
profile:
    cargo run --release --all-features --example alloc_profile

# Run memory profiler with tracking allocator (accurate B/pixel measurements)
profile-memory:
    cargo run --release --all-features --example memory_profile

# Run allocation profiler with heaptrack (Linux only)
profile-heap:
    heaptrack cargo run --release --all-features --example alloc_profile

# View heaptrack results (latest)
profile-view:
    heaptrack_gui $(ls -t heaptrack.alloc_profile.*.zst 2>/dev/null | head -1)