djvu-rs 0.35.0

Read, render, convert, and create DjVu files. Pure-Rust DjVu decoder/encoder with CLI, WebAssembly, and Python bindings. DjVu to PDF, EPUB, TIFF, PNG, and text. MIT licensed, no GPL dependencies.
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

# Local developer gates mirroring CI. `make hooks` once to enable the pre-push hook.
.PHONY: check hooks pgo wasm wasm-threads-check conformance package-versions encode-rss-scaling

## Run the same deterministic gates CI enforces (fmt, clippy, no_std, wasm, tests).
check:
	@scripts/check.sh

## Enable the version-controlled git hooks (pre-push runs `make check`).
hooks:
	@git config core.hooksPath .githooks && echo "git hooks enabled: core.hooksPath=.githooks"

## Opt-in profile-guided optimization build (layers PGO over fat-LTO). Trains on
## the corpus, then PGO-rebuilds the `djvu` CLI. ~15% faster cold render; see the
## "PGO" entry in PERF_EXPERIMENTS.md. Needs the llvm-tools-preview component.
pgo:
	@scripts/pgo.sh

## Build the shipped browser WASM package: scalar fallback + simd128 variant
## selected at runtime via WebAssembly.validate. Pass OUT=... or FEATURES=...
## to override the generated package directory or wasm feature set.
wasm:
	@bash scripts/build_wasm_dual.sh

## Opt-in wasm32 thread-pool build check (`wasm-threads` feature, rayon via
## wasm-bindgen-rayon). Needs nightly + `-Z build-std` — NOT a required CI gate
## and NOT part of `scripts/check.sh`/`make check`. See WASM_THREADS in
## PERF_EXPERIMENTS.md. Pass `ARGS=--build` for a full release build+link.
wasm-threads-check:
	@scripts/wasm_threads_check.sh $(ARGS)

## Reproduce the DjVuLibre conformance gate and write conformance_site/ (#682).
conformance:
	@bash scripts/run_conformance.sh

## Verify Python/npm packaging versions track the crate version (#692).
package-versions:
	@bash scripts/check_package_versions.sh

## Measure `djvu encode` peak RSS vs. page count (6/12/24 by default) and
## report the marginal MB/page slope. Not a CI gate — an on-demand
## measurement harness for the encoder peak-memory investigation; see
## PERF_EXPERIMENTS.md, "Encoder peak-memory measurement harness".
## Override via env vars (FIXTURE, PAGE_COUNTS, QUALITY, OUT_DIR, ...); see
## scripts/encode_rss_scaling.sh --help.
encode-rss-scaling:
	@bash scripts/encode_rss_scaling.sh