tugyt 0.2.3__tar.gz

tugyt-0.2.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ftnick
+
+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.

tugyt-0.2.3/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: tugyt
+Version: 0.2.3
+Summary: A focused YouTube downloader powered by yt-dlp.
+Author: ftnick
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: yt-dlp==2026.8.19
+Requires-Dist: rich==15.0.0
+Dynamic: license-file
+
+<p align="center">
+  <img src="icon.ico" width="160">
+</p>
+<p align="center">
+  <sub>Fetch (icon) by <a href="https://thenounproject.com/browse/icons/term/fetch/" target="_blank" title="highlight Icons">Gregor Cresnar</a> from <a href="https://thenounproject.com/browse/icons/term/fetch/" target="_blank" title="highlight Icons">Noun Project</a> (CC BY 3.0)</sub>
+</p>
+
+<h1 align="center">tugyt</h1>
+
+<p align="center">
+    is a lightweight command-line YouTube downloader powered by <a href="https://github.com/yt-dlp/yt-dlp" target="_blank">yt-dlp</a>, with support for videos, playlists, audio extraction, subtitles, metadata, and download archives.
+</p>
+
+<p align="center">
+  <a href="https://github.com/ftnick/tugyt/actions/workflows/python-package.yml"><img src="https://github.com/ftnick/tugyt/actions/workflows/python-package.yml/badge.svg" alt="CI"></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/ftnick/tugyt/blob/main/LICENSE"><img src="https://img.shields.io/github/license/ftnick/tugyt" alt="License"></a>
+  <a href="https://github.com/ftnick/tugyt/commits/main"><img src="https://img.shields.io/github/last-commit/ftnick/tugyt" alt="Last commit"></a>
+</p>

tugyt-0.2.3/README.md

@@ -0,0 +1,21 @@
+<p align="center">
+  <img src="icon.ico" width="160">
+</p>
+<p align="center">
+  <sub>Fetch (icon) by <a href="https://thenounproject.com/browse/icons/term/fetch/" target="_blank" title="highlight Icons">Gregor Cresnar</a> from <a href="https://thenounproject.com/browse/icons/term/fetch/" target="_blank" title="highlight Icons">Noun Project</a> (CC BY 3.0)</sub>
+</p>
+
+<h1 align="center">tugyt</h1>
+
+<p align="center">
+    is a lightweight command-line YouTube downloader powered by <a href="https://github.com/yt-dlp/yt-dlp" target="_blank">yt-dlp</a>, with support for videos, playlists, audio extraction, subtitles, metadata, and download archives.
+</p>
+
+<p align="center">
+  <a href="https://github.com/ftnick/tugyt/actions/workflows/python-package.yml"><img src="https://github.com/ftnick/tugyt/actions/workflows/python-package.yml/badge.svg" alt="CI"></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/ftnick/tugyt/blob/main/LICENSE"><img src="https://img.shields.io/github/license/ftnick/tugyt" alt="License"></a>
+  <a href="https://github.com/ftnick/tugyt/commits/main"><img src="https://img.shields.io/github/last-commit/ftnick/tugyt" alt="Last commit"></a>
+</p>

tugyt-0.2.3/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools==84.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tugyt"
+dynamic = ["version"]
+description = "A focused YouTube downloader powered by yt-dlp."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "ftnick" }]
+dependencies = [
+    "yt-dlp==2026.8.19",
+    "rich==15.0.0",
+]
+
+[project.scripts]
+tugyt = "tugyt.tugyt:cli"
+
+[tool.setuptools.packages.find]
+include = ["tugyt*"]
+
+[tool.setuptools.dynamic]
+version = { attr = "tugyt.tugyt.__version__" }

tugyt-0.2.3/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tugyt-0.2.3/setup.py

@@ -0,0 +1,4 @@
+from setuptools import setup
+
+
+setup()

tugyt-0.2.3/tests/test_tugyt.py

