nashville 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 65bdcc757a28ad998b1ebb23fcddc84d97953d38
+  data.tar.gz: ebcbb2664e78721c41ceaf8cca7e39150fc5f94b
+SHA512:
+  metadata.gz: 674f00c3f0d4e0c73ba53022d6a7dc42abbfe6084e910ae17eb703c41449ebebc5c4034a07d794acb0a9cba4d07553331bc2e33875fc7dc1e7bf1742106d76fa
+  data.tar.gz: dccaab5326c12d41e89650db1e7f4c6cbb6a701c8d4e1c02e7f020e073a233603fd67f5dacee8d96d16bda015c78fa2f57fd542a83b08bd5f2aacb2a414b4689

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,46 @@
+PATH
+  remote: .
+  specs:
+    nashville (0.0.1)
+      commander (~> 4.1)
+      json
+      rash
+      terminal-table (~> 1.4)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    commander (4.1.5)
+      highline (~> 1.6.11)
+    diff-lcs (1.2.5)
+    docile (1.1.2)
+    hashie (2.0.5)
+    highline (1.6.20)
+    json (1.8.1)
+    multi_json (1.8.4)
+    rake (10.1.1)
+    rash (0.4.0)
+      hashie (~> 2.0.0)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.7)
+    rspec-expectations (2.14.4)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.4)
+    simplecov (0.8.2)
+      docile (~> 1.1.0)
+      multi_json
+      simplecov-html (~> 0.8.0)
+    simplecov-html (0.8.0)
+    terminal-table (1.4.5)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  nashville!
+  rake
+  rspec
+  simplecov

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2014 Mattt Thompson (http://mattt.me/)
+
+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,97 @@
+
+Nashville is a wrapper and command line interface for querying the iTunes Store API.
+
+> Nashville is named for the [famed home of the entertainment industry](http://en.wikipedia.org/wiki/Nashville), in [Los Angeles, California](http://en.wikipedia.org/wiki/Los_Angeles).
+> It's part of a series of world-class command-line utilities for iOS development, which includes [Cupertino](https://github.com/mattt/cupertino) (Apple Dev Center management), [Shenzhen](https://github.com/mattt/shenzhen) (Building & Distribution), [Houston](https://github.com/mattt/houston) (Push Notifications), [Venice](https://github.com/mattt/venice) (In-App Purchase Verification), and [Dubai](https://github.com/mattt/dubai) (Passbook pass generation).
+
+## Installation
+
+    $ gem install nashville
+
+## Usage
+
+```ruby
+require 'nashville'
+
+Nashville::Movie.search(director: "Wes Anderson")
+
+Nashville::Music::Artist.search(artist: "Miles Davis", limit: 5)
+```
+
+## Command Line Interface
+
+Nashville also comes with the `its` binary, which allows you to query the iTunes Store from the command line:
+
+    $ its search --help
+
+    Usage: its search QUERY
+
+      Examples:
+
+        # search
+        its search "Jamiroquai"
+
+      Options:
+        -m, --media MEDIA    The media type to search for
+        -e, --entity ENTITY  The type of results to be returned, relative to the specified media type.
+        -a, --attribute ATTRIBUTE The attribute to be searched for in the stores, relative to the specified media type.
+
+        --limit LIMIT        The maximum number of results to return.
+        --language LANGUAGE  The language, English or Japanese, to use when returning search results.
+        -p, --secret SECRET  Use a shared secret for auto-renewable subscription receipts
+        -X, --[no-]explicit  Include explicit content in search results.
+
+
+    $ its search "Blue in Green" --media music --entity song
+
+    50 Results
+
+    +------------------------+---------------------------------------------------------------------------------+
+    |                                                 Result 1                                                 |
+    +------------------------+---------------------------------------------------------------------------------+
+    | artistId               | 44984                                                                           |
+    | artistName             | Miles Davis                                                                     |
+    | artistViewUrl          | https://itunes.apple.com/us/artist/miles-davis/id44984?uo=4                     |
+    | artworkUrl100          | http://a3.mzstatic.com/us/r30/Music/75/d7/9e/mzi.tugmofjx.100x100-75.jpg        |
+    | artworkUrl30           | http://a3.mzstatic.com/us/r30/Music/75/d7/9e/mzi.tugmofjx.30x30-50.jpg          |
+    | artworkUrl60           | http://a2.mzstatic.com/us/r30/Music/75/d7/9e/mzi.tugmofjx.60x60-50.jpg          |
+    | collectionCensoredName | Kind of Blue                                                                    |
+    | collectionExplicitness | notExplicit                                                                     |
+    | collectionId           | 162322551                                                                       |
+    | collectionName         | Kind of Blue                                                                    |
+    | collectionPrice        | 9.99                                                                            |
+    | collectionViewUrl      | https://itunes.apple.com/us/album/blue-in-green/id162322551?i=162322872&uo=4    |
+    | country                | USA                                                                             |
+    | currency               | USD                                                                             |
+    | discCount              | 1                                                                               |
+    | discNumber             | 1                                                                               |
+    | kind                   | song                                                                            |
+    | previewUrl             | http://a456.phobos.apple.com/us/r1000/090/Music/ca/55/73/mzm.yslzuywm.aac.p.m4a |
+    | primaryGenreName       | Jazz                                                                            |
+    | radioStationUrl        | https://itunes.apple.com/us/station/idra.162322872                              |
+    | releaseDate            | 1997-03-04T08:00:00Z                                                            |
+    | trackCensoredName      | Blue In Green                                                                   |
+    | trackCount             | 6                                                                               |
+    | trackExplicitness      | notExplicit                                                                     |
+    | trackId                | 162322872                                                                       |
+    | trackName              | Blue In Green                                                                   |
+    | trackNumber            | 3                                                                               |
+    | trackPrice             | 0.99                                                                            |
+    | trackTimeMillis        | 337560                                                                          |
+    | trackViewUrl           | https://itunes.apple.com/us/album/blue-in-green/id162322551?i=162322872&uo=4    |
+    | wrapperType            | track                                                                           |
+    +------------------------+---------------------------------------------------------------------------------+
+
+    ...
+
+## Contact
+
+Mattt Thompson
+
+- http://github.com/mattt
+- http://twitter.com/mattt
+- m@mattt.me
+
+## License
+
+Nashville is available under the MIT license. See the LICENSE file for more info.

data/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler/setup'
+
+gemspec = eval(File.read("nashville.gemspec"))
+
+task :build => "#{gemspec.full_name}.gem"
+
+file "#{gemspec.full_name}.gem" => gemspec.files + ["nashville.gemspec"] do
+  system "gem build nashville.gemspec"
+end

data/bin/its

@@ -0,0 +1,88 @@
+#!/usr/bin/env ruby
+
+require 'nashville'
+
+require 'commander/import'
+require 'terminal-table'
+
+HighLine.track_eof = false # Fix for built-in Ruby
+Signal.trap("INT") {} # Suppress backtrace when exiting command
+
+program :version, Nashville::VERSION
+program :description, 'A command-line interface for querying the iTunes Store'
+
+program :help, 'Author', 'Mattt Thompson <m@mattt.me>'
+program :help, 'Website', 'https://github.com/mattt'
+program :help_formatter, :compact
+
+default_command :help
+
+command :search do |c|
+  c.syntax = 'its search QUERY'
+  c.summary = ''
+  c.description = ''
+  c.option '-m', '--media MEDIA', %w(movie podcast music musicVideo audiobook shortFilm tvShow software ebook all), 'The media type to search for'
+  c.option '-e', '--entity ENTITY', 'The type of results to be returned, relative to the specified media type.'
+  c.option '-a', '--attribute ATTRIBUTE', 'The attribute to be searched for in the stores, relative to the specified media type.'
+  c.option '--limit LIMIT', 'The maximum number of results to return.'
+  c.option '--language LANGUAGE', %w(en_us ja_jp), 'The language, English or Japanese, to use when returning search results.'
+  c.option '-p', '--secret SECRET', 'Use a shared secret for auto-renewable subscription receipts'
+  c.option '-X', '--[no-]explicit', 'Include explicit content in search results.'
+
+  c.example 'search', 'its search "Jamiroquai"'
+
+  c.action do |args, options|
+    say_error "Missing receipt argument" and abort unless term = args.first
+
+    params = {}
+    params[:term] = term
+    params[:media] = options.media if options.media
+    params[:entity] = options.entity if options.entity
+    params[:attribute] = options.attribute if options.attribute
+    params[:limit] = options.limit if options.limit
+    params[:lang] = options.language if options.language
+
+    begin
+      results = client.search(params)
+
+      enable_paging
+
+      puts "#{results.length} #{results.length == 1 ? 'Result' : 'Results'}"
+      puts
+
+      results.each_with_index do |result, index|
+        table = Terminal::Table.new :title => "Result #{index + 1}" do |t|
+          result.keys.sort.each do |key|
+            t << [key, result[key]]
+          end
+        end
+
+        puts table
+        puts
+      end
+
+    rescue => error
+      say_error error.message and abort
+    end
+  end
+end
+
+command :preview do |c|
+  c.syntax = 'its preview URL'
+  c.summary = ''
+  c.description = ''
+
+  c.example 'description', 'its search "query"'
+
+  c.action do |args, options|
+    say_error "Missing receipt argument" and abort unless url = args.first
+
+    `open "#{url}" -a "QuickTime Player.app"`
+  end
+end
+
+private
+
+def client
+  @client ||= Nashville::Client.new
+end

data/lib/nashville.rb

@@ -0,0 +1,3 @@
+require 'nashville/version'
+require 'nashville/client'
+require 'nashville/media'

data/lib/nashville/client.rb

@@ -0,0 +1,36 @@
+require 'json'
+require 'net/https'
+require 'uri'
+
+module Nashville
+  ITUNES_SEARCH_ENDPOINT = "https://itunes.apple.com/search"
+
+  class Client
+    attr_accessor :search_url
+    attr_accessor :country
+
+    def initialize
+      @search_url = ENV['ITUNES_SEARCH_ENDPOINT'] || ITUNES_SEARCH_ENDPOINT
+      @country = 'US'
+    end
+
+    def search(params = {})
+      params[:country] ||= @country
+
+      uri = URI(@search_url)
+      uri.query = URI.encode_www_form(params)
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+      http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+
+      request = Net::HTTP::Get.new(uri.request_uri)
+      request['Accept'] = "application/json"
+
+      response = http.request(request)
+      json = JSON.parse(response.body)
+
+      return json["results"]
+    end
+  end
+end

data/lib/nashville/media.rb

@@ -0,0 +1,92 @@
+require 'hashie/rash'
+
+module Nashville
+  module Media
+    def self.included(base)
+      base.send(:extend, ClassMethods)
+    end
+
+    module ClassMethods
+      def Entity(entity)
+        delegator = self
+
+        klass = Class.new(Hashie::Rash) do
+          extend ClassMethods
+
+          define_singleton_method(:entity) do
+            return entity
+          end
+
+          define_singleton_method(:delegator) do
+            return delegator
+          end
+
+          define_singleton_method(:media) do |*args|
+            media = args.first
+            if class_variable_defined?(:@@media)
+              class_variable_get(:@@media)
+            elsif media
+              class_variable_set(:@@media, media)
+            else
+              self.delegator.media
+            end
+          end
+
+          define_singleton_method(:attributes) do |*args|
+            attributes = args
+            if class_variable_defined?(:@@attributes)
+              class_variable_get(:@@attributes)
+            elsif attributes and not attributes.empty?
+              class_variable_set(:@@attributes, attributes.collect(&:to_sym))
+            else
+              self.delegator.attributes
+            end
+          end
+
+          define_singleton_method(:search) do |params|
+            unless params[:term]
+              attribute, *additional = params.keys.collect(&:to_sym) & self.attributes
+              if not attribute
+                raise ArgumentError, "Missing search criteria, specify one of #{self.attributes}"
+              elsif not additional.empty?
+                raise ArgumentError, "Too many search criteria specified (#{attributes})"
+              else
+                params[:attribute] = "#{attribute}Term"
+                params[:term] = params.delete(attribute)
+              end
+            end
+
+            params[:media] = self.media
+            params[:entity] = self.entity
+
+            results = self.delegator.search(params)
+            results.collect{|result| self.new(result)}
+          end
+        end
+      end
+    end
+  end
+
+  include Media
+
+  class << self
+    def search(params = {})
+      client.search(params)
+    end
+
+    private
+
+    def client
+      @@client ||= Client.new
+    end
+  end
+end
+
+require 'nashville/media/audio_book'
+require 'nashville/media/ebook'
+require 'nashville/media/movie'
+require 'nashville/media/music'
+require 'nashville/media/podcast'
+require 'nashville/media/short_film'
+require 'nashville/media/software'
+require 'nashville/media/tv_show'

data/lib/nashville/media/audio_book.rb

@@ -0,0 +1,9 @@
+module Nashville
+  class AudioBook < Entity(:audiobook)
+    media :audibook
+    attributes :title, :author
+
+    class Author < Entity(:audiobookAuthor)
+    end
+  end
+end

data/lib/nashville/media/ebook.rb

@@ -0,0 +1,6 @@
+module Nashville
+  class Ebook < Entity(:ebook)
+    media :ebook
+
+  end
+end

data/lib/nashville/media/movie.rb

@@ -0,0 +1,9 @@
+module Nashville
+  class Movie < Entity(:movie)
+    media :movie
+    attributes :actor, :artist, :shortFilm, :producer, :rating, :director, :releaseYear, :featureFilm, :movieArtist, :movie, :description
+
+    class Artist < Entity(:movieArtist)
+    end
+  end
+end

data/lib/nashville/media/music.rb

@@ -0,0 +1,24 @@
+module Nashville
+  class Music < Entity(:song)
+    media :music
+    attributes :mix, :artist, :composer, :album, :song
+
+    class Artist < Entity(:musicArtist)
+    end
+
+    class Track < Entity(:musicTrack)
+    end
+
+    class Album < Entity(:album)
+    end
+
+    class Video < Entity(:musicVideo)
+    end
+
+    class Mix < Entity(:mix)
+    end
+
+    class Song < Entity(:song)
+    end
+  end
+end

data/lib/nashville/media/podcast.rb

@@ -0,0 +1,9 @@
+module Nashville
+  class Podcast < Entity(:podcast)
+    media :podcast
+    attributes :title, :language, :author, :artist, :keywords, :description
+
+    class Author < Entity(:podcastAuthor)
+    end
+  end
+end

data/lib/nashville/media/short_film.rb

@@ -0,0 +1,9 @@
+module Nashville
+  class ShortFilm < Entity(:shortFilm)
+    media :shortFilm
+    attributes :artist, :shortFilm, :description
+
+    class Artist < Entity(:shortFilmArtist)
+    end
+  end
+end

data/lib/nashville/media/software.rb

@@ -0,0 +1,12 @@
+module Nashville
+  class Software < Entity(:software)
+    media :software
+    attributes :softwareDeveloper
+
+    class IPadSoftware < Entity(:iPadSoftware)
+    end
+
+    class MacSoftware < Entity(:macSoftware)
+    end
+  end
+end

data/lib/nashville/media/tv_show.rb

@@ -0,0 +1,12 @@
+module Nashville
+  class TV < Entity(:tvEpisode)
+    media :tvShow
+    attributes :tvEpisode, :show, :tvSeason, :description
+
+    class Episode < Entity(:tvEpisode)
+    end
+
+    class Season < Entity(:tvSeason)
+    end
+  end
+end

data/lib/nashville/version.rb

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

data/nashville.gemspec

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "nashville/version"
+
+Gem::Specification.new do |s|
+  s.name        = "nashville"
+  s.authors     = ["Mattt Thompson"]
+  s.email       = "m@mattt.me"
+  s.license     = "MIT"
+  s.homepage    = "http://github.com/nomad/nashville"
+  s.version     = Nashville::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.summary     = "iTunes Store API Client"
+  s.description = ""
+
+  s.add_dependency "json"
+  s.add_dependency "commander", "~> 4.1"
+  s.add_dependency "terminal-table", "~> 1.4"
+  s.add_dependency "rash"
+
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "rake"
+  s.add_development_dependency "simplecov"
+
+  s.files         = Dir["./**/*"].reject { |file| file =~ /\.\/(bin|log|pkg|script|spec|test|vendor)/ }
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,161 @@
+--- !ruby/object:Gem::Specification
+name: nashville
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Mattt Thompson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  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: commander
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4.1'
+- !ruby/object:Gem::Dependency
+  name: terminal-table
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: rash
+  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: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ''
+email: m@mattt.me
+executables:
+- its
+extensions: []
+extra_rdoc_files: []
+files:
+- ./Gemfile
+- ./Gemfile.lock
+- ./lib/nashville/client.rb
+- ./lib/nashville/media/audio_book.rb
+- ./lib/nashville/media/ebook.rb
+- ./lib/nashville/media/movie.rb
+- ./lib/nashville/media/music.rb
+- ./lib/nashville/media/podcast.rb
+- ./lib/nashville/media/short_film.rb
+- ./lib/nashville/media/software.rb
+- ./lib/nashville/media/tv_show.rb
+- ./lib/nashville/media.rb
+- ./lib/nashville/version.rb
+- ./lib/nashville.rb
+- ./LICENSE
+- ./nashville.gemspec
+- ./Rakefile
+- ./README.md
+- bin/its
+homepage: http://github.com/nomad/nashville
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.1.11
+signing_key: 
+specification_version: 4
+summary: iTunes Store API Client
+test_files: []