26 breaking releases

0.32.0 Jun 1, 2021
0.30.0 Apr 21, 2021
0.29.0 Mar 30, 2021
0.24.1 Dec 15, 2020
0.1.0 Nov 27, 2019

#63 in Command-line interface

Download history 259/week @ 2021-02-24 472/week @ 2021-03-03 675/week @ 2021-03-10 266/week @ 2021-03-17 412/week @ 2021-03-24 611/week @ 2021-03-31 296/week @ 2021-04-07 346/week @ 2021-04-14 531/week @ 2021-04-21 311/week @ 2021-04-28 264/week @ 2021-05-05 592/week @ 2021-05-12 263/week @ 2021-05-19 358/week @ 2021-05-26 635/week @ 2021-06-02 306/week @ 2021-06-09

1,752 downloads per month
Used in 39 crates (37 directly)

MIT license

46KB
1.5K SLoC

nu-source

Overview

The nu-source crate contains types and traits used for keeping track of metadata about values being processed. Nu uses Tags to keep track of where a value came from, an AnchorLocation, as well as positional information about the value, a Span. An AnchorLocation can be a Url, File, or Source text that a value was parsed from. The source Text is special in that it is a type similar to a String that comes with the ability to be cheaply cloned. A Span keeps track of a value's start and end positions. These types make up the metadata for a value and are wrapped up together in a Tagged struct, which holds everything needed to track and locate a value.

Nu's metadata system can be seen when reporting errors. In the following example Nu is able to report to the user where the typo of a column originated from.

1 | ls | get typ
  |          ^^^ did you mean 'type'?

In addition to metadata tracking, nu-source also contains types and traits related to debugging, tracing, and formatting the metadata and values it processes.

Other Resources

Dependencies

~0.9–1.5MB
~34K SLoC