yt 0.0.1 → 0.4.0

data/Rakefile

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

data/TODO.md

@@ -0,0 +1,11 @@
+* find by url (either video or channel or.. playlist)
+* Google accounts?
+* ENV support
+
+* add has_one :status to video
+
+* operations like subscribe that require authentication should not fail if
+called on Yt::Channel without auth but, similarly to account, show the prompt
+or ask for the device code
+
+* scope

data/bin/yt

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+
+begin
+  require 'yt'
+rescue LoadError
+  require 'rubygems'
+  require 'yt'
+end
+
+############################
+
+Yt.configure do |config|
+  config.scenario = :server_app
+  config.api_key = ENV['YT_TEST_APP_SERVER_API_KEY']
+end
+
+############################
+
+channel = Yt::Channel.new id: ARGV[0] || 'UCxO1tY8h1AhOz0T4ENwmpow'
+
+puts "Title: #{channel.title}"
+puts "Description: #{channel.description}"
+puts "Thumbnail: #{channel.thumbnail_url}"
+puts "Videos: "
+channel.videos.each do |video|
+  puts "  Annotations: #{video.annotations.count}"
+  puts "  Duration: #{video.duration}s"
+  puts "  Title: #{video.title}"
+  puts "  Description: #{video.description}"
+  puts "  Thumbnail: #{video.thumbnail_url}"
+end

data/lib/yt.rb

@@ -0,0 +1,2 @@
+require 'yt/config'
+require 'yt/models/account'

data/lib/yt/actions/delete.rb

@@ -0,0 +1,27 @@
+require 'yt/utils/request'
+
+module Yt
+  module Actions
+    module Delete
+
+    private
+
+      def do_delete(extra_delete_params = {})
+        request = Request.new delete_params.merge(extra_delete_params)
+        response = request.run
+        raise unless response.is_a? Net::HTTPNoContent
+        yield response.body
+      end
+
+      def delete_params
+        {}.tap do |params|
+          params[:method] = :delete
+          params[:format] = :json
+          params[:host] = 'www.googleapis.com'
+          params[:scope] = 'https://www.googleapis.com/auth/youtube'
+          params[:auth] = @auth
+        end
+      end
+    end
+  end
+end

data/lib/yt/actions/delete_all.rb

@@ -0,0 +1,28 @@
+require 'yt/actions/list'
+require 'yt/utils/request'
+
+module Yt
+  module Actions
+    module DeleteAll
+      include List
+
+    private
+
+      def do_delete_all(params = {})
+        where(params).map do |item|
+          yield item if block_given?
+          item.delete
+        end.tap { @items = [] }
+      end
+      
+      def where(params = {})
+        list.find_all do |item|
+          params.all? do |method, value|
+            # TODO: could be symbol etc...
+            item.respond_to?(method) && item.send(method) == value
+          end
+        end
+      end
+    end
+  end
+end

data/lib/yt/actions/insert.rb

@@ -0,0 +1,29 @@
+require 'yt/utils/request'
+
+module Yt
+  module Actions
+    module Insert
+
+    private
+
+      def do_insert(extra_insert_params = {})
+        request = Request.new insert_params.merge(extra_insert_params)
+        response = request.run
+        raise unless response.is_a? Net::HTTPOK
+        @items = []
+        new_item response.body
+      end
+
+      def insert_params
+        {}.tap do |params|
+          params[:method] = :post
+          params[:format] = :json
+          params[:host] = 'www.googleapis.com'
+          params[:body_type] = :json
+          params[:scope] = 'https://www.googleapis.com/auth/youtube'
+          params[:auth] = @auth
+        end
+      end
+    end
+  end
+end

data/lib/yt/actions/list.rb

