Struct SymbolSet 

pub struct SymbolSet {
    pub symbol_ids: Vec<String>,
}

SymbolSet - a collection of SymbolIds for filtering search results.

This type represents a set of symbols identified by their 32-character BLAKE3 hash SymbolIds. It can be loaded from JSON files or extracted from Magellan algorithm outputs.

JSON Format

{
  "symbol_ids": [
    "abc123def456789012345678901234ab",
    "def456789012345678901234abcd1234",
    ...
  ]
}

Example

use llmgrep::algorithm::SymbolSet;
use std::path::Path;

let symbol_set = SymbolSet::from_file(Path::new("symbols.json"))?;
symbol_set.validate()?;

Fields

symbol_ids: Vec<String>

List of SymbolIds (32-char BLAKE3 hashes)

Implementations

impl SymbolSet

pub fn from_file(path: &Path) -> Result<Self, LlmError>

Load SymbolSet from a JSON file.

Arguments

• path - Path to the JSON file containing SymbolSet data

Returns

A validated SymbolSet if the file exists and contains valid JSON.

Errors

Returns LlmError::IoError if the file cannot be read. Returns LlmError::JsonError if the JSON is invalid or malformed.

Example

use llmgrep::algorithm::SymbolSet;
use std::path::Path;

let symbol_set = SymbolSet::from_file(Path::new("reachable.json"))?;

pub fn validate(&self) -> Result<(), LlmError>

Validate that all SymbolIds are in the correct format (32 hex characters).

Magellan SymbolIds are 32-character BLAKE3 hashes represented as lowercase hexadecimal strings. This method validates that format.

Returns

Ok(()) if all SymbolIds are valid.

Errors

Returns LlmError::InvalidQuery if any SymbolId has an invalid format.

Example

use llmgrep::algorithm::SymbolSet;

let symbol_set = SymbolSet {
    symbol_ids: vec![
        "abc123def456789012345678901234ab".to_string(),
    ],
};
assert!(symbol_set.validate().is_ok());

pub fn is_empty(&self) -> bool

Check if the SymbolSet is empty.

pub fn len(&self) -> usize

Return the number of SymbolIds in the set.

Trait Implementations

impl Clone for SymbolSet

fn clone(&self) -> SymbolSet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SymbolSet

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SymbolSet

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SymbolSet

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

where __S: Serializer,

Serialize this value into the given Serde serializer.