yt 0.33.4 → 0.34.1

data/lib/yt/models/live_cuepoint.rb

@@ -0,0 +1,23 @@
+require 'yt/models/base'
+
+module Yt
+  module Models
+    # Provides methods to interact with YouTube Content ID live cuepoints.
+    # @see https://developers.google.com/youtube/v3/live/docs/liveCuepoints
+    class LiveCuepoint < Base
+      def initialize(options = {})
+        @data = options[:data]
+        @id = options[:id]
+        @auth = options[:auth]
+      end
+
+      # @return [String] the ID that YouTube assigns and uses to uniquely
+      #   identify the live_cuepoint.
+      has_attribute :id
+
+      # @return [String] the ID that uniquely identifies the broadcast that the
+      #   live_cuepoint is associated with.
+      has_attribute :broadcast_id
+    end
+  end
+end

data/lib/yt/models/playlist.rb

@@ -37,10 +37,6 @@ module Yt
       #   @return [String] the title of the channel that the playlist belongs to.
       delegate :channel_title, to: :snippet
 
-      # @!attribute [r] tags
-      #   @return [Array<String>] the list of tags attached to the playlist.
-      delegate :tags, to: :snippet
-
     ### STATISTICS ###
 
       has_one :content_detail
@@ -164,6 +160,9 @@ module Yt
       # @macro report_by_playlist_dimensions
       has_report :views, Integer
 
+      # @macro report_by_playlist_dimensions
+      has_report :engaged_views, Integer
+
       # @macro report_by_playlist_dimensions
       has_report :estimated_minutes_watched, Integer
 
@@ -206,7 +205,7 @@ module Yt
           else
             params[:ids] = "channel==#{channel_id}"
           end
-          params[:filters] = "playlist==#{id};isCurated==1"
+          params[:filters] = "playlist==#{id}"
         end
       end
 

data/lib/yt/models/reference.rb

@@ -169,4 +169,4 @@ module Yt
       end
     end
   end
-end
+end

data/lib/yt/models/resource.rb

@@ -12,13 +12,7 @@ module Yt
 
       # @!attribute [r] id
       #   @return [String] the ID that YouTube uses to identify each resource.
-      def id
-        if @id.nil? && @match && @match[:kind] == :channel
-          @id ||= fetch_channel_id
-        else
-          @id
-        end
-      end
+      attr_reader :id
 
     ### STATUS ###
 
@@ -51,7 +45,11 @@ module Yt
         if options[:url]
           @url = options[:url]
           @match = find_pattern_match
-          @id = @match['id']
+          if kind == "channel" && @match.key?('format')
+            @id ||= fetch_channel_id
+          else
+            @id = @match['id']
+          end
         else
           @id = options[:id]
         end
