/cuna

Another cue sheet parser

Primary LanguageRustMIT LicenseMIT

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 for 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.