yt 0.25.1 → 0.25.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e9fd88acf793e77574d16b31819944cd77df882d
-  data.tar.gz: 7e535a7e4c88f91477f2ccc19ce7ad5d4c1968cc
+  metadata.gz: a06e107e7f31f7de48b0d8ff204c767c823c25eb
+  data.tar.gz: edfd691ddfbb02206d8edde88ade590ea16054be
 SHA512:
-  metadata.gz: 8eed1c36c8d41ae347a6bf9f951842446415efdf8bd9df139973122366fda9f772ffcf5aa7da08c87aa576c382c4364ddadfec8ebefa0717e9355874f5bea548
-  data.tar.gz: 0cd8c87df0590b986dd1e72d6f7332dc633505386cfe6514595591efa237828df096ae610cb72ba946edc5024543cb84c45220d0b9bfc26b09a982ac7e437824
+  metadata.gz: 71703d93dc25594789d244709ef378fab971c23dd6920ea8e10e7daa2546d3087a6246d80135e3c5c01ad94b4cf05f4ade40199bff5acb91fcd3cd1065527010
+  data.tar.gz: 874b280fabf0bc5417203724049dfe5915d9d2d6d19c79f8e3b5395f221ad324ead150cae7468bda633e78575aad364560001b2802268addd6376cbe9bae89b1

data/CHANGELOG.md

