yt 0.7.10 → 0.7.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d59d615fd8bb939c84404f9cda73c12135b8ca68
-  data.tar.gz: dc7a6b4c8421c86f2b568263c408876957f7907d
+  metadata.gz: f68323942ee8bbe17cfaee4597c9e608f33c118d
+  data.tar.gz: 745a59c51f7ab201a9fa01f14ddf1613ccf0c8fd
 SHA512:
-  metadata.gz: d08d0ca9a0bb9beeb223f1f26739dbdff3226a969a6d7a1060b6038c8c9a79ae1c969535555994166cd23c367816e399a53a31830868e443fc834f203623df5d
-  data.tar.gz: 2d30fd95cc78bc93b838bf165c2546298de4f192944ead0330d1a20be923e0c470f41a3edce61624565f407d562125917f32eac98e44bba109fd240351ab3977
+  metadata.gz: 470da624d81c6433c66346e55a4d375fec56bf6f10d7d1e730e20956f6afcde80719c95656a0809c4b27e39325e701886076c7c0f5617bd6311dc1e5b06e338d
+  data.tar.gz: fa26426355b8cb643494e483cb1e729d09c1413e5ba78c2d67bee1121a036e5c53ac4031dc86c257e3228c060fe7869ed67580dcd94fdbff48719d357d941076

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    yt (0.7.10)
+    yt (0.7.11)
       activesupport
 
 GEM

data/README.md

@@ -41,7 +41,7 @@ To install on your system, run
 
 To use inside a bundled Ruby project, add this line to the Gemfile:
 
-    gem 'yt', '~> 0.7.10'
+    gem 'yt', '~> 0.7.11'
 
 Since the gem follows [Semantic Versioning](http://semver.org),
 indicating the full version in your Gemfile (~> *major*.*minor*.*patch*)
@@ -158,6 +158,7 @@ channel.dislikes to: 2.days.ago #=> {Tue, 27 May 2014 => 0.0, Wed, 28 May 2014 =
 channel.shares since: 7.days.ago, until: 7.days.ago  #=> {Wed, 28 May 2014 => 3.0}
 
 channel.viewer_percentages #=> {female: {'18-24' => 12.12, '25-34' => 16.16,…}…}
+channel.viewer_percentage(gender: :male) #=> 49.12
 ```
 
 *The methods above require to be authenticated as the channel’s account (see below).*
@@ -175,6 +176,7 @@ channel.shares since: 7.days.ago, until: 7.days.ago  #=> {Wed, 28 May 2014 => 3.
 channel.impressions_on 5.days.ago #=> 157.0
 
 channel.viewer_percentages #=> {female: {'18-24' => 12.12, '25-34' => 16.16,…}…}
+channel.viewer_percentage(gender: :female) #=> 49.12
 ```
 
 *The methods above require to be authenticated as the channel’s content owner (see below).*
@@ -241,6 +243,7 @@ video.dislikes to: 2.days.ago #=> {Tue, 27 May 2014 => 0.0, Wed, 28 May 2014 =>
 video.shares since: 7.days.ago, until: 7.days.ago  #=> {Wed, 28 May 2014 => 3.0}
 
 video.viewer_percentages #=> {female: {'18-24' => 12.12, '25-34' => 16.16,…}…}
+video.viewer_percentage(gender: :female) #=> 49.12
 ```
 
 *The methods above require to be authenticated as the video’s owner (see below).*
@@ -258,6 +261,7 @@ video.shares since: 7.days.ago, until: 7.days.ago  #=> {Wed, 28 May 2014 => 3.0}
 video.impressions_on 5.days.ago #=> 157.0
 
 video.viewer_percentages #=> {female: {'18-24' => 12.12, '25-34' => 16.16,…}…}
+video.viewer_percentage(gender: :female) #=> 49.12
 ```
 
 *The methods above require to be authenticated as the video’s content owner (see below).*

data/lib/yt/associations/has_viewer_percentages.rb

@@ -13,10 +13,16 @@ module Yt
       #       '25-34', '35-44', '45-54', '55-64', '65-')
       #     @example Return the % of male viewers of a channel older than 64
       #       channel.viewer_percentages[:male]['65-'] #=> 12.02
+      #   @!method viewer_percentage(filters = {})
+      #     @return [Float] the percentage of viewer matching the filters.
+      #     @param [Hash] filters The type of viewers to be accounted for.
+      #     @option filters [Symbol] :gender Either :male or :female.
+      #     @example Return the % of male viewers of a video
+      #       channel.viewer_percentage(gender: :male) #=> 52.02
 
-      # Defines a public instance methods to access the viewer percentages of
+      # Defines two public instance methods to access the viewer percentages of
       # a resource for a specific metric.
-      # @example Adds +viewer_percentages+ on a Channel resource.
+      # @example Adds +viewer_percentages+ and +viewer_percentage+ on Channel.
       #   class Channel < Resource
       #     has_viewer_percentages
       #   end
@@ -24,6 +30,7 @@ module Yt
         require 'yt/collections/viewer_percentages'
 
         define_viewer_percentages_method
+        define_viewer_percentage_method
       end
 
     private
@@ -34,6 +41,12 @@ module Yt
           @viewer_percentages ||= Collections::ViewerPercentages.of(self).all
         end
       end
+
+      def define_viewer_percentage_method
+        define_method :viewer_percentage do |filters = {}|
+          viewer_percentages[filters[:gender]].values.sum.round(2)
+        end
+      end
     end
   end
 end

data/lib/yt/version.rb

@@ -1,3 +1,3 @@
 module Yt
-  VERSION = '0.7.10'
+  VERSION = '0.7.11'
 end

data/spec/requests/as_account/channel_spec.rb

@@ -102,6 +102,7 @@ describe Yt::Channel, :device_app do
 
     it 'returns valid reports for channel-related demographics' do
       expect{channel.viewer_percentages}.not_to raise_error
+      expect{channel.viewer_percentage}.not_to raise_error
     end
   end
 

data/spec/requests/as_account/video_spec.rb

@@ -101,6 +101,7 @@ describe Yt::Video, :device_app do
 
     it 'returns valid reports for video-related demographics' do
       expect{video.viewer_percentages}.not_to raise_error
+      expect{video.viewer_percentage}.not_to raise_error
     end
   end
 end

data/spec/requests/as_content_owner/channel_spec.rb

@@ -259,6 +259,9 @@ describe Yt::Channel, :partner do
         expect(channel.viewer_percentages[:male]['45-54']).to be_a Float
         expect(channel.viewer_percentages[:male]['55-64']).to be_a Float
         expect(channel.viewer_percentages[:male]['65-']).to be_a Float
+
+        expect(channel.viewer_percentage(gender: :male)).to be_a Float
+        expect(channel.viewer_percentage(gender: :female)).to be_a Float
       end
     end
 

data/spec/requests/as_content_owner/video_spec.rb

@@ -246,6 +246,9 @@ describe Yt::Video, :partner do
         expect(video.viewer_percentages[:male]['45-54']).to be_a Float
         expect(video.viewer_percentages[:male]['55-64']).to be_a Float
         expect(video.viewer_percentages[:male]['65-']).to be_a Float
+
+        expect(video.viewer_percentage(gender: :male)).to be_a Float
+        expect(video.viewer_percentage(gender: :female)).to be_a Float
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: yt
 version: !ruby/object:Gem::Version
-  version: 0.7.10
+  version: 0.7.11
 platform: ruby
 authors:
 - Claudio Baccigalupo