vidload 0.5.3 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2674d9d261f3cc70b53dc839aa9a83690b3a9a0db99aa601f3437e4e0b1131af
-  data.tar.gz: 6df78a1ff421c653780ac60a6f2ce0e273ac0dd81adbf2350f53c9241530e782
+  metadata.gz: bfb4321ae5920e81d81c3309dd6311afc2146df5c91143f1d59ade27a5d53267
+  data.tar.gz: ecbd3f8b0003e336d633240715b87f5f9253b2e4cf452da4da0e9b4827a18bf3
 SHA512:
-  metadata.gz: 1f1d62a1f636b7e60487ae84ee38e971d61e583c8681c7d124871e7f141bbc7a0e79cf5281ce60a1bee10fe429dc264522ede268331cb2c8f240b10c7e307c3e
-  data.tar.gz: 8189ba5721861dd2a09d3330afbc11d3cbd711f9d9131058cbe2be37c56601c5e4cefa01f2af3c1c7c48622f46618e6ad9d69605c8e2c3c95cb46181521c5f10
+  metadata.gz: '038dd29d23532baae65bdcf587a36599bd12fc74d991c46f9f524c2a8d1615ae1b941e934c4a618e47454d4fff3c1c0748068656f319d798b46633fb2abe4c3f'
+  data.tar.gz: 56ae75f98274d050c9ac0e1e16d6649e5587a2ae38fdd3e9163cdc12f73c290979ce877cab80f8316bd76402ef0376a260bfa45e7f5e52d8931bef553d38adde

data/lib/vidload/custom/api.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+require 'playwright'
+require 'tty-spinner'
+require 'open3'
+require 'io/console'
+
+module Vidload
+  module Custom
+    module Api
+      class DownloaderBuilder
+        REQUIRED_ARGS = %i[playwright_cli_path].freeze
+
+        def initialize
+          @kwargs = {}
+        end
+
+        def with_kwargs(**kwargs)
+          @kwargs = kwargs
+          self
+        end
+
+        def with_service_url(service_url)
+          @kwargs[:service_url] = service_url
+          self
+        end
+
+        def with_video_url(video_url)
+          @kwargs[:video_url] = video_url
+          self
+        end
+
+        def with_title(title)
+          @kwargs[:title] = title
+          self
+        end
+
+        def with_author_name(author_name)
+          @kwargs[:author_name] = author_name
+          self
+        end
+
+        def with_playwright_cli_path(playwright_cli_path)
+          @kwargs[:playwright_cli_path] = playwright_cli_path
+          self
+        end
+
+        def is_headless?(headless)
+          @kwargs[:headless] = headless
+          self
+        end
+
+        def build
+          REQUIRED_ARGS.each do |required_arg|
+            raise ArgumentError, "#{required_arg} must be provided" unless @kwargs[required_arg]
+          end
+
+          Downloader.new(**@kwargs)
+        end
+      end
+
+      class Downloader
+        def initialize(**kwargs)
+          @kwargs = kwargs
+        end
+
+        def self.builder
+          DownloaderBuilder.new
+        end
+
+        def self.from_hash(hash)
+          builder.with_kwargs(**hash).build
+        end
+
+        # main func to be called in your own scripts defined under web/
+        def download_video(video_starter_callbacks: [])
+          Playwright.create(playwright_cli_executable_path: @kwargs[:playwright_cli_path]) do |playwright|
+            browser = playwright.chromium.launch(headless: @kwargs['headless'])
+            page = browser.new_page
+
+            manage_video_download(page, *video_starter_callbacks)
+
+            browser.close
+          end
+        end
+
+        def display_calling_args
+          puts 'Called with:'
+          @kwargs.each do |key, value|
+            puts "\t#{key}=#{value}"
+          end
+        end
+
+        def self.display_with_spinner(loading_msg = 'Loading...')
+          spinner = TTY::Spinner.new("[:spinner] #{loading_msg}")
+          spinner.auto_spin
+          yield
+          spinner.success('(done)')
+        end
+
+        private
+
+        def manage_video_download(page, *video_starter_callbacks)
+          video_starter_callbacks.each do |callback|
+            res = callback.call(page, @kwargs)
+            @kwargs[:title] = res[:title] if !@kwargs[:title] && res[:title]
+            @kwargs[:author_name] = res[:author_name] if !@kwargs[:author_name] && res[:author_name]
+            @kwargs[:cover_img_url] = res[:cover_img_url] if !@kwargs[:cover_img_url] && res[:cover_img_url]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/vidload/custom/cli.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'thor'
+
+module Vidload
+  module Custom
+    class Cli < Thor
+      desc 'custom VIDEO_URLS...', 'download one ore more mp4 videos'
+      method_option :title, type: :string, required: false
+      method_option :author_name, type: :string, required: false
+      method_option :playwright_cli_path, type: :string, required: true
+      method_option :headless, type: :boolean, default: true
+      method_option :service_url, type: :string, required: true
+      def custom(*video_urls)
+        video_urls.each do |video_url|
+          params = {
+            video_url: video_url,
+            **options
+          }
+
+          process_custom(params)
+          sleep 1
+        end
+      end
+
+      private
+
+      def process_custom(params)
+        raise NotImplementedError
+      end
+    end
+  end
+end

data/lib/vidload/custom.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Vidload
+  module Custom
+    require_relative 'custom/api'
+    require_relative 'custom/cli'
+  end
+end

