yayvd 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 03e9c133c4903acd5b5e4ca9d1efbc7c8d73068ffd3e90e6f70925b4d6145181
+  data.tar.gz: f0de49d56d5143f5dd2d68e631e7a47962e3b75771e23d7e01efb0804293a23a
+SHA512:
+  metadata.gz: 5075ceacf9303923cc7ee318ac4c7af4d1add0eeb6814909af370d27b060886da771af1b70d95686eb9bdccce0b3637779d2c6013082d19dc2276f2df6b15ea3
+  data.tar.gz: 68fa339643827abf48783ef50289a5e2b8617a61bf5bc64ee842db831439d67522642966f5573ec38ecd178eaff5c0981f8e34c746ddc19ed576b6969e6697cd

data/README.md

@@ -0,0 +1,110 @@
+# YAYVD (Yet Another Youtube Video Downloader)
+
+[![Gem Version](https://badge.fury.io/rb/yayvd.svg)](https://badge.fury.io/rb/yayvd)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**YAYVD** is a developer-friendly Ruby wrapper for [yt-dlp](https://github.com/yt-dlp/yt-dlp). It simplifies the process of downloading videos and audio from YouTube, providing a clean Ruby API while leveraging the power and stability of `yt-dlp`.
+
+Designed for both **Humans** (simple API, sensible defaults) and **AI Agents** (structured metadata, predictable errors).
+
+## 🚀 Features
+
+*   **Simple API:** Download video or audio with a single line of code.
+*   **Smart Audio:** Automatically extracts high-quality audio, converts to MP3, and embeds metadata (Artist, Title, Cover Art).
+*   **Rich Metadata:** Fetch video details (views, duration, upload date) without downloading the file.
+*   **Reliable:** Built on top of `yt-dlp`, the industry standard for video extraction.
+*   **Configurable:** Customize paths and binary locations easily.
+
+## 📦 Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'yayvd'
+```
+
+And then execute:
+
+    $ bundle install
+
+### System Dependencies
+
+YAYVD requires `yt-dlp` and `ffmpeg` (for audio conversion) to be installed on your system.
+
+**macOS (Homebrew):**
+```bash
+brew install yt-dlp ffmpeg
+```
+
+**Linux (Debian/Ubuntu):**
+```bash
+sudo apt update
+sudo apt install yt-dlp ffmpeg
+```
+
+**Python (Universal):**
+```bash
+pip install yt-dlp
+```
+
+## 🛠 Usage
+
+### Basic Usage
+
+```ruby
+require 'yayvd'
+
+# Initialize with a YouTube URL
+video = Yayvd::Video.new("https://www.youtube.com/watch?v=dQw4w9WgXcQ")
+
+# 1. Get Metadata (Fast, no download)
+info = video.info
+puts "Title: #{info.title}"       # => "Rick Astley - Never Gonna Give You Up"
+puts "Views: #{info.views}"       # => 123456789
+puts "Date:  #{info.upload_date}" # => <Date: 2009-10-25>
+
+# 2. Download Audio (High Quality MP3 + Metadata + Cover Art)
+# Saves to current directory by default
+video.download_audio
+
+# 3. Download Video (Best Quality MP4)
+video.download_video
+```
+
+### Advanced Configuration
+
+You can configure download paths and binary locations globally:
+
+```ruby
+Yayvd.configure do |config|
+  config.default_download_path = "/home/user/Downloads"
+  config.yt_dlp_path = "/usr/local/bin/yt-dlp" # Optional: Custom binary path
+end
+```
+
+### Custom Output Path per Download
+
+```ruby
+video.download_audio(path: "/tmp/music")
+video.download_video(path: "/tmp/videos")
+```
+
+## 🤖 AI Context (For LLMs & Agents)
+
+If you are an AI agent using this library, here is the mental model:
+
+1.  **Class:** `Yayvd::Video` is the main entry point.
+2.  **Initialization:** `Yayvd::Video.new(url)` is lightweight. It does not make network requests.
+3.  **Metadata:** `.info` returns an `OpenStruct`. It caches the result, so calling it multiple times is safe.
+4.  **Blocking:** `.download_audio` and `.download_video` are **blocking** operations. They shell out to `yt-dlp`.
+5.  **Errors:**
+    *   `Yayvd::ExecutionError`: Raised if `yt-dlp` fails (e.g., invalid URL, network error).
+    *   `Yayvd::Error::Messages::YT_DLP_NOT_FOUND`: Raised if the binary is missing.
+
+## 🤝 Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/Lusqinha/YAYVD.
+
+## 📝 License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,9 @@
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task default: :test

data/lib/yayvd/config.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Yayvd
+  class Configuration
+    attr_accessor :yt_dlp_path, :ffmpeg_path, :default_download_path
+
+    def initialize
+      @yt_dlp_path = "yt-dlp" # Tenta usar do PATH por padrão
+      @ffmpeg_path = "ffmpeg"
+      @default_download_path = Dir.pwd
+    end
+  end
+end

data/lib/yayvd/error.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Yayvd
+  class Error < StandardError
+    module Messages
+      YT_DLP_EXECUTION_FAILED = "Failed to execute yt-dlp"
+      YT_DLP_NOT_FOUND = "yt-dlp not found. Please install it to use this gem."
+    end
+  end
+
+  class ExecutionError < Error; end
+  class DependencyError < Error; end
+end

data/lib/yayvd/executor.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require "open3"
+
+module Yayvd
+  class Executor
+    def execute(args)
+      binary = Yayvd.configuration.yt_dlp_path
+      cmd = "#{binary} #{args}"
+      
+      stdout, stderr, status = Open3.capture3(cmd)
+
+      unless status.success?
+        raise Yayvd::ExecutionError, "#{Yayvd::Error::Messages::YT_DLP_EXECUTION_FAILED}: #{stderr}"
+      end
+
+      stdout
+    end
+  end
+end

data/lib/yayvd/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Yayvd
+  VERSION = "0.1.0"
+end

data/lib/yayvd/video.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+require 'json'
+require 'date'
+require 'ostruct'
+
+module Yayvd
+  class Video
+    attr_reader :url, :metadata
+
+    def initialize(url, executor: Executor.new)
+      @url = url
+      @metadata = nil
+      @executor = executor
+    end
+
+    def info
+      return @metadata if @metadata
+
+      output = run_command("--dump-json")
+      raw_data = JSON.parse(output)
+      
+      @metadata = OpenStruct.new(
+        title: raw_data["title"],
+        duration: raw_data["duration"],
+        views: raw_data["view_count"],
+        uploader: raw_data["uploader"],
+        upload_date: parse_date(raw_data["upload_date"]),
+        formats: raw_data["formats"]
+      )
+    end
+
+    def download_audio(path: nil)
+      output_dir = path || Yayvd.configuration.default_download_path
+      output_template = File.join(output_dir, "%(title)s.%(ext)s")
+
+      # -f bestaudio: Best audio source
+      # -x: Extract audio
+      # --audio-format mp3: Convert to mp3
+      # --audio-quality 0: Best VBR quality
+      # --embed-metadata: Adds artist, title, etc to the file
+      # --embed-thumbnail: Adds video thumbnail as album art
+      args = "-f bestaudio -x --audio-format mp3 --audio-quality 0 --embed-metadata --embed-thumbnail -o \"#{output_template}\""
+
+      run_command(args)
+    end
+
+    def download_video(quality: :best, path: nil)
+      output_dir = path || Yayvd.configuration.default_download_path
+      output_template = File.join(output_dir, "%(title)s.%(ext)s")
+
+      # bestvideo+bestaudio/best: Best video and audio merged
+      # --merge-output-format mp4: Ensure final container is mp4
+      args = "-f \"bestvideo+bestaudio/best\" --merge-output-format mp4 -o \"#{output_template}\""
+
+      run_command(args)
+    end
+
+    private
+
+    def run_command(args)
+      full_args = "#{args} \"#{@url}\""
+      @executor.execute(full_args)
+    end
+
+    def parse_date(date_str)
+      Date.parse(date_str) rescue nil
+    end
+  end
+end

data/lib/yayvd.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require_relative "yayvd/version"
+require_relative "yayvd/config"
+require_relative "yayvd/executor"
+require_relative "yayvd/video"
+require_relative "yayvd/error"
+
+module Yayvd
+  class << self
+    attr_accessor :configuration
+  end
+
+  def self.configure
+    self.configuration ||= Configuration.new
+    yield(configuration)
+  end
+end

data/mise.toml

@@ -0,0 +1,2 @@
+[tools]
+ruby = "3.4.3"

data/yayvd.gemspec

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative "lib/yayvd/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "yayvd"
+  spec.version = Yayvd::VERSION
+  spec.authors = ["Lucas"]
+  spec.email = ["lucas@example.com"]
+
+  spec.summary = "Yet Another Youtube Video Downloader - A robust Ruby wrapper for yt-dlp"
+  spec.description = "A simple Ruby interface for downloading YouTube videos and audio using yt-dlp."
+  spec.homepage = "https://github.com/Lusqinha/YAYVD"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.0.0"
+
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git .circleci appveyor Gemfile])
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,51 @@
+--- !ruby/object:Gem::Specification
+name: yayvd
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Lucas
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: A simple Ruby interface for downloading YouTube videos and audio using
+  yt-dlp.
+email:
+- lucas@example.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- Rakefile
+- lib/yayvd.rb
+- lib/yayvd/config.rb
+- lib/yayvd/error.rb
+- lib/yayvd/executor.rb
+- lib/yayvd/version.rb
+- lib/yayvd/video.rb
+- mise.toml
+- yayvd.gemspec
+homepage: https://github.com/Lusqinha/YAYVD
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: Yet Another Youtube Video Downloader - A robust Ruby wrapper for yt-dlp
+test_files: []