brainzz 0.0.13 → 0.0.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2a671d124176c1959b3197fd55e6637c610a5ae7
-  data.tar.gz: 1b9ab27231a0fb1983816d84a5774243d303a7fe
+  metadata.gz: 5c3b7c8a7a3823fe06e1f4b09a528d6f9772f6f7
+  data.tar.gz: 9f415ab84b1f27e291c414a7832a3b72ecc751e4
 SHA512:
-  metadata.gz: 26065917c46b2207eb9d79ed1a5af5338aca388aaca4283946222ca601ef220c19b2e0ac96760ad070b3dceb48e0478ce51db5f820f6d58a65b03574155e1199
-  data.tar.gz: 3ebbc06bedd1e8689c3fce27ca2417c89bfbf04b702ee0173069047f52f0eec613fa52ed9758f554be7dc04dfa99e12054e438bd6c62eb8a01aaf25759d6dde1
+  metadata.gz: 5ee2a8f8a1b3fe7d5f2e18b3bd5e6e50bcdb67a2daef4d37d361f0d5f4e304f01d601cd71c4d18cd1c92cdcbab99c9e4111a9eb60d631887d851f2c5940f4456
+  data.tar.gz: 46fbc04ae7d163b4c03388aff58d006fd47bcb44fddd35b9eb2298081d30dfdd63309c8b25db8d1457b2b6d17c1d3c249a5ef673de4db9aeaa4396f5b41da523

data/README.md

@@ -72,6 +72,31 @@ Every response from the public API is wrapped in a `Response` object
 that will always have the same interface regardless of request.
 The `Response#data` attribute will be an object specific to the data requested.
 
+### channel_details_for
+
+Accepts an array of channel ids.
+The maximum length of the array is determined by YouTube.
+
+This endpoint returns a hash with channel ids as keys
+and channel objects as the values.
+
+#### Channel Attributes Accessible
+
+* id
+* title
+* published_at
+* description
+* uploads_playlist
+* likes_playlist
+* google_plus_id
+* view_count
+* comment_count
+* subscriber_count
+* video_count
+
+#### Parameters
+
+* channel ids (Array[String])
 
 ### playlist_items_for
 

data/lib/brainzz.rb

@@ -10,6 +10,7 @@ require_relative 'brainzz/enums/view_source_enum'
 
 require_relative 'brainzz/models/base_model'
 require_relative 'brainzz/models/video'
+require_relative 'brainzz/models/channel'
 require_relative 'brainzz/models/stat'
 require_relative 'brainzz/models/video_stat'
 require_relative 'brainzz/models/channel_stat'
@@ -37,12 +38,15 @@ require_relative 'brainzz/params/base_params'
 require_relative 'brainzz/params/analytics_params'
 require_relative 'brainzz/params/stats_params'
 require_relative 'brainzz/params/video_details_params'
+require_relative 'brainzz/params/channel_details_params'
 require_relative 'brainzz/params/video_stats_params'
 require_relative 'brainzz/params/channel_stats_params'
 require_relative 'brainzz/params/playlist_items_params'
 
 require_relative 'brainzz/responses/playlist_items_response'
+require_relative 'brainzz/responses/details_response'
 require_relative 'brainzz/responses/video_details_response'
+require_relative 'brainzz/responses/channel_details_response'
 require_relative 'brainzz/responses/video_stats_response'
 require_relative 'brainzz/responses/view_count_response'
 require_relative 'brainzz/responses/like_count_response'
@@ -62,6 +66,7 @@ require_relative 'brainzz/commands/base_command'
 require_relative 'brainzz/commands/data_command'
 require_relative 'brainzz/commands/playlist_items_command'
 require_relative 'brainzz/commands/video_details_command'
+require_relative 'brainzz/commands/channel_details_command'
 require_relative 'brainzz/commands/analytics_command'
 require_relative 'brainzz/commands/stats_command'
 require_relative 'brainzz/commands/video_stats_command'

data/lib/brainzz/commands/channel_details_command.rb

@@ -0,0 +1,29 @@
+module Brainzz
+  class ChannelDetailsCommand < DataCommand
+    class << self
+      private
+
+      def on_execute(channel_ids)
+        channel_details_params = ChannelDetailsParams.new(channel_ids)
+
+        if channel_details_params.valid?
+          response = get(channel_details_params)
+          ChannelDetailsResponse.new response
+        else
+          ChannelDetailsResponse.new
+        end
+      end
+
+      def endpoint
+        'channels'
+      end
+
+      def params(channel_details_params)
+        super.merge({
+          'id'   => channel_details_params.channel_ids.join(','),
+          'part' => 'snippet,contentDetails,statistics'
+        })
+      end
+    end
+  end
+end

data/lib/brainzz/core.rb

@@ -2,6 +2,10 @@ module Brainzz
   module Core
     extend self
 
+    def channel_details_for(channel_ids)
+      ChannelDetailsCommand.execute channel_ids
+    end
+
     def playlist_items_for(playlist_id, response = nil)
       PlaylistItemsCommand.execute playlist_id, response
     end

data/lib/brainzz/models/channel.rb

