tunecore_direct 0.0.3 → 0.0.5

data/Manifest.txt

@@ -5,6 +5,7 @@ README.txt
 Rakefile
 config/hoe.rb
 config/requirements.rb
+examples/quick_tutorial.rb
 lib/tunecore_direct.rb
 lib/tunecore_direct/album.rb
 lib/tunecore_direct/base.rb

data/examples/quick_tutorial.rb

@@ -0,0 +1,60 @@
+# This script will demonstrate how to create a user at TuneCore and add an Album and Song.
+email = 'alex.kane@gmail.com'
+tunecore_server = "http://localhost:3000"
+api_key = "testkey"
+
+# Set up our environment
+#require 'rubygems'
+require 'tunecore_direct'
+include TunecoreDirect
+TunecoreDirect::Base.tunecore_server = tunecore_server
+TunecoreDirect::Base.api_key = api_key
+
+person = Person.get("alex.kane@gmail.com")
+
+
+# Create a person
+person = TunecoreDirect::Person.new
+person.name = "Joe Schmoe"
+person.email = email
+person.password = "pa$$word"
+person.phone_number = "212-555-1212"
+person.country = "United States"
+person.postal_code = "11201"
+# person.create should return true.  If it returns false check person.errors to see why the person
+# couldn't be created.  Assuming that it returned true, the person_id attribute will now be set.
+person.create
+
+# Create an Album for our person
+album = TunecoreDirect::Album.new
+album.name = "My Album"
+album.person_id = person.person_id # this is the person_id of the person we created above
+album.orig_release_date = "2008-02-23"
+album.sale_date = "2008-02-23"
+album.primary_genre = "Rock"
+album.secondary_genre = "Alternative"
+album.artist_name = "Alex Kane"
+album.label_name = "Shochu"
+album.c_copyright = "1999"
+album.p_copyright = "1999"
+album.recording_location = "Brooklyn"
+album.parental_advisory = false
+album.stores = "iTunesUS,iTunesAU,iTunesCA,iTunesEU,iTunesJP,iTunesEU,RhapsodyRH,MusicNet,Napster,eMusic,Amazon,Lala"
+# Our album object is built, now let's create it on the TuneCore server.  Like person, the Album object will 
+# return true if the album was created, and false if there was a problem.  If false check album.errors to see
+# what the problem was. 
+album.create
+
+
+# Create a song to go on the Album we just created
+song = TunecoreDirect::Song.new
+song.album_id = album.album_id
+song.name = "My song"
+song.track_num = 1
+song.save
+
+# Now that we've created the Song in TuneCore's server the next step is to upload the audio file
+# to TuneCore.  We do this by using TuneCore's flash uploade tool.
+# The url to upload tool for this song is:
+
+

data/lib/tunecore_direct/album.rb

@@ -27,7 +27,7 @@ module TunecoreDirect
     attr_accessor :artist_name, :label_name, :c_copyright, :p_copyright, :recording_location, :parental_advisory
     attr_accessor :artwork_s3_id, :takedown_at
     attr_accessor :errors 
-    attr_accessor :stores, :state
+    attr_accessor :stores, :state, :xml
     
     def initialize(options = {})
       options.each do |k,v|
@@ -38,8 +38,8 @@ module TunecoreDirect
     # Creates an Album object from a Rexml:Element
     def self.from_xml_element( album_element)
       @xml = album_element
-      #puts @xml
-      album = self.new
+      puts @xml
+      album = self.new(:xml => @xml)
       album.album_id = album_element.elements["id"].text
       album.person_id = album_element.elements["person-id"].text 
       album.name = album_element.elements["name"].text
@@ -101,7 +101,13 @@ module TunecoreDirect
         
     # Returns an array that contains every Song in this Album
     def songs
-      raise "Album#songs is not implemented in this version of the SDK"
+    #  if @xml == nil
+    #    self.
+      songs = []
+      @xml.elements.each("songs/song") do |song_element|
+        songs << Song.from_xml_element( song_element)
+      end
+      return songs
     end
     
     # Returns the number of songs that have been created for this album
@@ -129,7 +135,12 @@ module TunecoreDirect
     
     def is_taken_down?
       !@takedown.nil?
-    end      
+    end
     
+    def upload_url
+      "http://#{TunecoreDirect::Base.tunecore_server}/partner/songs?album_id=#{self.album_id}"
+    end    
+        
+
   end
 end

