musicz 0.0.1

data/lib/musicz/entities/artist_credit.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require "musicz/entity"
+require "musicz/entities/artist_reference"
+
+module Musicz
+  module Entities
+    class ArtistCredit < Entity
+      attribute :name, Types::Strict::String
+      attribute? :joinphrase, Types::Strict::String.optional
+      attribute? :artist, ArtistReference
+    end
+  end
+end

data/lib/musicz/entities/artist_list.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require "musicz/entity"
+require "musicz/entities/artist"
+
+module Musicz
+  module Entities
+    class ArtistList < Entity
+      attribute :created, Types::Strict::String
+      attribute :count, Types::JSON::Decimal
+      attribute :offset, Types::JSON::Decimal
+      attribute :artists, Types::Array.of(Artist)
+    end
+  end
+end

data/lib/musicz/entities/artist_reference.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require "musicz/entity"
+
+module Musicz
+  module Entities
+    class ArtistReference < Entity
+      attribute :id, Types::Strict::String
+      attribute :name, Types::Strict::String
+      attribute? :sort_name, Types::Strict::String.optional
+      attribute? :disambiguation, Types::Strict::String.optional
+    end
+  end
+end

data/lib/musicz/entities/disc_id.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "musicz/entity"
+
+module Musicz
+  module Entities
+    class DiscId < Entity
+      attribute :id, Types::Strict::String
+      attribute :sectors, Types::Strict::Integer
+    end
+  end
+end

data/lib/musicz/entities/error.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "musicz/entity"
+
+module Musicz
+  module Entities
+    class Error < Entity
+      attribute :error, Types::Strict::String
+      attribute? :help, Types::Strict::String.optional
+    end
+  end
+end

data/lib/musicz/entities/label_info_reference.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require "musicz/entity"
+
+module Musicz
+  module Entities
+    class LabelInfoReference < Entity
+      attribute :label do
+        attribute :id, Types::Strict::String
+        attribute :name, Types::Strict::String
+        attribute :sort_name, Types::Strict::String
+        attribute? :label_code, Types::Strict::String.optional
+        attribute? :disambiguation, Types::Strict::String.optional
+      end
+      attribute? :catalog_number, Types::Strict::String.optional
+    end
+  end
+end

data/lib/musicz/entities/life_span.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require "musicz/entity"
+
+module Musicz
+  module Entities
+    class LifeSpan < Entity
+      attribute :ended, Types::Strict::Bool.default(false)
+      attribute? :begin, Types::Strict::String.optional
+      attribute? :end, Types::Strict::String.optional
+    end
+  end
+end

data/lib/musicz/entities/media.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require "musicz/entity"
+require "musicz/entities/disc_id"
+require "musicz/entities/track"
+
+module Musicz
+  module Entities
+    class Media < Entity
+      attribute :track_offset, Types::Strict::Integer
+      attribute :track_count, Types::Strict::Integer
+      attribute :title, Types::Strict::String
+      attribute :format, Types::Strict::String
+      attribute :discids, Types::Array.of(DiscId).default([].freeze)
+      attribute :tracks, Types::Array.of(Track).default([].freeze)
+    end
+  end
+end

data/lib/musicz/entities/rating.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "musicz/entity"
+
+module Musicz
+  module Entities
+    class Rating < Entity
+      attribute :votes_count, Types::Strict::Integer
+      attribute :value, Types::JSON::Decimal
+    end
+  end
+end

data/lib/musicz/entities/recording.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require "musicz/entity"
+require "musicz/entities/artist_credit"
+require "musicz/entities/release_reference"
+
+module Musicz
+  module Entities
+    class Recording < Entity
+      attribute :id, Types::Strict::String
+      attribute :title, Types::Strict::String
+      attribute? :disambiguation, Types::Strict::String.optional
+      attribute? :score, Types::Strict::Integer.optional
+      attribute? :artist_credit, Types::Array.of(ArtistCredit)
+      attribute? :length, Types::JSON::Decimal.optional
+      attribute? :isrcs, Types::Array.of(Types::Strict::String)
+        .default([].freeze)
+      attribute? :releases, Types::Array.of(ReleaseReference)
+    end
+  end
+end

data/lib/musicz/entities/recording_list.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require "musicz/entity"
+require "musicz/entities/recording"
+
+module Musicz
+  module Entities
+    class RecordingList < Entity
+      attribute :created, Types::Strict::String
+      attribute :count, Types::JSON::Decimal
+      attribute :offset, Types::JSON::Decimal
+      attribute :recordings, Types::Array.of(Recording)
+    end
+  end
+end

data/lib/musicz/entities/recording_reference.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require "musicz/entity"
+
+module Musicz
+  module Entities
+    class RecordingReference < Entity
+      attribute :id, Types::Strict::String
+      attribute :title, Types::Strict::String
+      attribute? :disambiguation, Types::Strict::String.optional
+    end
+  end
+end

data/lib/musicz/entities/release.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "musicz/entity"
+require "musicz/entities/text_representation"
+require "musicz/entities/artist_credit"
+require "musicz/entities/label_info_reference"
+require "musicz/entities/media"
+
+module Musicz
+  module Entities
+    class Release < Entity
+      attribute :id, Types::Strict::String
+      attribute :title, Types::Strict::String
+      attribute? :date, Types::Strict::String.optional
+      attribute? :text_representation, TextRepresentation.optional
+      attribute? :country, Types::Strict::String.optional
+      attribute? :status, Types::Strict::String.optional
+      attribute? :quality, Types::Strict::String.optional
+      attribute? :packaging, Types::Strict::String.optional
+      attribute? :barcode, Types::Strict::String.optional
+      attribute? :status_id, Types::Strict::String.optional
+      attribute? :artist_credit, Types::Array.of(ArtistCredit)
+      attribute? :label_info, Types::Array.of(LabelInfoReference)
+      attribute? :asin, Types::Strict::String.optional
+      attribute? :disambiguation, Types::Strict::String.optional
+      attribute? :media, Media.optional
+
+      attribute? :release_group do
+        attribute :id, Types::Strict::String
+        attribute :primary_type, Types::Strict::String
+      end
+
+      attribute :release_events, Types::Array.of(ReleaseEvent)
+        .default([].freeze)
+    end
+  end
+end

