Struct VName 

pub struct VName {
    pub corpus: String,
    pub root: String,
    pub path: String,
    pub language: String,
    pub signature: String,
}

Kythe-style globally unique identifier for a code entity.

VNames are stable across repos, languages, and time — they form the universal address space of the Travsr graph.

Fields

corpus: String

Logical corpus (e.g. repo URL or org/project).

root: String

Root within the corpus (e.g. branch or build root).

path: String

Path within the root (e.g. src/foo.ts).

language: String

Source language identifier (e.g. typescript, rust).

signature: String

Symbol signature within the file (e.g. class:PaymentService#charge).

Implementations

impl VName

pub fn new( corpus: impl Into<String>, root: impl Into<String>, path: impl Into<String>, language: impl Into<String>, signature: impl Into<String>, ) -> VName

Construct a VName from its five components.

pub fn id(&self) -> NodeId

Stable 64-bit identifier derived from the five-field VName.

The hash is the first 8 bytes of the BLAKE3 digest of: [SIGNATURE_FORMAT_VERSION] || [len_u32_le][corpus] || [len_u32_le][root] || ...

Length-prefix encoding (4-byte little-endian field length before each field) replaces the NUL-separator scheme. This guarantees that no two distinct VNames share the same byte stream, and that a v0 byte stream (which starts with raw corpus bytes) can never equal a v1 stream (which starts with [version_byte][len]). See RFC-002.

Trait Implementations

impl Clone for VName

fn clone(&self) -> VName

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VName

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for VName

fn deserialize<__D>( __deserializer: __D, ) -> Result<VName, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for VName

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for VName

fn eq(&self, other: &VName) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for VName

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for VName

impl StructuralPartialEq for VName