yt 0.7.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2a5cb2545b6f99eea1e0198c6109efd72a30c3eb
-  data.tar.gz: 9c1782a564c0705ce405d867d4f4b0d29f1b7b34
+  metadata.gz: a68ecd01c6ad97c1ba1e12d81d98585021ed0fbd
+  data.tar.gz: b2449d697020efacdaf22a0c4a4a618148ad7e9a
 SHA512:
-  metadata.gz: 9f10cbdd0d96b4cc395064814b0aa4cb85b6769ee71981415092797bb9d5931ce35e856560592c3960602e007798894a206df96e4454e60128f86216e7cc61a9
-  data.tar.gz: 9966a633b35554e6716245eb7da8d786bd9f3d79cdf29c77c1bc09101b26348d5031f856e2a33e194ae8d64c9a600bbd131f1c88b44afc1ea2aeabc7f5300aaa
+  metadata.gz: f45cdebb0d4794bf071049b3ad71970dfccefcf25fd9957db5b830a3391cc8074894324127f167f32542b53292b48a375806946370d8b3e5061bdac49c07c823
+  data.tar.gz: fbc25da3f1f339b26e5fc701eddd8043ccbbb978112d8f19318d2e705494bf16ac6f46ab967de57e71921ca5f9bdaaec55d7565a6e31429d9075b2baa3fe2cad

data/Gemfile.lock

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

data/HISTORY.md

@@ -4,6 +4,10 @@ v0.7 - 2014/06/18
 * [breaking change] Rename DetailsSet to ContentDetail
 * Add statistics_set to Video (views, likes, dislikes, favorites, comments)
 * Add statistics_set to Channel (views, comments, videos, subscribers)
+* More snippet methods for Video (channel_id, channel_title, category_id, live_broadcast_content)
+* 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?)
 
 v0.6 - 2014/06/05
 -----------------

data/README.md

