yt 0.7.1 → 0.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a68ecd01c6ad97c1ba1e12d81d98585021ed0fbd
-  data.tar.gz: b2449d697020efacdaf22a0c4a4a618148ad7e9a
+  metadata.gz: 6dc19edffeaae2714ad047a40032115520edd738
+  data.tar.gz: 3f71e513ce00e106d65739806406953b4388f0b6
 SHA512:
-  metadata.gz: f45cdebb0d4794bf071049b3ad71970dfccefcf25fd9957db5b830a3391cc8074894324127f167f32542b53292b48a375806946370d8b3e5061bdac49c07c823
-  data.tar.gz: fbc25da3f1f339b26e5fc701eddd8043ccbbb978112d8f19318d2e705494bf16ac6f46ab967de57e71921ca5f9bdaaec55d7565a6e31429d9075b2baa3fe2cad
+  metadata.gz: 08d1aa16ee0d6ddbe7f6b15098cbd72bfcbe9e9901bbcf87d1b6abf15e0d10fc73af313173d149fd6610bb73b4e40ace2536579ccbca618030dc97e76da332d9
+  data.tar.gz: ae6645e795bdb55896d4844e9824ce0e3001a8f4a39210418887bbeaa221cef15ecc4ca4ab2f6e6ac0d21a3fcae4409e9f7a080e3171dc5ecabace67b63c0ea9

data/Gemfile.lock

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

data/HISTORY.md

@@ -8,6 +8,7 @@ v0.7 - 2014/06/18
 * More snippet methods for Playlist (channel_id, channel_title)
 * More snippet methods for PlaylistItem (channel_id, channel_title, playlist_id, video_id)
 * More status methods for PlaylistItem (privacy_status, public?, private?, unlisted?)
+* Add video.update to update title, description, tags and categoryId of a video
 
 v0.6 - 2014/06/05
 -----------------

data/README.md

@@ -50,7 +50,7 @@ Yt::Account
 Use [Yt::Account](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/Account) to:
 
 * authenticate as a YouTube account
-* read attributes of the account
+* read the attributes of the account
 * access the YouTube channel of the account
 
 ```ruby
@@ -86,7 +86,7 @@ Yt::Channel
 
 Use [Yt::Channel](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/Channel) to:
 
-* read attributes of a channel
+* read the attributes of a channel
 * access the videos of a channel
 * access the playlists of a channel
 * subscribe to and unsubscribe from a channel
@@ -150,7 +150,8 @@ Yt::Video
 
 Use [Yt::Video](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/Video) to:
 
-* read attributes of a video
+* read the attributes of a video
+* update the attributes of a video
 * access the annotations of a video
 * like and dislike a video
 
@@ -191,12 +192,19 @@ video.like #=> true
 
 *The methods above require to be authenticated as a YouTube account (see below).*
 
+```ruby
+video.update title: 'New title', description: 'New description', tags: ['new tag'], categoryId: '21'
+```
+
+*The methods above require to be authenticated as the video’s owner (see below).*
+
 Yt::Playlist
 ------------
 
 Use [Yt::Playlist](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/Playlist) to:
 
-* read attributes of a playlist
+* read the attributes of a playlist
+* update the attributes of a playlist
 * access the items of a playlist
 * add one or multiple videos to a playlist
 * delete items from a playlist
@@ -223,6 +231,7 @@ playlist.playlist_items.first.video.title #=> "Fullscreen Creator Platform"
 *The methods above do not require authentication.*
 
 ```ruby
+playlist.update title: 'New title', description: 'New description', tags: ['new tag'], privacy_status: 'private'
 playlist.add_video 'MESycYJytkU'
 playlist.add_videos ['MESycYJytkU', 'MESycYJytkU']
 playlist.delete_playlist_items title: 'Fullscreen Creator Platform' #=> [true]
@@ -235,7 +244,7 @@ Yt::PlaylistItem
 
 Use [Yt::PlaylistItem](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/PlaylistItem) to:
 
-* read attributes of a playlist item
+* read the attributes of a playlist item
 * delete a playlist item
 
 ```ruby
@@ -270,7 +279,7 @@ Yt::Annotation
 
 Use [Yt::Annotation](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/Annotation) to:
 
-* read attributes of an annotation
+* read the attributes of an annotation
 
 ```ruby
 video = Yt::Video.new id: 'MESycYJytkU'
@@ -406,7 +415,7 @@ To install on your system, run
 
 To use inside a bundled Ruby project, add this line to the Gemfile:
 
