simple_youtube 3.0.0 → 3.0.1

data/.bundle/config

@@ -0,0 +1 @@
+--- {}

data/.gitignore

@@ -0,0 +1,5 @@
+Gemfile.lock
+*.gem
+.bundle
+pkg
+

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/README.markdown

@@ -0,0 +1,179 @@
+simple_youtube works with the YouTube v2 API to...
+
+1) Read(:get) YouTube data with no API Key
+
+2) Update(:put) YouTube video data using your Gdata API Key and OAuth. Pass in your OAuth token/secret. Watch Ryan B's great [Simple OmniAuth screencast](http://railscasts.com/episodes/241-simple-omniauth) for OAuth set up in Rails. Beforehand you'll also need to [authenticate and authorize your host to use the Google APIs](http://code.google.com/apis/accounts/docs/RegistrationForWebAppsAuto.html) to get a developer(x_gdata_key) key and host(host_secret) key
+
+3) Currently no Create or Delete functionality.
+
+I have tried to cover most of the examples from the [YouTube API reference](http://code.google.com/apis/youtube/2.0/reference.html)
+
+`gem install simple_youtube`
+
+## Video
+
+### :get a single video uid
+
+[http://gdata.youtube.com/feeds/api/videos/wOzOc0xxJu8?v=2](http://gdata.youtube.com/feeds/api/videos/wOzOc0xxJu8?v=2)
+
+    video_uid = Youtube::Video.find(:scope => 'wOzOc0xxJu8', :params => {:v => '2'})
+    video_uid.entry.size # => 1
+    video_uid.entry[0].title # => "Michael Watford - So Into You (Dub Mix)"
+
+### :get top 5 'ruby on rails' videos
+
+[http://gdata.youtube.com/feeds/api/videos?q=ruby+on+rails&max-results=5&v=2](http://gdata.youtube.com/feeds/api/videos?q=ruby+on+rails&max-results=5&v=2)
+
+    video_search = Youtube::Video.find(:params => {:q => 'ruby on rails', :"max-results" => '5', :v => '2'})
+    video_search.entry.size             # => 5
+    video_search.title                  # => "YouTube Videos matching query: ruby on rails"
+    video_search.entry[3].link[1].href  # => http://gdata.youtube.com/feeds/api/videos/UCB57Npj9U0/responses?v=2
+    
+   
+### :get related videos
+
+[http://gdata.youtube.com/feeds/api/videos/rFVHjZYoq4Q/related?v=2](http://gdata.youtube.com/feeds/api/videos/rFVHjZYoq4Q/related?v=2)
+
+    video_related = Youtube::Video.find(:scope => 'rFVHjZYoq4Q', :type => 'related', :params => {:v => '2'})
+    video_related.entry.size            # => 25
+    video_related.entry[24].author.uri  # => http://gdata.youtube.com/feeds/api/users/neodracco
+    
+
+### :get video responses
+
+[http://gdata.youtube.com/feeds/api/videos/rFVHjZYoq4Q/responses?v=2](http://gdata.youtube.com/feeds/api/videos/rFVHjZYoq4Q/responses?v=2)
+
+    video_responses = Youtube::Video.find(:scope => 'rFVHjZYoq4Q', :type => 'responses', :params => {:v => '2'})
+    video_responses.entry[1].group.category  # => Music
+    
+
+### :get video comments
+
+[http://gdata.youtube.com/feeds/api/videos/rFVHjZYoq4Q/comments?v=2](http://gdata.youtube.com/feeds/api/videos/rFVHjZYoq4Q/comments?v=2)
+
+    video_comments = Youtube::Video.find(:scope => 'rFVHjZYoq4Q', :type => 'comments', :params => {:v => '2'})
+    video_comments.entry[0].content         # => Come up to my first ever e on this about 14-15 years ago, ahh too long...
+    
+
+### :get top 11 videos in Comedy category/tag
+
+[http://gdata.youtube.com/feeds/api/videos?category=Comedy&max-results=11&v=2](http://gdata.youtube.com/feeds/api/videos?category=Comedy&max-results=11&v=2)
+
+    video_category = Youtube::Video.find(:params => {:category => 'Comedy', :"max-results" => '11', :v => '2'})
+    video_category.entry.size  # => 11
+    video_category.entry[9].category[2].term  # => Harry Potter
+    video_category.entry[0].category[1].term  # => Comedy
+    
+
+### :get top 5 videos in Comedy category/tag, excluding Film category/tag
+
+[http://gdata.youtube.com/feeds/api/videos?category=Comedy%2C-Film&max-results=5&v=2](http://gdata.youtube.com/feeds/api/videos?category=Comedy%2C-Film&max-results=5&v=2)
+
+    video_category_comedy_exclude_film = Youtube::Video.find(:params => {:category => 'Comedy,-Film', :"max-results" => '5', :v => '2'})
+    video_category_comedy_exclude_film.entry[1].category.size  # => 18
+    video_category_comedy_exclude_film.entry[1].category.each { |category| puts 'film' if category.term.eql?('Film') }  #=> nil
+    
+
+### :get videos in david, beckham,(News or Sports) category/tags
+
+[http://gdata.youtube.com/feeds/api/videos?category=david%2Cbeckham%2CNews%7CSports&v=2](http://gdata.youtube.com/feeds/api/videos?category=david%2Cbeckham%2CNews%7CSports&v=2)
+
+    video_category_david_beckham_news_or_sports = Youtube::Video.find(:params => {:category => 'david,beckham,News|Sports', :v => '2'})
+    video_category_david_beckham_news_or_sports.entry[7].category[1].label  # => Sports
+    video_category_david_beckham_news_or_sports.entry[7].category[2].term   # => david
+    
+### :put an updated video
+
+    video_uid = "video_uid"
+    user_name = "user_name"
+    update_xml = IO.read('fixture/video_update.xml')
+    oauth_token = "oauth_token"
+    oauth_token_secret = "oauth_token_secret"
+    x_gdata_key = "x_gdata_key"
+    host = "www.host.com"
+    host_secret = "host_secret"
+    
+    response = Youtube::Video.update(video_uid, user_name, update_xml, oauth_token, oauth_token_secret, x_gdata_key, host, host_secret)
+    response.code # => 200    
+    
+## Standardfeed
+    
+### :get top rated videos from today
+
+[http://gdata.youtube.com/feeds/api/standardfeeds/top_rated?time=today&v=2](http://gdata.youtube.com/feeds/api/standardfeeds/top_rated?time=today&v=2)
+
+    standardfeed_topratedtoday = Youtube::Standardfeed.find(:type => 'top_rated', :params => {:time => 'today', :v => '2'})
+    standardfeed_topratedtoday.entry[16].author.name = "ZOMGitsCriss"
+  
+### :get top rated videos from jp
+
+[http://gdata.youtube.com/feeds/api/standardfeeds/JP/top_rated?v=2](http://gdata.youtube.com/feeds/api/standardfeeds/JP/top_rated?v=2)
+
+    standardfeed_toprated_jp = Youtube::Standardfeed.find(:scope => 'JP', :type => 'top_rated', :params => {:v => '2'})
+    standardfeed_toprated_jp.id = "tag:youtube.com,2008:standardfeed:jp:top_rated"
+    standardfeed_toprated_jp.entry[1].link[4].href = "http://gdata.youtube.com/feeds/api/standardfeeds/jp/top_rated/v/BQ9YtJC-Kd8?v=2"
+  
+  
+### :get top rated comedy videos from jp
+    
+[http://gdata.youtube.com/feeds/api/standardfeeds/JP/top_rated?category=Comedy&max-results=11&v=2]("http://gdata.youtube.com/feeds/api/standardfeeds/jp/top_rated/v/7hYGkqc1gqE?v=2")
+
+    standardfeed_toprated_jp_comedy = Youtube::Standardfeed.find(:scope => 'JP', :type => 'top_rated', :params => {:category => 'Comedy', :"max-results" => '11', :v => '2'})
+    standardfeed_toprated_jp_comedy.entry[1].link[4].href = "http://gdata.youtube.com/feeds/api/standardfeeds/jp/top_rated/v/7hYGkqc1gqE?v=2"
+
+
+## User 
+
+### :get a single user
+
+[http://gdata.youtube.com/feeds/api/users/neodracco](http://gdata.youtube.com/feeds/api/users/neodracco)
+    
+    user_search = Youtube::User.find(:scope => 'neodracco')
+    user_search.entry.size => 1
+
+### :get ionysis favourite videos
+    
+[http://gdata.youtube.com/feeds/api/users/ionysis/favorites?v=2](http://gdata.youtube.com/feeds/api/users/ionysis/favorites?v=2)
+
+    user_ionysis_favourites = Youtube::User.find(:scope => 'ionysis', :type => 'favorites', :params => {:v => '2'})
+    user_ionysis_favourites.entry[7].statistics.favoriteCount) = "9586"
+    user_ionysis_favourites.entry[7].rating[1].numLikes) = "2568"
+  
+### :get cyanure1982 playlists
+
+[http://gdata.youtube.com/feeds/api/users/cyanure1982/playlists?v=2](http://gdata.youtube.com/feeds/api/users/cyanure1982/playlists?v=2)
+
+    user_cyanure1982_playlists = Youtube::User.find(:scope => 'cyanure1982', :type => 'playlists', :params => {:v => '2'})
+    user_cyanure1982_playlists.entry[2].title) = "shinnenkai"
+  
+### :get ionysis subscriptions
+
+[http://gdata.youtube.com/feeds/api/users/ionysis/subscriptions?v=2](http://gdata.youtube.com/feeds/api/users/ionysis/subscriptions?v=2)
+
+    user_ionysis_subscriptions = Youtube::User.find(:scope => 'ionysis', :type => 'subscriptions', :params => {:v => '2'})
+    user_ionysis_subscriptions.entry[0].title) = "Videos published by : vinyljunkie07"
+  
+### :get vinyljunkie07 contacts
+
+[http://gdata.youtube.com/feeds/api/users/vinyljunkie07/contacts?v=2](http://gdata.youtube.com/feeds/api/users/vinyljunkie07/contacts?v=2)
+
+    user_vinyljunkie07_contacts = Youtube::User.find(:scope => 'vinyljunkie07', :type => 'contacts', :params => {:v => '2'})
+    user_vinyljunkie07_contacts.entry[18].id) "tag:youtube.com,2008:user:vinyljunkie07:contact:CrackerSchool"
+    
+
+## Playlist 
+   
+### :get the cyanure1982 playlist - shinnenkai(D00BDE6AA710D50C)
+
+[http://gdata.youtube.com/feeds/api/playlists/D00BDE6AA710D50C?max-results=14&v=2](http://gdata.youtube.com/feeds/api/playlists/D00BDE6AA710D50C?max-results=14&v=2)
+
+    playlist_cyanure1982 = Youtube::Playlist.find(:scope => 'D00BDE6AA710D50C', :params => {:"max-results" => '14', :v => '2'})
+    playlist_cyanure1982.entry.size = 14
+    playlist_cyanure1982.entry[7].group.keywords = "nu, jazz, club, house, Jazztronik, dj, Yukihiro, Fukutomi, Mondo, Grosso, Daishi, Dance, FreeTEMPO, FPM, KJM, Kentaro, Takizawa"
+    
+simple_youtube is derived from the active_youtube gem from the [Quark ruby blog](http://www.quarkruby.com/2008/2/12/active-youtube)
+    
+Big Thanks to the Quark crew for the inspiration!!!
+
+
+

data/Rakefile

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

data/lib/simple_youtube.rb

@@ -1,2 +1,5 @@
-require File.dirname(__FILE__) + "/simple_youtube/activeyoutube"
-require File.dirname(__FILE__) + "/simple_youtube/youtube"
+module SimpleYoutube
+  ROOT = File.dirname(__FILE__) + '/..'
+end
+
+Dir[SimpleYoutube::ROOT + '/lib/simple_youtube/**/*.rb'].each { |file| require file }

data/lib/simple_youtube/activeyoutube.rb

@@ -1,6 +1,7 @@
 require 'rubygems'
 require 'active_resource'
-require File.dirname(__FILE__) + "/entry_interface_shim"
+
+require SimpleYoutube::ROOT + "/lib/simple_youtube/entry_interface_shim"
 
 class ActiveYoutube < ActiveResource::Base
 
@@ -14,6 +15,6 @@ class ActiveYoutube < ActiveResource::Base
     headers['Accept'] = "application/atom+xml"
     path = "#{prefix()}#{collection_name}#{'/' if scope}#{scope}#{'/' if type}#{type}#{query_string(query)}"
     instantiate_record(format.decode(connection.get(path, headers).body))
-  end  
+  end
 
 end

data/lib/simple_youtube/version.rb

@@ -0,0 +1,4 @@
+module SimpleYoutube
+  VERSION = '3.0.1'
+end
+

data/simple_youtube.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "simple_youtube/version"
+
+Gem::Specification.new do |s|
+  s.name        = 'simple_youtube'
+  s.version     = SimpleYoutube::VERSION
+  s.authors     = ['James Shipton']
+  s.email       = ['ionysis@gmail.com']
+  s.homepage    = 'https://github.com/jamesshipton/simple_youtube'
+  s.summary     = 'ActiveResource extension to Gdata Youtube API.'
+  s.description = 'ActiveResource extension to Gdata Youtube API, anonymous Reads, Updates using your API key and OAuth, no Create or Delete access.'
+
+  s.rubyforge_project = 'simple_youtube'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- spec/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency 'activeresource', '~> 3.1'
+  s.add_dependency 'oauth', '~> 0.4'
+
+  s.add_development_dependency 'fakeweb', '~> 1.3'
+  s.add_development_dependency 'rspec', '~> 2.6'
+  s.add_development_dependency 'debugger'
+  s.add_development_dependency 'rake'
+end

data/spec/fakeweb_helper.rb

@@ -1,22 +1,22 @@
 require 'fakeweb'
 
-module FakewebHelper 
-  # Make sure nothing gets out (IMPORTANT)  
+module FakewebHelper
+  # Make sure nothing gets out (IMPORTANT)
   FakeWeb.allow_net_connect = false
 
-  # Turns a fixture file name into a full path  
-  def fixture_file(filename)  
-    return '' if filename == ''  
-    File.expand_path('./fixture/' + filename)  
-  end  
+  # Turns a fixture file name into a full path
+  def fixture_file(filename)
+    return '' if filename == ''
+    "#{SimpleYoutube::ROOT}/spec/fixture/#{filename}"
+  end
 
-  # Convenience methods for stubbing URLs to fixtures  
-  def stub_get(url, filename)  
-    FakeWeb.register_uri(:get, url, :response => fixture_file(filename))  
+  # Convenience methods for stubbing URLs to fixtures
+  def stub_get(url, filename)
+    FakeWeb.register_uri(:get, url, :response => fixture_file(filename))
   end
-  
+
   def stub_http_error(http_type, url, error_code, error_message)
-    FakeWeb.register_uri(http_type, url, :status => [error_code, error_message])  
+    FakeWeb.register_uri(http_type, url, :status => [error_code, error_message])
   end
 
 end

data/spec/spec_helper.rb

@@ -1,7 +1,8 @@
-require File.dirname(__FILE__) + "/../lib/" + "simple_youtube"
-require File.dirname(__FILE__) + "/fakeweb_helper"
+require 'simple_youtube'
+
+require 'fakeweb_helper'
 
 RSpec.configure do |c|
   c.treat_symbols_as_metadata_keys_with_true_values = true
-  c.color_enabled = true  
+  c.color_enabled = true
 end

data/spec/youtube_update_spec.rb

@@ -1,31 +1,51 @@
 require 'spec_helper'
 
 describe 'YoutubeUpdateSpec' do
-
-  it "updates a video on youtube" do
-
-    consumer = double("consumer")
-    access_token = double("access_token")
-    host = "www.host.com"
-    host_secret = "host_secret"
-    oauth_token = "oauth_token"
+  it 'updates a video on youtube' do
+    consumer = double('consumer')
+    access_token = double('access_token')
+    host = 'www.host.com'
+    host_secret = 'host_secret'
+    oauth_token = 'oauth_token'
     oauth_token_secret = "oauth_token_secret"
-    x_gdata_key = "x_gdata_key"
-    video_uid = "video_uid"
-    user_name = "user_name"
-    update_xml = IO.read('fixture/video_update.xml')
-    
-    OAuth::Consumer.should_receive(:new).with(host, host_secret, {:site=>"https://www.google.com", :request_token_path=>"/accounts/OAuthGetRequestToken", :authorize_path=>"/accounts/OAuthAuthorizeToken", :access_token_path=>"/accounts/OAuthGetAccessToken"}).and_return(consumer)
-
-    OAuth::AccessToken.should_receive(:new).with(consumer, oauth_token, oauth_token_secret).and_return(access_token)
+    x_gdata_key = 'x_gdata_key'
+    video_uid = 'video_uid'
+    user_name = 'user_name'
+    update_xml = IO.read(SimpleYoutube::ROOT + '/spec/fixture/video_update.xml')
+
+    OAuth::Consumer.should_receive(:new).
+      with(
+        host,
+        host_secret,
+        { :site => 'https://www.google.com',
+          :request_token_path => '/accounts/OAuthGetRequestToken',
+          :authorize_path => '/accounts/OAuthAuthorizeToken',
+          :access_token_path => '/accounts/OAuthGetAccessToken' }).
+      and_return(consumer)
+
+    OAuth::AccessToken.should_receive(:new).
+      with(consumer, oauth_token, oauth_token_secret).
+      and_return(access_token)
+
+    access_token.should_receive(:put).
+      with(
+        "http://gdata.youtube.com/feeds/api/users/#{user_name}/uploads/#{video_uid}",
+        update_xml,
+        { 'Accept' => 'application/atom+xml',
+          'Content-Type' => 'application/atom+xml',
+          'X-GData-Key' => "key=#{x_gdata_key}" }).
+      and_return(Net::HTTPResponse.new(1.0, 200, 'OK'))
+
+    response = Youtube::Video.update(
+      video_uid,
+      user_name,
+      update_xml,
+      oauth_token,
+      oauth_token_secret,
+      x_gdata_key,
+      host,
+      host_secret)
 
-    access_token.should_receive(:put).with("http://gdata.youtube.com/feeds/api/users/#{user_name}/uploads/#{video_uid}", update_xml, {'Accept' => 'application/atom+xml', 'Content-Type' => 'application/atom+xml', 'X-GData-Key' => x_gdata_key}).and_return(Net::HTTPResponse.new(1.0, 200, "OK")
-    )
-
-    response = Youtube::Video.update(video_uid, user_name, update_xml, oauth_token, oauth_token_secret, x_gdata_key, host, host_secret)
-    
     response.code.should == 200
-
   end
-
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: simple_youtube
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.0.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-05 00:00:00.000000000Z
+date: 2013-03-13 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activeresource
-  requirement: &70335748278960 !ruby/object:Gem::Requirement
+  requirement: &70351174725400 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,10 +21,10 @@ dependencies:
         version: '3.1'
   type: :runtime
   prerelease: false
-  version_requirements: *70335748278960
+  version_requirements: *70351174725400
 - !ruby/object:Gem::Dependency
   name: oauth
-  requirement: &70335748278220 !ruby/object:Gem::Requirement
+  requirement: &70351174724540 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +32,10 @@ dependencies:
         version: '0.4'
   type: :runtime
   prerelease: false
-  version_requirements: *70335748278220
+  version_requirements: *70351174724540
 - !ruby/object:Gem::Dependency
   name: fakeweb
-  requirement: &70335748277400 !ruby/object:Gem::Requirement
+  requirement: &70351174723540 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,10 +43,10 @@ dependencies:
         version: '1.3'
   type: :development
   prerelease: false
-  version_requirements: *70335748277400
+  version_requirements: *70351174723540
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70335748276640 !ruby/object:Gem::Requirement
+  requirement: &70351174722920 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -54,7 +54,29 @@ dependencies:
         version: '2.6'
   type: :development
   prerelease: false
-  version_requirements: *70335748276640
+  version_requirements: *70351174722920
+- !ruby/object:Gem::Dependency
+  name: debugger
+  requirement: &70351174722260 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70351174722260
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &70351174721180 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70351174721180
 description: ActiveResource extension to Gdata Youtube API, anonymous Reads, Updates
   using your API key and OAuth, no Create or Delete access.
 email:
@@ -63,10 +85,17 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- .bundle/config
+- .gitignore
+- Gemfile
+- README.markdown
+- Rakefile
+- lib/simple_youtube.rb
 - lib/simple_youtube/activeyoutube.rb
 - lib/simple_youtube/entry_interface_shim.rb
+- lib/simple_youtube/version.rb
 - lib/simple_youtube/youtube.rb
-- lib/simple_youtube.rb
+- simple_youtube.gemspec
 - spec/fakeweb_helper.rb
 - spec/fixture/playlist_cyanure1982.xml
 - spec/fixture/standardfeed_toprated_jp.xml
@@ -102,14 +131,20 @@ required_ruby_version: !ruby/object:Gem::Requirement
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: 4037484550341055447
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: 4037484550341055447
 requirements: []
-rubyforge_project: 
+rubyforge_project: simple_youtube
 rubygems_version: 1.8.15
 signing_key: 
 specification_version: 3