@@ -0,0 +1,267 @@
+from typing import Optional
+
+import pytest
+
+import tugyt.tugyt as app
+
+
+class FakeProgress:
+    entered = 0
+
+    def __enter__(self):
+        self.__class__.entered += 1
+        return self
+
+    def __exit__(self, exception_type, exception, traceback):
+        return False
+
+    def update(self, status):
+        pass
+
+
+class FakeDownloader:
+    instances = []
+    result = 0
+    error: Optional[type[Exception]] = None
+
+    def __init__(self, options):
+        self.options = options
+        self.__class__.instances.append(self)
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exception_type, exception, traceback):
+        return False
+
+    def download(self, urls):
+        if self.error:
+            raise self.error("download failed")
+        self.urls = urls
+        return self.result
+
+
+class FakeYtdlp:
+    class utils:
+        class DownloadError(Exception):
+            pass
+
+    YoutubeDL = FakeDownloader
+
+
+@pytest.fixture(autouse=True)
+def reset_fake_downloader(monkeypatch):
+    FakeDownloader.instances = []
+    FakeDownloader.result = 0
+    FakeDownloader.error = None
+    FakeProgress.entered = 0
+    monkeypatch.setattr(app, "yt_dlp", FakeYtdlp)
+    monkeypatch.setattr(app, "DownloadProgress", FakeProgress)
+
+
+def test_parser_defaults_and_input():
+    args = app.create_parser().parse_args(["https://www.youtube.com/watch?v=example"])
+
+    assert args.input == ["https://www.youtube.com/watch?v=example"]
+    assert args.output == app.DEFAULT_OUTPUT
+    assert args.format == "bv*+ba/b"
+    assert args.retries == 10
+
+
+def test_read_inputs_expands_files_and_preserves_order(tmp_path):
+    input_file = tmp_path / "urls.txt"
+    input_file.write_text(
+        "# ignored\nhttps://example.test/one\n\n https://example.test/two \n",
+        encoding="utf-8",
+    )
+
+    assert app._read_inputs(["https://example.test/direct", str(input_file)]) == [
+        "https://example.test/direct",
+        "https://example.test/one",
+        "https://example.test/two",
+    ]
+
+
+def test_normalize_subtitle_languages_expands_all_alias():
+    assert app._normalize_subtitle_languages("en.*,all,ja") == ["en.*", ".*", "ja"]
+
+
+def test_build_options_translates_all_optional_flags():
+    args = app.create_parser().parse_args([
+        "https://www.youtube.com/watch?v=example",
+        "--quiet",
+        "--verbose",
+        "--keep-video",
+        "--ignore-errors",
+        "--no-continue",
+        "--output",
+        "%(id)s.%(ext)s",
+        "--format",
+        "best",
+        "--extract-audio",
+        "--audio-format",
+        "opus",
+        "--audio-quality",
+        "128K",
+        "--list-formats",
+        "--dump-json",
+        "--skip-download",
+        "--write-thumbnail",
+        "--write-info-json",
+        "--write-description",
+        "--write-subs",
+        "--write-auto-subs",
+        "--embed-metadata",
+        "--embed-thumbnail",
+        "--embed-subs",
+        "--no-playlist",
+        "--flat-playlist",
+        "--playlist-start",
+        "2",
+        "--playlist-end",
+        "8",
+        "--playlist-items",
+        "2,4-6",
+        "--download-archive",
+        "archive.txt",
+        "--sponsorblock-remove",
+        "sponsor,intro",
+        "--proxy",
+        "http://proxy.test:8080",
+        "--user-agent",
+        "test-agent",
+        "--concurrent-fragments",
+        "4",
+        "--retries",
+        "3",
+        "--rate-limit",
+        "1000",
+        "--sub-langs",
+        "en,all",
+        "--sub-format",
+        "vtt",
+    ])
+
+    options = app.build_options(args)
+
+    assert options["format"] == "best"
+    assert options["outtmpl"] == "%(id)s.%(ext)s"
+    assert options["quiet"] is True
+    assert options["no_warnings"] is True
+    assert options["continuedl"] is False
+    assert options["concurrent_fragment_downloads"] == 4
+    assert options["subtitleslangs"] == ["en", ".*"]
+    assert options["subtitlesformat"] == "vtt"
+    assert options["postprocessors"] == [{
+        "key": "FFmpegExtractAudio",
+        "preferredcodec": "opus",
+        "preferredquality": "128K",
+    }]
+    assert options["http_headers"] == {"User-Agent": "test-agent"}
+    assert options["proxy"] == "http://proxy.test:8080"
+    assert options["verbose"] is True
+
+
+def test_main_downloads_expanded_inputs_and_adds_progress_hook(tmp_path):
+    input_file = tmp_path / "urls.txt"
+    input_file.write_text("https://example.test/video\n", encoding="utf-8")
+    args = app.create_parser().parse_args([str(input_file)])
+    FakeDownloader.result = 7
+
+    assert app.main(args) == 7
+
+    downloader = FakeDownloader.instances[0]
+    assert downloader.urls == ["https://example.test/video"]
+    assert downloader.options["noprogress"] is True
+    assert len(downloader.options["progress_hooks"]) == 1
+
+
+def test_main_quiet_mode_does_not_register_progress_hook():
+    args = app.create_parser().parse_args(["https://example.test/video", "--quiet"])
+
+    assert app.main(args) == 0
+
+    options = FakeDownloader.instances[0].options
+    assert FakeProgress.entered == 0
+    assert "noprogress" not in options
+    assert "progress_hooks" not in options
+
+
+def test_main_parses_fresh_arguments_for_each_call(monkeypatch):
+    first_args = app.create_parser().parse_args(["https://example.test/first"])
+    second_args = app.create_parser().parse_args(["https://example.test/second"])
+    parsed_args = iter([first_args, second_args])
+    monkeypatch.setattr(app.cmdl_parser, "parse_args", lambda: next(parsed_args))
+
+    assert app.main() == 0
+    assert app.main() == 0
+
+    assert [instance.urls for instance in FakeDownloader.instances] == [
+        ["https://example.test/first"],
+        ["https://example.test/second"],
+    ]
+
+
+def test_main_translates_downloader_error():
+    FakeDownloader.error = FakeYtdlp.utils.DownloadError
+    args = app.create_parser().parse_args(["https://example.test/video"])
+
+    with pytest.raises(app.DownloadError, match="download failed"):
+        app.main(args)
+
+
+def test_main_rejects_missing_dependency(monkeypatch):
+    monkeypatch.setattr(app, "yt_dlp", None)
+    args = app.create_parser().parse_args(["https://example.test/video"])
+
+    with pytest.raises(app.DownloadError, match="yt-dlp is not installed"):
+        app.main(args)
+
+
+def test_main_rejects_input_file_without_urls(tmp_path):
+    input_file = tmp_path / "empty.txt"
+    input_file.write_text("# no URLs\n\n", encoding="utf-8")
+    args = app.create_parser().parse_args([str(input_file)])
+
+    with pytest.raises(app.DownloadError, match="No URLs were found"):
+        app.main(args)
+
+
+def test_execute_passes_parsed_arguments_to_main(monkeypatch):
+    captured = {}
+
+    def fake_main(args):
+        captured["args"] = args
+        return 4
+
+    monkeypatch.setattr(app, "main", fake_main)
+
+    assert app.execute("https://example.test/video", "--quiet") == 4
+    assert captured["args"].input == ["https://example.test/video"]
+    assert captured["args"].quiet is True
+
+
+def test_logger_respects_quiet_mode(capsys):
+    logger = app.YtdlpLogger(quiet=True)
+
+    logger.debug("ordinary message")
+    logger.info("info message")
+    logger.warning("warning message")
+    logger.error("error message")
+
+    output = capsys.readouterr()
+    assert output.out == ""
+    assert output.err == "WARNING: warning message\nERROR: error message\n"
+
+
+def test_cli_reports_download_errors(monkeypatch, capsys):
+    def fail_main():
+        raise app.DownloadError("bad input")
+
+    monkeypatch.setattr(app, "main", fail_main)
+
+    with pytest.raises(SystemExit) as error:
+        app.cli()
+
+    assert error.value.code == 1
+    assert capsys.readouterr().err.endswith("tugyt: bad input\n")

