ExDisco.Releases.Release (ex_disco v0.1.0)

Copy Markdown View Source

A specific release (pressing) of a recorded work from Discogs.

Unlike a Master (the abstract work), a Release is a concrete manifestation with specific details: format (vinyl, CD, cassette), country, label, catalog number, release date, and tracklist.

Key Fields

  • :id — Unique Discogs release ID
  • :title — Release title
  • :year — Year of release
  • :released — Release date (YYYY-MM-DD format)
  • :country — Country of origin
  • :status — Release status (Official, Bootleg, etc.)
  • :artists — Main artists (list of ArtistCredit)
  • :extraartists — Guest artists, producers, etc.
  • :tracklist — List of Track structs (songs, movements)
  • :formats — List of Format structs (Vinyl, CD, etc.)
  • :labels — List of label entities
  • :genres — Genre classifications
  • :styles — Genre styles (e.g., "House", "Techno" within electronic)
  • :images — Cover art and other images
  • :community — Community stats (rating, wants, haves)
  • :master_id — Link to the abstract master release (if applicable)
  • :notes — Release notes and condition information

Nested Structures

Many fields are complex nested structs:

Examples

Fetch and explore a release:

{:ok, release} = ExDisco.Releases.get_release(249504)
IO.inspect(release.title)
IO.inspect(release.year)

release.artists
|> Enum.map(&(&1.name))
|> Enum.each(&IO.inspect/1)

release.tracklist
|> Enum.each(&IO.inspect(&1.title))

IO.inspect(release.community.rating.average)

Summary

Types

release_identifier()
t()

Functions

from_api(data)

Types

release_identifier()

@type release_identifier() :: %{type: String.t(), value: String.t()}

t()

@type t() :: %ExDisco.Releases.Release{
  artists: [ExDisco.Types.ArtistCredit.t()],
  community: ExDisco.Releases.Community.t() | nil,
  companies: [ExDisco.Types.CreditEntity.t()],
  country: String.t() | nil,
  data_quality: String.t() | nil,
  date_added: String.t() | nil,
  date_changed: String.t() | nil,
  estimated_weight: non_neg_integer() | nil,
  extraartists: [ExDisco.Types.ArtistCredit.t()],
  format_quantity: non_neg_integer() | nil,
  formats: [ExDisco.Releases.Format.t()],
  genres: [String.t()],
  id: pos_integer(),
  identifiers: [release_identifier()],
  images: [ExDisco.Types.Image.t()],
  labels: [ExDisco.Types.CreditEntity.t()],
  lowest_price: float() | nil,
  master_id: pos_integer() | nil,
  master_url: String.t() | nil,
  notes: String.t() | nil,
  num_for_sale: non_neg_integer() | nil,
  released: String.t() | nil,
  released_formatted: String.t() | nil,
  resource_url: String.t() | nil,
  series: [String.t()],
  status: String.t() | nil,
  styles: [String.t()],
  thumb: String.t() | nil,
  title: String.t(),
  tracklist: [ExDisco.Releases.Track.t()],
  uri: String.t() | nil,
  videos: [ExDisco.Releases.Video.t()],
  year: non_neg_integer() | nil
}

Functions

from_api(data)

@spec from_api(map()) :: t()