Enum Roots 

pub enum Roots {
    Single(PathBuf),
    Split {
        project_root: PathBuf,
        paths: ProjectPaths,
    },
}

Where a project’s .bynk files live.

Variants

Single(PathBuf)

A single tree walked as one root (in-memory builds and legacy single-file/single-tree inputs).

Split

v0.113 (DECISION S): a project rooted at project_root, with a flat include/exclude layout (ProjectPaths). Test-ness is structural (a suite declaration), so there is no source/test role split — the tree is walked for .bynk files and each declaration is partitioned by kind.

Fields

project_root: PathBuf

paths: ProjectPaths

Implementations

impl Roots

pub fn trees(&self) -> Vec<(PathBuf, PathBuf)>

Every include tree this project’s roots resolve to, each paired with its project-root-relative include prefix — joined onto that tree’s (root-relative) source_path to build each file’s identity_path (empty for a single-root project). A file’s identity path is relative to the root that contains it.

R3.9 (#1113): [paths] include is no longer capped at a hardcoded primary/secondary pair — every entry becomes its own tree, walked and discovered like any other. pub so bynk-driver walks exactly the trees compile_project would, rather than a hand-duplicated copy that can silently drift from this one.

Two include entries that resolve to the same absolute root (a typo like ["src", "src"], or two entries a symlink/.. makes equal) collapse to that root’s first occurrence — the old Roots::resolve this replaces skipped a secondary tree equal to the primary the same way (split_mode = src_root != tests_root); without this a duplicate entry would be walked and parsed twice, producing spurious duplicate-name diagnostics. An empty include list falls back to one tree at project_root itself, matching Roots::resolve’s old unwrap_or_default() primary — every caller that reaches trees() is meant to go through ProjectPaths::conventional/ try_read_project_paths, which never produce an empty list, but ProjectPaths’s fields are pub and this keeps a caller that constructs one directly from indexing an empty Vec.

pub fn project_root(&self) -> &Path

Where bynk.schema.lock lives — distinct from Self::trees’s per-include roots, since a Split layout’s roots are subdirectories of the project root, but the registry belongs beside bynk.toml, one level up, the same place bynk.deploy.lock lives.

#1085 review: used only to give schema_registry::parse’s corruption diagnostic a real location again — #1078 made bynk-emit disk-free for this file, which cost the absolute path the old message carried. Never used for I/O; bynk-driver’s own schema_lock::lock_path is the one that actually names the file for its own error messages.

pub fn excludes(&self) -> Vec<PathBuf>

Absolute subtrees to skip during discovery: the author’s exclude list plus the tool’s own build-output and dependency caches (out, node_modules), so a project whose include is the root does not sweep up generated or vendored files.

Trait Implementations

impl Clone for Roots

fn clone(&self) -> Roots

Returns a duplicate of the value.

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

Performs copy-assignment from source.