yt-dlp.rb 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5376972dc27fa3ad59be7ba8c80c0ff9a5046854aefbdf3a33fca45433fc1c16
+  data.tar.gz: e96a6c8677803fb682bb03c7add405dc0a20c38b49997696dac30b4f66cefa31
+SHA512:
+  metadata.gz: cf93abf7e6ece1e46dc3a116c2a8220b2018654c2d34c152379b690bb60fbe2f0aea0f557e60544fa1a4c415c8d7cdd11c1041fde5924163eefe0f1295eea971
+  data.tar.gz: 8c4beb1285df288c15fe9b2cfb63c628f17ee77752ee82bd856f8faccaebc470ab6bd36203c574d708d2d89d09960a979cf391aa60d9a0fceaf0d8efc7bbd684

data/.github/workflows/ci.yml

@@ -0,0 +1,54 @@
+name: CI
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  ruby_dependencies:
+    name: Ruby - download and cache dependencies
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+
+      - name: Ruby gem cache
+        uses: actions/cache@v1
+        with:
+          path: vendor/bundle
+          key: gems-${{ hashFiles('**/Gemfile.lock') }}
+          restore-keys: gems-
+
+      - name: Install gems
+        run: bundle install --jobs 4 --retry 3 --path vendor/bundle
+
+  tests:
+    name: Run tests
+    runs-on: ubuntu-latest
+    needs: ruby_dependencies
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+
+      - name: Ruby gem cache
+        uses: actions/cache@v1
+        with:
+          path: vendor/bundle
+          key: gems-${{ hashFiles('**/Gemfile.lock') }}
+          restore-keys: gems-
+
+      - name: Install gems
+        run: bundle install --jobs 4 --retry 3 --path vendor/bundle
+
+      - name: Run tests
+        run: bundle exec rake test

data/.gitignore

@@ -0,0 +1,16 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+*nope.avi*
+.byebug_history

data/.rubocop.yml

@@ -0,0 +1,11 @@
+# Metrics/AbcSize:
+#   Max: 22
+
+Metrics/MethodLength:
+  Max: 14
+
+Style/ModuleFunction:
+  Enabled: false
+
+Style/FileName:
+  Enabled: false

data/.rubocop_todo.yml

@@ -0,0 +1,135 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2015-10-19 08:34:35 -0400 using RuboCop version 0.34.2.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 7
+Lint/AmbiguousRegexpLiteral:
+  Exclude:
+    - 'test/yt-dlp/runner_test.rb'
+    - 'test/yt-dlp/support_test.rb'
+    - 'test/yt-dlp_test.rb'
+
+# Offense count: 1
+Lint/Debugger:
+  Exclude:
+    - 'tmp/parse_formats.rb'
+
+# Offense count: 2
+# Cop supports --auto-correct.
+Lint/DeprecatedClassMethods:
+  Exclude:
+    - 'test/yt-dlp/runner_test.rb'
+    - 'test/yt-dlp/support_test.rb'
+
+# Offense count: 3
+Metrics/AbcSize:
+  Max: 22
+
+# Offense count: 3
+# Configuration parameters: CountComments.
+Metrics/MethodLength:
+  Max: 14
+
+# Offense count: 2
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/AccessModifierIndentation:
+  Enabled: false
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles, ProceduralMethods, FunctionalMethods, IgnoredMethods.
+Style/BlockDelimiters:
+  Enabled: false
+
+# Offense count: 2
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/BracesAroundHashParameters:
+  Exclude:
+    - 'test/yt-dlp/output_test.rb'
+    - 'test/yt-dlp/runner_test.rb'
+
+# Offense count: 1
+# Configuration parameters: Exclude.
+Style/Documentation:
+  Exclude:
+    - 'lib/yt-dlp/version.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+Style/EmptyLinesAroundAccessModifier:
+  Exclude:
+    - 'lib/yt-dlp/video.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/EmptyLinesAroundClassBody:
+  Exclude:
+    - 'lib/yt-dlp/output.rb'
+
+# Offense count: 5
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/EmptyLinesAroundModuleBody:
+  Exclude:
+    - 'lib/yt-dlp/output.rb'
+    - 'lib/yt-dlp/runner.rb'
+    - 'lib/yt-dlp/support.rb'
+    - 'lib/yt-dlp/video.rb'
+
+# Offense count: 2
+# Configuration parameters: Exclude.
+Style/FileName:
+  Exclude:
+    - 'lib/yt-dlp.rb'
+    - 'test/yt-dlp_test.rb'
+
+# Offense count: 1
+Style/ModuleFunction:
+  Exclude:
+    - 'lib/yt-dlp.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: AllowMultipleReturnValues.
+Style/RedundantReturn:
+  Exclude:
+    - 'lib/yt-dlp/support.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles, AllowInnerSlashes.
+Style/RegexpLiteral:
+  Exclude:
+    - 'test/yt-dlp_test.rb'
+
+# Offense count: 3
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/SpaceAroundEqualsInParameterDefault:
+  Enabled: false
+
+# Offense count: 12
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, EnforcedStyleForEmptyBraces, SupportedStyles.
+Style/SpaceInsideHashLiteralBraces:
+  Enabled: false
+
+# Offense count: 2
+# Cop supports --auto-correct.
+Style/SpecialGlobalVars:
+  Exclude:
+    - 'test/test_helper.rb'
+    - 'tmp/parse_formats.rb'
+
+# Offense count: 22
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/StringLiterals:
+  Enabled: false