@@ -0,0 +1,65 @@
+require 'yt/utils/request'
+
+module Yt
+  module Actions
+    module List
+
+      delegate :count, :first, :any?, :each, :map, to: :list
+      alias size count
+
+    private
+
+      def list
+        @last_index, @page_token = 0, nil
+        Enumerator.new do |items|
+          while next_item = find_next
+            items << next_item
+          end
+        end
+      end
+
+      def find_next
+        @items ||= []
+        if @items[@last_index].nil? && more_pages?
+          more_items = next_page.map{|data| new_item data}
+          @items.concat more_items
+        end
+        @items[(@last_index +=1) -1]
+      end
+
+      # To be overriden by the subclasses
+      def new_item(data)
+      end
+
+      def more_pages?
+        @last_index.zero? || !@page_token.nil?
+      end
+
+      def next_page
+        params = list_params.dup
+        params[:params][:pageToken] = @page_token if @page_token
+        next_page = fetch_page params
+        @page_token = next_page[:token]
+        next_page[:items]
+      end
+
+      def fetch_page(params = {})
+        request = Request.new params
+        response = request.run
+        raise unless response.is_a? Net::HTTPOK
+        token = response.body['nextPageToken']
+        items = response.body.fetch 'items', []
+        {items: items, token: token}
+      end
+
+      def list_params
+        {}.tap do |params|
+          params[:method] = :get
+          params[:format] = :json
+          params[:host] = 'www.googleapis.com'
+          params[:auth] = @auth
+        end
+      end
+    end
+  end
+end

data/lib/yt/actions/update.rb

@@ -0,0 +1,25 @@
+require 'yt/utils/request'
+
+module Yt
+  module Actions
+    module Update
+      def do_update(extra_update_params = {}, options = {})
+        request = Request.new update_params.deep_merge(extra_update_params)
+        response = request.run
+        expected_response = options.fetch :expect, Net::HTTPNoContent
+        raise unless response.is_a? expected_response
+        yield response.body
+      end
+
+      def update_params
+        {}.tap do |params|
+          params[:method] = :put
+          params[:format] = :json
+          params[:host] = 'www.googleapis.com'
+          params[:scope] = 'https://www.googleapis.com/auth/youtube'
+          params[:auth] = @auth
+        end
+      end
+    end
+  end
+end

data/lib/yt/associations.rb

@@ -0,0 +1,33 @@
+require 'active_support/core_ext/module/delegation'
+require 'active_support/dependencies/autoload'
+require 'active_support/core_ext/string/inflections' # for camelize
+
+module Yt
+  module Associations
+    # @note: Using Autoload to avoid circular dependencies.
+    #        For instance: Yt::Channel requires Yt::Base, which requires
+    #        Yt::Associations, which requires Yt::Associations::Subscription,
+    #        which requires Yt::Subscription, which requires Yt::Base
+    extend ActiveSupport::Autoload
+
+    autoload :Annotations
+    autoload :Channels
+    autoload :DetailsSets
+    autoload :PlaylistItems
+    autoload :Playlists
+    autoload :Ratings
+    autoload :Snippets
+    autoload :Statuses
+    autoload :Subscriptions
+    autoload :UserInfos
+    autoload :Videos
+
+    def has_many(attributes, options = {})
+      mod = attributes.to_s.sub(/.*\./, '').camelize
+      include "Yt::Associations::#{mod.pluralize}".constantize
+      delegate *options[:delegate], to: attributes if options[:delegate]
+    end
+
+    alias has_one has_many
+  end
+end

data/lib/yt/associations/annotations.rb

@@ -0,0 +1,15 @@
+require 'yt/collections/annotations'
+
+module Yt
+  module Associations
+    # Provides the `has_many :annotations` method to YouTube resources,
+    # which allows to access to content annotation set-specific methods.
+    # YouTube resources with annotations are: videos.
+    module Annotations
+      def annotations
+        @annotations ||= Collections::Annotations.by_video self
+      end
+    end
+  end
+end
+

data/lib/yt/associations/channels.rb

@@ -0,0 +1,20 @@
+require 'yt/collections/channels'
+
+module Yt
+  module Associations
+    # Provides the `has_one :channel` method to YouTube resources, which
+    # allows to access to channel-specific methods like.
+    # YouTube resources with a channel are: account.
+    module Channels
+      def channel
+        @channel ||= channels.first
+      end
+
+    private
+
+      def channels
+        @channels ||= Collections::Channels.by_account self
+      end
+    end
+  end
+end