tugyt-0.2.3/tugyt/__init__.py

@@ -0,0 +1,5 @@
+from . import tugyt
+
+
+def execute(*args):
+    return tugyt.execute(*args)

tugyt-0.2.3/tugyt/__main__.py

@@ -0,0 +1,3 @@
+from .tugyt import cli
+
+cli()

tugyt-0.2.3/tugyt/tugyt.py

@@ -0,0 +1,282 @@
+"""Command-line YouTube downloader powered by yt-dlp."""
+
+import argparse
+import logging
+import sys
+from contextlib import nullcontext
+from pathlib import Path
+from typing import Any, Iterable, List, Optional
+
+from rich.progress import (
+    BarColumn,
+    DownloadColumn,
+    Progress,
+    TaskProgressColumn,
+    TextColumn,
+    TimeRemainingColumn,
+    TransferSpeedColumn,
+)
+
+_YT_DLP_IMPORT_ERROR: Optional[ImportError] = None
+
+try:
+    import yt_dlp
+except ImportError as error:  # pragma: no cover
+    yt_dlp = None
+    _YT_DLP_IMPORT_ERROR = error
+
+__version__ = "0.2.3"
+__author__ = "ftnick"
+__license__ = "MIT"
+
+MODULE_NAME = "tugyt"
+DEFAULT_OUTPUT = "%(title)s [%(id)s].%(ext)s"
+logger = logging.getLogger(MODULE_NAME)
+
+
+class DownloadError(Exception):
+    """Raised when yt-dlp cannot complete a requested operation."""
+
+
+class YtdlpLogger:
+    """Bridge yt-dlp messages into the standard logger and CLI output."""
+
+    def __init__(self, quiet: bool = False):
+        self.quiet = quiet
+
+    def debug(self, message: str) -> None:
+        if message.startswith("[debug]"):
+            logger.debug(message)
+        elif not self.quiet:
+            print(message)
+
+    def info(self, message: str) -> None:
+        if not self.quiet:
+            print(message)
+
+    def warning(self, message: str) -> None:
+        print(f"WARNING: {message}", file=sys.stderr)
+
+    def error(self, message: str) -> None:
+        print(f"ERROR: {message}", file=sys.stderr)
+
+
+class DownloadProgress:
+    """Render yt-dlp download events as a single Rich progress display."""
+
+    def __init__(self):
+        self.progress = Progress(
+            TextColumn("[progress.description]{task.description}"),
+            BarColumn(),
+            TaskProgressColumn(),
+            DownloadColumn(),
+            TransferSpeedColumn(),
+            TimeRemainingColumn(),
+        )
+        self.tasks = {}
+
+    def __enter__(self):
+        self.progress.start()
+        return self
+
+    def __exit__(self, exception_type, exception, traceback):
+        self.progress.stop()
+
+    def update(self, status: dict) -> None:
+        if status["status"] == "downloading":
+            filename = Path(status.get("filename", "download")).name
+            task_id = self.tasks.get(filename)
+            total = status.get("total_bytes") or status.get("total_bytes_estimate")
+            if task_id is None:
+                task_id = self.progress.add_task(filename, total=total)
+                self.tasks[filename] = task_id
+            self.progress.update(
+                task_id,
+                total=total,
+                completed=status.get("downloaded_bytes", 0),
+            )
+        elif status["status"] == "finished":
+            filename = Path(status.get("filename", "download")).name
+            task_id = self.tasks.get(filename)
+            if task_id is not None:
+                self.progress.update(task_id, completed=status.get("total_bytes"))
+
+
+def _read_inputs(inputs: Iterable[str]) -> List[str]:
+    """Expand text files into URLs while preserving command-line order."""
+    expanded = []
+    for value in inputs:
+        path = Path(value).expanduser()
+        if path.is_file():
+            with path.open("r", encoding="utf-8") as input_file:
+                expanded.extend(
+                    line.strip() for line in input_file
+                    if line.strip() and not line.lstrip().startswith("#")
+                )
+        else:
+            expanded.append(value)
+    return expanded
+
+
+def _add_optional(options: dict, key: str, value: Any) -> None:
+    if value is not None:
+        options[key] = value
+
+
+def _normalize_subtitle_languages(value: str) -> List[str]:
+    """Convert yt-dlp's CLI all-languages alias to its API regex form."""
+    return [".*" if language == "all" else language for language in value.split(",")]
+
+
+def build_options(args: argparse.Namespace) -> dict:
+    """Translate CLI arguments into yt-dlp options."""
+    options = {
+        "format": args.format,
+        "outtmpl": args.output,
+        "noplaylist": args.no_playlist,
+        "quiet": args.quiet,
+        "no_warnings": args.quiet,
+        "ignoreerrors": args.ignore_errors,
+        "continuedl": not args.no_continue,
+        "retries": args.retries,
+        "fragment_retries": args.retries,
+        "concurrent_fragment_downloads": args.concurrent_fragments,
+        "logger": YtdlpLogger(args.quiet),
+        "writethumbnail": args.write_thumbnail,
+        "writeinfojson": args.write_info_json,
+        "writedescription": args.write_description,
+        "writesubtitles": args.write_subs,
+        "writeautomaticsub": args.write_auto_subs,
+        "embedmetadata": args.embed_metadata,
+        "embedthumbnail": args.embed_thumbnail,
+        "embedsubtitles": args.embed_subs,
+        "listformats": args.list_formats,
+        "dump_single_json": args.dump_json,
+        "skip_download": args.skip_download,
+        "playliststart": args.playlist_start,
+        "playlistend": args.playlist_end,
+        "playlist_items": args.playlist_items,
+        "flat_playlist": args.flat_playlist,
+        "keepvideo": args.keep_video,
+    }
+    _add_optional(options, "proxy", args.proxy)
+    _add_optional(options, "ratelimit", args.rate_limit)
+    _add_optional(options, "download_archive", args.download_archive)
+    _add_optional(options, "subtitleslangs", _normalize_subtitle_languages(args.sub_langs))
+    _add_optional(options, "subtitlesformat", args.sub_format)
+    if args.extract_audio:
+        options["postprocessors"] = [{
+            "key": "FFmpegExtractAudio",
+            "preferredcodec": args.audio_format,
+            "preferredquality": args.audio_quality,
+        }]
+    if args.sponsorblock_remove:
+        options["sponsorblock_remove"] = args.sponsorblock_remove
+    if args.user_agent:
+        options["http_headers"] = {"User-Agent": args.user_agent}
+    if args.verbose:
+        options["verbose"] = True
+    return options
+
+
+def create_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog=MODULE_NAME,
+        description="Download YouTube videos, playlists, channels, and audio with yt-dlp.",
+    )
+    parser.add_argument("input", nargs="+", help="YouTube URLs or text files containing URLs")
+    parser.add_argument("-v", "--version", action="version", version=__version__)
+    parser.add_argument("-q", "--quiet", action="store_true", help="suppress yt-dlp output")
+    parser.add_argument("--verbose", action="store_true", help="show yt-dlp debug output")
+    parser.add_argument("-k", "--keep-video", action="store_true",
+                        help="keep the original downloaded fragments after merging")
+    parser.add_argument("--ignore-errors", action="store_true", help="continue when an item fails")
+    parser.add_argument("--no-continue", action="store_true", help="restart partial downloads")
+    parser.add_argument("-o", "--output", "--output-path", default=DEFAULT_OUTPUT,
+                        help="output template (default: %%(title)s [%%(id)s].%%(ext)s)")
+    parser.add_argument("-f", "--format", default="bv*+ba/b",
+                        help="yt-dlp format selector (default: bv*+ba/b)")
+    parser.add_argument("-x", "--extract-audio", action="store_true", help="extract audio with ffmpeg")
+    parser.add_argument(
+        "--audio-format",
+        choices=("best", "aac", "flac", "mp3", "m4a", "opus", "vorbis", "wav"),
+        default="mp3",
+    )
+    parser.add_argument("--audio-quality", default="192K", help="audio bitrate passed to ffmpeg")
+    parser.add_argument("-F", "--list-formats", action="store_true", help="list available formats without downloading")
+    parser.add_argument("--dump-json", action="store_true", help="print metadata as JSON")
+    parser.add_argument("--skip-download", action="store_true", help="process metadata without downloading media")
+    parser.add_argument("--write-thumbnail", action="store_true", help="save the video thumbnail")
+    parser.add_argument("--write-info-json", action="store_true", help="save metadata beside the media")
+    parser.add_argument("--write-description", action="store_true", help="save the video description")
+    parser.add_argument("--write-subs", action="store_true", help="download manually created subtitles")
+    parser.add_argument("--write-auto-subs", action="store_true", help="download automatic subtitles")
+    parser.add_argument("--sub-langs", default="en.*,ja.*,all", help="subtitle languages")
+    parser.add_argument("--sub-format", default="best", help="subtitle format")
+    parser.add_argument("--embed-metadata", action="store_true", help="embed metadata in the media")
+    parser.add_argument("--embed-thumbnail", action="store_true", help="embed the thumbnail in the media")
+    parser.add_argument("--embed-subs", action="store_true", help="embed downloaded subtitles")
+    parser.add_argument("--no-playlist", action="store_true", help="download only the supplied video")
+    parser.add_argument("--flat-playlist", action="store_true", help="do not resolve playlist entries")
+    parser.add_argument("--playlist-start", type=int, metavar="N", help="playlist item to start at")
+    parser.add_argument("--playlist-end", type=int, metavar="N", help="playlist item to stop at")
+    parser.add_argument("--playlist-items", metavar="ITEMS", help="playlist items, e.g. 1,3,5-7")
+    parser.add_argument("--download-archive", metavar="FILE", help="skip IDs already recorded in FILE")
+    parser.add_argument("--sponsorblock-remove", metavar="CATEGORIES",
+                        help="remove SponsorBlock categories, e.g. sponsor,intro")
+    parser.add_argument("-y", "--proxy", help="HTTP/SOCKS proxy URL")
+    parser.add_argument("--user-agent", help="custom HTTP User-Agent")
+    parser.add_argument("--concurrent-fragments", type=int, default=1, metavar="N",
+                        help="number of fragments to download concurrently")
+    parser.add_argument("--retries", type=int, default=10, metavar="N", help="retry count")
+    parser.add_argument("--rate-limit", type=int, metavar="BYTES",
+                        help="maximum download rate in bytes per second")
+    return parser
+
+
+cmdl_parser = create_parser()
+
+
+def main(args: Optional[argparse.Namespace] = None) -> int:
+    """Download all supplied URLs and return a process exit code."""
+    args = args or cmdl_parser.parse_args()
+    if yt_dlp is None:
+        raise DownloadError("yt-dlp is not installed. Run `python -m pip install yt-dlp`.") from _YT_DLP_IMPORT_ERROR
+    urls = _read_inputs(args.input)
+    if not urls:
+        raise DownloadError("No URLs were found in the supplied input.")
+    yt_dlp_module: Any = yt_dlp
+    try:
+        progress_context = nullcontext() if args.quiet else DownloadProgress()
+        with progress_context as progress:
+            options = build_options(args)
+            if not args.quiet:
+                assert progress is not None
+                options["noprogress"] = True
+                options["progress_hooks"] = [progress.update]
+            with yt_dlp_module.YoutubeDL(options) as downloader:
+                return downloader.download(urls)
+    except yt_dlp_module.utils.DownloadError as error:
+        raise DownloadError(str(error)) from error
+
+
+def execute(*args: str) -> int:
+    """Programmatic entrypoint compatible with the original package."""
+    return main(cmdl_parser.parse_args(list(args)))
+
+
+def cli() -> None:
+    """Console-script entrypoint."""
+    logging.basicConfig(level=logging.DEBUG if "--verbose" in sys.argv else logging.INFO)
+    try:
+        raise SystemExit(main())
+    except KeyboardInterrupt:
+        print("\nInterrupted.", file=sys.stderr)
+        raise SystemExit(130)
+    except DownloadError as error:
+        print(f"tugyt: {error}", file=sys.stderr)
+        raise SystemExit(1)
+
+
+if __name__ == "__main__":
+    cli()

