3 unstable releases

0.2.0 Aug 17, 2022
0.1.1 Aug 17, 2022
0.1.0 Nov 26, 2021

#2967 in Parser implementations

Download history 1/week @ 2024-03-13 2/week @ 2024-03-20 25/week @ 2024-03-27 29/week @ 2024-04-03 6/week @ 2024-05-15 2/week @ 2024-05-22

54 downloads per month
Used in csv-partial-cache

MIT license

9KB
107 lines

License Crates.io Documentation

Fast deserialization of a single csv line.

Usage

#[derive(Debug, PartialEq, serde::Deserialize)]
struct Foo(String, i32);

assert_eq!(csv_line::from_str::<Foo>("foo,42").unwrap(), Foo("foo".into(), 42));
assert_eq!(csv_line::from_str_sep::<Foo>("foo 42", b' ').unwrap(), Foo("foo".into(), 42));

Speed

The performance is comparable with serde_json (lower is better):

test csv_builder ... bench:      16,003 ns/iter (+/- 914)
test csv_core    ... bench:      15,695 ns/iter (+/- 1,155)
test csv_line    ... bench:         240 ns/iter (+/- 14)
test serde_json  ... bench:         124 ns/iter (+/- 5)

The benchmark code is here.

Safety

This crate uses #![forbid(unsafe_code)] to ensure everything is implemented in 100% safe Rust.

Contributing

We appreciate all kinds of contributions, thank you!

Note on README

Most of the readme is automatically copied from the crate documentation by cargo-readme-sync. This way the readme is always in sync with the docs and examples are tested.

So if you find a part of the readme you'd like to change between <!-- cargo-sync-readme start --> and <!-- cargo-sync-readme end --> markers, don't edit README.md directly, but rather change the documentation on top of src/lib.rs and then synchronize the readme with:

cargo sync-readme

(make sure the cargo command is installed):

cargo install cargo-sync-readme

If you have rusty-hook installed the changes will apply automatically on commit.

License

This project is licensed under the MIT license.

Dependencies

~2–2.9MB
~42K SLoC