chainsaw/
lib.rs

1//! Build and query dependency graphs for TypeScript/JavaScript and Python codebases.
2//!
3//! Chainsaw parses import statements, resolves them against the filesystem, and
4//! constructs a full transitive dependency graph from any entry file. The graph
5//! can then be queried for total import weight, heaviest packages, shortest
6//! import chains, optimal cut points, and before/after diffs.
7//!
8//! This library backs the `chainsaw` CLI. The public API is internal and
9//! unstable -- it exists so benchmarks and tests can access internals.
10
11#![warn(clippy::pedantic)]
12#![allow(clippy::must_use_candidate)]
13#![allow(clippy::missing_errors_doc)]
14#![allow(clippy::missing_panics_doc)]
15#![allow(clippy::module_name_repetitions)]
16// compact_str 0.8 (oxc_span) + 0.9 (oxc_resolver) — transitive, out of our control.
17#![allow(clippy::multiple_crate_versions)]
18
19pub mod cache;
20pub mod error;
21pub mod graph;
22pub mod lang;
23pub mod loader;
24pub mod query;
25pub mod report;
26pub mod walker;
27
28/// Compile-time guard: all public types must be Send + Sync + Unpin.
29/// If an internal change (e.g. adding Rc or Cell) breaks these, this
30/// test will fail to compile rather than silently degrading the API.
31#[cfg(test)]
32mod auto_trait_tests {
33    fn is_normal<T: Sized + Send + Sync + Unpin>() {}
34
35    #[test]
36    fn public_types_are_send_sync() {
37        is_normal::<crate::graph::ModuleId>();
38        is_normal::<crate::graph::EdgeId>();
39        is_normal::<crate::graph::EdgeKind>();
40        is_normal::<crate::graph::Module>();
41        is_normal::<crate::graph::Edge>();
42        is_normal::<crate::graph::ModuleGraph>();
43        is_normal::<crate::query::TraceResult>();
44        is_normal::<crate::query::TraceSnapshot>();
45        is_normal::<crate::query::DiffResult>();
46        is_normal::<crate::walker::BuildResult>();
47        is_normal::<crate::error::Error>();
48        is_normal::<crate::loader::LoadedGraph>();
49        is_normal::<crate::lang::ParseError>();
50        is_normal::<crate::lang::RawImport>();
51        is_normal::<crate::lang::ParseResult>();
52        is_normal::<crate::lang::ProjectKind>();
53    }
54}
chainsaw/lib.rs

chainsaw/
lib.rs
