yt 0.11.0 → 0.11.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 20c3426083692b2c9726ef4c76119e2ad252f51d
-  data.tar.gz: 3e03a4ab33ee8de7c5ea9e9786b05b3bc953790e
+  metadata.gz: 1bca9a6106823c8817aef8eb024c9b54ae1a684d
+  data.tar.gz: a4dd91d6a9be61e077ab502b4268cf7362383142
 SHA512:
-  metadata.gz: d4f963fe983113861da21a13f2cca84011d8a717601c53f5009a6e0304354ea30d605ed31cc14ff8959107592ab6cb913387d27285ff63bf640a26fc08c8e968
-  data.tar.gz: 4ef695b291cb1b97884acdfc26a92130a83c6ed169319add5c9e901e8bb9067e515b992b6250750aeb71053dc1756f53e56a240c4c5fe1aa292a3f26559cf447
+  metadata.gz: 5bcd46f496c2a4cd43a280da1bcea6b54d5527152ed2cf73cae7797ba4eb7033a20f998caf9208d19bc665f9ac9e6ebd2421df48e6f07d4c4171d37414c156f7
+  data.tar.gz: 5da86f76c045a7760ab56ed9022029332c6f2bc75ad2fe10d9750545a0900388f52db27be88e88907e9d893798bd3927de587ce9e5376dbd52eb192104a59ff2

data/CHANGELOG.md

@@ -6,6 +6,17 @@ For more information about changelogs, check
 [Keep a Changelog](http://keepachangelog.com) and
 [Vandamme](http://tech-angels.github.io/vandamme).
 
+## 0.11.1 - 2014-08-17
+
+* [ENHANCEMENT] Add Video search even without a parent account or channel
+
+For instance, to search for the most viewed video on the whole YouTube, run:
+
+```ruby
+videos = Yt::Collections::Videos.new
+videos.where(order: 'viewCount').first.title #=>  "PSY - GANGNAM STYLE"
+```
+
 ## 0.11.0 - 2014-08-17
 
 **How to upgrade**

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    yt (0.11.0)
+    yt (0.11.1)
       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.11.0'
+    gem 'yt', '~> 0.11.1'
 
 Since the gem follows [Semantic Versioning](http://semver.org),
 indicating the full version in your Gemfile (~> *major*.*minor*.*patch*)

data/lib/yt/collections/base.rb

@@ -19,10 +19,25 @@ module Yt
         new parent: parent, auth: parent.auth
       end
 
-      def where(conditions = {})
+      # Adds requirements to the collection in order to limit the result of
+      # List methods to only items that match the requirements.
+      #
+      # Under the hood, all the requirements are passed to the YouTube API
+      # as query parameters, after transforming the keys to camel-case.
+      #
+      # To know which requirements are available for each collection, check
+      # the documentation of the corresponding YouTube API endpoint.
+      # For instance the list of valid requirements to filter a list of videos
+      # are at https://developers.google.com/youtube/v3/docs/search/list
+      #
+      # @example Return the first video of a channel (no requirements):
+      #   video.channels.first
+      # @example Return the first long video of a channel by video count:
+      #   video.channels.where(order: 'viewCount', video_duration: 'long').first
+      def where(requirements = {})
         self.tap do
           @items = []
-          @where_params = conditions
+          @where_params = requirements
         end
       end
 

data/lib/yt/collections/videos.rb

@@ -48,12 +48,13 @@ module Yt
       end
 
       def videos_params
-        @parent.videos_params.tap do |params|
+        {}.tap do |params|
           params[:type] = :video
           params[:max_results] = 50
           params[:part] = 'snippet'
           params[:order] = 'date'
           params[:published_before] = @published_before if @published_before
+          params.merge! @parent.videos_params if @parent
           apply_where_params! params
         end
       end

data/lib/yt/version.rb

@@ -1,3 +1,3 @@
 module Yt
-  VERSION = '0.11.0'
+  VERSION = '0.11.1'
 end

data/spec/requests/as_server_app/videos_spec.rb

@@ -0,0 +1,15 @@
+# encoding: UTF-8
+require 'spec_helper'
+require 'yt/collections/videos'
+
+describe Yt::Collections::Videos, :server_app do
+  subject(:videos) { Yt::Collections::Videos.new }
+
+  specify 'without :where conditions, returns all YouTube videos', :ruby2 do
+    expect(videos.size).to be > 100_000
+  end
+
+  specify 'with a query term, only returns some YouTube videos' do
+    expect(videos.where(q: 'Fullscreen CreatorPlatform', video_duration: :long).size).to be < 100_000
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: yt
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.11.1
 platform: ruby
 authors:
 - Claudio Baccigalupo
@@ -250,6 +250,7 @@ files:
 - spec/requests/as_server_app/playlist_spec.rb
 - spec/requests/as_server_app/resource_spec.rb
 - spec/requests/as_server_app/video_spec.rb
+- spec/requests/as_server_app/videos_spec.rb
 - spec/requests/unauthenticated/video_spec.rb
 - spec/spec_helper.rb
 - spec/support/fail_matcher.rb
@@ -334,6 +335,7 @@ test_files:
 - spec/requests/as_server_app/playlist_spec.rb
 - spec/requests/as_server_app/resource_spec.rb
 - spec/requests/as_server_app/video_spec.rb
+- spec/requests/as_server_app/videos_spec.rb
 - spec/requests/unauthenticated/video_spec.rb
 - spec/spec_helper.rb
 - spec/support/fail_matcher.rb