data/lib/yt/associations/details_sets.rb

@@ -0,0 +1,20 @@
+require 'yt/collections/details_sets'
+
+module Yt
+  module Associations
+    # Provides the `has_one :details_set` method to YouTube resources, which
+    # allows to access to content detail set-specific methods like `duration`.
+    # YouTube resources with content details are: videos.
+    module DetailsSets
+      def details_set
+        @detail_set ||= details_sets.first
+      end
+
+    private
+
+      def details_sets
+        @details_sets ||= Collections::DetailsSets.by_video self
+      end
+    end
+  end
+end

data/lib/yt/associations/playlist_items.rb

@@ -0,0 +1,26 @@
+require 'yt/collections/playlist_items'
+
+module Yt
+  module Associations
+    # Provides the `has_many :playlist_items` method to YouTube resources, which
+    # allows to invoke playlist_item-related methods, such as .add_video.
+    # YouTube resources with playlist items are: playlists.
+    module PlaylistItems
+      def playlist_items
+        @playlist_items ||= Collections::PlaylistItems.by_playlist self
+      end
+
+      def add_video(video_id)
+        playlist_items.insert id: video_id, kind: :video
+      end
+
+      def add_videos(video_ids = [])
+        video_ids.map{|video_id| add_video video_id}
+      end
+
+      def delete_playlist_items(attrs = {})
+        playlist_items.delete_all attrs
+      end
+    end
+  end
+end

data/lib/yt/associations/playlists.rb

@@ -0,0 +1,22 @@
+require 'yt/collections/playlists'
+
+module Yt
+  module Associations
+    # Provides the `has_many :playlists` method to YouTube resources, which
+    # allows to invoke playlist-related methods, such as .create_playlist.
+    # YouTube resources with playlist are: channels.
+    module Playlists
+      def playlists
+        @playlists ||= Collections::Playlists.by_channel self
+      end
+
+      def create_playlist(params = {})
+        playlists.insert params
+      end
+
+      def delete_playlists(attrs = {})
+        playlists.delete_all attrs
+      end
+    end
+  end
+end

data/lib/yt/associations/ratings.rb

@@ -0,0 +1,39 @@
+require 'yt/collections/ratings'
+
+module Yt
+  module Associations
+    # Provides the `has_one :rating` method to YouTube resources, which
+    # allows to invoke rating-related methods, such as .like.
+    # YouTube resources with rating are: videos.
+    module Ratings
+      def rating
+        @rating ||= ratings.first
+      end
+
+      def liked?
+        rating.rating == :like
+      end
+
+      def like
+        rating.update :like
+        liked?
+      end
+
+      def dislike
+        rating.update :dislike
+        !liked?
+      end
+
+      def unlike
+        rating.update :none
+        !liked?
+      end
+
+    private
+
+      def ratings
+        @ratings ||= Collections::Ratings.by_video self
+      end
+    end
+  end
+end

data/lib/yt/associations/snippets.rb

@@ -0,0 +1,20 @@
+require 'yt/collections/snippets'
+
+module Yt
+  module Associations
+    # Provides the `has_one :snippet` method to YouTube resources, which
+    # allows to access to content detail set-specific methods like `title`.
+    # YouTube resources with content details are: videos and channels.
+    module Snippets
+      def snippet
+        @snippet ||= snippets.first
+      end
+
+    private
+
+      def snippets
+        @snippets ||= Collections::Snippets.by_resource self
+      end
+    end
+  end
+end

data/lib/yt/associations/statuses.rb

@@ -0,0 +1,14 @@
+require 'yt/models/status'
+
+module Yt
+  module Associations
+    # Provides the `has_one :status` method to YouTube resources, which
+    # allows to access to status-specific methods like `public?`.
+    # YouTube resources with status are: playlists.
+    module Statuses
+      def status
+        @status
+      end
+    end
+  end
+end