cella_gui 1.0.0

A GUI for the Cella cellular automata library
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

.PHONY: all build build-release run run-gui check clippy fmt fmt-check doc clean \
		test test-all test-all-single test-all-single-run \
		coverage coverage-all test-create-snapshots test-update-benchmarks

# ── Default ───────────────────────────────────────────────────────────────────
all: build

# ── Build ─────────────────────────────────────────────────────────────────────

## Debug build
build:
	cargo build --package cella_gui --bin cella

## Release build
build-release:
	cargo build --package cella_gui --bin cella --release

# ── Run ───────────────────────────────────────────────────────────────────────

## Run the application (CLI / default mode)
run:
	cargo run --package cella_gui --bin cella

## Run the application with the GUI at 1024x768
run-gui:
	cargo run --package cella_gui --bin cella -- --gui --size 1024x768

# ── Code quality ──────────────────────────────────────────────────────────────

## Check compilation without producing binaries
check:
	cargo check --workspace

## Run Clippy lints across the workspace, plus cella_lib's own examples
## (cella_lib is a path dependency, not a workspace member of the root
## Cargo.toml, so `--workspace` above never reaches its examples; that
## needs a second invocation with cella_lib itself as the build root).
clippy:
	cargo clippy --workspace -- -D warnings
	cd cella_lib && cargo clippy --examples -- -D warnings

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

## Check formatting without modifying files
fmt-check:
	cargo fmt --all -- --check

# ── Documentation ─────────────────────────────────────────────────────────────

## Build and open the documentation
doc:
	cargo doc --workspace --no-deps --open

# ── Tests ─────────────────────────────────────────────────────────────────────

## Quick test run — only non-ignored tests (fast feedback)
## Includes the wildfire_smc example's own unit tests (`cargo test
## --package cella_lib` alone builds the example but does not run its
## tests -- `cella_lib` is not a workspace member of the root Cargo.toml,
## same "examples need a second invocation" trap `clippy` above works
## around).
test:
	cd cella_lib && CELLA_ASCII=0 cargo test --package cella_lib
	cd cella_lib && CELLA_ASCII=0 cargo test --example wildfire_smc

## Run all tests including ignored ones (multi-threaded)
test-all:
	cd cella_lib && CELLA_ASCII=0 cargo test --package cella_lib -- --include-ignored
	cd cella_lib && CELLA_ASCII=0 cargo test --example wildfire_smc -- --include-ignored

## Run all tests including ignored ones, single-threaded
test-all-single:
	cd cella_lib && cargo test --package cella_lib -- --include-ignored --test-threads=1

## Run all tests single-threaded with bench runs=1 and config export enabled
test-all-single-run:
	cd cella_lib && CELLA_BENCH_RUNS=1 CELLA_EXPORT_CONFIGS=1 cargo test --package cella_lib -- --include-ignored --test-threads=1

## Generate line coverage for cella_lib (non-ignored tests)
coverage:
	cd cella_lib && CELLA_ASCII=0 cargo llvm-cov --package cella_lib --html

## Generate line coverage for cella_lib including ignored tests
coverage-all:
	cd cella_lib && CELLA_ASCII=0 cargo llvm-cov --package cella_lib --html -- --include-ignored

## Regenerate / update snapshot files
test-create-snapshots:
	cd cella_lib && CELLA_UPDATE_SNAPSHOTS=1 cargo test --package cella_lib -- --include-ignored

## Update benchmark baseline files
test-update-benchmarks:
	cd cella_lib && CELLA_UPDATE_BENCH=1 cargo test --package cella_lib -- --include-ignored --test-threads=1

# ── Clean ─────────────────────────────────────────────────────────────────────

## Remove build artifacts
clean:
	cargo clean