Struct ProjectBuilder 

pub struct ProjectBuilder { /* private fields */ }

Builder for assembling a multi-file project into a unified schema.

Files are added one at a time (or by scanning a directory), then assembled into a ProjectSchema via coproduct construction.

Implementations

impl ProjectBuilder

pub fn new() -> Self

Create a new project builder with the default parser registry.

pub fn with_registry(registry: ParserRegistry) -> Self

Create a new project builder with a custom parser registry.

pub fn with_config( cfg: &ProjectConfig, base_dir: &Path, ) -> Result<Self, ProjectError>

Create a project builder configured from a ProjectConfig.

Compiles exclude patterns and builds the per-package protocol override map.

Errors

Returns ProjectError::InvalidPattern if a glob pattern is malformed.

pub fn with_config_and_cache( cfg: &ProjectConfig, base_dir: &Path, file_cache: FileCache, ) -> Result<Self, ProjectError>

Create a project builder configured from a ProjectConfig with an incremental parsing cache.

Behaves like with_config but attaches a FileCache so that unchanged files are not re-parsed.

Errors

Returns ProjectError::InvalidPattern if a glob pattern is malformed.

pub const fn take_cache(&mut self) -> Option<FileCache>

Extract the cache from the builder (e.g., for saving after build).

Returns None if no cache was attached.

pub fn add_file( &mut self, path: &Path, content: &[u8], ) -> Result<(), ProjectError>

Add a single file to the project.

The file’s language is detected from its path. If the language is recognized, the file is parsed via tree-sitter. Otherwise, it is parsed as a raw file (text or binary).

If a cache is attached and the file’s mtime and size match the cached entry, the cached schema is used without re-parsing.

Errors

Returns ProjectError::ParseFailed if parsing fails.

pub fn add_directory(&mut self, dir: &Path) -> Result<(), ProjectError>

Add all files in a directory (recursively).

Skips hidden directories (starting with .) and common build/output directories (target, node_modules, __pycache__, .git, etc.).

Errors

Returns ProjectError if any file fails to read or parse.

pub fn file_count(&self) -> usize

Get the number of files added to the builder.

pub const fn file_schemas(&self) -> &FxHashMap<PathBuf, Schema>

Access the per-file parsed schemas without consuming the builder.

pub const fn protocol_map_ref(&self) -> &FxHashMap<PathBuf, String>

Access the per-file protocol names without consuming the builder.

pub fn build_tree<S>( self, store: &mut S, ) -> Result<ProjectSchemaTree, ProjectError>

where S: Store,

Build the project as a Merkle tree of per-file schemas rather than a flat coproduct schema.

The tree is stored incrementally in store; see build_project_tree for the standalone function form.

Errors

Returns ProjectError::CoproductFailed if the underlying store rejects an object write.

pub fn build(self) -> Result<ProjectSchema, ProjectError>

Build the project schema by constructing the coproduct of all file schemas.

Each file’s vertices are prefixed with the file path to ensure uniqueness in the coproduct. Edges within a file retain their local structure.

Errors

Returns ProjectError::CoproductFailed if construction fails.

Trait Implementations

impl Default for ProjectBuilder

fn default() -> Self

Returns the “default value” for a type.