hprof-analyzer 0.2.0

Fast, low-memory Java HPROF heap-dump analyzer with Eclipse MAT-parity reports (System Overview, Leak Suspects, Top Consumers).
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

[workspace]
members = [".", "crates/hprof-wasm"]
resolver = "2"

[package]
name = "hprof-analyzer"
version = "0.2.0"
edition = "2024"
rust-version = "1.85"
description = "Fast, low-memory Java HPROF heap-dump analyzer with Eclipse MAT-parity reports (System Overview, Leak Suspects, Top Consumers)."
license = "MIT"
repository = "https://github.com/parttimenerd/hprof-analyzer"
readme = "README.md"
authors = ["Johannes Bechberger"]
keywords = ["hprof", "heap-dump", "java", "memory", "oom"]
categories = ["command-line-utilities", "development-tools::profiling"]
exclude = [
    "tests/fixtures/*.hprof",
    "tests/fixtures/*.hprof.gz",
    "tests/fixtures/*.hprof.zip",
    "tests/fixtures/*.json",
    "tests/fixtures/*.md",
    "tests/fixtures/*.index",
    "tests/fixtures/*.threads",
    "web/dist/*",
    "web/node_modules/*",
    "dist/*",
    ".git-worktrees/*",
    "docs/*",
    "*.png",
]

[[bin]]
name = "hprof-analyzer"
path = "src/main.rs"

[lib]
name = "hprof_analyzer"
path = "src/lib.rs"
crate-type = ["rlib"]

[features]
# Opt-in Eclipse MAT differential-oracle test harness (tests/mat_oracle.rs).
# No extra deps: the harness shells out to scripts/mat-oracle.sh. Compiled only
# under `--features mat-oracle`; its tests are #[ignore]d and gated on MAT_HOME.
mat-oracle = []
# Native-only dependencies (CLI, server, REPL, HTML scraping, compression).
# The WASM crate depends on hprof-analyzer with default-features = false to
# avoid pulling in these non-WASM-compatible crates.
default = ["native"]
native = ["dep:reedline", "dep:crossterm", "dep:tiny_http", "dep:clap", "dep:clap_complete", "dep:scraper", "dep:zstd", "dep:zip", "dep:tar", "dep:ureq", "dep:self-replace"]

[dependencies]
base64 = "0.22"
tiny_http = { version = "0.12", optional = true }
clap = { version = "4", features = ["derive"], optional = true }
clap_complete = { version = "4", optional = true }
flate2 = "1"
# default-features = false drops legacy/arrays/zdict_builder C extensions; only encode/decode needed
zstd = { version = "0.13", default-features = false, optional = true }
# Used for reading Eclipse MAT plugin jars (DEFLATE-compressed entries) to
# detect the installed MAT parser ID. deflate feature only; no bzip2/zstd needed.
zip = { version = "2", default-features = false, features = ["deflate"], optional = true }
tar = { version = "0.4", optional = true }
# HTTP download for `update` subcommand; TLS via native OS roots (rustls + webpki).
ureq = { version = "3", default-features = false, features = ["rustls"], optional = true }
# Atomic self-replacement of the running binary (handles Windows file locking).
self-replace = { version = "1", optional = true }
scraper = { version = "0.27", optional = true }
# pinned to =1.2.1: schemars 1.x had breaking API changes; bump carefully
schemars = "=1.2.1"
serde = { version = "1", features = ["derive"] }
serde_json = "1"
# only deserializing TOML; "display" feature (TOML serialization) is not needed
toml = { version = "0.8", default-features = false, features = ["parse"] }
chumsky = "0.13.0"
ariadne = "0.6.0"
logos = "0.16.1"
reedline = { version = "0.43", optional = true }
crossterm = { version = "0.28", optional = true }
# full regex (not regex-lite) for MAT's quoted-FROM Java-Pattern class matching
regex = "1"

[target.'cfg(unix)'.dependencies]
libc = "0.2"

[dev-dependencies]
cargo-husky = { version = "1.5.0", features = ["precommit-hook", "run-cargo-fmt", "user-hooks"] }
jsonschema = "0.47.0"
proptest = "1"
tar = "0.4"
tempfile = "3"

[build-dependencies]
flate2 = "1"

# Clippy is run in CI (see .github/workflows/ci.yml). Most lints are enforced;
# the allows below are deliberate patterns in the memory-critical hot paths,
# not tech debt:
#   needless_range_loop  - index drives several parallel per-object arrays at
#                          once (semi/ancestor/label, class_idx, ...); the
#                          iterator rewrite obscures the shared index and can
#                          perturb the bit-exact dominator/pass2 hot loops.
#   ptr_arg              - &mut Vec params are grown via push()/clear() inside
#                          the fill routines; a slice cannot resize.
#   collapsible_if       - nested `if let` guards read more clearly unmerged.
#   too_many_arguments   - the retained-set builder threads many CSR arrays by
#                          reference to avoid extra allocations.
[lints.clippy]
needless_range_loop = "allow"
ptr_arg = "allow"
collapsible_if = "allow"
too_many_arguments = "allow"
redundant_closure_call = "allow"

[profile.release]
lto = true
codegen-units = 1
panic = "abort"

# Fast iteration profile: no LTO, many codegen units, full opt level.
# Use with: cargo build --profile fast
# Suitable for testing on many cores; binary is ~10-15% slower than release.
[profile.fast]
inherits = "release"
lto = false
codegen-units = 256
panic = "abort"