nddrylliog_youtube_it 2.1.4

data/Gemfile

@@ -0,0 +1,5 @@
+source 'http://rubygems.org'
+
+gemspec
+
+gem 'webmock', '~> 1.7.10', :group => :test

data/Gemfile.lock

@@ -0,0 +1,38 @@
+PATH
+  remote: .
+  specs:
+    youtube_it (2.1.4)
+      builder
+      faraday (~> 0.7.3)
+      oauth (~> 0.4.4)
+      oauth2 (~> 0.5.2)
+      simple_oauth (~> 0.1.5)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.2.7)
+    builder (3.0.0)
+    crack (0.3.1)
+    faraday (0.7.6)
+      addressable (~> 2.2)
+      multipart-post (~> 1.1)
+      rack (~> 1.1)
+    multi_json (1.1.0)
+    multipart-post (1.1.5)
+    oauth (0.4.5)
+    oauth2 (0.5.2)
+      faraday (~> 0.7)
+      multi_json (~> 1.0)
+    rack (1.4.1)
+    simple_oauth (0.1.5)
+    webmock (1.7.10)
+      addressable (~> 2.2, > 2.2.5)
+      crack (>= 0.1.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  webmock (~> 1.7.10)
+  youtube_it!

data/Manifest.txt

@@ -0,0 +1,37 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+TODO.txt
+lib/youtube_it.rb
+lib/youtube_it/chain_io.rb
+lib/youtube_it/client.rb
+lib/youtube_it/model/author.rb
+lib/youtube_it/model/category.rb
+lib/youtube_it/model/contact.rb
+lib/youtube_it/model/content.rb
+lib/youtube_it/model/message.rb
+lib/youtube_it/model/playlist.rb
+lib/youtube_it/model/rating.rb
+lib/youtube_it/model/thumbnail.rb
+lib/youtube_it/model/user.rb
+lib/youtube_it/model/video.rb
+lib/youtube_it/parser.rb
+lib/youtube_it/record.rb
+lib/youtube_it/request/base_search.rb
+lib/youtube_it/request/error.rb
+lib/youtube_it/request/standard_search.rb
+lib/youtube_it/request/user_search.rb
+lib/youtube_it/request/video_search.rb
+lib/youtube_it/request/video_upload.rb
+lib/youtube_it/response/video_search.rb
+lib/youtube_it/middleware/faraday_authheader.rb
+lib/youtube_it/middleware/faraday_oauth.rb
+lib/youtube_it/middleware/faraday_youtubeit.rb
+lib/youtube_it/version.rb
+test/helper.rb
+test/test_chain_io.rb
+test/test_client.rb
+test/test_video.rb
+test/test_video_search.rb
+

data/README.rdoc

@@ -0,0 +1,296 @@
+== DONATION
+
+  YOUTUBE_IT is developed by many contributors who are passioned about opensource projects 
+  and selflessly donate their time and work. Following that spirit your donations to this project 
+  will be destined to the Tuquito Libre Foundation(http://fundacion.tuquito.org.ar) for developing 
+  technology projects intended to close the digital gap in Latin America.
+
+{<img src=https://www.pledgie.com/campaigns/16746.png?skin_name=chrome>}[http://www.pledgie.com/campaigns/16746]
+
+== DESCRIPTION
+
+  youtube_it is the most complete Ruby client for the YouTube GData API. It provides an easy
+  way to access the latest and most complete access to YouTube's video API.
+  In comparison with the earlier Youtube interfaces, this new API and
+  library offers much-improved flexibility around executing complex search
+  queries to obtain well-targeted video search results.  In addition, standard video management 
+  including but not limited to uploading, deleting, updating, like, dislike, ratings and
+  comments.
+  
+== INSTALLATION & SETUP:
+  * Create a youtube account.
+  * Create a developer key here http://code.google.com/apis/youtube/dashboard.
+  * sudo gem install youtube_it
+
+Note: youtube_it supports ClientLogin(YouTube account), OAuth or AuthSub authentication methods.
+
+== Example Rails 3 App
+
+You can get an example how you can use youtube_it with Rails 3 here: http://github.com/chebyte/youtube_it_rails_app_example
+
+== DEMO
+
+You can see to youtube_it in action here: http://youtube-it.heroku.com
+
+== ESTABLISHING A CLIENT
+
+Creating a client:
+  $ require 'youtube_it'
+  $ client = YouTubeIt::Client.new
+
+Client with developer key:
+  $ client = YouTubeIt::Client.new(:dev_key => "developer_key")
+    
+Client with youtube account and developer key:
+  $ client = YouTubeIt::Client.new(:username => "youtube_username", :password =>  "youtube_passwd", :dev_key => "developer_key")
+
+Client with AuthSub:
+    $ client = YouTubeIt::AuthSubClient.new(:token => "token" , :dev_key => "developer_key")
+
+Client with OAuth:
+  $ client = YouTubeIt::OAuthClient.new("consumer_key", "consumer_secret", "youtube_username", "developer_key")
+  $ client.authorize_from_access("access_token", "access_secret")
+
+Client with OAuth2:
+  $ client = YouTubeIt::OAuth2Client.new(client_access_token: "access_token", client_refresh_token: "refresh_token", client_id: "client_id", client_secret: "client_secret", dev_key: "dev_key", expires_at: "expiration time")
+
+If your access token is still valid (be careful, access tokens may only be valid for about 1 hour), you can use the client directly. If you want to refresh the access token using the refresh token just do:
+
+  $ client.refresh_access_token!
+
+== VIDEO QUERIES
+
+Note:  Each type of client enables searching capabilities.
+
+Basic Queries:
+  $ client.videos_by(:query => "penguin")
+  $ client.videos_by(:query => "penguin", :page => 2, :per_page => 15)
+  $ client.videos_by(:query => "penguin", :restriction => "DE")
+  $ client.videos_by(:tags => ['tiger', 'leopard'])
+  $ client.videos_by(:categories => [:news, :sports])
+  $ client.videos_by(:categories => [:news, :sports], :tags => ['soccer', 'football'])
+  $ client.videos_by(:user => 'liz')
+  $ client.videos_by(:favorites, :user => 'liz')
+  $ client.video_by("FQK1URcxmb4")
+  $ client.video_by("https://www.youtube.com/watch?v=QsbmrCtiEUU")  
+  $ client.video_by_user("chebyte","FQK1URcxmb4")
+
+Standard Queries:
+  $ client.videos_by(:most_viewed)
+  $ client.videos_by(:most_linked, :page => 3)
+  $ client.videos_by(:top_rated, :time => :today)
+
+Advanced Queries (with boolean operators OR (either), AND (include), NOT (exclude)):
+  $ client.videos_by(:categories => { :either => [:news, :sports], :exclude => [:comedy] }, :tags => { :include => ['football'], :exclude => ['soccer'] })
+
+
+Queries for safeSearch
+  The safe_search parameter indicates whether the search results should include restricted content as well as standard content. 
+  The following values are valid for this parameter: none, moderate(default), strict
+  
+  $ client.videos_by(:query => "penguin", :safe-search => "strict")
+
+Fields Parameter(experimental features):
+  Return videos more than 1000 views
+  $ client.videos_by(:fields => {:view_count => "1000"})
+
+  Filter by date
+  $ client.videos_by(:fields => {:published  => ((Date.today)})
+  $ client.videos_by(:fields => {:recorded   => ((Date.today)})  
+
+  Filter by date with range
+  $ client.videos_by(:fields => {:published  => ((Date.today - 30)..(Date.today))})
+  $ client.videos_by(:fields => {:recorded   => ((Date.today - 30)..(Date.today))})  
+  
+== VIDEO MANAGEMENT
+
+Note: YouTube account, OAuth or AuthSub enables video management.
+
+Upload Video:
+  $ client.video_upload(File.open("test.mov"), :title => "test",:description => 'some description', :category => 'People',:keywords => %w[cool blah test])
+
+Upload Video With A Developer Tag (Note the tags are not immediately available):
+  $ client.video_upload(File.open("test.mov"), :title => "test",:description => 'some description', :category => 'People',:keywords => %w[cool blah test], :dev_tag => 'tagdev')
+
+Update Video:
+  $ client.video_update("FQK1URcxmb4", :title => "new test",:description => 'new description', :category => 'People',:keywords => %w[cool blah test])
+
+Delete Video:
+  $ client.video_delete("FQK1URcxmb4")
+
+My Videos:
+  $ client.my_videos
+
+My Video:
+  $ client.my_video(video_id)
+  
+Profile Details:
+  $ client.profile(user) #default: current user
+
+List Comments:
+  $ client.comments(video_id)
+
+Add A Comment:
+  $ client.add_comment(video_id, "test comment!")
+
+List Favorites:
+  $ client.favorites(user) # default: current user
+
+Add Favorite:
+  $ client.add_favorite(video_id)
+
+Delete Favorite:
+  $ client.delete_favorite(video_id)
+
+Like A Video:
+  $ client.like_video(video_id)
+
+Dislike A Video:
+  $ client.dislike_video(video_id)
+
+List Subscriptions:
+  $ client.subscriptions(user) # default: current user
+
+Subscribe To A Channel:
+  $ client.subscribe_channel(channel_name)
+
+Unsubscribe To A Channel:
+  $ client.unsubscribe_channel(subscription_id)
+
+List New Subscription Videos:
+  $ client.new_subscription_videos(user) # default: current user
+  
+List Playlists:
+  $ client.playlists(user) # default: current user
+
+Select Playlist:
+  $ client.playlist(playlist_id)
+
+Select All Videos From A Playlist:
+  $ playlist = client.playlist(playlist_id)
+  $ playlist.videos
+
+Create Playlist:
+  $ playlist = client.add_playlist(:title => "new playlist", :description => "playlist description")
+
+Delete Playlist:
+  $ client.delete_playlist(playlist_id)
+
+Add Video To Playlist:
+  $ client.add_video_to_playlist(playlist_id, video_id)
+
+Remove Video From Playlist:
+  $ client.remove_video_from_playlist(playlist_id, playlist_entry_id)
+
+List Related Videos
+  $ video = client.video_by("https://www.youtube.com/watch?v=QsbmrCtiEUU&feature=player_embedded")
+  $ video.related.videos
+
+Add Response Video
+  $ video.add_response(original_video_id, response_video_id)
+
+Delete Response Video
+  $ video.delete_response(original_video_id, response_video_id)
+
+List Response Videos
+  $ video = client.video_by("https://www.youtube.com/watch?v=QsbmrCtiEUU&feature=player_embedded")
+  $ video.responses.videos
+
+  
+== ACCESS CONTROL LIST
+
+  You can give permissions in your videos, for example denied comments, rate, etc...
+  you can read more there http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_yt:accessControl
+  you have available the followings options:
+
+* :rate, :comment, :commentVote, :videoRespond, :list, :embed, :syndicate
+
+  with just two values:
+*    allowed or denied
+
+  Example
+
+  client = YouTubeIt::Client.new(:username => "youtube_username", :password =>  "youtube_passwd", :dev_key => "developer_key")
+
+* upload video with denied comments
+
+  client.video_upload(File.open("test.mov"), :title => "test",:description => 'some description', :category => 'People',:keywords => %w[cool blah test], :comment => "denied")
+
+
+== Video Upload From Browser:
+
+When uploading a video from your browser you need make a form upload with the followings params:
+  $ upload_token(params, nexturl)
+params  => params like :title => "title", :description => "description", :category => "People", :tags => ["test"]
+nexturl => redirect to this url after upload
+
+
+Controller
+  def upload
+    @upload_info = YouTubeIt::Client.new.upload_token(params, videos_url)
+  end
+
+View (upload.html.erb)
+  <% form_tag @upload_info[:url], :multipart => true do %>
+    <%= hidden_field_tag :token, @upload_info[:token] %>
+    <%= label_tag :file %>
+    <%= file_field_tag :file %>
+    <%= submit_tag "Upload video" %>
+  <% end %>
+
+== WIDESCREEN VIDEOS
+
+If the videos has support for widescreen:
+  $ video.embed_html_with_width(1280)
+
+Note: you can specify width or just use the default of 1280.
+
+== USING HTML5
+
+Now you can embed videos without use flash using html5, usefull for mobiles that not support flash but has html5 browser
+
+You can specify these options
+  $ video.embed_html5({:class => 'video-player', :id => 'my-video', :width => '425', :height => '350', :frameborder => '1', :url_params => {:option_one => "value", :option_two => "value"}})
+
+or just use with default options
+  $ video.embed_html5 #default: width: 425, height: 350, frameborder: 0
+
+== LOGGING
+
+YouTubeIt passes all logs through the logger variable on the class itself. In Rails context, assign the Rails logger to that variable to collect the messages
+(don't forget to set the level to debug):
+  $ YouTubeIt.logger = RAILS_DEFAULT_LOGGER
+  $ RAILS_DEFAULT_LOGGER.level = Logger::DEBUG
+
+== CONTRIBUTORS:
+
+* Kyle J. Ginavan.
+* Mauro Torres - http://github.com/chebyte
+* Marko Seppa  - https://github.com/mseppae
+* Walter Korman - https://github.com/shaper
+* Shane Vitarana - https://github.com/shanev
+
+== LICENSE:
+
+MIT License
+
+Copyright (c) 2010 Kyle J. Ginavan
+
+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/Rakefile

@@ -0,0 +1,21 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'rake'
+require 'bundler'
+begin
+  Bundler.setup(:default, :test)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+task :default => :test

data/VERSION

@@ -0,0 +1 @@
+2.1.4

data/lib/youtube_it.rb

@@ -0,0 +1,91 @@
+require 'logger'
+require 'open-uri'
+require 'net/https'
+require 'digest/md5'
+require 'rexml/document'
+require 'builder'
+require 'oauth'
+require 'oauth2'
+require 'faraday'
+
+class YouTubeIt
+
+  # Base error class for the extension
+  class Error < RuntimeError
+    attr_reader :code
+    def initialize(msg, code = 0)
+      super(msg)
+      @code = code
+    end
+  end
+
+  def self.esc(s) #:nodoc:
+    CGI.escape(s.to_s)
+  end
+
+  # Set the logger for the library
+  def self.logger=(any_logger)
+    @logger = any_logger
+  end
+
+  # Get the logger for the library (by default will log to STDOUT). TODO: this is where we grab the Rails logger too
+  def self.logger
+    @logger ||= create_default_logger
+  end
+
+  def self.adapter=(faraday_adapter)
+    @adapter = faraday_adapter
+  end
+  
+  def self.adapter
+    @adapter ||= Faraday.default_adapter
+  end
+  
+  # Gets mixed into the classes to provide the logger method
+  module Logging #:nodoc:
+
+    # Return the base logger set for the library
+    def logger
+      YouTubeIt.logger
+    end
+  end
+
+  private
+    def self.create_default_logger
+      logger = Logger.new(STDOUT)
+      logger.level = Logger::DEBUG
+      logger
+    end
+end
+
+%w(
+  version
+  client
+  record
+  parser
+  model/author
+  model/category
+  model/comment
+  model/contact
+  model/content
+  model/message
+  model/playlist
+  model/rating
+  model/subscription
+  model/thumbnail
+  model/user
+  model/video
+  model/activity
+  request/base_search
+  request/error
+  request/user_search
+  request/standard_search
+  request/video_upload
+  request/video_search
+  response/video_search
+  middleware/faraday_authheader.rb
+  middleware/faraday_oauth.rb
+  middleware/faraday_oauth2.rb
+  middleware/faraday_youtubeit.rb
+  chain_io
+).each{|m| require File.dirname(__FILE__) + '/youtube_it/' + m }