Struct PathWithPosition 

pub struct PathWithPosition {
    pub path: PathBuf,
    pub row: Option<u32>,
    pub column: Option<u32>,
}

A representation of a path-like string with optional row and column numbers. Matching values example: te, test.rs:22, te:22:5, test.c(22), test.c(22,5)etc.

Fields

path: PathBuf

row: Option<u32>

column: Option<u32>

Implementations

impl PathWithPosition

pub fn from_path(path: PathBuf) -> Self

Returns a PathWithPosition from a path.

pub fn parse_str(s: &str) -> Self

Parses a string that possibly has :row:column or (row, column) suffix. Parenthesis format is used by MSBuild compatible tools Ignores trailing :s, so test.rs:22: is parsed as test.rs:22. If the suffix parsing fails, the whole string is parsed as a path.

Be mindful that test_file:10:1: is a valid posix filename. PathWithPosition class assumes that the ending position-like suffix is not part of the filename.

Examples

assert_eq!(PathWithPosition::parse_str("test_file"), PathWithPosition {
    path: PathBuf::from("test_file"),
    row: None,
    column: None,
});
assert_eq!(PathWithPosition::parse_str("test_file:10"), PathWithPosition {
    path: PathBuf::from("test_file"),
    row: Some(10),
    column: None,
});
assert_eq!(PathWithPosition::parse_str("test_file.rs"), PathWithPosition {
    path: PathBuf::from("test_file.rs"),
    row: None,
    column: None,
});
assert_eq!(PathWithPosition::parse_str("test_file.rs:1"), PathWithPosition {
    path: PathBuf::from("test_file.rs"),
    row: Some(1),
    column: None,
});
assert_eq!(PathWithPosition::parse_str("test_file.rs:1:2"), PathWithPosition {
    path: PathBuf::from("test_file.rs"),
    row: Some(1),
    column: Some(2),
});

Expected parsing results when encounter ill-formatted inputs.

assert_eq!(PathWithPosition::parse_str("test_file.rs:a"), PathWithPosition {
    path: PathBuf::from("test_file.rs:a"),
    row: None,
    column: None,
});
assert_eq!(PathWithPosition::parse_str("test_file.rs:a:b"), PathWithPosition {
    path: PathBuf::from("test_file.rs:a:b"),
    row: None,
    column: None,
});
assert_eq!(PathWithPosition::parse_str("test_file.rs"), PathWithPosition {
    path: PathBuf::from("test_file.rs"),
    row: None,
    column: None,
});
assert_eq!(PathWithPosition::parse_str("test_file.rs::1"), PathWithPosition {
    path: PathBuf::from("test_file.rs"),
    row: Some(1),
    column: None,
});
assert_eq!(PathWithPosition::parse_str("test_file.rs:1::"), PathWithPosition {
    path: PathBuf::from("test_file.rs"),
    row: Some(1),
    column: None,
});
assert_eq!(PathWithPosition::parse_str("test_file.rs::1:2"), PathWithPosition {
    path: PathBuf::from("test_file.rs"),
    row: Some(1),
    column: Some(2),
});
assert_eq!(PathWithPosition::parse_str("test_file.rs:1::2"), PathWithPosition {
    path: PathBuf::from("test_file.rs:1"),
    row: Some(2),
    column: None,
});
assert_eq!(PathWithPosition::parse_str("test_file.rs:1:2:3"), PathWithPosition {
    path: PathBuf::from("test_file.rs:1"),
    row: Some(2),
    column: Some(3),
});

pub fn map_path<E>( self, mapping: impl FnOnce(PathBuf) -> Result<PathBuf, E>, ) -> Result<PathWithPosition, E>

pub fn to_string(&self, path_to_string: impl Fn(&PathBuf) -> String) -> String

Trait Implementations

impl Clone for PathWithPosition

fn clone(&self) -> PathWithPosition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PathWithPosition

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PathWithPosition

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for PathWithPosition

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

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 PathWithPosition

fn eq(&self, other: &PathWithPosition) -> 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 PathWithPosition

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for PathWithPosition

impl StructuralPartialEq for PathWithPosition