-    gem 'yt', '~> 0.7.1'
+    gem 'yt', '~> 0.7.2'
 
 Since the gem follows [Semantic Versioning](http://semver.org),
 indicating the full version in your Gemfile (~> *major*.*minor*.*patch*)

data/lib/yt/errors/request_error.rb

@@ -35,7 +35,7 @@ module Yt
       end
 
       def response_body
-        json['response_body']
+        json['response_body'].is_a?(Hash) ? json['response_body'] : {}
       end
 
       def request_curl

data/lib/yt/models/video.rb

@@ -5,7 +5,7 @@ module Yt
     # Provides methods to interact with YouTube videos.
     # @see https://developers.google.com/youtube/v3/docs/videos
     class Video < Resource
-      delegate :tags, :channel_id, :channel_title, :category_id, 
+      delegate :tags, :channel_id, :channel_title, :category_id,
         :live_broadcast_content, to: :snippet
 
       # @!attribute [r] content_detail
@@ -28,6 +28,25 @@ module Yt
       delegate :view_count, :like_count, :dislike_count, :favorite_count,
         :comment_count, to: :statistics_set
 
+      # @todo Update the status, not just the snippet. This requires some
+      #   caution, as the whole status object needs to be updated, not just
+      #   privacyStatus, but also embeddable, license, publicStatsViewable,
+      #   and publishAt
+      def update(options = {})
+        options[:title] ||= title
+        options[:description] ||= description
+        options[:tags] ||= tags
+        options[:categoryId] ||= category_id
+        snippet = options.slice :title, :description, :tags, :categoryId
+        body = {id: @id, snippet: snippet}
+
+        do_update(params: {part: 'snippet'}, body: body) do |data|
+          @id = data['id']
+          @snippet = Snippet.new data: data['snippet'] if data['snippet']
+          true
+        end
+      end
+
       # Returns whether the authenticated account likes the video.
       #
       # This method requires {Resource#auth auth} to return an
@@ -74,6 +93,18 @@ module Yt
         rating.update :none
         !liked?
       end
+
+    private
+
+      # @return [Hash] the parameters to submit to YouTube to update a video.
+      # @see https://developers.google.com/youtube/v3/docs/videos/update
+      def update_params
+        super.tap do |params|
+          params[:path] = '/youtube/v3/videos'
+          params[:body_type] = :json
+          params[:expected_response] = Net::HTTPOK
+        end
+      end
     end
   end
 end

data/lib/yt/version.rb

@@ -1,3 +1,3 @@
 module Yt
-  VERSION = '0.7.1'
+  VERSION = '0.7.2'
 end

data/spec/associations/device_auth/video_spec.rb

@@ -1,10 +1,12 @@
+# encoding: UTF-8
+
 require 'spec_helper'
 require 'yt/models/video'
 
 describe Yt::Video, :device_app do
   subject(:video) { Yt::Video.new id: id, auth: $account }
 
-  context 'given an existing video' do
+  context 'given someone else’s video' do
     let(:id) { 'MESycYJytkU' }
 
     it { expect(video.content_detail).to be_a Yt::ContentDetail }
@@ -25,6 +27,7 @@ describe Yt::Video, :device_app do
     it { expect(video.rating).to be_a Yt::Rating }
     it { expect(video.status).to be_a Yt::Status }
     it { expect(video.statistics_set).to be_a Yt::StatisticsSet }
+    it { expect{video.update}.to fail }
 
     context 'that I like' do
       before { video.like }
@@ -54,4 +57,26 @@ describe Yt::Video, :device_app do
     it { expect{video.status}.to raise_error Yt::Errors::NoItems }
     it { expect{video.statistics_set}.to raise_error Yt::Errors::NoItems }
   end
+
+  context 'given one of my own videos that I want to update' do
+    let(:id) { $account.videos.first.id }
+
+    describe 'updates the attributes that I specify explicitly' do
+      # NOTE: The use of UTF-8 characters is to test that we can pass up to
+      # 50 characters, independently of their representation
+      let(:attrs) { {title: "Yt Example Update Video #{rand} - ®•♡❥❦❧☙"} }
+      it { expect(video.update attrs).to eq true }
+      it { expect{video.update attrs}.to change{video.title} }
+    end
+
+    describe 'does not update the other attributes' do
+      let(:attrs) { {} }
+      it { expect(video.update attrs).to eq true }
+      it { expect{video.update attrs}.not_to change{video.title} }
+      it { expect{video.update attrs}.not_to change{video.description} }
+      it { expect{video.update attrs}.not_to change{video.tags} }
+      it { expect{video.update attrs}.not_to change{video.category_id} }
+      it { expect{video.update attrs}.not_to change{video.privacy_status} }
+    end
+  end
 end

data/spec/models/video_spec.rb

@@ -10,4 +10,12 @@ describe Yt::Video do
       it { expect(video.snippet).to be_a Yt::Snippet }
     end
   end
+
+  describe '#update' do
+    let(:attrs) { {id: 'MESycYJytkU', snippet: {'title'=>'old'}} }
+    before { expect(video).to receive(:do_update).and_yield 'snippet'=>{'title'=>'new'} }
+
+    it { expect(video.update title: 'new').to be true }
+    it { expect{video.update title: 'new'}.to change{video.title} }
+  end
 end

metadata

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