Struct ModuleProject 

pub struct ModuleProject { /* private fields */ }

A loaded module project rooted at an exact module.json path.

The project keeps the caller-selected manifest path, exposes the sibling module-lock.json path even when the lockfile is absent, and keeps the manifest in a lossless ManifestDocument so extension fields survive future edits.

Implementations

impl ModuleProject

pub fn validate(&self) -> Result<ContentHash, ProjectValidationError>

Validates this project’s manifest-referenced files and content tree.

The returned digest can be reused for signature verification.

impl ModuleProject

pub fn load(path: impl Into<PathBuf>) -> Result<Self, ProjectError>

Loads a project from the exact module.json path.

The returned value reloads this same path on later reads and derives the sibling module-lock.json path beside it.

pub fn discover(start: &Path) -> Result<Option<Self>, ProjectError>

Discovers the nearest ancestor project starting from start.

This walks each ancestor directory, checking for module.json, and stops at the first .git directory boundary. It returns Ok(None) when no ancestor project exists before that boundary.

pub fn root(&self) -> &Path

Returns the directory containing the loaded module.json.

pub fn manifest_path(&self) -> &Path

Returns the exact module.json path that loaded this project.

pub fn lockfile_path(&self) -> &Path

Returns the sibling module-lock.json path for this project.

The path is stable even when no lockfile exists yet.

pub fn document(&self) -> &ManifestDocument

Returns the lossless module.json document loaded from Self::manifest_path.

pub fn manifest(&self) -> &Manifest

Returns the validated manifest view of the current module.json document.

pub fn reload(&mut self) -> Result<(), ProjectError>

Reloads the exact module.json path from disk.

This keeps the same project root and sibling lockfile path while replacing the in-memory manifest document with the latest bytes.

pub fn load_lockfile(&self) -> Result<Option<Lockfile>, ProjectError>

Loads the sibling module-lock.json when it exists.

See LockedLockfile::read for the locking and empty-file behavior.

pub fn write_manifest( &self, document: &ManifestDocument, ) -> Result<(), ProjectError>

Writes document to this project’s module.json.

The manifest is replaced by an atomic rename, so a reader sees either the previous file or the complete new one. No lock is taken, because a text editor or another tool may rewrite the manifest at any time; the last writer wins.

Trait Implementations

impl Clone for ModuleProject

fn clone(&self) -> ModuleProject

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ModuleProject

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.