data/lib/tunecore_direct/person.rb

@@ -71,6 +71,12 @@ module TunecoreDirect
       req.get_people.object
     end
     
+    # Get's a person object from the TuneCore server.  Id can be either a person_id or an email address
+    def self.get(id)
+      req = Request.new
+      req.get_person(id).object
+    end
+    
     # Returns an array of albums owned by this person
     def albums
       req = Request.new

data/lib/tunecore_direct/song.rb

@@ -48,14 +48,19 @@ module TunecoreDirect
     # Creates an Album object from a Rexml:Element
     def self.from_xml_element( song_element)
       song = self.new
-      song.song_id        = song_element.elements["id"].text
-      song.album_id       = song_element.elements["album-id"].text
-      song.name           = song_element.elements["name"].text
-      song.artist_name    = song_element.elements["artist-name"].text unless song_element.elements["artist-name"].nil?
-      song.track_num      = song_element.elements["parental-advisory"].text
+      song.song_id            = song_element.elements["id"].text
+      song.album_id           = song_element.elements["album-id"].text
+      song.name               = song_element.elements["name"].text
+      song.artist_name        = song_element.elements["artist-name"].text unless song_element.elements["artist-name"].nil?
+      song.parental_advisory  = song_element.elements["parental-advisory"].text
+      song.track_num          = song_element.elements["track-num"].text
       return song
     end  
-      
+    
+    # Returns the URL for the upload tool
+    def upload_url
+      "#{tunecore_server}/partner/track_upload?api_key=#{api_key}&song_id=#{self.song_id}"
+    end
     
   end
   

data/lib/tunecore_direct/version.rb

@@ -2,7 +2,7 @@ module TunecoreDirect #:nodoc:
   module VERSION #:nodoc:
     MAJOR = 0
     MINOR = 0
-    TINY  = 3
+    TINY  = 5
 
     STRING = [MAJOR, MINOR, TINY].join('.')
   end

data/test/test_tunecore_direct.rb

@@ -3,7 +3,7 @@ require File.dirname(__FILE__) + '/test_helper.rb'
 class TestTunecoreDirect < Test::Unit::TestCase
 
   def setup
-    TunecoreDirect::Base.tunecore_server = "http://test.tunecore.com"
+    TunecoreDirect::Base.tunecore_server = "http://localhost:3000"
     TunecoreDirect::Base.api_key = "testkey"
     
     #random email address so we dont get collisions after the first test
@@ -46,7 +46,7 @@ class TestTunecoreDirect < Test::Unit::TestCase
     album.label_name = "Shochu"
     album.c_copyright = "1999"
     album.p_copyright = "1999"
-    album.recording_location = "Bucktown"
+    album.recording_location = "Brooklyn"
     album.parental_advisory = false
     album.stores = "iTunesUS,iTunesAU,iTunesCA,iTunesEU,iTunesJP,iTunesEU,RhapsodyRH,MusicNet,Napster,eMusic,Amazon,Lala"
     created = album.create
@@ -56,6 +56,7 @@ class TestTunecoreDirect < Test::Unit::TestCase
     song = TunecoreDirect::Song.new
     song.album_id = album.album_id
     song.name = "My song"
+    song.track_num = 1
     assert song.save == true
     
     # get all albums
@@ -66,6 +67,13 @@ class TestTunecoreDirect < Test::Unit::TestCase
     album_id = albums.first.album_id
     assert TunecoreDirect::Album.takedown( album_id ) != nil
     
+    # get person by email
+    person = TunecoreDirect::Person.get(@email)
+    assert person.email = @email
+    
+    # get all the songs for this album
+    songs = person.albums.first.songs
+    
   end
 
   

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: tunecore_direct
 version: !ruby/object:Gem::Version 
-  version: 0.0.3
+  version: 0.0.5
 platform: ruby
 authors: 
 - Alex Kane
@@ -30,7 +30,7 @@ cert_chain:
   f3TSOQ==
   -----END CERTIFICATE-----
 
-date: 2008-04-11 00:00:00 -04:00
+date: 2008-04-15 00:00:00 -04:00
 default_executable: 
 dependencies: []
 
@@ -54,6 +54,7 @@ files:
 - Rakefile
 - config/hoe.rb
 - config/requirements.rb
+- examples/quick_tutorial.rb
 - lib/tunecore_direct.rb
 - lib/tunecore_direct/album.rb
 - lib/tunecore_direct/base.rb