@@ -6,6 +6,10 @@ For more information about changelogs, check
 [Keep a Changelog](http://keepachangelog.com) and
 [Vandamme](http://tech-angels.github.io/vandamme).
 
+## 0.25.2 - 2015-07-22
+
+* [FEATURE] Add .includes(:video) to .playlist_items to eager-load video data of a list of playlist items.
+
 ## 0.25.1 - 2015-07-06
 
 * [ENHANCEMENT] `Yt::Video.new` accepts embedded video url.

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.25.1'
+    gem 'yt', '~> 0.25.2'
 
 Since the gem follows [Semantic Versioning](http://semver.org),
 indicating the full version in your Gemfile (~> *major*.*minor*.*patch*)
@@ -174,6 +174,24 @@ asset.ownership.release! #=> true
 asset.update metadata_mine: {notes: 'Some notes'} #=> true
 ```
 
+* to retrieve metadata for an asset (e.g. title, notes, description, custom_id)
+
+```ruby
+content_owner = Yt::ContentOwner.new(...)
+asset = content_owner.assets.where(id: 'A969176766549462', fetch_metadata: 'mine').first
+asset.metadata_mine.title #=> "Master Final   Neu La Anh Fix"
+
+asset = content_owner.assets.where(id: 'A969176766549462', fetch_metadata: 'effective').first
+asset.metadata_effective.title #=> "Neu la anh" (different due to ownership conflicts)
+```
+
+* to search for an asset
+
+```ruby
+content_owner.assets.where(labels: "campaign:cpiuwdz-8oc").size #=> 417
+content_owner.assets.where(labels: "campaign:cpiuwdz-8oc").first.title #=> "Whoomp! (Supadupafly) (Xxl Hip House Mix)"
+```
+
 Yt::Claim
 ---------
 

data/lib/yt/collections/playlist_items.rb

@@ -16,7 +16,23 @@ module Yt
       def attributes_for_new_item(data)
         snippet = data.fetch 'snippet', {}
         data['snippet'].reverse_merge! complete: snippet.key?('position')
-        super(data)
+        super(data).tap do |attributes|
+          attributes[:video] = data['video']
+        end
+      end
+
+      def eager_load_items_from(items)
+        if included_relationships.include?(:video)
+          video_ids = items.map{|item| item['snippet']['resourceId']['videoId']}.uniq
+          conditions = {id: video_ids.join(',')}
+          conditions[:part] = 'snippet,status,statistics'
+          videos = Collections::Videos.new(auth: @auth).where conditions
+          items.each do |item|
+            video = videos.find{|v| v.id == item['snippet']['resourceId']['videoId']}
+            item['video'] = video
+          end
+        end
+        super
       end
 
       # @return [Hash] the parameters to submit to YouTube to list playlist items.

data/lib/yt/models/playlist_item.rb

@@ -88,6 +88,13 @@ module Yt
         !@id.nil?
       end
 
+      # @private
+      # Override Resource's new to set video if the response includes it
+      def initialize(options = {})
+        super options
+        @video = options[:video] if options[:video]
+      end
+
     private
 
       def resource_id

data/lib/yt/request.rb

@@ -202,6 +202,7 @@ module Yt
       [
         OpenSSL::SSL::SSLError,
         Errno::ETIMEDOUT,
+        Errno::EHOSTUNREACH,
         Errno::ENETUNREACH,
         Errno::ECONNRESET,
         Net::HTTPServerError

data/lib/yt/version.rb

@@ -1,3 +1,3 @@
 module Yt
-  VERSION = '0.25.1'
+  VERSION = '0.25.2'
 end

data/spec/models/request_spec.rb

@@ -117,6 +117,27 @@ describe Yt::Request do
         end
       end
 
+      # NOTE: This test is just a reflection of YouTube irrational behavior of
+      # being unavailable once in a while, and therefore causing Net::HTTP to
+      # fail, although retrying after some seconds works.
+      context 'an Errno::EHOSTUNREACH' do
+        let(:http_error) { Errno::EHOSTUNREACH.new }
+
+        context 'every time' do
+          before { expect(Net::HTTP).to receive(:start).at_least(:once).and_raise http_error }
+
+          it { expect{request.run}.to fail }
+        end
+
+        context 'but works the second time' do
+          before { expect(Net::HTTP).to receive(:start).at_least(:once).and_return retry_response }
+          before { allow(retry_response).to receive(:body) }
+          let(:retry_response) { Net::HTTPOK.new nil, nil, nil }
+
+          it { expect{request.run}.not_to fail }
+        end
+      end
+
       # NOTE: This test is just a reflection of YouTube irrational behavior of
       # being unavailable once in a while, and therefore causing Net::HTTP to
       # fail, although retrying after some seconds works.

data/spec/requests/as_account/playlist_spec.rb

@@ -20,9 +20,31 @@ describe Yt::Playlist, :device_app do
       expect(playlist.privacy_status).to be_a String
     end
 
-    it { expect(playlist.playlist_items.first).to be_a Yt::PlaylistItem }
-    it { expect(playlist.playlist_items.first.snippet).to be_complete }
-    it { expect(playlist.playlist_items.first.position).not_to be_nil }
+    describe '.playlist_items' do
+      let(:item) { playlist.playlist_items.first }
+
+      specify 'returns the playlist item with the complete snippet' do
+        expect(item).to be_a Yt::PlaylistItem
+        expect(item.snippet).to be_complete
+        expect(item.position).not_to be_nil
+      end
+
+      specify 'does not eager-load the attributes of the item’s video' do
+        expect(item.video.instance_variable_defined? :@snippet).to be false
+        expect(item.video.instance_variable_defined? :@status).to be false
+        expect(item.video.instance_variable_defined? :@statistics_set).to be false
+      end
+    end
+
+    describe '.playlist_items.includes(:video)' do
+      let(:item) { playlist.playlist_items.includes(:video).first }
+
+      specify 'eager-loads the snippet, status and statistics of each video' do
+        expect(item.video.instance_variable_defined? :@snippet).to be true
+        expect(item.video.instance_variable_defined? :@status).to be true
+        expect(item.video.instance_variable_defined? :@statistics_set).to be true
+      end
+    end
   end
 
   context 'given an unknown playlist' do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yt
 version: !ruby/object:Gem::Version
-  version: 0.25.1
+  version: 0.25.2
 platform: ruby
 authors:
 - Claudio Baccigalupo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-07-06 00:00:00.000000000 Z
+date: 2015-07-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport