2 unstable releases

0.3.0 Mar 23, 2023
0.2.2 Nov 8, 2022
0.2.1 Oct 26, 2022
0.2.0 Feb 17, 2021
0.1.0 Jun 7, 2020

#252 in Encoding

Download history 33467/week @ 2023-11-25 32399/week @ 2023-12-02 31002/week @ 2023-12-09 26759/week @ 2023-12-16 17845/week @ 2023-12-23 28638/week @ 2023-12-30 39041/week @ 2024-01-06 36838/week @ 2024-01-13 41215/week @ 2024-01-20 42758/week @ 2024-01-27 39157/week @ 2024-02-03 34945/week @ 2024-02-10 33204/week @ 2024-02-17 34162/week @ 2024-02-24 32877/week @ 2024-03-02 13330/week @ 2024-03-09

119,016 downloads per month
Used in 326 crates (11 directly)

MIT license

13KB
201 lines

newline-converter

newline-converter is a simple library used for converting the newline characters in strings between Windows \r\n and Unix \n style. It mainly serves as a backend for Rust Newline converter CLI tool.

Crates.io

Comparision of newline-wrangling methods

newline-converter (this crate)

  • ✅ Properly handles edge-cases like lone \r characters. For example, \r\n sequences won't become \r\r\n after unix2dos call:
    use newline_converter::unix2dos;
    assert_eq!(
      unix2dos("\nfoo\r\nbar\n"),
      "\r\nfoo\rbar\n"
    );
    
  • ✅ Is the fastest when input data is small (few bytes of text with line breaks).
  • ❌ Is the slowest (or second slowest in case of unix2dos) when dealing with larger data sets (ex. 100 paragraphs of Lorem Ipsum).

string.replace

  • ❌ Does not handle edge cases properly in unix2dos.
  • ✅ Good performance on larger data sets.

regex crate Regex::replace_all

  • ❌ Does not handle edge cases properly in unix2dos, because of lack of support for look around.
  • ✅ The best performance with larger data sets.

fancy-regex crate Regex::replace_all

  • ✅ Properly handles edge cases.
  • unix2dos has worst performance of all implementations, by an order of magnitude (because of look around used).

Look into benches/bench.rs for the comparision benchmarks.

MSRV

Minimum Supported Rust Version is 1.38.0.

Dependencies

~555KB