Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vallentin/line-span
Find line ranges and jump between next and previous lines
https://github.com/vallentin/line-span
line lines rust scan scanner
Last synced: 9 days ago
JSON representation
Find line ranges and jump between next and previous lines
- Host: GitHub
- URL: https://github.com/vallentin/line-span
- Owner: vallentin
- License: mit
- Created: 2020-02-10T12:10:45.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-06-12T23:31:55.000Z (over 1 year ago)
- Last Synced: 2024-10-14T14:11:14.826Z (23 days ago)
- Topics: line, lines, rust, scan, scanner
- Language: Rust
- Homepage:
- Size: 42 KB
- Stars: 7
- Watchers: 2
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# line-span
[](https://github.com/vallentin/line-span/actions?query=workflow%3ACI)
[](https://crates.io/crates/line-span)
[](https://docs.rs/line-span)
[](https://github.com/vallentin/line-span)
This crate features utilities for finding the start, end, and range of
lines from a byte index. Further also being able to find the next and
previous line, from an arbitrary byte index.
This is provided via the trait [LineSpanExt], which is
implemented for [`str`], and provides the following methods:
## Usage
Add this to your `Cargo.toml`:
```toml
[dependencies]
line-span = "0.1"
```
## Releases
Release notes are available in the repo at [CHANGELOG.md].
-----
**Current Line:**
- [`find_line_start()`](https://docs.rs/line-span/*/line_span/trait.LineSpanExt.html#tymethod.find_line_start) to find the start of the current line.
- [`find_line_end()`](https://docs.rs/line-span/*/line_span/trait.LineSpanExt.html#tymethod.find_line_end) to find the end of the current line.
- [`find_line_range()`](https://docs.rs/line-span/*/line_span/trait.LineSpanExt.html#tymethod.find_line_range) to find the start and end current line.
**Next Line:**
- [`find_next_line_start()`](https://docs.rs/line-span/*/line_span/trait.LineSpanExt.html#tymethod.find_next_line_start) to find the start of the next line.
- [`find_next_line_end()`](https://docs.rs/line-span/*/line_span/trait.LineSpanExt.html#tymethod.find_next_line_end) to find the end of the next line.
- [`find_next_line_range()`](https://docs.rs/line-span/*/line_span/trait.LineSpanExt.html#tymethod.find_next_line_range) to find the start and end of the next line.
**Previous Line:**
- [`find_prev_line_start()`](https://docs.rs/line-span/*/line_span/trait.LineSpanExt.html#tymethod.find_prev_line_start) to find the start of the previous line.
- [`find_prev_line_end()`](https://docs.rs/line-span/*/line_span/trait.LineSpanExt.html#tymethod.find_prev_line_end) to find the end of the previous line.
- [`find_prev_line_range()`](https://docs.rs/line-span/*/line_span/trait.LineSpanExt.html#tymethod.find_prev_line_range) to find both start and end of the previous line.
**Utilities:**
- [`str_to_range()`] to get the range of a substring in a string.
- [`str_to_range_unchecked()`] unchecked version of [`str_to_range()`].
[`str_to_range`]: https://docs.rs/line-span/*/line_span/fn.str_to_range.html
[`str_to_range_unchecked`]: https://docs.rs/line-span/*/line_span/fn.str_to_range_unchecked.html
## [`LineSpan`] and [`LineSpanIter`]
The crate includes the [`LineSpanIter`] iterator. It is functionally equivalent to [`str::lines()`],
with the addition that it includes the ability to get the start and end byte indices of each line.
Additionally, it also includes the ability to get the end including and excluding the line ending (`\n` or `\r\n`).
An [`LineSpanIter`] can be created by calling [`line_spans()`](https://docs.rs/line-span/*/line_span/trait.LineSpans.html#tymethod.line_spans), implemented in the [`LineSpans`] trait. The crate implements the [`LineSpans`] trait for [`str`] and [`String`].
Note, [`LineSpan`] implements [`Deref`] to [`&str`], so in general,
swapping [`lines()`] to [`line_spans()`] would not cause many issues.
```rust
use line_span::LineSpans;
let text = "foo\nbar\r\nbaz";
for span in text.line_spans() {
println!(
"{:>2?}: {:?} {:?} {:?}",
span.range(),
span.as_str(),
span.as_str_with_ending(),
span.ending_str(),
);
}
```
This will output the following:
_(Manually aligned for better readability)_
```text
0.. 3: "foo" "foo\n" "\n"
4.. 7: "bar" "bar\r\n" "\r\n"
9..12: "baz" "baz" ""
```
## Current Line, Previous Line, and Next Line
```rust
use line_span::LineSpanExt;
let text = "foo\nbar\r\nbaz";
// ^
let i = 5; // 'a' in "bar"
let curr_range = text.find_line_range(i);
let next_range = text.find_next_line_range(i).unwrap();
let prev_range = text.find_prev_line_range(i).unwrap();
assert_eq!(curr_range, 4..7);
assert_eq!(&text[curr_range], "bar");
assert_eq!(prev_range, 0..3);
assert_eq!(&text[prev_range], "foo");
assert_eq!(next_range, 9..12);
assert_eq!(&text[next_range], "baz");
```
## Range of Substring in String
Use [`str_to_range`] (or [`str_to_range_unchecked`]) to get the
range of a substring in a string.
```rust
let string1 = "Foo Bar Baz";
let string2 = "Hello World";
let substring = &string1[4..7]; // "Bar"
// Returns `Some` as `substring` is a part of `string1`
assert_eq!(str_to_range(string1, substring), Some(4..7));
// Returns `None` as `substring` is not a part of `string2`
assert_eq!(str_to_range(string2, substring), None);
```
[CHANGELOG.md]: CHANGELOG.md
[LineSpanExt]: https://docs.rs/line-span/*/line_span/trait.LineSpanExt.html
[`LineSpan`]: https://docs.rs/line-span/*/line_span/struct.LineSpan.html
[`LineSpanIter`]: https://docs.rs/line-span/*/line_span/struct.LineSpanIter.html
[`LineSpans`]: https://docs.rs/line-span/*/line_span/trait.LineSpans.html
[`line_spans()`]: https://docs.rs/line-span/*/line_span/trait.LineSpans.html#tymethod.line_spans
[`Deref`]: https://doc.rust-lang.org/stable/std/ops/trait.Deref.html
[`str_to_range()`]: https://docs.rs/line-span/*/line_span/fn.str_to_range.html
[`str_to_range_unchecked()`]: https://docs.rs/line-span/*/line_span/fn.str_to_range_unchecked.html
[`str`]: https://doc.rust-lang.org/stable/std/primitive.str.html
[`&str`]: https://doc.rust-lang.org/stable/std/primitive.str.html
[`lines()`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.lines
[`str::lines()`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.lines
[`String`]: https://doc.rust-lang.org/stable/std/string/struct.String.html