ryo-analysis 0.1.0

Code graph and discovery engine for the RYO project
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

//! FileId - Internal high-speed file identifier.
//!
//! Uses SlotMap for O(1) operations with generation counting for dangling detection.

use slotmap::new_key_type;

new_key_type! {
    /// Internal file identifier for fast processing.
    ///
    /// # Properties
    /// - O(1) comparison and hashing
    /// - Generation counter for dangling detection
    /// - 8 bytes fixed size
    ///
    /// # Important: Only obtain through FileRegistry
    ///
    /// FileId must always be obtained through `FileRegistry::register()` or
    /// `FileRegistry::lookup()`. Direct creation is prohibited.
    ///
    /// ```rust,ignore
    /// // Correct usage
    /// let id = file_registry.register(path, crate_name);
    /// let id = file_registry.lookup(&path)?;
    ///
    /// // Prohibited: Direct creation
    /// // let id = FileId::default();  // Compiles but prohibited
    /// ```
    pub struct FileId;
}