tugyt-0.2.3/tugyt.egg-info/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: tugyt
+Version: 0.2.3
+Summary: A focused YouTube downloader powered by yt-dlp.
+Author: ftnick
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: yt-dlp==2026.8.19
+Requires-Dist: rich==15.0.0
+Dynamic: license-file
+
+<p align="center">
+  <img src="icon.ico" width="160">
+</p>
+<p align="center">
+  <sub>Fetch (icon) by <a href="https://thenounproject.com/browse/icons/term/fetch/" target="_blank" title="highlight Icons">Gregor Cresnar</a> from <a href="https://thenounproject.com/browse/icons/term/fetch/" target="_blank" title="highlight Icons">Noun Project</a> (CC BY 3.0)</sub>
+</p>
+
+<h1 align="center">tugyt</h1>
+
+<p align="center">
+    is a lightweight command-line YouTube downloader powered by <a href="https://github.com/yt-dlp/yt-dlp" target="_blank">yt-dlp</a>, with support for videos, playlists, audio extraction, subtitles, metadata, and download archives.
+</p>
+
+<p align="center">
+  <a href="https://github.com/ftnick/tugyt/actions/workflows/python-package.yml"><img src="https://github.com/ftnick/tugyt/actions/workflows/python-package.yml/badge.svg" alt="CI"></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/ftnick/tugyt/blob/main/LICENSE"><img src="https://img.shields.io/github/license/ftnick/tugyt" alt="License"></a>
+  <a href="https://github.com/ftnick/tugyt/commits/main"><img src="https://img.shields.io/github/last-commit/ftnick/tugyt" alt="Last commit"></a>
+</p>

tugyt-0.2.3/tugyt.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+tests/test_tugyt.py
+tugyt/__init__.py
+tugyt/__main__.py
+tugyt/tugyt.py
+tugyt.egg-info/PKG-INFO
+tugyt.egg-info/SOURCES.txt
+tugyt.egg-info/dependency_links.txt
+tugyt.egg-info/entry_points.txt
+tugyt.egg-info/requires.txt
+tugyt.egg-info/top_level.txt

tugyt-0.2.3/tugyt.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

tugyt-0.2.3/tugyt.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tugyt = tugyt.tugyt:cli

tugyt-0.2.3/tugyt.egg-info/requires.txt

@@ -0,0 +1,2 @@
+yt-dlp==2026.8.19
+rich==15.0.0

tugyt-0.2.3/tugyt.egg-info/top_level.txt

@@ -0,0 +1 @@
+tugyt