apple_music 0.1.0 → 0.2.0

data/lib/apple_music/song/relationships.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module AppleMusic
+  class Song < Resource
+    # https://developer.apple.com/documentation/applemusicapi/song/relationships
+    class Relationships
+      attr_reader :albums, :artists, :genres, :station
+
+      def initialize(props = {})
+        @albums = Relationship.new(props['albums']).data
+        @artists = Relationship.new(props['artists']).data
+        @genres = Relationship.new(props['genres']).data
+        @station = Relationship.new(props['station']).data.first
+      end
+    end
+
+    self.relationships_model = self::Relationships
+  end
+end

data/lib/apple_music/station.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module AppleMusic
+  # https://developer.apple.com/documentation/applemusicapi/station
+  class Station < Resource
+    class << self
+      # e.g. AppleMusic::Station.find('ra.985484166')
+      # https://developer.apple.com/documentation/applemusicapi/get_a_catalog_station
+      def find(id, **options)
+        storefront = Storefront.lookup(options.delete(:storefront))
+        response = AppleMusic.get("catalog/#{storefront}/stations/#{id}", options)
+        Response.new(response.body).data.first
+      end
+
+      # e.g. AppleMusic::Station.list(ids: ['ra.985484166', 'ra.1128062616'])
+      def list(**options)
+        raise ParameterMissing, 'required parameter :ids is missing' unless options[:ids]
+
+        get_collection_by_ids(options.delete(:ids), options)
+      end
+
+      # e.g. AppleMusic::Station.get_collection_by_ids(['ra.985484166', 'ra.1128062616'])
+      # https://developer.apple.com/documentation/applemusicapi/get_multiple_catalog_stations
+      def get_collection_by_ids(ids, **options)
+        ids = ids.is_a?(Array) ? ids.join(',') : ids
+        storefront = Storefront.lookup(options.delete(:storefront))
+        response = AppleMusic.get("catalog/#{storefront}/stations", options.merge(ids: ids))
+        Response.new(response.body).data
+      end
+
+      def search(term, **options)
+        AppleMusic.search(**options.merge(term: term, types: :stations)).stations
+      end
+    end
+  end
+end
+
+require 'apple_music/station/attributes'

data/lib/apple_music/station/attributes.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module AppleMusic
+  class Station < Resource
+    # https://developer.apple.com/documentation/applemusicapi/station/attributes
+    class Attributes
+      attr_reader :artwork, :duration_in_millis, :editorial_notes,
+                  :episode_number, :is_live, :name, :url
+
+      def initialize(props = {})
+        @artwork = Artwork.new(props['artwork']) # required
+        @duration_in_millis = props['durationInMillis']
+        @editorial_notes = EditorialNotes.new(props['editorialNotes']) if props['editorialNotes']
+        @episode_number = props['episodeNumber']
+        @is_live = props['isLive'] # required
+        @name = props['name'] # required
+        @url = props['url'] # required
+      end
+
+      def live?
+        is_live
+      end
+    end
+
+    self.attributes_model = self::Attributes
+  end
+end

data/lib/apple_music/storefront.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module AppleMusic
+  # https://developer.apple.com/documentation/applemusicapi/storefront
+  class Storefront < Resource
+    class << self
+      # https://developer.apple.com/documentation/applemusicapi/get_a_storefront
+      def find(id, **options)
+        response = AppleMusic.get("storefronts/#{id}", options)
+        Response.new(response.body).data.first
+      end
+
+      # https://developer.apple.com/documentation/applemusicapi/get_all_storefronts
+      def list(**options)
+        response = AppleMusic.get('storefronts', options)
+        Response.new(response.body).data
+      end
+
+      def lookup(value, required: true)
+        (value || AppleMusic.config.storefront).tap do |storefront|
+          raise ParameterMissing, 'required parameter :storefront is missing' if required && !storefront
+        end
+      end
+
+      def search(**_options)
+        warn 'WARN: :storefronts is not searchable resource'
+      end
+    end
+  end
+end
+
+require 'apple_music/storefront/attributes'

data/lib/apple_music/storefront/attributes.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module AppleMusic
+  class Storefront < Resource
+    # https://developer.apple.com/documentation/applemusicapi/storefront/attributes
+    class Attributes
+      attr_reader :default_language_tag, :name, :support_language_tags
+
+      def initialize(props = {})
+        @default_language_tag = props['defaultLanguageTag'] # required
+        @name = props['name'] # required
+        @support_language_tags = props['supportedLanguageTags'] # required
+      end
+    end
+
+    self.attributes_model = self::Attributes
+  end
+end

data/lib/apple_music/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AppleMusic
-  VERSION = '0.1.0'
+  VERSION = '0.2.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: apple_music
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Yoshiyuki Hirano
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-06-18 00:00:00.000000000 Z
+date: 2021-04-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -16,14 +16,28 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.15.4
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.15.4
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: jwt
   requirement: !ruby/object:Gem::Requirement
@@ -87,9 +101,12 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".env.example"
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
+- ".ruby-gemset"
+- ".ruby-version"
 - ".travis.yml"
 - Gemfile
 - Gemfile.lock
@@ -100,6 +117,50 @@ files:
 - bin/console
 - bin/setup
 - lib/apple_music.rb
+- lib/apple_music/activity.rb
+- lib/apple_music/activity/attributes.rb
+- lib/apple_music/activity/relationships.rb
+- lib/apple_music/album.rb
+- lib/apple_music/album/attributes.rb
+- lib/apple_music/album/relationships.rb
+- lib/apple_music/apple_curator.rb
+- lib/apple_music/apple_curator/attributes.rb
+- lib/apple_music/apple_curator/relationships.rb
+- lib/apple_music/artist.rb
+- lib/apple_music/artist/attributes.rb
+- lib/apple_music/artist/relationships.rb
+- lib/apple_music/artwork.rb
+- lib/apple_music/chart.rb
+- lib/apple_music/chart_response.rb
+- lib/apple_music/config.rb
+- lib/apple_music/connection.rb
+- lib/apple_music/curator.rb
+- lib/apple_music/curator/attributes.rb
+- lib/apple_music/curator/relationships.rb
+- lib/apple_music/editorial_notes.rb
+- lib/apple_music/error.rb
+- lib/apple_music/genre.rb
+- lib/apple_music/genre/attributes.rb
+- lib/apple_music/music_video.rb
+- lib/apple_music/music_video/attributes.rb
+- lib/apple_music/music_video/relationships.rb
+- lib/apple_music/play_parameters.rb
+- lib/apple_music/playlist.rb
+- lib/apple_music/playlist/attributes.rb
+- lib/apple_music/playlist/relationships.rb
+- lib/apple_music/preview.rb
+- lib/apple_music/relationship.rb
+- lib/apple_music/resource.rb
+- lib/apple_music/response.rb
+- lib/apple_music/search.rb
+- lib/apple_music/search_result.rb
+- lib/apple_music/song.rb
+- lib/apple_music/song/attributes.rb
+- lib/apple_music/song/relationships.rb
+- lib/apple_music/station.rb
+- lib/apple_music/station/attributes.rb
+- lib/apple_music/storefront.rb
+- lib/apple_music/storefront/attributes.rb
 - lib/apple_music/version.rb
 homepage: https://github.com/yhirano55/apple_music
 licenses:
@@ -120,7 +181,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.2.9
 signing_key: 
 specification_version: 4
 summary: Apple Music API Client Ruby