Struct Codebase 

pub struct Codebase { /* private fields */ }

The codebase database.

Stores function definitions by content hash, with name mappings. Persisted to disk at ~/.trident/codebase/ (or $TRIDENT_CODEBASE_DIR).

Implementations

impl Codebase

pub fn open() -> Result<Self>

Open or create a codebase at the default location.

Uses $TRIDENT_CODEBASE_DIR if set, otherwise ~/.trident/codebase/.

pub fn open_at(root: &Path) -> Result<Self>

Open or create a codebase at a specific directory.

pub fn add_file(&mut self, file: &File) -> AddResult

Add a parsed file to the codebase: hash all functions, store definitions.

pub fn lookup(&self, name: &str) -> Option<&Definition>

Look up a definition by name.

pub fn hash_for_name(&self, name: &str) -> Option<&ContentHash>

Get the content hash for a name.

pub fn lookup_hash(&self, hash: &ContentHash) -> Option<&Definition>

Look up a definition by hash.

pub fn list_names(&self) -> Vec<(&str, &ContentHash)>

List all names in the codebase, sorted alphabetically.

pub fn rename(&mut self, old_name: &str, new_name: &str) -> Result<(), String>

Rename: rebind new_name to the hash currently bound to old_name, and remove the old_name binding.

pub fn alias(&mut self, name: &str, alias: &str) -> Result<(), String>

Alias: add an additional name pointing to the same hash as name.

pub fn name_history(&self, name: &str) -> Vec<(ContentHash, u64)>

Get history of a name: all hashes it has pointed to, with timestamps.

pub fn names_for_hash(&self, hash: &ContentHash) -> Vec<&str>

Get all names that currently point to a given hash.

pub fn dependencies(&self, hash: &ContentHash) -> Vec<(&str, &ContentHash)>

Get dependencies of a definition: (name, hash) pairs for each called function.

pub fn dependents(&self, hash: &ContentHash) -> Vec<(&str, &ContentHash)>

Get reverse dependencies: definitions that depend on a given hash.

pub fn stats(&self) -> CodebaseStats

Codebase statistics.

pub fn save(&self) -> Result<()>

Save the codebase to disk.

pub fn store_definition(&mut self, hash: ContentHash, def: Definition)

Store a definition directly by hash (used by registry publish).

pub fn bind_name(&mut self, name: &str, hash: ContentHash)

Bind a name to a hash directly (used by registry pull).

pub fn view(&self, name: &str) -> Option<String>

Pretty-print a definition by name.

pub fn lookup_by_prefix( &self, prefix: &str, ) -> Option<(&ContentHash, &Definition)>

Look up a definition by hash prefix (short hex or full hex).