Struct Project 

pub struct Project { /* private fields */ }

A project loaded entirely in memory as PureFile ASTs.

This is a pure data container with I/O capabilities. For transformations, use ryo-executor::Workspace. For searching, use ryo-analysis::DiscoveryEngine.

Fields

• config_root: Location of ryo.toml (or where it would be)
• metadata: Cargo workspace metadata (crate info, paths)
• config: Project configuration from ryo.toml
• files: Loaded source files

Implementations

impl Project

pub fn load(path: impl AsRef<Path>) -> Result<Self, ProjectError>

Load a project from disk

Workflow

1. Look for ryo.toml in the given directory
2. Determine Cargo.toml location from config or auto-detect
3. Create CargoMetadataProvider for workspace info
4. Load files by traversing mod declarations from entry points

Arguments

• path - Directory containing the project (with or without ryo.toml)

pub fn config_root(&self) -> &Path

Get the config root (where ryo.toml is or would be)

pub fn workspace_root(&self) -> &Path

Get the workspace root (from Cargo metadata)

pub fn root(&self) -> &Path

Get the root path (alias for workspace_root for backward compatibility)

pub fn metadata(&self) -> &CargoMetadataProvider

Get the Cargo metadata provider

pub fn config(&self) -> &RyoConfig

Get the project configuration

pub fn path_resolver(&self) -> WorkspacePathResolver

Create a WorkspacePathResolver for this project

Uses workspace type from CargoMetadataProvider to correctly validate crate:: paths (ambiguous in multi-crate workspaces).

pub fn file_paths(&self) -> impl Iterator<Item = &PathBuf>

Get all file paths

pub fn files(&self) -> &HashMap<PathBuf, PureFile>

Get all files

pub fn files_mut(&mut self) -> &mut HashMap<PathBuf, PureFile>

Get mutable access to files

pub fn file_count(&self) -> usize

Number of files loaded

pub fn resolve_path(&self, path: &Path) -> Option<PathBuf>

Resolve a path to the actual key in the files HashMap. Handles both relative and absolute paths.

pub fn get_file(&self, path: &Path) -> Option<&PureFile>

Get a file by path

pub fn get_file_mut(&mut self, path: &Path) -> Option<&mut PureFile>

Get a mutable file by path

pub fn insert_file(&mut self, path: PathBuf, file: PureFile)

Insert or update a file

pub fn get_file_with_path(&self, path: &Path) -> Option<(PathBuf, &PureFile)>

Get a file and its resolved path

pub fn get_file_mut_with_path( &mut self, path: &Path, ) -> Option<(PathBuf, &mut PureFile)>

Get a mutable file and its resolved path

pub fn contains_file(&self, path: &Path) -> bool

Check if a file exists

pub fn get_source(&self, path: &Path) -> Result<Option<String>, ProjectError>

Get generated source for a file

pub fn write_to_disk(&self, paths: &[PathBuf]) -> Result<usize, ProjectError>

Write modified files back to disk

Creates parent directories if they don’t exist (for newly created files).

pub fn write_all_to_disk(&self) -> Result<usize, ProjectError>

Write all files to disk

pub fn load_files( root: impl AsRef<Path>, ) -> Result<HashMap<PathBuf, PureFile>, ProjectError>

Load files from a project directory without creating a Project instance.

This is the preferred method for the Context-centric design where AnalysisContext is the Single Source of Truth for file content.

Example

let files = Project::load_files("/path/to/project")?;
let context = AnalysisContext::from_path_files(files, "crate");

pub fn write_from_context( &self, ctx: &AnalysisContext, files: &[WorkspaceFilePath], ) -> Result<usize, ProjectError>

Write modified files from an AnalysisContext to disk.

Arguments

• ctx - The AnalysisContext containing the modified files
• files - The WorkspaceFilePaths of the files to write

Returns

The number of files successfully written to disk.

pub fn sync_from_context( &mut self, ctx: &AnalysisContext, files: &[WorkspaceFilePath], )

Sync modified files from Context back to Project.files.

Maintains backward compatibility for code that still reads from Project.files.