12 releases (6 breaking)

0.7.0 Mar 19, 2023
0.6.3 Mar 8, 2022
0.6.2 Jul 21, 2021
0.6.0 Feb 7, 2021
0.1.0 Jul 22, 2020

#1223 in Parser implementations

22 downloads per month

MIT license

42KB
965 lines

cuna

Another simple cue parser for Rust with nom.
Supports cue files in UTF-8 and UTF-8 with BOM.
Current document is not complete and the api is a bit complex, so rcue or libcue.rs (though I can't compile this) may be a better choice.

Usage

crates.io documention

cuna 0.6 has introduced some incompatible changes, go to the release page to see them. Also note that the crate is still 0.x.

If you find anything confusing or that doesn't observe the cue standard, please open an issue.

use cuna::Cuna;
use cuna::error::Error;

fn main() -> Result<(), Error> {
    let file = "tests/EGOIST - Departures ~あなたにおくるアイの歌~.cue";
    let cue = Cuna::open(file)?;
    assert_eq!(cue.comments[0], "GENRE Pop");
    assert_eq!(cue.title(), &["Departures ~あなたにおくるアイの歌~".to_owned()]);
    assert_eq!(cue[0].name, "EGOIST - Departures ~あなたにおくるアイの歌~.flac");
    assert_eq!(cue[0][0].performer(), &["EGOIST".to_owned()]);
    Ok(())
}

Performance

This crate is not too slow, I think.

Here's a benchmark with a 42-line cue file (may be outdated).
Only test Cuna::from_utf8_with_bom() (now called Cuna::from_str()) with i5-7300HQ.

cuna                    time:   [21.899 us 21.962 us 22.033 us]
                        change: [-1.1745% -0.3960% +0.3489%] (p = 0.31 > 0.05)
                        No change in performance detected.
Found 3 outliers among 100 measurements (3.00%)
  1 (1.00%) high mild
  2 (2.00%) high severe

You can run cargo bench for more exact data.

Dependencies

~1–1.7MB
~35K SLoC