musicgraph 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 565669d2c3f1a4398efe5d9741cc59efc52ac894
+  data.tar.gz: 5001572c0cdc89a8fc4c9aeac31cb7d9a8057133
+SHA512:
+  metadata.gz: 709e4b6c88456e6a17e698e87ca7088ff80495451ace2804decdca9a3d8ba3a47e00cb48576aaa49f0bf716689fc0fd634f6822c66255da5bc8accafe9167236
+  data.tar.gz: 9dbe24da0a606226ca9e85f701cece956a3b219774d1fce028bf44fcf886799182fce56f5eaad495efc7f006f4f25dd8cde51f01fc1b33f85c3a4059f3bea6d7

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in musicgraph.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Dave Powers
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,82 @@
+# MusicGraph
+
+A Ruby gem to access the [MusicGraph API](https://developer.musicgraph.com/).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'musicgraph'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install musicgraph
+
+## Usage
+
+```ruby
+
+MusicGraph.api_key = "[api key]"
+
+artist = MusicGraph::Artist.search('kaiser chiefs').first
+artist.name # => "Kaiser Chiefs"
+artist.main_genre # => "rock"
+artist.decade # => "2000s / 2010s"
+
+artists = MusicGraph::Artist.search({similar_to: "Pink Floyd"})
+artists.first.name # => "David Gilmour"
+artists.last.name # => "Eric Clapton"
+
+artists = MusicGraph::Artist.search({decade: "1990s"})
+artists.first.name # => "Lil Wayne"
+
+artists = MusicGraph::Artist.search({genre: "Soul/R&B"})
+artists.last.name # => "Amy Winehouse"
+
+artists = MusicGraph::Artist.search({gender: "female"})
+artists.last.name # => "Shakira"
+
+artists = MusicGraph::Artist.search({country: "wales"})
+artists.last.name # => "Tom Jones"
+
+artists = MusicGraph::Artist.search({limit: 5})
+artists.length # => 5
+
+artist = MusicGraph::Artist.suggest("king").last
+artist.name # => "King James"
+
+artist = MusicGraph::Artist.find("e4de0d41-a6b5-11e0-b446-00251188dd67")
+artist.name # => "Beck"
+
+artist.edges # => ["albums", "similar", "tracks"]
+
+artist.metadata # => returns all available metadata
+
+artist.similar.first # => "Bob Forrest"
+
+artist.albums # => returns array of albums belonging to artist
+
+artist.tracks # => returns array of tracks belonging to artist
+
+artist = MusicGraph::Artist.find("e4de0d41-a6b5-11e0-b446-00251188dd67", ["id", "name"])
+artist.name # => "Beck"
+artist.gender # => nil
+```
+
+## Testing
+
+To configure the gem for testing, add the following to `.env`: `MUSICGRAPH_API_KEY=xyz` (where "xyz" is your MusicGraph API key)
+
+## Contributing
+
+1. Fork it ( https://github.com/[djpowers]/musicgraph/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/lib/musicgraph/album.rb

@@ -0,0 +1,7 @@
+module MusicGraph
+  class Album
+
+    def initialize(attributes)
+    end
+  end
+end

data/lib/musicgraph/artist.rb

@@ -0,0 +1,84 @@
+require "faraday"
+require "json"
+require "uri"
+
+API_URL = "http://api.musicgraph.com/api/v2/artist/"
+
+module MusicGraph
+  class Artist
+    attr_reader :seven_digital_id, :main_genre, :country_of_origin, :entity_type, :artist_ref_id, :vevo_id, :sort_name, :gender, :rhapsody_id, :id, :decade, :name
+
+    def initialize(attributes)
+      @seven_digital_id = attributes["7digital_id"]
+      @main_genre = attributes["main_genre"]
+      @country_of_origin = attributes["country_of_origin"]
+      @entity_type = attributes["entity_type"]
+      @artist_ref_id = attributes["artist_ref_id"]
+      @vevo_id = attributes["vevo_id"]
+      @sort_name = attributes["sort_name"]
+      @gender = attributes["gender"]
+      @rhapsody_id = attributes["rhapsody_id"]
+      @id = attributes["id"]
+      @decade = attributes["decade"]
+      @name = attributes["name"]
+    end
+
+    def self.search(params)
+      if params.is_a? String
+        response = Faraday.get("#{API_URL}search?#{MusicGraph.key_param}&name=#{params}")
+      elsif params.is_a? Hash
+        encoded_params = URI.encode_www_form(params)
+        response = Faraday.get("#{API_URL}search?#{MusicGraph.key_param}&#{encoded_params}")
+      end
+      artists = JSON.parse(response.body)["data"]
+      artists.map { |attributes| new(attributes) }
+    end
+
+    def self.suggest(params)
+      if params.is_a? String
+        response = Faraday.get("#{API_URL}suggest?#{MusicGraph.key_param}&prefix=#{params}")
+      elsif params.is_a? Hash
+        encoded_params = URI.encode_www_form(params)
+        response = Faraday.get("#{API_URL}suggest?#{MusicGraph.key_param}&#{encoded_params}")
+      end
+      artists = JSON.parse(response.body)["data"]
+      artists.map { |attributes| new(attributes) }
+    end
+
+    def self.find(id, filters = nil)
+      request = "#{API_URL}#{id}?#{MusicGraph.key_param}"
+      request += "&fields=#{filters.join(",")}" if filters
+      response = Faraday.get(request)
+      attributes = JSON.parse(response.body)
+      new(attributes["data"])
+    end
+
+    def edges
+      response = Faraday.get("#{API_URL}#{id}/edges?#{MusicGraph.key_param}")
+      JSON.parse(response.body)["data"]
+    end
+
+    def metadata
+      response = Faraday.get("#{API_URL}#{id}?#{MusicGraph.key_param}")
+      JSON.parse(response.body)["data"]
+    end
+
+    def similar
+      response = Faraday.get("#{API_URL}#{id}/similar?#{MusicGraph.key_param}")
+      artists = JSON.parse(response.body)["data"]
+      artists.map { |attributes| Artist.new(attributes) }
+    end
+
+    def albums
+      response = Faraday.get("#{API_URL}#{id}/albums?#{MusicGraph.key_param}")
+      albums = JSON.parse(response.body)["data"]
+      albums.map { |attributes| Album.new(attributes) }
+    end
+
+    def tracks
+      response = Faraday.get("#{API_URL}#{id}/albums?#{MusicGraph.key_param}")
+      albums = JSON.parse(response.body)["data"]
+      albums.map { |attributes| Track.new(attributes) }
+    end
+  end
+end

data/lib/musicgraph/track.rb

@@ -0,0 +1,7 @@
+module MusicGraph
+  class Track
+
+    def initialize(attributes)
+    end
+  end
+end

data/lib/musicgraph/version.rb

@@ -0,0 +1,3 @@
+module MusicGraph
+  VERSION = "0.0.1"
+end

data/lib/musicgraph.rb

@@ -0,0 +1,29 @@
+require "musicgraph/version"
+require "musicgraph/artist"
+require "musicgraph/album"
+require "musicgraph/track"
+
+begin
+  require "pry"
+rescue LoadError
+end
+
+module MusicGraph
+
+  def self.api_key=(key)
+    @api_key = key
+  end
+
+  def self.api_key
+    @api_key
+  end
+
+  protected
+  def self.key_param
+    begin
+      "api_key=" + MusicGraph.api_key
+    rescue
+      raise "No MusicGraph API key present (MusicGraph.api_key='xyz')"
+    end
+  end
+end

data/musicgraph.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'musicgraph/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "musicgraph"
+  spec.version       = MusicGraph::VERSION
+  spec.authors       = ["Dave Powers"]
+  spec.email         = ["djpowers89@gmail.com"]
+  spec.summary       = %q{Web service wrapper for MusicGraph API}
+  spec.description   = %q{Web service wrapper for MusicGraph API}
+  spec.homepage      = "https://github.com/djpowers/musicgraph"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "vcr"
+  spec.add_development_dependency "webmock"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "dotenv"
+
+  spec.add_dependency "faraday"
+  spec.add_dependency "json"
+end