Struct Import 

pub struct Import {
    pub name: String,
    pub path: Vec<String>,
    pub depth: usize,
    pub line: usize,
}

A name brought into a file’s scope, and the module path it came from.

Recorded as a lexical scoping signal, not a resolved path (#252). use crate::model::Symbol says that in this file Symbol came from a module called model, which is enough to prefer a definition under model.rs over a same-named one elsewhere — without needing to know where a crate root is, and so without extraction depending on any file but this one (ADR 0012).

Relative markers (crate, self, super, ., ..) are stripped: they position the path rather than naming a module.

Fields

name: String

The name as this file will write it — the alias when there is one.

Empty when the import brings in a whole file rather than one name: a C/C++ #include names a path, not a symbol (#267). Test that with brings_whole_file rather than comparing against the empty string, so the intent is visible at the call site.

path: Vec<String>

The module path segments before the name, outermost first.

depth: usize

How many dots a relative import leads with; 0 when absolute.

A Python relative import is the one module path resolvable with no project root at all: from ..pkg import X means “my parent package, then pkg”, which is arithmetic on the referencing file’s own path. Dropping the dots threw that away and left the module to be matched as a free-floating suffix against every candidate (#261).

Omitted from the serialized slice when zero, so a file with only absolute imports keeps a byte-identical slice.

line: usize

Implementations

impl Import

pub fn brings_whole_file(&self) -> bool

Whether this import brings in a whole file rather than one name.

A #include names a path — every declaration in that file becomes visible — so it has no single name to key on the way every other import does. Resolution matches it by path instead (#267).

Trait Implementations

impl Clone for Import

fn clone(&self) -> Import

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Import

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Import

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Import

impl PartialEq for Import

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Import

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Import