data/lib/vidload/mp2t/cli.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'thor'
+
+module Vidload
+  module Mp2t
+    class Cli < Thor
+      desc 'mp2t VIDEO_URLS...', 'download one ore more mp2t containerized videos'
+      method_option :video_name, type: :string, required: false
+      method_option :author_name, type: :string, required: false
+      method_option :output_dir, type: :string, required: false
+      method_option :headless, type: :boolean, default: true
+      method_option :author_dir, type: :boolean, default: false
+      method_option :hls_url, type: :string, required: true
+      method_option :master_playlist_name, type: :string, required: true
+      method_option :playwright_cli_path, type: :string, required: true
+      method_option :video_referer, type: :string, required: true
+      method_option :ts_seg_pattern, type: :string, required: true
+      method_option :hls_index_pattern, type: :string, required: true
+      def mp2t(*video_urls)
+        video_urls.each do |video_url|
+          params = {
+            video_url: video_url,
+            **options
+          }
+
+          process_mp2t(params)
+          sleep 1
+        end
+      end
+    end
+  end
+end

data/lib/vidload/mp2t.rb

@@ -3,5 +3,6 @@
 module Vidload
   module Mp2t
     require_relative 'mp2t/api'
+    require_relative 'mp2t/cli'
   end
 end

data/lib/vidload/mp4/cli.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'thor'
+
+module Vidload
+  module Mp4
+    class Cli < Thor
+      desc 'mp4 VIDEO_URLS...', 'download one ore more mp4 videos'
+      method_option :video_name, type: :string, required: false
+      method_option :video_hub_url, type: :string, required: true
+      method_option :playwright_cli_path, type: :string, required: true
+      method_option :headless, type: :boolean, default: true
+      def mp4(*video_urls)
+        video_urls.each do |video_url|
+          params = {
+            video_url: video_url,
+            **options
+          }
+
+          process_mp4(params)
+          sleep 1
+        end
+      end
+
+      private
+
+      def process_mp4(params)
+        raise NotImplementedError
+      end
+    end
+  end
+end

data/lib/vidload/mp4.rb

@@ -3,5 +3,6 @@
 module Vidload
   module Mp4
     require_relative 'mp4/api'
+    require_relative 'mp4/cli'
   end
 end

data/lib/vidload/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Vidload
-  VERSION = '0.5.3'
+  VERSION = '0.6.1'
 end

data/lib/vidload.rb

@@ -4,5 +4,5 @@ module Vidload
   require_relative 'vidload/version'
   require_relative 'vidload/mp2t'
   require_relative 'vidload/mp4'
-  require_relative 'vidload/cli'
+  require_relative 'vidload/custom'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vidload
 version: !ruby/object:Gem::Version
-  version: 0.5.3
+  version: 0.6.1
 platform: ruby
 authors:
 - Patacode <pata.codegineer@gmail.com>
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-13 00:00:00.000000000 Z
+date: 2026-03-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lucky_case
@@ -80,6 +80,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: gem-release
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -115,15 +129,20 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/vidload.rb
-- lib/vidload/cli.rb
+- lib/vidload/custom.rb
+- lib/vidload/custom/api.rb
+- lib/vidload/custom/cli.rb
 - lib/vidload/mp2t.rb
 - lib/vidload/mp2t/api.rb
+- lib/vidload/mp2t/cli.rb
 - lib/vidload/mp2t/remuxer.sh
 - lib/vidload/mp4.rb
 - lib/vidload/mp4/api.rb
+- lib/vidload/mp4/cli.rb
 - lib/vidload/version.rb
 homepage:
-licenses: []
+licenses:
+- MIT
 metadata: {}
 post_install_message:
 rdoc_options: []

data/lib/vidload/cli.rb

@@ -1,52 +0,0 @@
-# frozen_string_literal: true
-
-require 'thor'
-
-module Vidload
-  class Cli < Thor
-    desc 'mp2t VIDEO_URL', 'download a mp2t containerized video'
-    method_option :video_name, type: :string, required: false
-    method_option :author_name, type: :string, required: false
-    method_option :output_dir, type: :string, required: false
-    method_option :headless, type: :boolean, default: true
-    method_option :author_dir, type: :boolean, default: false
-    method_option :hls_url, type: :string, required: true
-    method_option :master_playlist_name, type: :string, required: true
-    method_option :playwright_cli_path, type: :string, required: true
-    method_option :video_referer, type: :string, required: true
-    method_option :ts_seg_pattern, type: :string, required: true
-    method_option :hls_index_pattern, type: :string, required: true
-    def mp2t(video_url)
-      params = {
-        video_url: video_url,
-        **options
-      }
-
-      process_mp2t(params)
-    end
-
-    desc 'mp4 VIDEO_URL', 'download a mp4 video'
-    method_option :video_name, type: :string, required: false
-    method_option :video_hub_url, type: :string, required: true
-    method_option :playwright_cli_path, type: :string, required: true
-    method_option :headless, type: :boolean, default: true
-    def mp4(video_url)
-      params = {
-        video_url: video_url,
-        **options
-      }
-
-      process_mp4(params)
-    end
-
-    private
-
-    def process_mp2t(params)
-      raise NotImplementedError
-    end
-
-    def process_mp4(params)
-      raise NotImplementedError
-    end
-  end
-end