yt-core 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0e73785b5cd82fa51ecccf38582af03f6a189fdf
-  data.tar.gz: d7dbbcded0e7bcf83b66ef6efe52ff48255b489f
+  metadata.gz: 28bc8c7b5dc7f93aba21e4190057758cd3bc63a9
+  data.tar.gz: 0fb9a20cba7679958c00e73bbb96d8dd9b4ba613
 SHA512:
-  metadata.gz: fe370fafb6f8ad53ca302f93bd537b75fbaaf8a4cffe05605328463bf699dd7ba0ff42538d45a111259b6d7ba9c4885ab9310133864de75b43cc4f61be3520c3
-  data.tar.gz: ecbb7e2216d4b974e3e1046e2c1652a6146f359a2c81f6a7eecbaba56e44330f08f776b3f59538ff82bdf02990f80a8849370c485f373e622de3dc5d9b81f25b
+  metadata.gz: 7e38e38ea200bda2994b4cb4b2a57d4d6b8dde5c1e8150c275ca8ad4a8410451d06380f47de81583ba3d7a87e7f5ed076dcf94447069ec8a0d0b6bf1717a9429
+  data.tar.gz: f894f69ac4dca2029574d16d8b5fe3fd708cf18a864218bafe08fa7553338ebfc521584664ae3a88d4c363fcc82bf91b4fe6d78bfad054ff02637f73512ff881

data/.gitignore

@@ -1,22 +1,14 @@
-*.gem
-*.rbc
-.bundle
-.config
-.yardoc
-Gemfile.lock
-InstalledFiles
-_yardoc
-coverage
-doc/
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp
-*.bundle
-*.so
-*.o
-*.a
-mkmf.log
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+_site
+.sass-cache
+pkg/
+.jekyll-metadata
+

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--fail-fast

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+notifications:
+  email: false
+rvm:
+  - 2.2.2
+script:
+  - bundle exec rspec
+  - bundle exec yard stats | grep "100.00% documented"

data/.yardopts

