#string-processing #file-line #line-column #information #spans

spanned

string processing with file/line/col information and the regular rust str API

10 releases

0.3.0 Jul 24, 2024
0.2.1 May 21, 2024
0.1.6 Feb 27, 2024
0.1.5 Nov 13, 2023
0.1.3 Oct 22, 2023

#7 in #line-column

Download history 6642/week @ 2024-08-12 4459/week @ 2024-08-19 4224/week @ 2024-08-26 4865/week @ 2024-09-02 5000/week @ 2024-09-09 5123/week @ 2024-09-16 4492/week @ 2024-09-23 3931/week @ 2024-09-30 4921/week @ 2024-10-07 4330/week @ 2024-10-14 4331/week @ 2024-10-21 4755/week @ 2024-10-28 4191/week @ 2024-11-04 4064/week @ 2024-11-11 4365/week @ 2024-11-18 4451/week @ 2024-11-25

17,693 downloads per month
Used in 3 crates (via ui_test)

MIT/Apache

10KB
240 lines

Simple span handling for str and &[u8]

This crate exposes some of the methods that exist on str or bstr. If you are missing any you need, please open issues or PRs.

The basic usage is to read from a file and then use the methods to modify it:

let file = Spanned<String>::read_from_file(path)?;
for line in file.lines() {
    if let Some(rest) = line.strip_prefix("cake:") {
        println!("found a cake at {}: {}", rest.span.line_start, *rest);
    }
}

any Spanned object will always know its file, line and column information and correctly preserve it across operations that take subslices. The column information is counted in the number of utf8 characters, which is not entirely correct. Please open an issue if you encounter this to be a problem.

Dependencies

~3.5–10MB
~79K SLoC