22 releases
0.5.1 | Oct 11, 2024 |
---|---|
0.4.0 | Jul 29, 2024 |
0.3.5 | Feb 8, 2024 |
0.3.4 | Nov 25, 2023 |
0.1.0 | Dec 26, 2022 |
#167 in Database interfaces
249 downloads per month
125KB
2K
SLoC
CDTOC
CDTOC is a simple Rust library for parsing and working with audio CD tables of contents, namely in the form of CDTOC-style metadata values.
By default it can also generate disc IDs for services like AccurateRip, CDDB, CUETools Database, and MusicBrainz, but you can disable the corresponding crate feature(s) — accuraterip
, cddb
, ctdb
, and musicbrainz
respectively — to shrink the dependency tree if you don't need that functionality.
Examples
use cdtoc::Toc;
// From a CDTOC string.
let toc1 = Toc::from_cdtoc("4+96+2D2B+6256+B327+D84A").unwrap();
// From the raw parts.
let toc2 = Toc::from_parts(
vec![150, 11563, 25174, 45863],
None,
55370,
).unwrap();
// Either way gets you to the same place.
assert_eq!(toc1, toc2);
// You can also get a CDTOC-style string back at any time:
assert_eq!(toc1.to_string(), "4+96+2D2B+6256+B327+D84A");
De/Serialization
The optional serde
crate feature can be enabled to expose de/serialization implementations for this library's types:
Type | Format | Notes |
---|---|---|
AccurateRip |
String |
|
Cddb |
String |
|
Duration |
u64 |
|
ShaB64 |
String |
MusicBrainz and CTDB IDs. |
Toc |
String |
|
Track |
Map |
|
TrackPosition |
String |
Installation
Add cdtoc
to your dependencies
in Cargo.toml
, like:
[dependencies]
cdtoc = "0.5.*"
The disc ID helpers require additional dependencies, so if you aren't using them, be sure to disable the default features (adding back any you do want) to skip the overhead.
[dependencies.cdtoc]
version = "0.5.*"
default-features = false
License
Copyright © 2024 Blobfolio, LLC <hello@blobfolio.com>
This work is free. You can redistribute it and/or modify it under the terms of the Do What The Fuck You Want To Public License, Version 2.
DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
Version 2, December 2004
Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
Everyone is permitted to copy and distribute verbatim or modified
copies of this license document, and changing it is allowed as long
as the name is changed.
DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. You just DO WHAT THE FUCK YOU WANT TO.
Dependencies
~390–780KB
~16K SLoC