data/lib/musicz/entities/release_event.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require "musicz/entity"
+require "musicz/entities/area"
+
+module Musicz
+  module Entities
+    class ReleaseEvent < Entity
+      attribute :date, Types::Strict::String
+      attribute :area, Area
+    end
+  end
+end

data/lib/musicz/entities/release_group.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require "musicz/entity"
+
+module Musicz
+  module Entities
+    class ReleaseGroup < Entity
+      attribute :id, Types::Strict::String
+      attribute :type_id, Types::Strict::String
+      attribute? :title, Types::Strict::String.optional
+      attribute? :primary_type, Types::Strict::String.optional
+    end
+  end
+end

data/lib/musicz/entities/release_reference.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require "musicz/entity"
+require "musicz/entities/text_representation"
+require "musicz/entities/release_event"
+require "musicz/entities/release_group"
+
+module Musicz
+  module Entities
+    class ReleaseReference < Entity
+      attribute :id, Types::Strict::String
+      attribute :title, Types::Strict::String
+      attribute? :status, Types::Strict::String.optional
+      attribute? :disambiguation, Types::Strict::String.optional
+      attribute? :date, Types::Strict::String.optional
+      attribute? :country, Types::Strict::String.optional
+      attribute? :release_group, ReleaseGroup.optional
+    end
+  end
+end

data/lib/musicz/entities/tag.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "musicz/entity"
+
+module Musicz
+  module Entities
+    class Tag < Entity
+      attribute :count, Types::Strict::Integer
+      attribute :name, Types::Strict::String
+    end
+  end
+end

data/lib/musicz/entities/text_representation.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "musicz/entity"
+
+module Musicz
+  module Entities
+    class TextRepresentation < Entity
+      attribute :language, Types::Strict::String
+      attribute :script, Types::Strict::String
+    end
+  end
+end

data/lib/musicz/entities/track.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require "musicz/entity"
+require "musicz/entities/recording_reference"
+require "musicz/entities/artist_credit"
+
+module Musicz
+  module Entities
+    class Track < Entity
+      attribute :number, Types::Strict::String
+      attribute :length, Types::Strict::Integer
+      attribute :title, Types::Strict::String
+      attribute :recording, RecordingReference
+      attribute :artist_credit, ArtistCredit
+    end
+  end
+end

data/lib/musicz/entity.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require "dry-struct"
+require "musicz/types"
+
+module Musicz
+  class Entity < Dry::Struct
+    transform_keys do |key|
+      key.to_s.tr("-", "_").to_sym
+    end
+
+    transform_types do |type|
+      if type.default?
+        type.constructor do |value|
+          value.nil? ? Dry::Types::Undefined : value
+        end
+      else
+        type
+      end
+    end
+  end
+end

data/lib/musicz/request.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "uri"
+require "typhoeus"
+
+module Musicz
+  class Request
+    def self.default_config
+      Musicz.config
+    end
+
+    def self.build(config: default_config)
+      new(config: config)
+    end
+
+    def initialize(config:)
+      @config = config
+    end
+
+    def get(endpoint:, parameters:)
+      url = "#{uri(endpoint)}?#{URI.encode_www_form(parameters)}"
+      Typhoeus.get(url, headers: headers)
+    end
+
+    private
+
+    def headers
+      {
+        "User-Agent" => "#{@config.app_name} #{@config.contact}"
+      }
+    end
+
+    def uri(endpoint)
+      "#{@config.base_uri}/#{endpoint}"
+    end
+  end
+end

data/lib/musicz/search.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require "musicz/search/options/id_search"
+require "musicz/search/options/artist_query_terms"
+require "musicz/search/repository"
+require "musicz/search/artist_repository"

data/lib/musicz/search/area_repository.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require "musicz/search/repository"
+require "musicz/entities/area"
+
+module Musicz
+  module Search
+    class AreaRepository < Repository
+      ENDPOINT = "area"
+
+      def by_id(id_options)
+        by_id_with_entity(id_options, ENDPOINT, Musicz::Entities::Area)
+      end
+    end
+  end
+end

data/lib/musicz/search/artist_repository.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require "musicz/entities/artist_list"
+require "musicz/entities/artist"
+require "musicz/search/repository"
+
+module Musicz
+  module Search
+    class ArtistRepository < Repository
+      ENDPOINT = "artist"
+
+      # @param id_options [Musicz::Search::Options::IdSearch]
+      def by_id(id_options)
+        by_id_with_entity(id_options, ENDPOINT, Musicz::Entities::Artist)
+      end
+
+      # @param term [String] The general term to searh MusicBrainz for
+      # This gets executed on the MusicBrainz server by querying
+      # the artist, sortname and alias fields
+      def by_term(term)
+        by_term_with_entity(term, ENDPOINT, Musicz::Entities::ArtistList)
+      end
+
+      # @param query_terms [Musicz::Search::Options::ArtistQueryTerms]
+      # This executes a generic query against the MusicBrainz API
+      # No support for paging, so use decently specific queries
+      def by_query(query_terms)
+        by_query_with_entity(
+          query_terms,
+          ENDPOINT,
+          Musicz::Entities::ArtistList
+        )
+      end
+    end
+  end
+end