Struct Project 

pub struct Project {
    pub root: PathBuf,
    pub manifest: Manifest,
    pub entry: Option<PathBuf>,
}

A project on disk: its manifest, its entry program if it has one, and its directories.

Loading reads no source. Project::shape parses the entry; commands that only need the program set (check, test, fmt) never pay for — or fail on — that parse.

Fields

root: PathBuf

The directory holding Largo.toml.

manifest: Manifest

The parsed manifest.

entry: Option<PathBuf>

The entry program, or None for a site that has none.

Implementations

impl Project

pub fn load(root: &Path) -> Result<Project, CliError>

Load the project rooted at root.

pub fn pages_dir(&self) -> PathBuf

pages/ — one program per .lg file, each served at its own URL.

pub fn static_dir(&self) -> PathBuf

static/ — files served verbatim at root-relative paths.

pub fn has_site(&self) -> bool

Whether the project has a site: a pages/ or a static/ directory.

pub fn shape(&self) -> Result<ProjectShape, CliError>

The shape: ProjectShape::from_facts over Project::has_site and whether the entry’s assembled program contains a Serve statement.

An entry that does not assemble or does not parse is an error here rather than a guess: a full-stack site whose backend has a syntax error must not quietly become a site without one. The error is the same rendered diagnostic largo check prints.

pub fn require_entry(&self) -> Result<&Path, CliError>

The entry program, or the error that says this project is a site and has none — for the commands (run, emit, doc, …) that are about a program.

pub fn shape_or_best_effort(&self) -> ProjectShape

The shape, but NEVER refusing over a parse error: Project::shape’s exact answer when the entry parses, and a shape decided from what can still be read — has_site() (a file- system fact, unaffected by any parse) and a LEXICAL (not grammatical) scan for a Serve statement — when it does not.

A watch-mode dev server exists to survive the author’s mistakes: starting largo serve --watch on a page mid-typo, or a save that breaks it, must still bind a port and show the located error, never refuse to start. Project::shape remains the STRICT form for every other command (check, build, test, fmt, doctor) — they want “and it currently parses” folded into the answer, and their own pipelines report the parse error at the right place regardless (plan_web_bundle’s own comment: “the compile step below reports that at its line, so it is not reported twice here”).

Trait Implementations

impl Clone for Project

fn clone(&self) -> Project

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Project

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

Formats the value using the given formatter.