numeric-range 0.1.1

Parse and format compact integer-range strings like "1,3-5,7" (page ranges, CPU sets, line selections). Bidirectional, zero-dependency, no_std.
Documentation
  • Coverage
  • 100%
    13 out of 13 items documented1 out of 4 items with examples
  • Size
  • Source code size: 28.11 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 208.72 kB This is the summed size of all files generated by rustdoc for all configured targets
  • Ø build duration
  • this release: 2s Average build duration of successful builds.
  • all releases: 2s Average build duration of successful builds in releases after 2024-10-23.
  • Links
  • Homepage
  • trananhtung/numeric-range
    0 0 0
  • crates.io
  • Dependencies
    • —
  • Versions
  • Owners
  • trananhtung

numeric-range

All Contributors

Crates.io Documentation CI License no_std

Parse and format compact integer-range strings — the familiar "1,3-5,7" syntax from print dialogs (page ranges), CPU affinity lists (taskset, cgroups), line selectors, and CLI flags. Both directions, zero dependencies, #![no_std].

assert_eq!(numeric_range::parse("1,3-5,7").unwrap(), vec![1, 3, 4, 5, 7]);
assert_eq!(numeric_range::format(&[1, 3, 4, 5, 7]), "1,3-5,7");

Why numeric-range?

Rust's existing crates in this space are parse-only or restrictively licensed. numeric-range is a small, permissive (MIT/Apache-2.0), no_std crate that does both parse and compact-format, so you can round-trip a user's --pages flag, normalize a CPU set, or render a selection back to its shortest form.

[dependencies]
numeric-range = "0.1"

API

Function Behavior
parse(&str) -> Result<Vec<u64>, ParseError> "1,3-5,7" → [1,3,4,5,7] (input order preserved)
format(&[u64]) -> String [5,3,4,1,7] → "1,3-5,7" (sorted, de-duplicated, runs collapsed)
  • Whitespace around numbers and separators is tolerated ("1, 3 - 5").
  • Empty input parses to an empty Vec.
  • Errors: empty parts ("1,,2"), non-numbers ("a", "+5"), malformed ranges ("1-2-3"), descending ranges ("5-1"), and ranges that would expand beyond 10 million values (so a tiny untrusted string can't exhaust memory).
  • Values are unsigned (u64), matching page/CPU/line use cases.

no_std

numeric-range is #![no_std] and only needs alloc. It builds for bare-metal targets such as thumbv7em-none-eabi.

Contributors ✨

This project follows the all-contributors specification. Contributions of any kind are welcome — code, docs, bug reports, ideas, reviews! See the emoji key for how each contribution is recognized, and open a PR or issue to get involved.

Thanks goes to these wonderful people:

License

Licensed under either of Apache-2.0 or MIT at your option.