Struct ClasspathIndex 

pub struct ClasspathIndex {
    pub version: u32,
    pub string_table: Vec<String>,
    pub classes: Vec<ClassStub>,
    pub package_index: HashMap<String, (usize, usize)>,
    pub annotation_index: HashMap<String, Vec<usize>>,
}

Merged classpath index for fast FQN lookup.

Combines all per-JAR stubs into a single sorted index with secondary indices for package and annotation lookup.

Persisted at: .sqry/classpath/index.sqry

Fields

version: u32

Format version (independent from graph snapshot version).

string_table: Vec<String>

Local string table for deduplication within the index.

Reserved for future optimisation; currently populated with unique FQN strings but not used for indirection.

classes: Vec<ClassStub>

Classes sorted by FQN for binary search.

package_index: HashMap<String, (usize, usize)>

Package index: package name to (start, end) range of indices into classes. The range is half-open: classes[start..end].

annotation_index: HashMap<String, Vec<usize>>

Annotation index: annotation FQN to list of class indices in classes that carry that annotation.

Implementations

impl ClasspathIndex

pub fn build(stubs: Vec<ClassStub>) -> Self

Build an index from collected stubs.

1. Sorts classes by FQN.
2. Builds the package index (groups consecutive classes by package prefix).
3. Builds the annotation index (scans all class-level annotations).
4. Populates the string table with unique FQNs.

pub fn lookup_fqn(&self, fqn: &str) -> Option<&ClassStub>

Look up a class by fully qualified name (binary search).

Returns None if no class with the given FQN exists in the index.

pub fn lookup_package(&self, package: &str) -> &[ClassStub]

Look up all classes in a package.

Returns an empty slice if the package is not found.

pub fn lookup_annotated(&self, annotation_fqn: &str) -> Vec<&ClassStub>

Look up classes with a specific annotation.

Returns an empty vec if no classes carry the given annotation.

pub fn save(&self, path: &Path) -> ClasspathResult<()>

Persist the index to disk at the given path.

Uses atomic write (temp file + rename) to prevent corrupt reads.

Errors

Returns ClasspathError::IndexError on serialization or I/O failure.

pub fn load(path: &Path) -> ClasspathResult<Self>

Load the index from disk.

Errors

Returns ClasspathError::IndexError if:

• The file cannot be read.
• The file cannot be deserialized.
• The format version does not match CLASSPATH_INDEX_VERSION.

Trait Implementations

impl Clone for ClasspathIndex

fn clone(&self) -> ClasspathIndex

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClasspathIndex

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ClasspathIndex

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ClasspathIndex

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

where __S: Serializer,

Serialize this value into the given Serde serializer.