Struct FileRegistry 

pub struct FileRegistry { /* private fields */ }

Central file management registry.

Responsibilities

• Bidirectional conversion: WorkspaceFilePath ↔ FileId
• File lifecycle management

Thread Safety

• Read operations are thread-safe
• Write operations require exclusive control

Implementations

impl FileRegistry

pub fn new() -> Self

Create a new registry.

pub fn with_capacity(capacity: usize) -> Self

Create a registry with pre-allocated capacity.

pub fn register(&mut self, path: WorkspaceFilePath) -> FileId

Register a file (returns existing ID if already registered).

Returns

• FileId: Registration success (new or existing)

pub fn remove(&mut self, id: FileId) -> Option<WorkspaceFilePath>

Remove a file from the registry.

Returns

• Some(WorkspaceFilePath): The removed file’s path
• None: File not found

pub fn lookup(&self, path: &WorkspaceFilePath) -> Option<FileId>

WorkspaceFilePath → FileId (O(1) hash lookup).

pub fn path(&self, id: FileId) -> Option<&WorkspaceFilePath>

FileId → WorkspaceFilePath (O(1) array access).

pub fn crate_name(&self, id: FileId) -> Option<&str>

FileId → crate name (convenience method).

pub fn contains(&self, id: FileId) -> bool

Check if FileId is valid (including generation check).

pub fn update_path( &mut self, id: FileId, new_path: WorkspaceFilePath, ) -> Result<WorkspaceFilePath, InvalidFileId>

Update file path (e.g., after rename/move).

This updates the path while preserving the FileId.

pub fn iter(&self) -> impl Iterator<Item = (FileId, &WorkspaceFilePath)>

Iterate over all files.

pub fn iter_in_crate<'a>( &'a self, crate_name: &'a str, ) -> impl Iterator<Item = FileId> + 'a

Iterate over files in a specific crate.

pub fn len(&self) -> usize

Get the number of registered files.

pub fn is_empty(&self) -> bool

Check if the registry is empty.

Trait Implementations

impl Clone for FileRegistry

fn clone(&self) -> FileRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for FileRegistry

fn default() -> Self

Returns the “default value” for a type.

impl Serialize for FileRegistry

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.