data/.ruby-version

@@ -0,0 +1 @@
+2.7.2

data/1.0_RELEASE_GOALS.md

@@ -0,0 +1,7 @@
+yt-dlp.rb hits 1.0 when:
+
+* [x] It works on all major Unix platforms
+* [x] It works on Windows
+* [ ] It fully supports all features of yt-dlp in a Ruby-friendly way
+* [ ] It supports logging
+* [ ] [It uses v1.0 Terrapin](https://github.com/thoughtbot/terrapin/blob/master/GOALS)

data/Gemfile

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in yt-dlp.rb.gemspec
+gemspec
+
+gem 'erb'
+
+group :development do
+  gem 'rubocop', '~> 1.22', '>= 1.22.3'
+end
+
+group :extras do
+  gem 'byebug'
+  gem 'm'
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 sapslaj
+
+MIT License
+
+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 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

@@ -0,0 +1,62 @@
+# yt-dlp
+
+Wrapper for the [yt-dlp](https://github.com/yt-dlp/yt-dlp) video download tool. This gem is heavily inspired by the youtube_dl.rb gem
+
+![CI](https://github.com/andrepcg/yt-dlp.rb/workflows/CI/badge.svg)
+
+
+## Install the gem
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'yt-dlp.rb'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install yt-dlp.rb
+
+## Install yt-dlp
+This gem ships with the latest (working) version of yt-dlp built-in, so you don't have to install yt-dlp at all! Unless you want to.
+
+Some features of yt-dlp require ffmpeg or avconf to be installed.  Normally these are available for installation from your distribution's repositories.
+
+## Usage
+
+Pretty simple.
+
+```ruby
+YtDlp.download "https://www.youtube.com/watch?v=gvdf5n-zI14", output: 'some_file.mp4'
+```
+
+All options available to yt-dlp can be passed to the options hash
+
+```ruby
+options = {
+  username: 'someone',
+  password: 'password1',
+  rate_limit: '50K',
+  format: :worst,
+  continue: false
+}
+
+YtDlp.download "https://www.youtube.com/watch?v=gvdf5n-zI14", options
+```
+
+Options passed as `options = {option: true}` or `options = {option: false}` are passed to yt-dlp as `--option` or `--no-option`
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Pass test suite (`rake test`)
+5. Push to the branch (`git push origin my-new-feature`)
+6. Create a new Pull Request
+
+Remember: commit now, commit often.

data/Rakefile

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+require 'erb'
+
+Rake::TestTask.new do |t|
+  t.pattern = 'test/**/*_test.rb'
+end
+
+task default: [:test]
+
+namespace :binaries do
+  def get_binaries(version)
+    puts 'Updating python script'
+    system("wget -O ./vendor/bin/yt-dlp https://github.com/yt-dlp/yt-dlp/releases/download/#{version}/yt-dlp")
+    puts 'Updating Windows EXE'
+    system("wget -O ./vendor/bin/yt-dlp.exe https://github.com/yt-dlp/yt-dlp/releases/download/#{version}/yt-dlp.exe")
+  end
+
+  desc 'Get binaries for specific version (run with `rake binaries:version[2015.07.07]`)'
+  task :version, [:ver] do |_t, a|
+    get_binaries(a[:ver])
+  end
+end
+
+__END__
+# Version file

data/lib/yt-dlp/options.rb

@@ -0,0 +1,179 @@
+# frozen_string_literal: true
+
+module YtDlp
+  # Option and configuration getting, setting, and storage, and all that
+  class Options
+    # @return [Hash] key value storage object
+    attr_accessor :store
+
+    # @return [Array] array of keys that won't be saved to the options store
+    attr_accessor :banned_keys
+
+    # Options initializer
+    #
+    # @param options [Hash] a hash of options
+    def initialize(options = {})
+      @store = if options.is_a? Hash
+                 options
+               else
+                 options.to_h
+               end
+
+      @banned_keys = []
+    end
+
+    # Returns options as a hash
+    #
+    # @return [Hash] hash of options
+    def to_hash
+      remove_banned
+      @store
+    end
+    alias to_h to_hash
+
+    # Iterate through the paramized keys and values.
+    #
+    # @yield [paramized_key, value]
+    # @return [Object] @store
+    #
+    # TODO: Enumerable?
+    def each_paramized
+      @store.each do |key, value|
+        yield(paramize(key), value)
+      end
+    end
+
+    # Iterate through the keys and their paramized counterparts.
+    #
+    # @yield [key, paramized_key]
+    # @return [Object] @store
+    def each_paramized_key
+      @store.each_key do |key|
+        yield(key, paramize(key))
+      end
+    end
+
+    # Set options using a block
+    #
+    # @yield [config] self
+    def configure
+      yield(self) if block_given?
+      remove_banned
+      self
+    end
+
+    # Get option with brackets syntax
+    #
+    # @param key [Object] key
+    # @return [Object] value
+    def [](key)
+      remove_banned
+      return nil if banned? key
+
+      @store[key.to_sym]
+    end
+
+    # Set option with brackets syntax
+    #
+    # @param key [Object] key
+    # @param value [Object] value
+    # @return [Object] whatever Hash#= returns
+    def []=(key, value)
+      remove_banned
+      return if banned? key
+
+      @store[key.to_sym] = value
+    end
+
+    # Merge options with given hash, removing banned keys, and returning a
+    # new instance of Options.
+    #
+    # @param hash [Hash] Hash to merge options with
+    # @return [YtDlp::Options] Merged Options instance
+    def with(hash)
+      merged = Options.new(@store.merge(hash.to_h))
+      merged.banned_keys = @banned_keys
+      merged.send(:remove_banned)
+      merged
+    end
+
+    # Option getting and setting using ghost methods
+    #
+    # @param method [Symbol] method name
+    # @param args [Array] list of arguments passed
+    # @param block [Proc] implicit block given
+    # @return [Object] the value of method in the options store
+    def method_missing(method, *args, &_block)
+      remove_banned
+      if method.to_s.include? '='
+        method = method.to_s.tr('=', '').to_sym
+        return nil if banned? method
+
+        @store[method] = args.first
+      else
+        return nil if banned? method
+
+        @store[method]
+      end
+    end
+
+    # Calls a block to do operations on keys
+    # See sanitize_keys! for examples
+    #
+    # @param block [Proc] Block with operations on keys
+    # @yieldparam key [Object] Original key
+    # @yieldreturn [Object] Manipulated key
+    def manipulate_keys!(&block)
+      @store.keys.each do |old_name|
+        new_name = block.call(old_name)
+        unless new_name == old_name
+          @store[new_name] = @store[old_name]
+          @store.delete(old_name)
+        end
+      end
+    end
+
+    # Symbolizes and sanitizes keys in the option store
+    #
+    # @return [Object] @store
+    def sanitize_keys!
+      # Symbolize
+      manipulate_keys! { |key_name| key_name.is_a?(Symbol) ? key_name : key_name.to_sym }
+
+      # Underscoreize (because Terrapin doesn't like hyphens)
+      manipulate_keys! { |key_name| key_name.to_s.tr('-', '_').to_sym }
+    end
+
+    # Symbolizes and sanitizes keys and returns a copy of self
+    #
+    # @return [YtDlp::Options] Options with sanitized keys.
+    def sanitize_keys
+      safe_copy = dup
+      safe_copy.sanitize_keys!
+      safe_copy
+    end
+
+    # Check if key is a banned key
+    #
+    # @param key [Object] key to check
+    # @return [Boolean] true if key is banned, false if not.
+    def banned?(key)
+      @banned_keys.include? key
+    end
+
+    private
+
+    # Helper function to convert option keys into command-line-friendly parameters
+    #
+    # @param key [Symbol, String] key to paramize
+    # @return [String] paramized key
+    def paramize(key)
+      key.to_s.tr('_', '-')
+    end
+
+    # Helper to remove banned keys from store
+    def remove_banned
+      @store.delete_if { |key, _value| banned? key }
+    end
+  end
+end

data/lib/yt-dlp/runner.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+module YtDlp
+  # Utility class for running and managing yt-dlp
+  class Runner
+    include YtDlp::Support
+
+    # @return [String] URL to download
+    attr_accessor :url
+
+    # @return [YtDlp::Options] Options access.
+    attr_accessor :options
+
+    # @return [String] Executable path
+    attr_reader :executable_path
+
+    # @return [String] Executable name to use
+    attr_accessor :executable
+
+    # Command Line runner initializer
+    #
+    # @param url [String] URL to pass to yt-dlp executable
+    # @param options [Hash, Options] options to pass to the executable. Automatically converted to Options if it isn't already
+    def initialize(url, options = {})
+      @url = url
+      @options = YtDlp::Options.new(options)
+      @executable = 'yt-dlp'
+    end
+
+    # Returns usable executable path for yt-dlp
+    #
+    # @return [String] usable executable path for yt-dlp
+    def executable_path
+      @executable_path ||= usable_executable_path_for(@executable)
+    end
+
+    # Returns Terrapin's runner engine
+    #
+    # @return [CommandLineRunner] backend runner class
+    def backend_runner
+      Terrapin::CommandLine.runner
+    end
+
+    # Sets Terrapin's runner engine
+    #
+    # @param terrapin_runner [CommandLineRunner] backend runner class
+    # @return [Object] whatever Terrapin::CommandLine.runner= returns.
+    def backend_runner=(terrapin_runner)
+      Terrapin::CommandLine.runner = terrapin_runner
+    end
+
+    # Returns the command string without running anything
+    #
+    # @return [String] command line string
+    def to_command
+      terrapin_line(options_to_commands).command(@options.store)
+    end
+    alias command to_command
+
+    # Runs the command
+    #
+    # @return [String] the output of yt-dlp
+    def run
+      terrapin_line(options_to_commands).run(@options.store)
+    end
+    alias download run
+
+    # Options configuration.
+    # Just aliases to options.configure
+    #
+    # @yield [config] options
+    # @param a [Array] arguments to pass to options#configure
+    # @param b [Proc] block to pass to options#configure
+    def configure(*a, &b)
+      options.configure(*a, &b)
+    end
+
+    private
+
+    # Parses options and converts them to Terrapin's syntax
+    #
+    # @return [String] commands ready to do terrapin
+    def options_to_commands
+      commands = []
+      @options.sanitize_keys.each_paramized_key do |key, paramized_key|
+        case @options[key].to_s
+        when 'true'
+          commands.push "--#{paramized_key}"
+        when 'false'
+          commands.push "--no-#{paramized_key}"
+        else
+          commands.push "--#{paramized_key} :#{key}"
+        end
+      end
+      commands.push quoted(url)
+      commands.join(' ')
+    end
+  end
+end

data/lib/yt-dlp/support.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module YtDlp
+  # Some support methods and glue logic.
+  module Support
+    # Returns a usable yt-dlp executable (system or vendor)
+    #
+    # @param exe [String] Executable to search for
+    # @return [String] executable path
+    def usable_executable_path_for(exe)
+      system_path = which(exe)
+      if system_path.nil?
+        # TODO: Search vendor bin for executable before just saying it's there.
+        vendor_path = File.absolute_path("#{__FILE__}/../../../vendor/bin/#{exe}")
+        File.chmod(775, vendor_path) unless File.executable?(vendor_path) # Make sure vendor binary is executable
+        vendor_path
+      else
+        system_path.strip
+      end
+    end
+
+    alias executable_path_for usable_executable_path_for
+
+    # Helper for doing lines of terrapin (initializing, auto executable stuff, etc)
+    #
+    # @param command [String] command switches to run
+    # @param executable_path [String] executable to run. Defaults to usable yt-dlp.
+    # @return [Terrapin::CommandLine] initialized Terrapin instance
+    def terrapin_line(command, executable_path = nil)
+      executable_path = executable_path_for('yt-dlp') if executable_path.nil?
+      Terrapin::CommandLine.new(executable_path, command)
+    end
+
+    # Helper to add quotes to beginning and end of a URL or whatever you want....
+    #
+    # @param url [String] Raw URL
+    # @return [String] Quoted URL
+    def quoted(url)
+      "\"#{url}\""
+    end
+
+    # Cross-platform way of finding an executable in the $PATH.
+    # Stolen from http://stackoverflow.com/a/5471032
+    #
+    #   which('ruby') #=> /usr/bin/ruby
+    #
+    # @param cmd [String] cmd to search for
+    # @return [String] full path for the cmd
+    def which(cmd)
+      exts = ENV['PATHEXT'] ? ENV['PATHEXT'].split(';') : ['']
+      ENV['PATH'].split(File::PATH_SEPARATOR).each do |path|
+        exts.each do |ext|
+          exe = File.join(path, "#{cmd}#{ext}")
+          return exe if File.executable?(exe) && !File.directory?(exe)
+        end
+      end
+      nil
+    end
+  end
+end

data/lib/yt-dlp/version.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+# Version file
+# If you are updating this code, make sure you are updating
+# lib/yt-dlp/version.rb as well as the Rakefile.
+
+module YtDlp
+  # Semantic Version as well as the bundled binary version.
+  # "(major).(minor).(teeny).(pre-release).(binary-version)"
+  VERSION = '0.1.0'
+end

data/lib/yt-dlp/video.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+module YtDlp
+  # Video model for using and downloading a single video.
+  class Video < Runner
+    class << self
+      # Instantiate a new Video model and download the video
+      #
+      #   YtDlp.download 'https://www.youtube.com/watch?v=KLRDLIIl8bA' # => #<YtDlp::Video:0x00000000000000>
+      #   YtDlp.get 'https://www.youtube.com/watch?v=ia1diPnNBgU', extract_audio: true, audio_quality: 0
+      #
+      # @param url [String] URL to use and download
+      # @param options [Hash] Options to pass in
+      # @return [YtDlp::Video] new Video model
+      def download(url, options = {})
+        video = new(url, options)
+        video.download
+        video
+      end
+      alias get download
+
+      def information(url, options = {})
+        video = new(url, options)
+        video.information
+      end
+    end
+
+    # @return [YtDlp::Options] Download Options for the last download
+    attr_reader :download_options
+
+    # Instantiate new model
+    #
+    # @param url [String] URL to initialize with
+    # @param options [Hash] Options to populate the everything with
+    def initialize(url, options = {})
+      @url = url
+      @options = YtDlp::Options.new(options.merge(default_options))
+      @options.banned_keys = banned_keys
+    end
+
+    # Download the video.
+    def download
+      raise ArgumentError, 'url cannot be nil' if @url.nil?
+      raise ArgumentError, 'url cannot be empty' if @url.empty?
+
+      set_information_from_json(YtDlp::Runner.new(url, runner_options).run)
+    end
+
+    alias get download
+
+    # Returns the expected filename
+    #
+    # @return [String] Filename downloaded to
+    def filename
+      _filename
+    end
+
+    # Metadata information for the video, gotten from --print-json
+    #
+    # @return [OpenStruct] information
+    def information
+      @information || grab_information_without_download
+    end
+
+    # Redirect methods for information getting
+    #
+    # @param method [Symbol] method name
+    # @param args [Array] method arguments
+    # @param block [Proc] explict block
+    # @return [Object] The value from @information
+    def method_missing(method, *args, &block)
+      value =
+        if information.is_a?(Array)
+          information.first[method]
+        else
+          information[method]
+        end
+
+      if value.nil?
+        super
+      else
+        value
+      end
+    end
+
+    private
+
+    # Add in other default options here.
+    def default_options
+      {
+        color: false,
+        progress: false,
+        print_json: true
+      }
+    end
+
+    def banned_keys
+      %i[
+        get_url
+        get_title
+        get_id
+        get_thumbnail
+        get_description
+        get_duration
+        get_filename
+        get_format
+      ]
+    end
+
+    def runner_options
+      YtDlp::Options.new(@options.to_h.merge(default_options))
+    end
+
+    def set_information_from_json(json) # :nodoc:
+      @information =
+        if json.include?("\n")
+          json.split("\n").collect do |root_node|
+            JSON.parse(root_node, symbolize_names: true)
+          end
+        else
+          JSON.parse(json, symbolize_names: true)
+        end
+    end
+
+    def grab_information_without_download # :nodoc:
+      set_information_from_json(YtDlp::Runner.new(url, runner_options.with({ skip_download: true })).run)
+    end
+  end
+end

data/lib/yt-dlp.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require 'terrapin'
+require 'json'
+require 'ostruct'
+
+require 'yt-dlp/version'
+require 'yt-dlp/support'
+require 'yt-dlp/options'
+require 'yt-dlp/runner'
+require 'yt-dlp/video'
+
+# Global YtDlp module. Contains some convenience methods and all of the business classes.
+module YtDlp
+  extend self
+  extend Support
+
+  # Downloads given array of URLs with any options passed
+  #
+  # @param urls [String, Array] URLs to download
+  # @param options [Hash] Downloader options
+  # @return [YtDlp::Video, Array] Video model or array of Video models
+  def download(urls, options = {})
+    if urls.is_a? Array
+      urls.map { |url| YtDlp::Video.get(url, options) }
+    else
+      YtDlp::Video.get(urls, options) # Urls should be singular but oh well. url = urls. There. Go cry in a corner.
+    end
+  end
+
+  alias get download
+
+  def information(urls, options = {})
+    if urls.is_a? Array
+      urls.map { |url| YtDlp::Video.information(url, options) }
+    else
+      YtDlp::Video.information(urls, options) # Urls should be singular but oh well. url = urls. There. Go cry in a corner.
+    end
+  end
+
+  # Lists extractors
+  #
+  # @return [Array] list of extractors
+  def extractors
+    @extractors ||= terrapin_line('--list-extractors').run.split("\n")
+  end
+
+  # Returns yt-dlp's version
+  #
+  # @return [String] yt-dlp version
+  def binary_version
+    @binary_version ||= terrapin_line('--version').run.strip
+  end
+
+  # Returns user agent
+  #
+  # @return [String] user agent
+  def user_agent
+    @user_agent ||= terrapin_line('--dump-user-agent').run.strip
+  end
+end

data/yt-dlp.rb.gemspec

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'yt-dlp/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'yt-dlp.rb'
+  spec.version       = YtDlp::VERSION
+  spec.authors       = %w[andrepcg]
+  spec.email         = ['andrepcg@gmail.com']
+  spec.summary       = 'yt-dlp wrapper for Ruby'
+  spec.description   = 'yt-dlp.rb is a command line wrapper for the python script yt-dlp'
+  spec.homepage      = 'https://github.com/andrepcg/yt-dlp.rb'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  # 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.required_ruby_version = '>= 2.6'
+
+  spec.add_dependency 'terrapin', '>=0.6.0'
+
+  spec.add_development_dependency 'bundler', '>= 1.6'
+  spec.add_development_dependency 'codeclimate-test-reporter'
+  spec.add_development_dependency 'minitest', '~> 5.14.3'
+  spec.add_development_dependency 'purdytest'
+  spec.add_development_dependency 'rake', '~> 10.0'
+end

metadata

@@ -0,0 +1,146 @@
+--- !ruby/object:Gem::Specification
+name: yt-dlp.rb
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- andrepcg
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2021-11-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: terrapin
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: codeclimate-test-reporter
+  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: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.14.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.14.3
+- !ruby/object:Gem::Dependency
+  name: purdytest
+  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: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: yt-dlp.rb is a command line wrapper for the python script yt-dlp
+email:
+- andrepcg@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/ci.yml"
+- ".gitignore"
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
+- ".ruby-version"
+- 1.0_RELEASE_GOALS.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/yt-dlp.rb
+- lib/yt-dlp/options.rb
+- lib/yt-dlp/runner.rb
+- lib/yt-dlp/support.rb
+- lib/yt-dlp/version.rb
+- lib/yt-dlp/video.rb
+- vendor/bin/yt-dlp
+- vendor/bin/yt-dlp.exe
+- yt-dlp.rb.gemspec
+homepage: https://github.com/andrepcg/yt-dlp.rb
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.6'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.4
+signing_key: 
+specification_version: 4
+summary: yt-dlp wrapper for Ruby
+test_files: []