![MusicBrainz] Rust  

[![Latest Version]][crates.io] [![Build Status]][Action]

[Build Status]: https://github.com/RustyNova016/musicbrainzrs/actions/workflows/rustcheck.yaml/badge.svg [Action]: https://github.com/RustyNova016/musicbrainzrs/actions/workflows/rustcheck.yaml [Latest Version]: https://img.shields.io/crates/v/musicbrainz_rs.svg [crates.io]: https://www.crates.io/crates/musicbrainz_rs [MusicBrainz]: https://static.metabrainz.org/MB/header-logo-1f7dc2a.svg

MusicBrainz rust is a utility crate for the the MusicBrainz API.

you may be looking for :

• Api documentation
• The crate

Usage

You can choose to use either the default async client or a blocking one.

async client:

musicbrainz_rs = "0.9.0"

blocking client:

musicbrainz_rs = { version = "0.9.0", default-features = false, features = ["blocking"] }

Features

Note: All the example below use the blocking feature for the sake of conciseness.

Fetch query

To perform a lookups via fetch queries, you need to import the Fetch trait. This can be done using musicbrainz_rs::prelude

use musicbrainz_rs::entity::artist;
use musicbrainz_rs::entity::artist::*;
use musicbrainz_rs::prelude::*;
fn main() {     let nirvana = Artist::fetch()         .id("5b11f4ce-a62d-471e-81fc-a69a8278c7da")         .execute();
asserteq!(nirvana.unwrap().name, "Nirvana".tostring()); }

Include parameters

You can also use includes to get more detail about a resource :

Every Musicbrainz resource has allowed include parameters.

use musicbrainz_rs::entity::label::*;
use musicbrainz_rs::prelude::*;
fn main() {     let ninja_tune = Label::fetch()         .id("dc940013-b8a8-4362-a465-291026c04b42")         .with_tags()         .with_ratings()         .execute()         .unwrap();
assert!(ninja_tune         .tags         .unwrap()         .iter()         .any(|tag| tag.name == "independent"));
assert!(ninjatune.rating.issome()); }

CoverArt query

Release and ReleaseGroup entities in MusicBrainz also allow you to make CoverArt queries on them:

use musicbrainz_rs::entity::release::*;
use musicbrainz_rs::entity::CoverartResponse;
use musicbrainz_rs::prelude::*;
use musicbrainz_rs::FetchCoverart;
fn main() {     // CoverArt Query for a Release.     let inuterocoverart = Release::fetch_coverart()         .id("76df3287-6cda-33eb-8e9a-044b5e15ffdd")         .execute()         .expect("Unable to get cover art");
if let CoverartResponse::Json(coverart) = inuterocoverart {         assert!(!coverart.images[0].back);         assert_eq!(             coverart.images[0].image,             "http://coverartarchive.org/release/76df3287-6cda-33eb-8e9a-044b5e15ffdd/829521842.jpg"         );     } else {         assert!(false);     }
let in_utero = Release::fetch()         .id("76df3287-6cda-33eb-8e9a-044b5e15ffdd")         .execute()         .expect("Unable to get release");
// Calling get_coverart() method on an already fetched Release entity.     let inuterocoverart = in_utero         .get_coverart()         .execute()         .expect("Unable to get coverart");
if let CoverartResponse::Json(coverart) = inuterocoverart {         assert!(!coverart.images[0].back);         assert_eq!(             coverart.images[0].image,             "http://coverartarchive.org/release/76df3287-6cda-33eb-8e9a-044b5e15ffdd/829521842.jpg"         );     } else {         assert!(false);     }
// CoverArt Query Builder to fetch a specific resource.     let inutero500pxfrontcoverart = Release::fetch_coverart()         .id("76df3287-6cda-33eb-8e9a-044b5e15ffdd")         .res_500()         .back()         .execute()         .expect("Unable to get cover art");
if let CoverartResponse::Url(coverarturl) = inutero500pxfront_coverart {         println!("{}", coverart_url);     } else {         assert!(false);     } }

Browse query

Use musicbrainzrs::Browse or bring it in scope using musicbrainzrs::prelude to perform a browse query. Just like Include every muscibrainz resource has allowable linked entities for such queries.

use musicbrainz_rs::entity::artist;
use musicbrainz_rs::entity::artist::Artist;
use musicbrainz_rs::prelude::*;
fn main() {     let artistsoninuterorelease = Artist::browse()         .by_release("18d4e9b4-9247-4b44-914a-8ddec3502103")         .execute();
let artistsoninuterorelease = artistsoninuterorelease.unwrap();
artistsoninuterorelease         .entities         .iter()         .for_each(|artist| println!("{:?}", artist.name)); }

Search query

Use musicbrainzrs::Search to perform a search query.

use musicbrainz_rs::entity::artist::Artist;
use musicbrainz_rs::prelude::*;
fn main() {     musicbrainzrs::config::setuseragent("myawesome_app/1.0");
let query = Artist::query_builder()         .artist("Miles Davis")         .and()         .country("US")         .build();
let query_result = Artist::search(query).execute().unwrap();     let queryresult: Vec<String> = queryresult.entities         .iter()         .map(|artist| artist.name.clone()).collect();
assert!(queryresult.contains(&"Miles Davis".tostring()));     assert!(queryresult.contains(&"Miles Davis Quintet".tostring())); }