Struct Session 

pub struct Session { /* private fields */ }

An open dependency-graph session.

Created via Session::open, which loads (or builds) the graph and resolves the entry module. The background cache writer is joined on drop.

Implementations

impl Session

pub fn open(entry: &Path, no_cache: bool) -> Result<Self, Error>

Load a dependency graph from entry and resolve the entry module.

When no_cache is true the on-disk cache is bypassed entirely.

pub fn trace(&self, opts: &TraceOptions) -> TraceResult

Trace transitive import weight from the entry module.

pub fn trace_from( &self, file: &Path, opts: &TraceOptions, ) -> Result<(TraceResult, PathBuf), Error>

Trace transitive import weight from an arbitrary file in the graph.

pub fn resolve_target(&self, arg: &str) -> ResolvedTarget

Resolve a chain/cut argument to a ChainTarget.

If the argument looks like a file path and resolves to a module in the graph, returns ChainTarget::Module. Otherwise falls through to a package name lookup.

pub fn chain( &self, target_arg: &str, include_dynamic: bool, ) -> (ResolvedTarget, Vec<Vec<ModuleId>>)

Find all shortest import chains from the entry to a target.

pub fn cut( &mut self, target_arg: &str, top: i32, include_dynamic: bool, ) -> (ResolvedTarget, Vec<Vec<ModuleId>>, Vec<CutModule>)

Find import chains and optimal cut points to sever them.

pub fn diff_entry( &mut self, other: &Path, opts: &TraceOptions, ) -> Result<(DiffResult, PathBuf), Error>

Trace from a different entry point in the same graph and diff against the current entry. Returns the diff and the canonical path of the other entry (avoids redundant canonicalization by the caller).

pub fn packages(&self) -> &HashMap<String, PackageInfo>

All third-party packages in the dependency graph.

pub fn imports(&self, file: &Path) -> Result<Vec<(PathBuf, EdgeKind)>, Error>

List direct imports of a file (outgoing edges).

pub fn importers(&self, file: &Path) -> Result<Vec<(PathBuf, EdgeKind)>, Error>

List files that import a given file (reverse edge lookup).

pub fn info(&self, package_name: &str) -> Option<&PackageInfo>

Look up package info by name.

pub fn entry_label(&self) -> String

Display label for the current entry point, including the project directory name for disambiguation (e.g. wrangler/src/index.ts).

pub fn entry_label_for(&self, path: &Path) -> String

Display label for an arbitrary path, relative to the project root.

pub fn set_entry(&mut self, path: &Path) -> Result<(), Error>

Switch the default entry point to a different file in the graph.

The file must already be in the graph (no rebuild). Accepts both absolute paths and paths relative to the project root.

pub fn watch(&mut self)

Start watching the project root for file changes.

After calling this, refresh() will short-circuit when no relevant files have changed since the last refresh. Idempotent: calling watch() again replaces the existing watcher.

pub fn is_dirty(&self) -> bool

Whether the watcher has detected changes since the last refresh.

pub fn refresh(&mut self) -> Result<bool, Error>

Check for file changes and rebuild the graph if needed.

Returns true if the graph was updated (cold build or module count changed since the last load).

pub fn trace_report( &mut self, opts: &TraceOptions, top_modules: i32, ) -> TraceReport

Trace and produce a display-ready report.

pub fn trace_from_report( &self, file: &Path, opts: &TraceOptions, top_modules: i32, ) -> Result<(TraceReport, PathBuf), Error>

Trace from a different file and produce a display-ready report.

pub fn chain_report( &self, target_arg: &str, include_dynamic: bool, ) -> ChainReport

Find import chains and produce a display-ready report.

pub fn cut_report( &mut self, target_arg: &str, top: i32, include_dynamic: bool, ) -> CutReport

Find cut points and produce a display-ready report.

pub fn diff_report( &mut self, other: &Path, opts: &TraceOptions, limit: i32, ) -> Result<DiffReport, Error>

Diff two entry points and produce a display-ready report.

pub fn packages_report(&self, top: i32) -> PackagesReport

List packages and produce a display-ready report.

pub fn graph(&self) -> &ModuleGraph

pub fn root(&self) -> &Path

pub fn entry(&self) -> &Path

pub fn entry_id(&self) -> ModuleId

pub fn valid_extensions(&self) -> &'static [&'static str]

pub fn from_cache(&self) -> bool

pub fn unresolvable_dynamic_count(&self) -> usize

pub fn unresolvable_dynamic_files(&self) -> &[(PathBuf, usize)]

pub fn file_warnings(&self) -> &[String]