@@ -0,0 +1,107 @@
+module Brainzz
+  class Channel < BaseModel
+    attr_accessor :id,
+      :title,
+      :published_at,
+      :description,
+      :uploads_playlist,
+      :likes_playlist,
+      :google_plus_id,
+      :view_count,
+      :comment_count,
+      :subscriber_count,
+      :video_count
+
+
+    def initialize(hash = {})
+      @hash = hash || {}
+
+      @id = transform(hash_id)
+
+      initialize_snippet
+      initialize_content_details
+      initialize_statistics
+    end
+
+    private
+
+    def hash_id
+      @hash['channelId'] || @hash['id']
+    end
+
+    def initialize_snippet
+      @title            = transform(hash_title)
+      @description      = transform(hash_description)
+      @published_at     = transform_date(hash_published_at)
+    end
+
+    def snippet
+      @hash['snippet'] || {}
+    end
+
+    def hash_title
+      snippet['title']
+    end
+
+    def hash_description
+      snippet['description']
+    end
+
+    def hash_published_at
+      snippet['publishedAt']
+    end
+
+    def initialize_content_details
+      @uploads_playlist = transform(hash_uploads_playlist)
+      @likes_playlist   = transform(hash_likes_playlist)
+      @google_plus_id   = transform(hash_google_plus_id)
+    end
+
+    def content_details
+      @hash['contentDetails'] || {}
+    end
+
+    def related_playlists
+      content_details['relatedPlaylists']
+    end
+
+    def hash_google_plus_id
+      content_details['googlePlusUserId']
+    end
+
+    def hash_uploads_playlist
+      related_playlists['uploads']
+    end
+
+    def hash_likes_playlist
+      related_playlists['likes']
+    end
+
+    def initialize_statistics
+      @view_count       = transform(hash_view_count)
+      @comment_count    = transform(hash_comment_count)
+      @subscriber_count = transform(hash_subscriber_count)
+      @video_count      = transform(hash_video_count)
+    end
+
+    def statistics
+      @hash['statistics'] || {}
+    end
+
+    def hash_view_count
+      statistics['viewCount']
+    end
+
+    def hash_comment_count
+      statistics['commentCount']
+    end
+
+    def hash_subscriber_count
+      statistics['subscriberCount']
+    end
+
+    def hash_video_count
+      statistics['videoCount']
+    end
+  end
+end

data/lib/brainzz/params/channel_details_params.rb

@@ -0,0 +1,13 @@
+module Brainzz
+  class ChannelDetailsParams
+    attr_reader :channel_ids
+
+    def initialize(channel_ids)
+      @channel_ids = channel_ids
+    end
+
+    def valid?
+      !!(@channel_ids && !@channel_ids.empty?)
+    end
+  end
+end

data/lib/brainzz/responses/channel_details_response.rb

@@ -0,0 +1,5 @@
+module Brainzz
+  class ChannelDetailsResponse < DetailsResponse
+    make_with_model Channel
+  end
+end

data/lib/brainzz/responses/details_response.rb

@@ -0,0 +1,25 @@
+module Brainzz
+  class DetailsResponse < ::Reverb::Response
+    class << self
+      private
+
+      def make_with_model(model)
+        @model = model
+      end
+
+      def model
+        @model
+      end
+    end
+
+    def on_success
+      self.data = {}
+
+      items = body['items'] || []
+      items.each do |item|
+        instance = self.class.send(:model).new(item)
+        self.data[instance.id] = instance
+      end
+    end
+  end
+end

data/lib/brainzz/responses/video_details_response.rb

@@ -1,13 +1,5 @@
 module Brainzz
-  class VideoDetailsResponse < ::Reverb::Response
-    def on_success
-      self.data = {}
-
-      items = body['items'] || []
-      items.each do |item|
-        video = Video.new(item)
-        self.data[video.id] = video
-      end
-    end
+  class VideoDetailsResponse < DetailsResponse
+    make_with_model Video
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brainzz
 version: !ruby/object:Gem::Version
-  version: 0.0.13
+  version: 0.0.14
 platform: ruby
 authors:
 - Travis Herrick
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-07-06 00:00:00.000000000 Z
+date: 2015-07-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -184,6 +184,7 @@ files:
 - lib/brainzz/commands/annotations_clicked_by_day_command.rb
 - lib/brainzz/commands/annotations_clicked_totals_command.rb
 - lib/brainzz/commands/base_command.rb
+- lib/brainzz/commands/channel_details_command.rb
 - lib/brainzz/commands/channel_stats_command.rb
 - lib/brainzz/commands/channel_subscribers_gained_by_day_command.rb
 - lib/brainzz/commands/channel_subscribers_gained_totals_command.rb
@@ -234,6 +235,7 @@ files:
 - lib/brainzz/models/annotations_clickable_count.rb
 - lib/brainzz/models/annotations_clicked_count.rb
 - lib/brainzz/models/base_model.rb
+- lib/brainzz/models/channel.rb
 - lib/brainzz/models/channel_stat.rb
 - lib/brainzz/models/channel_subscribers_gained_count.rb
 - lib/brainzz/models/channel_subscribers_lost_count.rb
@@ -255,6 +257,7 @@ files:
 - lib/brainzz/models/view_percentage.rb
 - lib/brainzz/params/analytics_params.rb
 - lib/brainzz/params/base_params.rb
+- lib/brainzz/params/channel_details_params.rb
 - lib/brainzz/params/channel_stats_params.rb
 - lib/brainzz/params/playlist_items_params.rb
 - lib/brainzz/params/stats_params.rb
@@ -262,9 +265,11 @@ files:
 - lib/brainzz/params/video_stats_params.rb
 - lib/brainzz/responses/annotations_clickable_response.rb
 - lib/brainzz/responses/annotations_clicked_response.rb
+- lib/brainzz/responses/channel_details_response.rb
 - lib/brainzz/responses/channel_subscribers_gained_response.rb
 - lib/brainzz/responses/channel_subscribers_lost_response.rb
 - lib/brainzz/responses/comment_count_response.rb
+- lib/brainzz/responses/details_response.rb
 - lib/brainzz/responses/dislike_count_response.rb
 - lib/brainzz/responses/like_count_response.rb
 - lib/brainzz/responses/playlist_items_response.rb