@@ -17,13 +17,8 @@ After [registering your app](#configuring-your-app), you can run commands like:
 ```ruby
 channel = Yt::Channel.new id: 'UCxO1tY8h1AhOz0T4ENwmpow'
 channel.title #=> "Fullscreen"
-channel.description #=> "The first media company for the connected generation."
 channel.public? #=> true
-channel.view_count #=> 421619
 channel.comment_count #=> 773
-channel.video_count #=> 13
-channel.subscriber_count #=> 136925
-channel.subscriber_count_visible? #=> true
 channel.videos.count #=> 13
 ```
 
@@ -63,7 +58,7 @@ Use [Yt::Account](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/Acco
 account = Yt::Account.new access_token: 'ya29.1.ABCDEFGHIJ'
 
 account.email #=> .. your e-mail address..
-account.channel #=> #<Yt::Channel @id=...>
+account.channel #=> #<Yt::Models::Channel @id=...>
 ```
 
 *All the above methods require authentication (see below).*
@@ -81,7 +76,7 @@ Use [Yt::ContentOwner](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models
 content_owner = Yt::ContentOwner.new owner_name: 'CMSname', access_token: 'ya29.1.ABCDEFGHIJ'
 
 content_owner.partnered_channels.count #=> 12
-content_owner.partnered_channels.first #=> #<Yt::Channel @id=...>
+content_owner.partnered_channels.first #=> #<Yt::Models::Channel @id=...>
 ```
 
 *All the above methods require authentication (see below).*
@@ -100,15 +95,25 @@ Use [Yt::Channel](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/Chan
 
 ```ruby
 channel = Yt::Channel.new id: 'UCxO1tY8h1AhOz0T4ENwmpow'
+
 channel.title #=> "Fullscreen"
+channel.description #=> "The first media company for the connected generation."
 channel.description.has_link_to_playlist? #=> false
+channel.thumbnail_url #=> "https://yt3.ggpht.com/-KMnbKDBl60w/AAAAAAAAAAI/AAAAAAAAAAA/NjmFYOCVig4/s88-c-k-no/photo.jpg"
+channel.published_at #=> 2006-03-23 06:13:25 UTC
 channel.public? #=> true
 
+channel.view_count #=> 421619
+channel.comment_count #=> 773
+channel.video_count #=> 13
+channel.subscriber_count #=> 136925
+channel.subscriber_count_visible? #=> true
+
 channel.videos.count #=> 12
-channel.videos.first #=> #<Yt::Video @id=...>
+channel.videos.first #=> #<Yt::Models::Video @id=...>
 
 channel.playlists.count #=> 2
-channel.playlists.first #=> #<Yt::Playlist @id=...>
+channel.playlists.first #=> #<Yt::Models::Playlist @id=...>
 ```
 
 *The methods above do not require authentication.*
@@ -140,7 +145,6 @@ channel.views since: 3.days.ago, until: 2.days.ago #=> {Wed, 28 May 2014 => 12,
 
 *The methods above require to be authenticated as the channel’s content owner (see below).*
 
-
 Yt::Video
 -----------
 
@@ -152,13 +156,27 @@ Use [Yt::Video](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/Video)
 
 ```ruby
 video = Yt::Video.new id: 'MESycYJytkU'
+
 video.title #=> "Fullscreen Creator Platform"
-video.duration #=> 63
-video.description.has_link_to_subscribe? #=> false
+video.description #=> "The new Fullscreen Creator Platform gives creators and brands a suite of exclusive Fullscreen Apps to build, manage and monetize their YouTube audience..."
+video.description.has_link_to_channel? #=> true
+video.thumbnail_url #=> "https://i1.ytimg.com/vi/MESycYJytkU/default.jpg"
+video.published_at #=> 2013-07-09 16:27:32 UTC
 video.public? #=> true
+video.tags #=> []
+video.channel_id #=> "UCxO1tY8h1AhOz0T4ENwmpow"
+video.channel_title #=> "Fullscreen"
+video.category_id #=> "22"
+video.live_broadcast_content #=> "none"
+
+video.duration #=> 86
+video.hd? #=> true
+video.stereoscopic? #=> false
+video.captioned? #=> true
+video.licensed? #=> false
 
 video.annotations.count #=> 1
-video.annotations.first #=> #<Yt::Annotation @id=...>
+video.annotations.first #=> #<Yt::Models::Annotation @id=...>
 ```
 
 *The methods above do not require authentication.*
@@ -185,11 +203,19 @@ Use [Yt::Playlist](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/Pla
 
 ```ruby
 playlist = Yt::Playlist.new id: 'PLSWYkYzOrPMRCK6j0UgryI8E0NHhoVdRc'
+
 playlist.title #=> "Fullscreen Features"
+playlist.description #=> "You send us your best videos and we feature our favorite ones throughout the week!"
+playlist.description.has_link_to_subscribe? #=> false
+playlist.thumbnail_url #=> "https://i1.ytimg.com/vi/36kL2alg7Jk/default.jpg"
+playlist.published_at #=> 2012-11-27 21:23:38 UTC
 playlist.public? #=> true
+playlist.tags #=> []
+playlist.channel_id #=> "UCxO1tY8h1AhOz0T4ENwmpow"
+playlist.channel_title #=> "Fullscreen"
 
 playlist.playlist_items.count #=> 1
-playlist.playlist_items.first #=> #<Yt::PlaylistItem @id=...>
+playlist.playlist_items.first #=> #<Yt::Models::PlaylistItem @id=...>
 playlist.playlist_items.first.position #=> 0
 playlist.playlist_items.first.video.title #=> "Fullscreen Creator Platform"
 ```
@@ -204,6 +230,40 @@ playlist.delete_playlist_items title: 'Fullscreen Creator Platform' #=> [true]
 
 *The methods above require to be authenticated as the playlist’s owner (see below).*
 
+Yt::PlaylistItem
+----------------
+
+Use [Yt::PlaylistItem](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/PlaylistItem) to:
+
+* read attributes of a playlist item
+* delete a playlist item
+
+```ruby
+item = Yt::PlaylistItem.new id: 'PLjW_GNR5Ir0GWEP_oveGBNjTvKkYyZfsna1TZDCBP-Z8'
+
+item.title #=> "Titanium - David Guetta - Space Among Many Cover ft. Evan Chan and Glenna Roberts"
+item.description #=> "CLICK to tweet this video: [...]"
+item.description.has_link_to_channel? #=> true
+item.thumbnail_url #=> "https://i1.ytimg.com/vi/W4GhTprSsOY/default.jpg"
+item.published_at #=> 2012-12-22 19:38:02 UTC
+item.public? #=> true
+item.channel_id #=> "UCxO1tY8h1AhOz0T4ENwmpow"
+item.channel_title #=> "Fullscreen"
+item.playlist_id #=> "PLSWYkYzOrPMRCK6j0UgryI8E0NHhoVdRc"
+item.position #=> 0
+item.video_id #=> "W4GhTprSsOY"
+item.video #=> #<Yt::Models::Video @id=...>
+
+```
+
+*The methods above do not require authentication.*
+
+```ruby
+item.delete #=> true
+```
+
+*The methods above require to be authenticated as the playlist’s owner (see below).*
+
 
 Yt::Annotation
 --------------
@@ -346,7 +406,7 @@ To install on your system, run
 
 To use inside a bundled Ruby project, add this line to the Gemfile:
 
-    gem 'yt', '~> 0.7.0'
+    gem 'yt', '~> 0.7.1'
 
 Since the gem follows [Semantic Versioning](http://semver.org),
 indicating the full version in your Gemfile (~> *major*.*minor*.*patch*)

data/lib/yt/collections/snippets.rb

@@ -10,7 +10,7 @@ module Yt
       # @return [Yt::Models::Snippet] a new snippet initialized with
       #   one of the items returned by asking YouTube for a list of snippets.
       def new_item(data)
-        Yt::Snippet.new data: data['snippet']
+        Yt::Snippet.new data: data['snippet'], auth: @auth
       end
 
       # @return [Hash] the parameters to submit to YouTube to get the
@@ -19,9 +19,15 @@ module Yt
       def list_params
         super.tap do |params|
           params[:params] = {id: @parent.id, part: 'snippet'}
-          params[:path] = "/youtube/v3/#{@parent.kind.pluralize}"
         end
       end
+
+      # @private
+      # @note Snippets overrides +list_resources+ since the endpoint is not 
+      #   '/snippets' but the endpoint related to the snippet’s resource.
+      def list_resources
+        @parent.class.to_s.pluralize
+      end
     end
   end
 end

data/lib/yt/collections/statuses.rb

@@ -21,9 +21,15 @@ module Yt
       def list_params
         super.tap do |params|
           params[:params] = {id: @parent.id, part: 'status'}
-          params[:path] = "/youtube/v3/#{@parent.kind.pluralize}"
         end
       end
+
+      # @private
+      # @note Statuses overrides +list_resources+ since the endpoint is not 
+      #   '/statuses' but the endpoint related to the snippet’s resource.
+      def list_resources
+        @parent.class.to_s.pluralize
+      end
     end
   end
 end

data/lib/yt/models/account.rb

@@ -16,9 +16,8 @@ module Yt
       # @!attribute [r] user_info
       #   @return [Yt::Models::UserInfo] the account’s profile information.
       has_one :user_info
-      delegate :id, :email, :has_verified_email?, :gender, :name,
-               :given_name, :family_name, :profile_url, :avatar_url,
-               :locale, :hd, to: :user_info
+      delegate :id, :email, :has_verified_email?, :gender, :name, :given_name,
+        :family_name, :profile_url, :avatar_url, :locale, :hd, to: :user_info
 
       # @!attribute [r] videos
       #   @return [Yt::Collections::Videos] the videos owned by the account.

data/lib/yt/models/channel.rb

@@ -22,12 +22,11 @@ module Yt
       #   @return [Yt::Collections::Playlists] the channel’s playlists.
       has_many :playlists
 
-
       # @!attribute [r] statistics_set
       #   @return [Yt::Models::StatisticsSet] the statistics for the video.
       has_one :statistics_set
       delegate :view_count, :comment_count, :video_count, :subscriber_count,
-               :subscriber_count_visible?, to: :statistics_set
+        :subscriber_count_visible?, to: :statistics_set
 
       # Returns whether the authenticated account is subscribed to the channel.
       #

data/lib/yt/models/playlist.rb

@@ -5,6 +5,7 @@ module Yt
     # Provides methods to interact with YouTube playlists.
     # @see https://developers.google.com/youtube/v3/docs/playlists
     class Playlist < Resource
+      delegate :tags, :channel_id, :channel_title, to: :snippet
 
       # @!attribute [r] playlist_items
       #   @return [Yt::Collections::PlaylistItems] the playlist’s items.

data/lib/yt/models/playlist_item.rb

@@ -1,28 +1,12 @@
-require 'yt/models/base'
+require 'yt/models/resource'
 
 module Yt
   module Models
     # Provides methods to interact with YouTube playlist items.
     # @see https://developers.google.com/youtube/v3/docs/playlistItems
-    class PlaylistItem < Base
-      # @return [String] the ID that uniquely identify a YouTube playlist item.
-      attr_reader :id
-
-      # @return [String] the order in which the item appears in the playlist.
-      #   The value uses a zero-based index, so the first item has a position
-      #   of 0, the second item has a position of 1, and so forth.
-      attr_reader :position
-
-      attr_reader :video
-
-      def initialize(options = {})
-        @id = options[:id]
-        @auth = options[:auth]
-        if options[:snippet]
-          @position = options[:snippet]['position']
-          @video = Video.new video_params_for options
-        end
-      end
+    class PlaylistItem < Resource
+      delegate :channel_id, :channel_title, :playlist_id, :position, :video_id,
+        :video, to: :snippet
 
       def delete(options = {})
         do_delete {@id = nil}
@@ -43,14 +27,6 @@ module Yt
           params[:params] = {id: @id}
         end
       end
-
-      def video_params_for(options = {})
-        {}.tap do |params|
-          params[:id] = options[:snippet].fetch('resourceId', {})['videoId']
-          params[:snippet] = options[:snippet].except 'resourceId'
-          params[:auth] = options[:auth]
-        end
-      end
     end
   end
 end

data/lib/yt/models/resource.rb

@@ -9,7 +9,7 @@ module Yt
 
       has_one :snippet
       delegate :title, :description, :thumbnail_url, :published_at,
-               :tags, to: :snippet
+        to: :snippet
 
       has_one :status
       delegate :privacy_status, :public?, :private?, :unlisted?, to: :status

data/lib/yt/models/snippet.rb

@@ -2,50 +2,123 @@ require 'yt/models/description'
 
 module Yt
   module Models
-    # Encapsulates information about the snippet of a resource, for
-    # instance a channel.
+    # Contains basic information about the resource. The details of the snippet
+    # are different for the different types of resources. Resources with a
+    # snippet are: channels, videos, playlists, playlist items.
     # @see https://developers.google.com/youtube/v3/docs/channels#resource
+    # @see https://developers.google.com/youtube/v3/docs/videos#resource
     class Snippet
       def initialize(options = {})
         @data = options[:data]
+        @auth = options[:auth]
       end
 
       # @return [String] the resource’s title.
+      #   For channels: the channel’s title.
+      #   For videos: the video’s title. Has a maximum of 100 characters and
+      #     may contain all valid UTF-8 characters except < and >.
+      #   For playlists: the playlist’s title.
+      #   For playlist items: the item’s title.
       def title
         @title ||= @data.fetch 'title', ''
       end
 
       # @return [Yt::Models::Description] the resource’s description.
+      #   For channels: the channel’s description. Has a maximum of 1000
+      #     characters.
+      #   For videos: the video’s description. Has a maximum of 5000 bytes and
+      #     may contain all valid UTF-8 characters except < and >.
+      #   For playlists: the playlist’s description.
+      #   For playlist items: the item’s description.
       def description
         @description ||= Description.new @data.fetch('description', '')
       end
 
-      # @return [Time or nil] the date and time that the resource was created.
+      # @return [Time] the date and time that the resource was published.
+      #   For channels: the date and time that the channel was created.
+      #   For videos: the date and time that the video was published.
+      #   For playlists: the date and time that the playlist was created.
+      #   For playlist items: the date and time that the item was added to the
+      #     playlist.
       def published_at
         @published_at ||= Time.parse @data['publishedAt']
       end
 
-      # Return the tags of a YouTube resource.
-      #
-      # @return [Array] An array of Yt::Tag object, one for each tag of the resource.
-      #
-      # @note YouTube API only includes tags in a resource’s snippet if the
-      #       resource is a video belonging to the authenticated account.
-      def tags
-        @tags ||= @data.fetch 'tags', []
-      end
-
-      # @return [String] a thumbnail image associated with the resource.
       # @param [Symbol or String] size The size of the thumbnail to retrieve.
-      #   Valid values are: default, medium, high.
-      #   For a resource that refers to a video, default equals 120x90px,
-      #   medium equals 320x180px, high equals 480x360px.
-      #   For a resource that refers to a channel, default equals 88x88px,
-      #   medium equals 240x240px, high equals 800x800px.
+      # @return [String or nil] a thumbnail image associated with the resource.
+      #   For channels: sizes correspond to 88x88px (default), 240x240px
+      #     (medium), and 800x800px (high).
+      #   For videos, playlists, playlist items: sizes correspond to 120x90px
+      #     (default), 320x180px (medium), and 480x360px (high).
       def thumbnail_url(size = :default)
         @thumbnails ||= @data.fetch 'thumbnails', {}
         @thumbnails.fetch(size.to_s, {})['url']
       end
+
+      # @return [String or nil] the ID of the related channel.
+      #   For videos: the ID that YouTube uses to uniquely identify the
+      #     channel that the video was uploaded to.
+      #   For playlists: the ID that YouTube uses to uniquely identify the
+      #     channel that published the playlist.
+      #   For playlist items: the ID that YouTube uses to uniquely identify
+      #     the user that added the item to the playlist.
+      def channel_id
+        @channel_id ||= @data['channelId']
+      end
+
+      # @return [String or nil] the title of the related channel.
+      #   For videos: the title of the channel the video belongs to.
+      #   For playlists: the title of the channel the playlist belongs to.
+      #   For playlist items: the title of the channel the playlist item
+      #     belongs to.
+      def channel_title
+        @channel_title ||= @data['channelTitle']
+      end
+
+      # @return [Array<Yt::Models::Tag>] A list of associated keyword tags.
+      #   For videos: tags are only visible to the video’s uploader.
+      #   For playlists: keyword tags associated with the playlist.
+      def tags
+        @tags ||= @data.fetch 'tags', []
+      end
+
+      # @return [String or nil] the YouTube video category associated with the
+      #   video (for videos only).
+      # @see https://developers.google.com/youtube/v3/docs/videoCategories/list
+      def category_id
+        @category_id ||= @data['categoryId']
+      end
+
+      # @return [String or nil] whether the resource is an upcoming/active live
+      #   broadcast. Valid values are: live, none, upcoming (for videos only).
+      def live_broadcast_content
+        @live_broadcast_content ||= @data['liveBroadcastContent']
+      end
+
+      # @return [String or nil] the ID that YouTube uses to uniquely identify
+      #   the playlist that the item is in (for playlist items only).
+      def playlist_id
+        @playlist_id ||= @data['playlistId']
+      end
+
+      # @return [Integer or nil] the order in which the item appears in a
+      #   playlist. The value is zero-based, so the first item has a position
+      #   of 0, the second item of 1, and so forth (for playlist items only).
+      def position
+        @position ||= @data['position'].to_i
+      end
+
+      # @return [String or nil] the ID of the video the playlist item
+      #   represents in the playlist (only for playlist items).
+      def video_id
+        @video_id ||= @data.fetch('resourceId', {})['videoId']
+      end
+
+      # @return [Yt::Models::Video or nil] the video the playlist item
+      #   represents in the playlist (only for playlist items).
+      def video
+        @video ||= Video.new id: video_id, auth: @auth if video_id
+      end
     end
   end
 end

data/lib/yt/models/statistics_set.rb

@@ -6,7 +6,6 @@ module Yt
     # the resource has been viewed or liked.
     # @see https://developers.google.com/youtube/v3/docs/videos#resource
     class StatisticsSet < Base
-
       def initialize(options = {})
         @data = options[:data]
       end

data/lib/yt/models/video.rb

@@ -5,11 +5,14 @@ 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, 
+        :live_broadcast_content, to: :snippet
+
       # @!attribute [r] content_detail
       #   @return [Yt::Models::ContentDetail] the video’s content details.
       has_one :content_detail
       delegate :duration, :hd?, :stereoscopic?, :captioned?, :licensed?,
-               to: :content_detail
+        to: :content_detail
 
       # @!attribute [r] rating
       #   @return [Yt::Models::Rating] the video’s rating.
@@ -23,7 +26,7 @@ module Yt
       #   @return [Yt::Models::StatisticsSet] the statistics for the video.
       has_one :statistics_set
       delegate :view_count, :like_count, :dislike_count, :favorite_count,
-               :comment_count, to: :statistics_set
+        :comment_count, to: :statistics_set
 
       # Returns whether the authenticated account likes the video.
       #

data/lib/yt/version.rb

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

data/spec/associations/device_auth/channel_spec.rb

@@ -4,88 +4,46 @@ require 'spec_helper'
 require 'yt/models/channel'
 
 describe Yt::Channel, :device_app do
-  let(:channel) { Yt::Channel.new id: id, auth: $account }
+  subject(:channel) { Yt::Channel.new id: id, auth: $account }
 
-  describe '.snippet of existing channel' do
+  context 'given someone else’s channel' do
     let(:id) { 'UCxO1tY8h1AhOz0T4ENwmpow' }
-    it { expect(channel.snippet).to be_a Yt::Snippet }
-  end
-
-  describe '.snippet of unknown channel' do
-    let(:id) { 'not-a-channel-id' }
-    it { expect{channel.snippet}.to raise_error Yt::Errors::NoItems }
-  end
-
-  describe '.statistics_set of existing channel' do
-    let(:id) { 'UCxO1tY8h1AhOz0T4ENwmpow' }
-    it { expect(channel.statistics_set).to be_a Yt::StatisticsSet }
-  end
 
-  describe '.statistics_set of unknown channel' do
-    let(:id) { 'not-a-channel-id' }
-    it { expect{channel.statistics_set}.to raise_error Yt::Errors::NoItems }
-  end
+    it 'returns valid snippet data' do
+      expect(channel.snippet).to be_a Yt::Snippet
+      expect(channel.title).to be_a String
+      expect(channel.description).to be_a Yt::Description
+      expect(channel.thumbnail_url).to be_a String
+      expect(channel.published_at).to be_a Time
+    end
 
-  describe '.status of existing channel' do
-    let(:id) { 'UCxO1tY8h1AhOz0T4ENwmpow' }
     it { expect(channel.status).to be_a Yt::Status }
-  end
-
-  describe '.status of unknown channel' do
-    let(:id) { 'not-a-channel-id' }
-    it { expect{channel.status}.to raise_error Yt::Errors::NoItems }
-  end
-
-  describe '.videos of existing channel' do
-    let(:id) { 'UCxO1tY8h1AhOz0T4ENwmpow' }
+    it { expect(channel.statistics_set).to be_a Yt::StatisticsSet }
     it { expect(channel.videos).to be_a Yt::Collections::Videos }
-  end
-
-  describe '.videos of unknown channel starting with UC' do
-    let(:id) { 'UC-not-a-channel-id' }
-
-    # NOTE: This test is just a reflection of YouTube irrational behavior of
-    # returns 0 results if the name of an unknown channel starts with UC, but
-    # returning 100,000 results otherwise (ignoring the channel filter).
-    it { expect(channel.videos.count).to be 0 }
-  end
-
-  describe '.subscriptions to an existing channel' do
-    let(:id) { 'UCxO1tY8h1AhOz0T4ENwmpow' }
+    it { expect(channel.videos.first).to be_a Yt::Video }
+    it { expect(channel.playlists).to be_a Yt::Collections::Playlists }
+    it { expect(channel.playlists.first).to be_a Yt::Playlist }
+    it { expect{channel.create_playlist}.to raise_error Yt::Errors::RequestError }
+    it { expect{channel.delete_playlists}.to raise_error Yt::Errors::RequestError }
     it { expect(channel.subscriptions).to be_a Yt::Collections::Subscriptions }
 
     # NOTE: These tests are slow because we *must* wait some seconds between
     # subscribing and unsubscribing to a channel, otherwise YouTube will show
     # wrong (cached) data, such as a user is subscribed when he is not.
-    context 'can be added', :slow do
+    context 'that I am not subscribed to', :slow do
       before { channel.unsubscribe }
       it { expect(channel.subscribed?).to be false }
       it { expect(channel.subscribe!).to be_truthy }
     end
 
-    context 'can be removed', :slow do
+    context 'that I am subscribed to', :slow do
       before { channel.subscribe }
       it { expect(channel.subscribed?).to be true }
       it { expect(channel.unsubscribe!).to be_truthy }
     end
   end
 
-  describe '.subscriptions to an unknown channel' do
-    let(:id) { 'not-a-channel-id' }
-    it { expect{channel.subscribe}.to raise_error Yt::Errors::RequestError }
-  end
-
-  describe '.subscriptions to my own channel' do
-    let(:id) { $account.channel.id }
-
-    # NOTE: This test is just a reflection of YouTube irrational behavior of
-    # raising a 500 error when you try to subscribe to your own channel, rather
-    # than a more logical 4xx error. Hopefully this will get fixed and this
-    # code (and test) removed.
-    it { expect{channel.subscribe}.to raise_error Yt::Errors::ServerError }
-  end
-
-  describe '.playlists of my own channel' do
+  context 'given my own channel' do
     let(:id) { $account.channel.id }
     let(:title) { 'Yt Test title' }
     let(:description) { 'Yt Test description' }
@@ -93,15 +51,13 @@ describe Yt::Channel, :device_app do
     let(:privacy_status) { 'unlisted' }
     let(:params) { {title: title, description: description, tags: tags, privacy_status: privacy_status} }
 
-    it { expect(channel.playlists).to be_a Yt::Collections::Playlists }
-
-    describe 'can be created' do
+    describe 'playlists can be added' do
       after { channel.delete_playlists params }
       it { expect(channel.create_playlist params).to be_a Yt::Playlist }
       it { expect{channel.create_playlist params}.to change{channel.playlists.count}.by(1) }
     end
 
-    describe 'can be deleted' do
+    describe 'playlists can be deleted' do
       let(:title) { "Yt Test Delete All Playlists #{rand}" }
       before { channel.create_playlist params }
 
@@ -109,16 +65,29 @@ describe Yt::Channel, :device_app do
       it { expect(channel.delete_playlists params).to eq [true] }
       it { expect{channel.delete_playlists params}.to change{channel.playlists.count}.by(-1) }
     end
+
+    # NOTE: This test is just a reflection of YouTube irrational behavior of
+    # raising a 500 error when you try to subscribe to your own channel,
+    # rather than a more logical 4xx error. Hopefully this will get fixed
+    # and this code (and test) removed.
+    it { expect{channel.subscribe}.to raise_error Yt::Errors::ServerError }
   end
 
-  describe '.playlists of someone else’s channel' do
-    let(:id) { 'UCxO1tY8h1AhOz0T4ENwmpow' }
+  context 'given an unknown channel' do
+    let(:id) { 'not-a-channel-id' }
 
-    it { expect(channel.playlists).to be_a Yt::Collections::Playlists }
+    it { expect{channel.snippet}.to raise_error Yt::Errors::NoItems }
+    it { expect{channel.status}.to raise_error Yt::Errors::NoItems }
+    it { expect{channel.statistics_set}.to raise_error Yt::Errors::NoItems }
+    it { expect{channel.subscribe}.to raise_error Yt::Errors::RequestError }
+
+    describe 'starting with UC' do
+      let(:id) { 'UC-not-a-channel-id' }
 
-    describe 'cannot be created or destroyed' do
-      it { expect{channel.create_playlist}.to raise_error Yt::Errors::RequestError }
-      it { expect{channel.delete_playlists}.to raise_error Yt::Errors::RequestError }
+      # NOTE: This test is just a reflection of YouTube irrational behavior of
+      # returns 0 results if the name of an unknown channel starts with UC, but
+      # returning 100,000 results otherwise (ignoring the channel filter).
+      it { expect(channel.videos.count).to be 0 }
     end
   end
 end

data/spec/associations/device_auth/playlist_item_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+require 'yt/models/playlist_item'
+
+describe Yt::PlaylistItem, :device_app do
+  subject(:item) { Yt::PlaylistItem.new id: id, auth: $account }
+
+  context 'given an existing playlist item' do
+    let(:id) { 'PLjW_GNR5Ir0GWEP_oveGBNjTvKkYyZfsna1TZDCBP-Z8' }
+
+    it 'returns valid snippet data' do
+      expect(item.snippet).to be_a Yt::Snippet
+      expect(item.title).to be_a String
+      expect(item.description).to be_a Yt::Description
+      expect(item.thumbnail_url).to be_a String
+      expect(item.published_at).to be_a Time
+      expect(item.channel_id).to be_a String
+      expect(item.channel_title).to be_a String
+      expect(item.playlist_id).to be_a String
+      expect(item.position).to be_an Integer
+      expect(item.video_id).to be_a String
+      expect(item.video).to be_a Yt::Models::Video
+    end
+  end
+
+  context 'given an unknown playlist item' do
+    let(:id) { 'not-a-playlist-item-id' }
+
+    it { expect{item.snippet}.to raise_error Yt::Errors::RequestError }
+  end
+end

data/spec/associations/device_auth/playlist_spec.rb

@@ -4,53 +4,63 @@ require 'spec_helper'
 require 'yt/models/playlist'
 
 describe Yt::Playlist, :device_app do
-  let(:playlist) { Yt::Playlist.new id: id, auth: $account }
+  subject(:playlist) { Yt::Playlist.new id: id, auth: $account }
 
-  describe '.snippet of existing playlist' do
+  context 'given an existing playlist' do
     let(:id) { 'PLSWYkYzOrPMRCK6j0UgryI8E0NHhoVdRc' }
-    it { expect(playlist.snippet).to be_a Yt::Snippet }
-  end
 
-  describe '.status of existing playlist' do
-    let(:id) { 'PLSWYkYzOrPMRCK6j0UgryI8E0NHhoVdRc' }
+    it 'returns valid snippet data' do
+      expect(playlist.snippet).to be_a Yt::Snippet
+      expect(playlist.title).to be_a String
+      expect(playlist.description).to be_a Yt::Description
+      expect(playlist.thumbnail_url).to be_a String
+      expect(playlist.published_at).to be_a Time
+      expect(playlist.tags).to be_an Array
+      expect(playlist.channel_id).to be_a String
+      expect(playlist.channel_title).to be_a String
+    end
+
     it { expect(playlist.status).to be_a Yt::Status }
+    it { expect(playlist.playlist_items).to be_a Yt::Collections::PlaylistItems }
+    it { expect(playlist.playlist_items.first).to be_a Yt::PlaylistItem }
   end
 
-  describe '.snippet of unknown playlist' do
+  context 'given an unknown playlist' do
     let(:id) { 'not-a-playlist-id' }
+
     it { expect{playlist.snippet}.to raise_error Yt::Errors::NoItems }
+    it { expect{playlist.status}.to raise_error Yt::Errors::NoItems }
   end
 
-  describe '.status of unknown playlist' do
-    let(:id) { 'not-a-playlist-id' }
-    it { expect{playlist.status}.to raise_error Yt::Errors::NoItems }
+  context 'given someone else’s playlist' do
+    let(:id) { 'PLSWYkYzOrPMRCK6j0UgryI8E0NHhoVdRc' }
+    let(:video_id) { 'MESycYJytkU' }
+
+    it { expect{playlist.delete}.to fail.with 'forbidden' }
+    it { expect{playlist.update}.to fail.with 'forbidden' }
+    it { expect{playlist.add_video! video_id}.to raise_error Yt::Errors::RequestError }
+    it { expect{playlist.delete_playlist_items}.to raise_error Yt::Errors::RequestError }
   end
 
-  describe '.delete on my own playlist' do
+  context 'given one of my own playlists that I want to delete' do
     before(:all) { @my_playlist = $account.create_playlist title: "Yt Test Delete Playlist #{rand}" }
     let(:id) { @my_playlist.id }
 
     it { expect(playlist.delete).to be true }
   end
 
-  describe '.delete on someone else’s playlist' do
-    let(:id) { 'PLSWYkYzOrPMRCK6j0UgryI8E0NHhoVdRc' }
-
-    it { expect{playlist.delete}.to fail.with 'forbidden' }
-  end
-
-  describe '.update on my own playlist' do
+  context 'given one of my own playlists that I want to update' do
     before(:all) { @my_playlist = $account.create_playlist title: "Yt Test Update Playlist #{rand}" }
     after(:all) { @my_playlist.delete }
     let(:id) { @my_playlist.id }
 
-    context 'changes the attributes that are specified to be updated' do
+    describe 'updates the attributes that I specify explicitly' do
       let(:attrs) { {title: "Yt Test Update Playlist #{rand} - new title"} }
       it { expect(playlist.update attrs).to eq true }
       it { expect{playlist.update attrs}.to change{playlist.title} }
     end
 
-    context 'does not changes the attributes that are not specified to be updated' do
+    describe 'does not update the other attributes' do
       let(:attrs) { {} }
       it { expect(playlist.update attrs).to eq true }
       it { expect{playlist.update attrs}.not_to change{playlist.title} }
@@ -58,20 +68,6 @@ describe Yt::Playlist, :device_app do
       it { expect{playlist.update attrs}.not_to change{playlist.tags} }
       it { expect{playlist.update attrs}.not_to change{playlist.privacy_status} }
     end
-  end
-
-  describe '.update on someone else’s playlist' do
-    let(:id) { 'PLSWYkYzOrPMRCK6j0UgryI8E0NHhoVdRc' }
-
-    it { expect{playlist.update}.to fail.with 'forbidden' }
-  end
-
-  describe '.playlist_items of my own playlist' do
-    before(:all) { @my_playlist = $account.create_playlist title: "Yt Test Items" }
-    after(:all) { @my_playlist.delete }
-    let(:id) { @my_playlist.id }
-
-    it { expect(playlist.playlist_items).to be_a Yt::Collections::PlaylistItems }
 
     context 'given an existing video' do
       let(:video_id) { 'MESycYJytkU' }
@@ -121,16 +117,4 @@ describe Yt::Playlist, :device_app do
       end
     end
   end
-
-  describe '.playlist_items of someone else’s playlist' do
-    let(:id) { 'PLSWYkYzOrPMRCK6j0UgryI8E0NHhoVdRc' }
-    let(:video_id) { 'MESycYJytkU' }
-
-    it { expect(playlist.playlist_items).to be_a Yt::Collections::PlaylistItems }
-
-    describe 'cannot be created or destroyed' do
-      it { expect{playlist.add_video! video_id}.to raise_error Yt::Errors::RequestError }
-      it { expect{playlist.delete_playlist_items}.to raise_error Yt::Errors::RequestError }
-    end
-  end
 end

data/spec/associations/device_auth/video_spec.rb

@@ -8,7 +8,20 @@ describe Yt::Video, :device_app do
     let(:id) { 'MESycYJytkU' }
 
     it { expect(video.content_detail).to be_a Yt::ContentDetail }
-    it { expect(video.snippet).to be_a Yt::Snippet }
+
+    it 'returns valid snippet data' do
+      expect(video.snippet).to be_a Yt::Snippet
+      expect(video.title).to be_a String
+      expect(video.description).to be_a Yt::Description
+      expect(video.thumbnail_url).to be_a String
+      expect(video.published_at).to be_a Time
+      expect(video.tags).to be_an Array
+      expect(video.channel_id).to be_a String
+      expect(video.channel_title).to be_a String
+      expect(video.category_id).to be_a String
+      expect(video.live_broadcast_content).to be_a String
+    end
+
     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 }

data/spec/associations/server_auth/channel_spec.rb

@@ -1,60 +1,42 @@
-# encoding: UTF-8
-
 require 'spec_helper'
 require 'yt/models/channel'
 
 describe Yt::Channel, :server_app do
-  let(:channel) { Yt::Channel.new id: id }
-
-  describe '.snippet of existing channel' do
-    let(:id) { 'UCxO1tY8h1AhOz0T4ENwmpow' }
-    it { expect(channel.snippet).to be_a Yt::Snippet }
-  end
-
-  describe '.snippet of unknown channel' do
-    let(:id) { 'not-a-channel-id' }
-    it { expect{channel.snippet}.to raise_error Yt::Errors::NoItems }
-  end
+  subject(:channel) { Yt::Channel.new id: id }
 
-  describe '.statistics_set of existing channel' do
+  context 'given an existing channel' do
     let(:id) { 'UCxO1tY8h1AhOz0T4ENwmpow' }
-    it { expect(channel.statistics_set).to be_a Yt::StatisticsSet }
-  end
 
-  describe '.statistics_set of unknown channel' do
-    let(:id) { 'not-a-channel-id' }
-    it { expect{channel.statistics_set}.to raise_error Yt::Errors::NoItems }
-  end
+    it 'returns valid snippet data' do
+      expect(channel.snippet).to be_a Yt::Snippet
+      expect(channel.title).to be_a String
+      expect(channel.description).to be_a Yt::Description
+      expect(channel.thumbnail_url).to be_a String
+      expect(channel.published_at).to be_a Time
+    end
 
-  describe '.status of existing channel' do
-    let(:id) { 'UCxO1tY8h1AhOz0T4ENwmpow' }
     it { expect(channel.status).to be_a Yt::Status }
-  end
-
-  describe '.status of unknown channel' do
-    let(:id) { 'not-a-channel-id' }
-    it { expect{channel.status}.to raise_error Yt::Errors::NoItems }
-  end
-
-  describe '.videos of existing channel' do
-    let(:id) { 'UCxO1tY8h1AhOz0T4ENwmpow' }
+    it { expect(channel.statistics_set).to be_a Yt::StatisticsSet }
     it { expect(channel.videos).to be_a Yt::Collections::Videos }
     it { expect(channel.videos.first).to be_a Yt::Video }
+    it { expect(channel.playlists).to be_a Yt::Collections::Playlists }
+    it { expect(channel.playlists.first).to be_a Yt::Playlist }
   end
 
-  describe '.videos of unknown channel starting with UC' do
-    let(:id) { 'UC-not-a-channel-id' }
+  context 'given an unknown channel' do
+    let(:id) { 'not-a-channel-id' }
 
-    # NOTE: This test is just a reflection of YouTube irrational behavior of
-    # returns 0 results if the name of an unknown channel starts with UC, but
-    # returning 100,000 results otherwise (ignoring the channel filter).
-    it { expect(channel.videos.count).to be 0 }
-  end
+    it { expect{channel.snippet}.to raise_error Yt::Errors::NoItems }
+    it { expect{channel.status}.to raise_error Yt::Errors::NoItems }
+    it { expect{channel.statistics_set}.to raise_error Yt::Errors::NoItems }
 
-  describe '.playlists of someone else’s channel' do
-    let(:id) { 'UCxO1tY8h1AhOz0T4ENwmpow' }
+    describe 'starting with UC' do
+      let(:id) { 'UC-not-a-channel-id' }
 
-    it { expect(channel.playlists).to be_a Yt::Collections::Playlists }
-    it { expect(channel.playlists.first).to be_a Yt::Playlist }
+      # NOTE: This test is just a reflection of YouTube irrational behavior of
+      # returns 0 results if the name of an unknown channel starts with UC, but
+      # returning 100,000 results otherwise (ignoring the channel filter).
+      it { expect(channel.videos.count).to be 0 }
+    end
   end
 end

data/spec/associations/server_auth/playlist_item_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+require 'yt/models/playlist_item'
+
+describe Yt::PlaylistItem, :server_app do
+  subject(:item) { Yt::PlaylistItem.new id: id }
+
+  context 'given an existing playlist item' do
+    let(:id) { 'PLjW_GNR5Ir0GWEP_oveGBNjTvKkYyZfsna1TZDCBP-Z8' }
+
+    it 'returns valid snippet data' do
+      expect(item.snippet).to be_a Yt::Snippet
+      expect(item.title).to be_a String
+      expect(item.description).to be_a Yt::Description
+      expect(item.thumbnail_url).to be_a String
+      expect(item.published_at).to be_a Time
+      expect(item.channel_id).to be_a String
+      expect(item.channel_title).to be_a String
+      expect(item.playlist_id).to be_a String
+      expect(item.position).to be_an Integer
+      expect(item.video_id).to be_a String
+      expect(item.video).to be_a Yt::Models::Video
+    end
+  end
+
+  context 'given an unknown playlist item' do
+    let(:id) { 'not-a-playlist-item-id' }
+
+    it { expect{item.snippet}.to raise_error Yt::Errors::RequestError }
+  end
+end

data/spec/associations/server_auth/playlist_spec.rb

@@ -1,36 +1,32 @@
-# encoding: UTF-8
-
 require 'spec_helper'
 require 'yt/models/playlist'
 
 describe Yt::Playlist, :server_app do
-  let(:playlist) { Yt::Playlist.new id: id }
+  subject(:playlist) { Yt::Playlist.new id: id }
 
-  describe '.snippet of existing playlist' do
+  context 'given an existing playlist' do
     let(:id) { 'PLSWYkYzOrPMRCK6j0UgryI8E0NHhoVdRc' }
-    it { expect(playlist.snippet).to be_a Yt::Snippet }
-  end
 
-  describe '.status of existing playlist' do
-    let(:id) { 'PLSWYkYzOrPMRCK6j0UgryI8E0NHhoVdRc' }
+    it 'returns valid snippet data' do
+      expect(playlist.snippet).to be_a Yt::Snippet
+      expect(playlist.title).to be_a String
+      expect(playlist.description).to be_a Yt::Description
+      expect(playlist.thumbnail_url).to be_a String
+      expect(playlist.published_at).to be_a Time
+      expect(playlist.tags).to be_an Array
+      expect(playlist.channel_id).to be_a String
+      expect(playlist.channel_title).to be_a String
+    end
+
     it { expect(playlist.status).to be_a Yt::Status }
+    it { expect(playlist.playlist_items).to be_a Yt::Collections::PlaylistItems }
+    it { expect(playlist.playlist_items.first).to be_a Yt::PlaylistItem }
   end
 
-  describe '.snippet of unknown playlist' do
+  context 'given an unknown playlist' do
     let(:id) { 'not-a-playlist-id' }
-    it { expect{playlist.snippet}.to raise_error Yt::Errors::NoItems }
-  end
 
-  describe '.status of unknown playlist' do
-    let(:id) { 'not-a-playlist-id' }
+    it { expect{playlist.snippet}.to raise_error Yt::Errors::NoItems }
     it { expect{playlist.status}.to raise_error Yt::Errors::NoItems }
   end
-
-  describe '.playlist_items of someone else’s playlist' do
-    let(:id) { 'PLSWYkYzOrPMRCK6j0UgryI8E0NHhoVdRc' }
-    let(:video_id) { 'MESycYJytkU' }
-
-    it { expect(playlist.playlist_items).to be_a Yt::Collections::PlaylistItems }
-    it { expect(playlist.playlist_items.first).to be_a Yt::PlaylistItem }
-  end
-end
+end

data/spec/associations/server_auth/video_spec.rb

@@ -8,7 +8,20 @@ describe Yt::Video, :server_app do
     let(:id) { 'MESycYJytkU' }
 
     it { expect(video.content_detail).to be_a Yt::ContentDetail }
-    it { expect(video.snippet).to be_a Yt::Snippet }
+
+    it 'returns valid snippet data' do
+      expect(video.snippet).to be_a Yt::Snippet
+      expect(video.title).to be_a String
+      expect(video.description).to be_a Yt::Description
+      expect(video.thumbnail_url).to be_a String
+      expect(video.published_at).to be_a Time
+      expect(video.tags).to be_an Array
+      expect(video.channel_id).to be_a String
+      expect(video.channel_title).to be_a String
+      expect(video.category_id).to be_a String
+      expect(video.live_broadcast_content).to be_a String
+    end
+
     it { expect(video.status).to be_a Yt::Status }
     it { expect(video.statistics_set).to be_a Yt::StatisticsSet }
   end

data/spec/models/playlist_item_spec.rb

@@ -4,18 +4,17 @@ require 'yt/models/playlist_item'
 describe Yt::PlaylistItem do
   subject(:playlist_item) { Yt::PlaylistItem.new attrs }
 
-  describe '#position' do
+  describe '#snippet' do
     context 'given fetching a playlist item returns a snippet' do
       let(:attrs) { {snippet: {"position"=>0}} }
-      it { expect(playlist_item.position).to be 0 }
+      it { expect(playlist_item.snippet).to be_a Yt::Snippet }
     end
   end
 
-  describe '#video' do
-    context 'given fetching a playlist item returns a snippet' do
-      let(:attrs) { {snippet: {"title"=>"Fullscreen"}} }
-      it { expect(playlist_item.video).to be_a Yt::Video }
-      it { expect(playlist_item.video.title).to eq "Fullscreen" }
+  describe '#status' do
+    context 'given fetching a playlist item returns a status' do
+      let(:attrs) { {status: {"privacyStatus"=>"public"}} }
+      it { expect(playlist_item.status).to be_a Yt::Status }
     end
   end
 

data/spec/models/snippet_spec.rb

@@ -3,50 +3,50 @@ require 'yt/models/snippet'
 
 describe Yt::Snippet do
   subject(:snippet) { Yt::Snippet.new data: data }
+  let(:data) { {} }
 
   describe '#title' do
-    context 'given fetching a snippet returns a title' do
+    context 'given a snippet with a title' do
       let(:data) { {"title"=>"Fullscreen"} }
       it { expect(snippet.title).to eq 'Fullscreen' }
     end
 
-    context 'given fetching a snippet does not return a title' do
-      let(:data) { {"description"=>"The first media company for the connected generation."} }
+    context 'given a snippet without a title' do
       it { expect(snippet.title).to eq '' }
     end
   end
 
-  describe '#published_at' do # publishedAt is always returned by YouTube
-    let(:data) { {"publishedAt"=>"2014-04-22T19:14:49.000Z"} }
-    it { expect(snippet.published_at.year).to be 2014 }
+  describe '#published_at' do
+    context 'given a snippet with a timestamp' do # always returned by YouTube
+      let(:data) { {"publishedAt"=>"2014-04-22T19:14:49.000Z"} }
+      it { expect(snippet.published_at.year).to be 2014 }
+    end
   end
 
   describe '#description' do
-    context 'given fetching a snippet returns a description' do
+    context 'given a snippet with a description' do
       let(:data) { {"description"=>"The first media company for the connected generation."} }
       it { expect(snippet.description).to eq 'The first media company for the connected generation.' }
     end
 
-    context 'given fetching a snippet does not return a description' do
-      let(:data) { {"title"=>"Fullscreen"} }
+    context 'given a snippet without a description' do
       it { expect(snippet.description).to eq '' }
     end
   end
 
   describe '#tags' do
-    context 'given fetching a snippet returns some tags' do
+    context 'given a snippet with tags' do
       let(:data) { {"tags"=>["promotion", "new media"]} }
       it { expect(snippet.tags).to eq ["promotion", "new media"] }
     end
 
-    context 'given fetching a snippet does not return any tag' do
-      let(:data) { {"title"=>"Fullscreen"} }
+    context 'given a snippet without tags' do
       it { expect(snippet.tags).to eq [] }
     end
   end
 
   describe '#thumbnail_url' do
-    context 'given fetching a snippet returns some thumbnails' do
+    context 'given a snippet with thumbnails' do
       let(:data) { {"thumbnails"=>{
         "default"=>{"url"=> "http://example.com/88x88.jpg"},
         "medium"=>{"url"=> "http://example.com/240x240.jpg"},
@@ -58,9 +58,66 @@ describe Yt::Snippet do
       it { expect(snippet.thumbnail_url :large).to be_nil }
     end
 
-    context 'given fetching a snippet returns any thumbnail' do
-      let(:data) { {"title"=>"Fullscreen"} }
+    context 'given a snippet without thumbnails' do
       it { expect(snippet.thumbnail_url).to be_nil }
     end
   end
+
+  describe '#channel_id' do
+    context 'given a snippet with a channel ID' do
+      let(:data) { {"channelId"=>"UCxO1tY8h1AhOz0T4ENwmpow"} }
+      it { expect(snippet.channel_id).to eq 'UCxO1tY8h1AhOz0T4ENwmpow' }
+    end
+
+    context 'given a snippet without a channel ID' do
+      it { expect(snippet.channel_id).to be_nil }
+    end
+  end
+
+  describe '#channel_title' do
+    context 'given a snippet with a channel title' do
+      let(:data) { {"channelTitle"=>"Fullscreen"} }
+      it { expect(snippet.channel_title).to eq 'Fullscreen' }
+    end
+
+    context 'given a snippet without a channel title' do
+      it { expect(snippet.channel_title).to be_nil }
+    end
+  end
+
+  describe '#category_id' do
+    context 'given a snippet with a category ID' do
+      let(:data) { {"categoryId"=>"22"} }
+      it { expect(snippet.category_id).to eq '22' }
+    end
+
+    context 'given a snippet without a category ID' do
+      it { expect(snippet.category_id).to be_nil }
+    end
+  end
+
+  describe '#live_broadcast_content' do
+    context 'given a snippet with live broadcast content' do
+      let(:data) { {"liveBroadcastContent"=>"live"} }
+      it { expect(snippet.live_broadcast_content).to eq 'live' }
+    end
+
+    context 'given a snippet without live broadcast content' do
+      it { expect(snippet.live_broadcast_content).to be_nil }
+    end
+  end
+
+  describe '#video_id and #video' do
+    context 'given a snippet with a video resource' do
+      let(:data) { {"resourceId"=>{"kind"=>"youtube#video","videoId"=>"W4GhTprSsOY"}} }
+      it { expect(snippet.video_id).to eq 'W4GhTprSsOY' }
+      it { expect(snippet.video).to be_a Yt::Models::Video }
+      it { expect(snippet.video.id).to eq 'W4GhTprSsOY' }
+    end
+
+    context 'given a snippet without a video resource' do
+      it { expect(snippet.video_id).to be_nil }
+      it { expect(snippet.video).to be_nil }
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yt
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.7.1
 platform: ruby
 authors:
 - Claudio Baccigalupo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-06-18 00:00:00.000000000 Z
+date: 2014-06-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -178,12 +178,14 @@ files:
 - spec/associations/device_auth/channel_spec.rb
 - spec/associations/device_auth/content_owner_spec.rb
 - spec/associations/device_auth/earnings_spec.rb
+- spec/associations/device_auth/playlist_item_spec.rb
 - spec/associations/device_auth/playlist_spec.rb
 - spec/associations/device_auth/resource_spec.rb
 - spec/associations/device_auth/video_spec.rb
 - spec/associations/device_auth/views_spec.rb
 - spec/associations/no_auth/video_spec.rb
 - spec/associations/server_auth/channel_spec.rb
+- spec/associations/server_auth/playlist_item_spec.rb
 - spec/associations/server_auth/playlist_spec.rb
 - spec/associations/server_auth/resource_spec.rb
 - spec/associations/server_auth/video_spec.rb
@@ -254,12 +256,14 @@ test_files:
 - spec/associations/device_auth/channel_spec.rb
 - spec/associations/device_auth/content_owner_spec.rb
 - spec/associations/device_auth/earnings_spec.rb
+- spec/associations/device_auth/playlist_item_spec.rb
 - spec/associations/device_auth/playlist_spec.rb
 - spec/associations/device_auth/resource_spec.rb
 - spec/associations/device_auth/video_spec.rb
 - spec/associations/device_auth/views_spec.rb
 - spec/associations/no_auth/video_spec.rb
 - spec/associations/server_auth/channel_spec.rb
+- spec/associations/server_auth/playlist_item_spec.rb
 - spec/associations/server_auth/playlist_spec.rb
 - spec/associations/server_auth/resource_spec.rb
 - spec/associations/server_auth/video_spec.rb