wojtek/musichoard
1
0
Fork 0
Code Issues 12 Pull Requests Actions Packages Projects 1 Releases 2 Wiki Activity

First draft of public data structures #2

Merged
wojtek merged 2 commits from 1---first-draft-of-public-data-structures into main 2023-03-29 02:46:49 +02:00
Conversation 0 Commits 2 Files Changed 3 +11 -9
1 changed files with 11 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit 057808c1cc - Show all commits

20
src/lib.rs
View File

@ -1,35 +1,37 @@
//! MusicHoard - a music collection manager.
use serde::{Deserialize, Serialize}; use serde::{Deserialize, Serialize};
use uuid; use uuid;
/// The [MusicBrainz Identifier](https://musicbrainz.org/doc/MusicBrainz_Identifier). /// [MusicBrainz Identifier](https://musicbrainz.org/doc/MusicBrainz_Identifier) (MBID).
type Mbid = uuid::Uuid; pub type Mbid = uuid::Uuid;
/// An artist. May be linked to MusicBrainz. /// [Artist](https://musicbrainz.org/doc/Artist).
#[derive(Deserialize, Serialize)] #[derive(Deserialize, Serialize)]
pub struct Artist { pub struct Artist {
pub name: String, pub name: String,
pub mbid: Option<Mbid>, pub mbid: Option<Mbid>,
} }
/// A single track on a release. /// [Track](https://musicbrainz.org/doc/Track).
#[derive(Deserialize, Serialize)] #[derive(Deserialize, Serialize)]
pub struct Track { pub struct Track {
pub number: u32, pub number: u32,
pub title: String, pub title: String,
pub artist: Artist, pub artist: Artist,
pub mbid: Option<Mbid>,
} }
/// MusicHoard release corresponds to MusicBrainz' concept of a release. However, it does not link /// [Release](https://musicbrainz.org/doc/Release).
/// to MusicBrainz as the intention of MusicHoard is to manage releases locally.
#[derive(Deserialize, Serialize)] #[derive(Deserialize, Serialize)]
pub struct Release { pub struct Release {
pub title: String, pub title: String,
pub artist: String, pub artist: String,
pub tracks: Vec<Track>, pub tracks: Vec<Track>,
pub mbid: Option<Mbid>,
} }
/// MusicHoard uses MusicBrainz [primary release group /// [Release group primary type](https://musicbrainz.org/doc/Release_Group/Type).
/// type](https://musicbrainz.org/doc/Release_Group/Type)
#[derive(Deserialize, Serialize)] #[derive(Deserialize, Serialize)]
pub enum ReleaseGroupType { pub enum ReleaseGroupType {
Album, Album,
@ -38,7 +40,7 @@ pub enum ReleaseGroupType {
Other, Other,
} }
/// MusicHoard uses MusicBrainz' [Release Group concept](https://musicbrainz.org/doc/Release_Group). /// [Release group](https://musicbrainz.org/doc/Release_Group).
#[derive(Deserialize, Serialize)] #[derive(Deserialize, Serialize)]
pub struct ReleaseGroup { pub struct ReleaseGroup {
pub r#type: ReleaseGroupType, pub r#type: ReleaseGroupType,