@@ -0,0 +1,3 @@
+--non-transitive-tag private
+--no-private
+lib/**/*.rb

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+For more information about changelogs, check
+[Keep a Changelog](http://keepachangelog.com) and
+[Vandamme](http://tech-angels.github.io/vandamme).
+
+## 0.1.0 - 2017-04-03
+
+* [FEATURE] Extracted first classes from Yt

data/Gemfile

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

data/LICENSE.txt

@@ -1,22 +1,21 @@
-Copyright (c) 2014 claudiob
+The MIT License (MIT)
 
-MIT License
+Copyright (c) 2014-present Fullscreen, Inc.
 
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -1,29 +1,93 @@
-# YtCore
+Yt - a Ruby client for the YouTube API
+======================================
 
-TODO: Write a gem description
+Yt helps you write apps that need to interact with YouTube.
 
-## Installation
+The **source code** is available on [GitHub](https://github.com/fullscreen/yt-core) and the **documentation** on [RubyDoc](http://www.rubydoc.info/gems/yt-core/frames).
 
-Add this line to your application's Gemfile:
+[![Build Status](http://img.shields.io/travis/Fullscreen/yt-core/master.svg)](https://travis-ci.org/Fullscreen/yt-core)
+[![Coverage Status](http://img.shields.io/coveralls/Fullscreen/yt-core/master.svg)](https://coveralls.io/r/Fullscreen/yt-core)
+[![Dependency Status](http://img.shields.io/gemnasium/Fullscreen/yt-core.svg)](https://gemnasium.com/Fullscreen/yt-core)
+[![Code Climate](http://img.shields.io/codeclimate/github/Fullscreen/yt-core.svg)](https://codeclimate.com/github/Fullscreen/yt-core)
+[![Online docs](http://img.shields.io/badge/docs-✓-green.svg)](http://www.rubydoc.info/gems/yt-core/frames)
+[![Gem Version](http://img.shields.io/gem/v/yt.svg)](http://rubygems.org/gems/yt-core)
 
-    gem 'yt-core'
+After [registering your app](https://fullscreen.github.io/yt-core/), you can run commands like:
 
-And then execute:
+```ruby
+channel = Yt::Channel.new id: 'UCwCnUcLcb9-eSrHa_RQGkQQ'
+channel.title #=> "Yt Test"
+```
 
-    $ bundle
+The **full documentation** is available at [rubydoc.info](http://www.rubydoc.info/gems/yt-core/frames).
 
-Or install it yourself as:
 
-    $ gem install yt-core
+A comprehensive guide to Yt
+===========================
 
-## Usage
+All the classes and methods available are detailed on the [Yt homepage](https://fullscreen.github.io/yt-core/):
 
-TODO: Write usage instructions here
+[![Yt homepage](https://cloud.githubusercontent.com/assets/10076/19788369/b61d7756-9c5c-11e6-8bd8-05f8d67aef4e.png)](https://fullscreen.github.io/yt-core/)
 
-## Contributing
+Please proceed to [https://fullscreen.github.io/yt-core](https://fullscreen.github.io/yt-core/) for more details and examples.
 
-1. Fork it ( https://github.com/[my-github-username]/yt-core/fork )
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create a new Pull Request
+
+How to install
+==============
+
+To install on your system, run
+
+    gem install yt-core
+
+To use inside a bundled Ruby project, add this line to the Gemfile:
+
+    gem 'yt-core', '~> 0.1.0'
+
+Since the gem follows [Semantic Versioning](http://semver.org),
+indicating the full version in your Gemfile (~> *major*.*minor*.*patch*)
+guarantees that your project won’t occur in any error when you `bundle update`
+and a new version of Yt is released.
+
+How to test
+===========
+
+To run live-tests against the YouTube API, type:
+
+```bash
+rspec
+```
+
+This will fail unless you have set up a test YouTube application with access to
+the YouTube Data API v3 and an environment variable:
+
+- `YT_SERVER_API_KEY`: API Key of a Google app with access to the YouTube Data API v3 and the YouTube Analytics API
+
+
+How to release new versions
+===========================
+
+If you are a manager of this project, remember to upgrade the [Yt gem](http://rubygems.org/gems/yt)
+whenever a new feature is added or a bug gets fixed.
+
+Make sure all the tests are passing on [Travis CI](https://travis-ci.org/Fullscreen/yt-core),
+document the changes in HISTORY.md and README.md, bump the version, then run
+
+    rake release
+
+Remember that the yt gem follows [Semantic Versioning](http://semver.org).
+Any new release that is fully backward-compatible should bump the *patch* version (0.0.x).
+Any new version that breaks compatibility should bump the *minor* version (0.x.0)
+
+How to contribute
+=================
+
+Contribute to the code by forking the project, adding the missing code,
+writing the appropriate tests and submitting a pull request.
+
+In order for a PR to be approved, all the tests need to pass and all the public
+methods need to be documented and listed in the guides. Remember:
+
+- to run all tests locally: `bundle exec rspec`
+- to generate the docs locally: `bundle exec yard`
+- to list undocumented methods: `bundle exec yard stats --list-undoc`
+- to launch the guides locally: `bundle exec jekyll s -s docs`

data/Rakefile

@@ -1,2 +1,9 @@
-require "bundler/gem_tasks"
+require 'bundler/gem_tasks'
 
+require "rspec/core/rake_task"
+require "rspec/core/version"
+
+desc "Run all examples"
+RSpec::Core::RakeTask.new :spec
+
+task default: [:spec]

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "yt"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/docs/_config.yml

@@ -0,0 +1,10 @@
+markdown: kramdown
+permalink: none
+baseurl: /yt-core
+defaults:
+  -
+    scope:
+      path: ""
+    values:
+      layout:  "default"
+      version: 0.0.0

data/docs/_includes/doc.html

@@ -0,0 +1 @@
+<a href="http://www.rubydoc.info/github/claudiob/{% if include.library %}{{ include.library }}{% else %}yt{% endif %}/master/Yt/{% if include.instance %}{{ include.instance }}-instance{% elsif include.class %}{{ include.class }}-class{% endif %}_method" class="pull-right"><strong>&rarr; Yt docs</strong></a>

data/docs/_includes/dt.html

@@ -0,0 +1,4 @@
+<dt>
+  <span class="label label-{{ include.label }} pull-right">{{ include.auth }}</span>
+  {{ include.title }}
+</dt>

data/docs/_includes/example.html

@@ -0,0 +1 @@
+<code class="language-ruby" data-lang="ruby">{% if include.object %}<span class="n">{{ include.object }}</span>{% if include.method %}<span class="o">.</span><span class="n">{{ include.method }}</span>{% endif %}{% endif %}{{ include.params }}{% if include.result %}{% if include.object %}&nbsp;{% endif %}<span class="c1"># =&gt; {{ include.result }}</span>{% endif %}</code>

data/docs/_includes/footer.html

@@ -0,0 +1,3 @@
+<footer></footer>
+<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.1/jquery.min.js"></script>
+<script src="//netdna.bootstrapcdn.com/bootstrap/3.3.4/js/bootstrap.min.js" type="text/javascript"></script>

data/docs/_includes/head.html

@@ -0,0 +1,21 @@
+<head>
+  <meta charset="utf-8">
+  <meta http-equiv="X-UA-Compatible" content="IE=edge">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <meta name="description" content="Yt · The reliable YouTube API Ruby client">
+  <meta name="keywords" content="YouTube, Rails, youtube_it, API, V3, Ruby, client, video, channel, OAuth">
+  <meta name="author" content="Claudio B.">
+  <title>Yt · The reliable YouTube API Ruby client{% if page.title %} · {{ page.title }}{% endif %}</title>
+  <link href="//netdna.bootstrapcdn.com/bootstrap/3.3.4/css/bootstrap.min.css" media="screen" rel="stylesheet" type="text/css" />
+  <link rel="stylesheet" href="{{ site.baseurl }}/css/yt.css">
+  <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
+  <!--[if lt IE 9]>
+    <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
+    <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
+  <![endif]-->
+  <link href="{{ site.baseurl }}/apple-touch-icon-precomposed.png" rel="apple-touch-icon-precomposed">
+  <link href="{{ site.baseurl }}/favicon.ico" rel="icon">
+
+  <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.1/jquery.min.js"></script>
+  <script src="//netdna.bootstrapcdn.com/bootstrap/3.3.4/js/bootstrap.min.js" type="text/javascript"></script>
+</head>

data/docs/_includes/header.html

@@ -0,0 +1,57 @@
+<nav class="navbar navbar-default navbar-fixed-top" role="navigation">
+  <div class="container">
+    <div class="navbar-header">
+      <button class="navbar-toggle" data-target="#navbar-collapse-1" data-toggle="collapse" type="button">
+        <span class="sr-only">Toggle navigation</span>
+        <span class="icon-bar"></span>
+        <span class="icon-bar"></span>
+        <span class="icon-bar"></span>
+      </button>
+
+      <a class="navbar-brand" href="{{ site.baseurl }}/">
+        <img alt="Yt" src="{{ site.baseurl }}/images/robot.png">
+        Yt<span class="hidden-xs"> · The reliable YouTube API Ruby client</span>
+      </a>
+    </div>
+
+    <div class="collapse navbar-collapse" id="navbar-collapse-1">
+      <ul class="nav navbar-nav navbar-right visible-xs-block">
+        {% if page.url == '/' %}
+          <li class="active"><a href="{{ site.baseurl }}/">Installing Yt</a></li>
+        {% else %}
+          <li><a href="{{ site.baseurl }}/">Installing Yt</a></li>
+        {% endif %}
+        {% if page.url == '/channels.html' %}
+          <li class="active"><a href="{{ site.baseurl }}/channels.html">Channels</a></li>
+        {% else %}
+          <li><a href="{{ site.baseurl }}/channels.html">Channels</a></li>
+        {% endif %}
+        {% if page.url == '/videos.html' %}
+          <li class="active"><a href="{{ site.baseurl }}/videos.html">Videos</a></li>
+        {% else %}
+          <li><a href="{{ site.baseurl }}/videos.html">Videos</a></li>
+        {% endif %}
+        {% if page.url == '/playlists.html' %}
+          <li class="active"><a href="{{ site.baseurl }}/playlists.html">Playlists</a></li>
+        {% else %}
+          <li><a href="{{ site.baseurl }}/playlists.html">Playlists</a></li>
+        {% endif %}
+        {% if page.url == '/playlist_items.html' %}
+          <li class="active"><a href="{{ site.baseurl }}/playlist_items.html">Playlist Items</a></li>
+        {% else %}
+          <li><a href="{{ site.baseurl }}/playlist_items.html">Playlist Items</a></li>
+        {% endif %}
+        {% if page.url == '/errors.html' %}
+          <li class="active"><a href="{{ site.baseurl }}/errors.html">Errors</a></li>
+        {% else %}
+          <li><a href="{{ site.baseurl }}/errors.html">Errors</a></li>
+        {% endif %}
+        {% if page.url == '/urls.html' %}
+          <li class="active"><a href="{{ site.baseurl }}/urls.html">URLs</a></li>
+        {% else %}
+          <li><a href="{{ site.baseurl }}/urls.html">URLs</a></li>
+        {% endif %}
+      </ul>
+    </div>
+  </div>
+</nav>

data/docs/_layouts/default.html

@@ -0,0 +1,58 @@
+<!DOCTYPE html>
+<html lang="en">
+  {% include head.html %}
+  <body>
+    {% include header.html %}
+    <main>
+      <div class="container">
+        <div class="row">
+          <div class="hidden-xs hidden-print col-sm-3" role="complementary">
+            <ol start="0" class="sidebar" data-spy="affix">
+              {% if page.url == '/' %}
+                <li><a href="{{ site.baseurl }}/" class="active">Installing Yt</a></li>
+              {% else %}
+                <li><a href="{{ site.baseurl }}/">Installing Yt</a></li>
+              {% endif %}
+              {% if page.url == '/channels.html' %}
+                <li><a href="{{ site.baseurl }}/channels.html" class="active">Channels</a></li>
+              {% else %}
+                <li><a href="{{ site.baseurl }}/channels.html">Channels</a></li>
+              {% endif %}
+              {% if page.url == '/videos.html' %}
+                <li><a href="{{ site.baseurl }}/videos.html" class="active">Videos</a></li>
+              {% else %}
+                <li><a href="{{ site.baseurl }}/videos.html">Videos</a></li>
+              {% endif %}
+              {% if page.url == '/playlists.html' %}
+                <li><a href="{{ site.baseurl }}/playlists.html" class="active">Playlists</a></li>
+              {% else %}
+                <li><a href="{{ site.baseurl }}/playlists.html">Playlists</a></li>
+              {% endif %}
+              {% if page.url == '/playlist_items.html' %}
+                <li><a href="{{ site.baseurl }}/playlist_items.html" class="active">Playlist Items</a></li>
+              {% else %}
+                <li><a href="{{ site.baseurl }}/playlist_items.html">Playlist Items</a></li>
+              {% endif %}
+              {% if page.url == '/errors.html' %}
+                <li><a href="{{ site.baseurl }}/errors.html" class="active">Errors</a></li>
+              {% else %}
+                <li><a href="{{ site.baseurl }}/errors.html">Errors</a></li>
+              {% endif %}
+              {% if page.url == '/urls.html' %}
+                <li><a href="{{ site.baseurl }}/urls.html" class="active">URLs</a></li>
+              {% else %}
+                <li><a href="{{ site.baseurl }}/urls.html">URLs</a></li>
+              {% endif %}
+            </ol>
+
+          </div>
+          <div class="col-xs-12 col-sm-9" role="main">
+            <h2>{{ page.h2 }}</h2>
+            {{ content }}
+          </div>
+        </div>
+      </div>
+    </main>
+    {% include footer.html %}
+  </body>
+</html>

data/docs/channels.html

@@ -0,0 +1,142 @@
+---
+title:  "Yt::Channel"
+h2: "Channels"
+---
+
+<p>
+  <code>Yt::Channel</code> represents a <a href="https://developers.google.com/youtube/v3/docs/channels">YouTube channel</a>.
+  Initialize using its YouTube ID:
+</p>
+
+<dl>
+  <dd><a class="anchor" id="new"></a><div class="highlight"><pre>
+{% include doc.html instance="Channel#initialize" %}{% include example.html object='channel = <span class="no">Yt</span><span class="o">::</span><span class="no">Channel</span>' method='new' params=' <span class="ss">id:</span> <span class="s1">"UCwCnUcLcb9-eSrHa_RQGkQQ"</span>' %}
+{% include example.html result='#&lt;Yt::Channel @id=UCwCnUcLcb9-eSrHa_RQGkQQ&gt;' %}
+{% include doc.html instance="Channel#canonical_url" %}{% include example.html object='channel' method='canonical_url' %}
+{% include example.html result='"https://www.youtube.com/channel/UCwCnUcLcb9-eSrHa_RQGkQQ"' %}</pre>
+  </div></dd>
+</dl>
+
+<hr />
+<h4>Authentication</h4>
+
+<p>
+  Most methods of <code>Yt::Channel</code> <strong>retrieve public data</strong> from YouTube (e.g.: fetch a channel’s title).<br />
+  To use these methods (marked with <span class="label label-success">&nbsp;</span> below), you only need to <a href="{{ site.baseurl }}/#api_key">generate an API key</a> and configure:
+</p>
+
+{% highlight ruby %}
+Yt.configuration.api_key = "<your api key>"                      ## use your API key
+
+channel = Yt::Channel.new id: 'UCwCnUcLcb9-eSrHa_RQGkQQ'         ## use any channel ID
+channel.title # => "Yt Test"
+{% endhighlight %}
+
+<hr />
+<h4>List of <code>Yt::Channel</code> data methods</h4>
+<dl>
+  {% include dt.html title="Channel’s snippet" label="success" auth="any authentication works" %}
+  <dd><a class="anchor" id="snippet"></a><div class="highlight"><pre>
+{% include doc.html instance="Channel#id" %}{% include example.html object='channel' method='id' result='"UCwCnUcLcb9-eSrHa_RQGkQQ"' %}
+{% include doc.html instance="Channel#title" %}{% include example.html object='channel' method='title' result='"Yt Test"' %}
+{% include doc.html instance="Channel#description" %}{% include example.html object='channel' method='description' result='"A test channel."' %}
+{% include doc.html instance="Channel#custom_url" %}{% include example.html object='channel' method='custom_url' result='"yt-test"' %}
+{% include doc.html instance="Channel#vanity_url" %}{% include example.html object='channel' method='vanity_url' result='"https://www.youtube.com/yt-test"' %}
+{% include doc.html instance="Channel#published_at" %}{% include example.html object='channel' method='published_at' result='2014-05-02 20:12:57 UTC' %}
+{% include doc.html instance="Channel#thumbnail_url" %}{% include example.html object='channel' method='thumbnail_url' result='"https://yt3.ggpht.com/-KMnbKDBl60w/photo.jpg"' %}</pre>
+  </div></dd>
+
+  {% include dt.html title="Channel’s status" label="success" auth="any authentication works" %}
+  <dd><a class="anchor" id="status"></a><div class="highlight"><pre>
+{% include doc.html instance="Channel#privacy_status" %}{% include example.html object='channel' method='privacy_status' result='"public"' %}
+{% include doc.html instance="Channel#is_linked" %}{% include example.html object='channel' method='is_linked' result='true' %}
+{% include doc.html instance="Channel#long_uploads_status" %}{% include example.html object='channel' method='long_uploads_status' result='"longUploadsUnspecified"' %}</pre>
+  </div></dd>
+
+  {% include dt.html title="Channel’s statistics" label="success" auth="any authentication works" %}
+  <dd><a class="anchor" id="statistics"></a><div class="highlight"><pre>
+{% include doc.html instance="Channel#view_count" %}{% include example.html object='channel' method='view_count' result='123' %}
+{% include doc.html instance="Channel#comment_count" %}{% include example.html object='channel' method='comment_count' result='93' %}
+{% include doc.html instance="Channel#subscriber_count" %}{% include example.html object='channel' method='subscriber_count' result='42' %}
+{% include doc.html instance="Channel#hidden_subscriber_count" %}{% include example.html object='channel' method='hidden_subscriber_count' result='false' %}
+{% include doc.html instance="Channel#video_count" %}{% include example.html object='channel' method='video_count' result='62' %}</pre>
+  </div></dd>
+
+  {% include dt.html title="Channel’s branding settings" label="success" auth="any authentication works" %}
+  <dd><a class="anchor" id="branding_settings"></a><div class="highlight"><pre>
+{% include doc.html instance="Channel#banner_image_url" %}{% include example.html object='channel' method='banner_image_url' result='"https://yt3.ggpht.com/9dh4rj-k-no"' %}
+{% include doc.html instance="Channel#keywords" %}{% include example.html object='channel' method='keywords' result='["Some", "tag"]' %}
+{% include doc.html instance="Channel#unsubscribed_trailer" %}{% include example.html object='channel' method='unsubscribed_trailer' result='"gknzFj_0vvY"' %}</pre>
+  </div></dd>
+</dl>
+<p>
+  To limit the number of HTTP requests, use <code>select</code> to specify which <a href="https://developers.google.com/youtube/v3/docs/channels/list#part">parts</a> of the channel’s data to load:
+</p>
+<dl>
+  <dd><a class="anchor" id="select"></a><div class="highlight"><pre>
+{% include example.html object='slow = channel' result='without select: 2 HTTP requests' %}
+{% include example.html object='slow' method='title' result='one HTTP request to fetch the channel’s snippet' %}
+{% include example.html object='slow' method='privacy_status' result='another HTTP request to fetch the channel’s status' %}
+
+{% include doc.html instance="Channel#select" %}{% include example.html object='fast = channel' method='select' params=' <span class="ss">:snippet</span><span class="p">,</span> <span class="ss">:status</span>' result='with select: 1 HTTP request' %}
+{% include example.html object='fast' method='title' result='one HTTP request to fetch both the channel’s snippet and status' %}
+{% include example.html object='fast' method='privacy_status' result='no extra HTTP requests' %}</pre>
+  </div></dd>
+</dl>
+
+<dl>
+  {% include dt.html title="Channel’s (public) videos" label="success" auth="any authentication works" %}
+  <dd><a class="anchor" id="videos"></a><div class="highlight"><pre>
+{% include doc.html instance="Channel#videos" %}{% include example.html object='channel' method='videos' %}
+{% include example.html result='#&lt;Yt::Relation [#&lt;Yt::Video @id=gknz...&gt;, #&lt;Yt::Video @id=32Gc...&gt;, ...]&gt;' %}</pre>
+  </div></dd>
+</dl>
+<dl>
+  {% include dt.html title="Channel’s (public) playlists" label="success" auth="any authentication works" %}
+  <dd><a class="anchor" id="playlists"></a><div class="highlight"><pre>
+{% include doc.html instance="Channel#playlists" %}{% include example.html object='channel' method='playlists' %}
+{% include example.html result='#&lt;Yt::Relation [#&lt;Yt::Playlist @id=PL-L...&gt;, #&lt;Yt::Playlist @id=PL-N...&gt;, ...]&gt;' %}</pre>
+  </div></dd>
+</dl>
+<p>
+  Before iterating through videos or playlists, use <code>select</code> to specify which <a href="https://developers.google.com/youtube/v3/docs/videos/list#part">parts</a> of each video’s data to load:
+</p>
+<dl>
+  <dd><a class="anchor" id="select"></a><div class="highlight"><pre>
+{% include doc.html instance="Relation#select" %}{% include example.html object='videos = channel.videos' method='select' params=' <span class="ss">:snippet</span>, <span class="ss">:statistics</span>' %}
+{% include example.html object='videos' method='map <span class="ss">&amp;:title</span>' result='["First public video", "Second public video", ...]' %}
+{% include example.html object='videos' method='map <span class="ss">&amp;:view_count</span>' result='[123, 456, ...]' %}</pre>
+  </div></dd>
+</dl>
+<p>
+  You can also use <code>limit</code> to only fetch a certain number of videos or playlists:
+</p>
+<dl>
+  <dd><a class="anchor" id="limit"></a><div class="highlight"><pre>
+{% include doc.html instance="Relation#limit" %}{% include example.html object='videos = channel.videos' method='limit' params=' <span class="mi">2</span>' %}
+{% include example.html object='videos' method='map <span class="ss">&amp;:id</span>' result='["gknzFj_0vvY", "oO6WawhsxTA"]' %}</pre>
+  </div></dd>
+</dl>
+<p>
+  You can also use <code>size</code> to quickly obtain the estimated number of videos or playlists:
+</p>
+<dl>
+  <dd><a class="anchor" id="size"></a><div class="highlight"><pre>
+{% include doc.html instance="Relation#size" %}{% include example.html object='channel.videos' method='size' result='312' %}</pre>
+  </div></dd>
+</dl>
+<p>
+  Note that, due to <a href="https://developers.google.com/youtube/v3/docs/search/list#channelId">YouTube API limitations</a>, only a maximum of 500 videos can be fetched for an unauthenticated channel.
+</p>
+
+<dl>
+  {% include dt.html title="Collection of channels" label="success" auth="any authentication works" %}
+  <dd><a class="anchor" id="where"></a><div class="highlight"><pre>
+{% include doc.html class="Channel#where" %}{% include example.html object='<span class="no">Yt</span><span class="o">::</span><span class="no">Channel</span>' method='where'  params=' <span class="ss">id:</span> [<span class="s1">"UCwCnUcLcb9-eSrHa_RQGkQQ"</span>, <span class="s1">"UCKe_0fJtkT1dYnzn"</span>, ...]' %}
+{% include example.html result='#&lt;Yt::Relation [#&lt;Yt::Channel @id=UCwCnUcLcb9-eSrHa_RQGkQQ&gt;, ...]&gt;' %}</pre>
+  </div></dd>
+</dl>
+<p>
+  The previous method returns existing channels that match the provided IDs, skipping any unrecognized ID.<br />
+  As usual, use <code>select</code> to specify which <a href="https://developers.google.com/youtube/v3/docs/channels/list#part">parts</a> of each channels’s data to load before iterating through the list.
+</p>