@@ -98,7 +96,8 @@ module Yt
       # @return [Array<Regexp>] patterns matching URLs of YouTube channels.
       CHANNEL_PATTERNS = [
         %r{^(?:https?://)?(?:www\.)?youtube\.com/channel/(?<id>UC[a-zA-Z0-9_-]{22})},
-        %r{^(?:https?://)?(?:www\.)?youtube\.com/(?<format>c/|user/)?(?<name>[a-zA-Z0-9_-]+)}
+        %r{^(?:https?://)?(?:www\.)?youtube\.com/(?<format>c/|user/)?(?<name>[a-zA-Z0-9_-]+)},
+        %r{^(?:https?://)?(?:www\.)?youtube\.com/(?<format>@)(?<name>[a-zA-Z0-9_-]+)}
       ]
 
     private
@@ -106,8 +105,7 @@ module Yt
       def find_pattern_match
         patterns.find do |kind, regex|
           if data = @url.match(regex)
-            # Note: With Ruby 2.4, the following is data.named_captures
-            break data.names.zip(data.captures).to_h.merge kind: kind
+            break data.named_captures.merge kind: kind
           end
         end || {kind: :unknown}
       end
@@ -123,19 +121,44 @@ module Yt
       end
 
       def fetch_channel_id
-        response = Net::HTTP.start 'www.youtube.com', 443, use_ssl: true do |http|
-          http.request Net::HTTP::Get.new("/#{@match['format']}#{@match['name']}")
-        end
-        if response.is_a?(Net::HTTPRedirection)
+        api_key = Yt.configuration.api_key if Yt.configuration.api_key
+        case @match['format']
+        when "@"
+          handle = "@#{@match['name']}"
+          response = Net::HTTP.start 'youtube.googleapis.com', 443, use_ssl: true do |http|
+            http.request Net::HTTP::Get.new("/youtube/v3/channels?part=snippet&forHandle=#{handle}&key=#{api_key}")
+          end
+          if response.is_a?(Net::HTTPOK) && item = JSON(response.body)['items']&.first
+            item['id']
+          else
+            raise Yt::Errors::NoItems
+          end
+        when "user/"
+          username = @match['name']
+          response = Net::HTTP.start 'youtube.googleapis.com', 443, use_ssl: true do |http|
+            http.request Net::HTTP::Get.new("/youtube/v3/channels?part=snippet&forUsername=#{username}&key=#{api_key}")
+          end
+          if response.is_a?(Net::HTTPOK) && item = JSON(response.body)['items']&.first
+            item['id']
+          else
+            raise Yt::Errors::NoItems
+          end
+        else # "c/", nil
           response = Net::HTTP.start 'www.youtube.com', 443, use_ssl: true do |http|
-            http.request Net::HTTP::Get.new(response['location'])
+            http.request Net::HTTP::Get.new("/#{@match['format']}#{@match['name']}")
+          end
+          if response.is_a?(Net::HTTPRedirection)
+            response = Net::HTTP.start 'www.youtube.com', 443, use_ssl: true do |http|
+              http.request Net::HTTP::Get.new(response['location'])
+            end
+          end
+          # puts response.body
+          regex = %r{(?<id>UC[a-zA-Z0-9_-]{22})}
+          if data = response.body.match(regex)
+            data[:id]
+          else
+            raise Yt::Errors::NoItems
           end
-        end
-        regex = %r{<meta itemprop="channelId" content="(?<id>UC[a-zA-Z0-9_-]{22})">}
-        if data = response.body.match(regex)
-          data[:id]
-        else
-          raise Yt::Errors::NoItems
         end
       end
 

data/lib/yt/models/resumable_session.rb

@@ -1,4 +1,3 @@
-require 'cgi'
 require 'yt/models/base'
 
 module Yt
@@ -30,7 +29,7 @@ module Yt
     private
 
       def session_params
-        CGI::parse(@uri.query).tap{|hash| hash.each{|k,v| hash[k] = v.first}}
+        URI.decode_www_form(@uri.query || "").to_h
       end
 
       # @note: YouTube documentation states that a valid upload returns an HTTP

data/lib/yt/models/snippet.rb

@@ -38,6 +38,11 @@ module Yt
       has_attribute :like_count, type: Integer
       has_attribute :updated_at, type: Time
 
+      has_attribute :last_updated, type: Time
+      has_attribute :language
+      has_attribute :name
+      has_attribute :status
+
       def thumbnail_url(size = :default)
         thumbnails.fetch(size.to_s, {})['url']
       end

data/lib/yt/models/statistics_set.rb

@@ -17,7 +17,12 @@ module Yt
       has_attribute :view_count, type: Integer
       has_attribute :comment_count, type: Integer
       has_attribute :like_count, type: Integer
+
+      # statistics.dislikeCount property included in an API response
+      # only if the API request was authenticated by the video owner
+      # as of December 13, 2021
       has_attribute :dislike_count, type: Integer
+
       has_attribute :favorite_count, type: Integer
       has_attribute :video_count, type: Integer
       has_attribute :subscriber_count, type: Integer

data/lib/yt/models/user_info.rb

@@ -11,6 +11,7 @@ module Yt
       end
 
       has_attribute :id, default: ''
+      has_attribute :sub, default: ''
       has_attribute :email, default: ''
       has_attribute :verified_email, default: false, camelize: false
       has_attribute :name, default: ''

data/lib/yt/models/video.rb

@@ -1,3 +1,4 @@
+require 'open-uri'
 require 'yt/models/resource'
 
 module Yt
@@ -421,6 +422,9 @@ module Yt
       # @macro report_by_video_dimensions
       has_report :views, Integer
 
+      # @macro report_by_video_dimensions
+      has_report :engaged_views, Integer
+
       # @macro report_by_video_dimensions
       has_report :estimated_minutes_watched, Integer
 
@@ -533,6 +537,10 @@ module Yt
       #     player that will play the video.
       delegate :embed_html, to: :player
 
+    ### CAPTION ###
+
+      has_many :captions
+
     ### ACTIONS (UPLOAD, UPDATE, DELETE) ###
 
       # Uploads a thumbnail
@@ -542,7 +550,7 @@ module Yt
       # @raise [Yt::Errors::RequestError] if path_or_url is not a valid path
       #   or URL.
       def upload_thumbnail(path_or_url)
-        file = open(path_or_url, 'rb') rescue StringIO.new
+        file = URI.open(path_or_url)
         session = resumable_sessions.insert file.size
 
         session.update(body: file) do |data|

data/lib/yt/models/video_group.rb

@@ -37,6 +37,9 @@ module Yt
       # @macro report_by_video_dimensions
       has_report :views, Integer
 
+      # @macro report_by_video_dimensions
+      has_report :engaged_views, Integer
+
       # @macro report_by_video_dimensions
       has_report :estimated_minutes_watched, Integer
 

data/lib/yt/request.rb

@@ -1,6 +1,7 @@
 require 'net/http' # for Net::HTTP.start
 require 'uri' # for URI.json
 require 'json' # for JSON.parse
+require "open-uri" # for URI.open
 require 'active_support' # does not load anything by default, but is required
 require 'active_support/core_ext' # for Hash.from_xml, Hash.to_param
 
@@ -84,6 +85,10 @@ module Yt
       end
     end
 
+    def open_uri
+      URI.open(uri.to_s, 'Authorization' => "Bearer #{@auth.access_token}")
+    end
+
     # Returns the +cURL+ version of the request, useful to re-run the request
     # in a shell terminal.
     # @return [String] the +cURL+ version of the request.

data/lib/yt/version.rb

@@ -1,3 +1,3 @@
 module Yt
-  VERSION = '0.33.4'
+  VERSION = '0.34.1'
 end

data/lib/yt.rb

@@ -14,6 +14,7 @@ require 'yt/models/video_group'
 require 'yt/models/comment_thread'
 require 'yt/models/ownership'
 require 'yt/models/advertising_options_set'
+require 'yt/models/caption'
 
 # An object-oriented Ruby client for YouTube.
 # Helps creating applications that need to interact with YouTube objects.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yt
 version: !ruby/object:Gem::Version
-  version: 0.33.4
+  version: 0.34.1
 platform: ruby
 authors:
-- Claudio Baccigalupo
-autorequire: 
+- Nullscreen
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-01-15 00:00:00.000000000 Z
+date: 2026-01-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -24,20 +24,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -52,62 +38,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: yard
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: coveralls
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: pry
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: vcr
   requirement: !ruby/object:Gem::Requirement
@@ -138,25 +68,16 @@ dependencies:
         version: '0'
 description: Youtube V3 API client.
 email:
-- claudio@fullscreen.net
-executables:
-- yt
+- nullscreen.code@gmail.com
+executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".rspec"
-- ".travis.yml"
 - ".yardopts"
 - CHANGELOG.md
-- Gemfile
 - MIT-LICENSE
 - README.md
-- Rakefile
 - YOUTUBE_IT.md
-- bin/yt
-- gemfiles/Gemfile.activesupport-3.x
-- gemfiles/Gemfile.activesupport-4.x
 - lib/yt.rb
 - lib/yt/actions/base.rb
 - lib/yt/actions/delete.rb
@@ -177,8 +98,11 @@ files:
 - lib/yt/collections/assets.rb
 - lib/yt/collections/authentications.rb
 - lib/yt/collections/base.rb
+- lib/yt/collections/branding_settings.rb
 - lib/yt/collections/bulk_report_jobs.rb
 - lib/yt/collections/bulk_reports.rb
+- lib/yt/collections/captions.rb
+- lib/yt/collections/channel_sections.rb
 - lib/yt/collections/channels.rb
 - lib/yt/collections/claim_histories.rb
 - lib/yt/collections/claims.rb
@@ -190,6 +114,7 @@ files:
 - lib/yt/collections/file_details.rb
 - lib/yt/collections/group_infos.rb
 - lib/yt/collections/group_items.rb
+- lib/yt/collections/live_cuepoints.rb
 - lib/yt/collections/live_streaming_details.rb
 - lib/yt/collections/ownerships.rb
 - lib/yt/collections/partnered_channels.rb
@@ -230,9 +155,12 @@ files:
 - lib/yt/models/asset_snippet.rb
 - lib/yt/models/authentication.rb
 - lib/yt/models/base.rb
+- lib/yt/models/branding_setting.rb
 - lib/yt/models/bulk_report.rb
 - lib/yt/models/bulk_report_job.rb
+- lib/yt/models/caption.rb
 - lib/yt/models/channel.rb
+- lib/yt/models/channel_section.rb
 - lib/yt/models/claim.rb
 - lib/yt/models/claim_event.rb
 - lib/yt/models/claim_history.rb
@@ -247,7 +175,7 @@ files:
 - lib/yt/models/group_info.rb
 - lib/yt/models/group_item.rb
 - lib/yt/models/id.rb
-- lib/yt/models/iterator.rb
+- lib/yt/models/live_cuepoint.rb
 - lib/yt/models/live_streaming_detail.rb
 - lib/yt/models/match_policy.rb
 - lib/yt/models/ownership.rb
@@ -274,12 +202,11 @@ files:
 - lib/yt/models/video_group.rb
 - lib/yt/request.rb
 - lib/yt/version.rb
-- yt.gemspec
-homepage: http://github.com/Fullscreen/yt
+homepage: http://github.com/nullscreen/yt
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -287,15 +214,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 1.9.3
+      version: '2.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.4.20
+signing_key:
 specification_version: 4
 summary: Yt makes it easy to interact with Youtube V3 API by providing a modular,
   intuitive and tested Ruby-style API.

data/.gitignore

@@ -1,27 +0,0 @@
-# See http://help.github.com/ignore-files/ for more about ignoring files.
-#
-# If you find yourself ignoring temporary files generated by your text editor
-# or operating system, you probably want to add a global ignore instead:
-#   git config --global core.excludesfile '~/.gitignore_global'
-
-# Ignore bundler config.
-/.bundle
-
-# Ignore the default SQLite database.
-/db/*.sqlite3
-/db/*.sqlite3-journal
-
-coverage/
-Gemfile.lock
-
-# Ignore all logfiles and tempfiles.
-/log/*.log
-/tmp
-**/tmp
-*.gem
-*.sqlite3
-
-doc/
-.yardoc/
-_site/
-TODO.md

data/.rspec

@@ -1,3 +0,0 @@
---color
---exclude_pattern spec/requests/as_content_owner/*_spec.rb
---tag=~slow

data/.travis.yml

@@ -1,7 +0,0 @@
-language: ruby
-notifications:
-  email: true
-matrix:
-  include:
-  - rvm: 2.6.3
-    gemfile: gemfiles/Gemfile.activesupport-4.x

data/Gemfile

@@ -1,4 +0,0 @@
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in yt.gemspec
-gemspec

data/Rakefile

@@ -1,11 +0,0 @@
-require "bundler"
-Bundler.setup
-Bundler::GemHelper.install_tasks
-
-require "rspec/core/rake_task"
-require "rspec/core/version"
-
-desc "Run all examples"
-RSpec::Core::RakeTask.new :spec
-
-task default: [:spec]

data/bin/yt

@@ -1,23 +0,0 @@
-#!/usr/bin/env ruby
-
-begin
-  require 'yt'
-rescue LoadError
-  require 'rubygems'
-  require 'yt'
-end
-
-Yt.configuration.log_level = :debug
-id = ARGV[1] || 'rdwz7QiG0lk'
-
-case ARGV[0]
-when 'info'
-  puts "Yt version #{Yt::VERSION}"
-  video = Yt::Video.new id: id
-  puts video.title
-when 'video'
-  video = Yt::Video.new id: id
-  views = "#{video.view_count} #{'view'.pluralize video.view_count}"
-  likes = "#{video.like_count} #{'like'.pluralize video.like_count}"
-  puts "'#{video.title}' by #{video.channel_title} has #{views} and #{likes}"
-end

data/gemfiles/Gemfile.activesupport-3.x

@@ -1,4 +0,0 @@
-source 'http://rubygems.org'
-
-gem 'activesupport', '~> 3.0'
-gemspec path: '../'

data/gemfiles/Gemfile.activesupport-4.x

@@ -1,4 +0,0 @@
-source 'http://rubygems.org'
-
-gem 'activesupport', '~> 4.0'
-gemspec path: '../'

data/lib/yt/models/iterator.rb

@@ -1,16 +0,0 @@
-module Yt
-  module Models
-    # @private
-    # If we dropped support for Ruby 1.9.3, then we could simply use Enumerator
-    # which takes a `size` parameter in Ruby >= 2.
-    class Iterator < Enumerator
-      def initialize(size=nil, &block)
-        RUBY_VERSION < '2' ? super(&block) : super(size, &block)
-      end
-
-      def size
-        RUBY_VERSION < '2' ? count : super
-      end
-    end
-  end
-end

data/yt.gemspec

@@ -1,36 +0,0 @@
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'yt/version'
-
-Gem::Specification.new do |spec|
-  spec.name          = "yt"
-  spec.version       = Yt::VERSION
-  spec.authors       = ["Claudio Baccigalupo"]
-  spec.email         = ["claudio@fullscreen.net"]
-  spec.description   = %q{Youtube V3 API client.}
-  spec.summary       = %q{Yt makes it easy to interact with Youtube V3 API by
-    providing a modular, intuitive and tested Ruby-style API.}
-  spec.homepage      = "http://github.com/Fullscreen/yt"
-  spec.license       = "MIT"
-
-  spec.required_ruby_version = '>= 1.9.3'
-
-  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
-    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
-  end
-  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
-  spec.require_paths = ["lib"]
-
-  spec.add_dependency 'activesupport' # '3 (Ruby 1.9) or 4 (Ruby 2)'
-
-  # For development / Code coverage / Documentation
-  spec.add_development_dependency 'bundler' #, '~> 1.0'
-  spec.add_development_dependency 'rspec' #, '~> 2.0'
-  spec.add_development_dependency 'rake' #, '~> 10.0'
-  spec.add_development_dependency 'yard' #, '~> 0.8.0'
-  spec.add_development_dependency 'coveralls' #, '~> 0.7.0'
-  spec.add_development_dependency 'pry'
-  spec.add_development_dependency 'vcr'
-  spec.add_development_dependency 'webmock'
-end