Enum Target 

pub enum Target {
    Symbol {
        path: String,
        symbol: String,
    },
    Line {
        path: String,
        line: u32,
        end: u32,
    },
    File {
        path: String,
    },
}

Where a figure’s node, or a stop’s anchor, points. Resolution happens when it is drawn, never when it is written, so it keeps pointing at the right code after an edit moves it.

Variants

Symbol

path#symbol, resolved through the file’s definition spans. The form to prefer: it survives the symbol moving.

Fields

path: String

symbol: String

Line

path:line or path:start-end, 1-based and inclusive.

Fields

path: String

line: u32

end: u32

File

Fields

path: String

Implementations

impl Target

pub fn parse(raw: &str) -> Self

# wins over :, and both win over a bare path, so a file whose name contains either is unaddressable. Naming a symbol is worth more than serving a path POSIX allows and no repo uses.

pub fn path(&self) -> &str

pub fn locate(&self, content: &str) -> Located

Where in content the target lands, in one pass: Found(line) for a target that names a line, Whole for a file, Lost for a symbol the file no longer defines. One call, since resolving a symbol parses the file and asking twice parses it twice.

Trait Implementations

impl Clone for Target

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Target

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

Formats the value using the given formatter.

impl Eq for Target

impl PartialEq for Target

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Target