yt-dlp-utils 0.0.3__tar.gz → 0.0.5__tar.gz

{yt_dlp_utils-0.0.3 → yt_dlp_utils-0.0.5}/PKG-INFO

@@ -1,15 +1,14 @@
 Metadata-Version: 2.3
 Name: yt-dlp-utils
-Version: 0.0.3
+Version: 0.0.5
 Summary: Utilities for programmatic use of yt-dlp.
 License: MIT
 Keywords: command line,yt-dlp
 Author: Andrew Udvare
 Author-email: audvare@gmail.com
 Requires-Python: >=3.10,<3.14
-Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -17,8 +16,8 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Typing :: Typed
 Requires-Dist: requests (>=2.32.3,<3.0.0)
-Requires-Dist: typing-extensions (>=4.13.1,<5.0.0)
-Requires-Dist: yt-dlp[default] (>=2025.3.31,<2026.0.0)
+Requires-Dist: typing-extensions (>=4.14.0,<5.0.0)
+Requires-Dist: yt-dlp[default] (>=2025.5.22,<2026.0.0)
 Project-URL: Documentation, https://yt-dlp-utils.readthedocs.org
 Project-URL: Homepage, https://tatsh.github.io/yt-dlp-utils/
 Project-URL: Issues, https://github.com/Tatsh/yt-dlp-utils/issues
@@ -31,7 +30,7 @@ Description-Content-Type: text/markdown
 [![PyPI - Version](https://img.shields.io/pypi/v/yt-dlp-utils)](https://pypi.org/project/yt-dlp-utils/)
 [![GitHub tag (with filter)](https://img.shields.io/github/v/tag/Tatsh/yt-dlp-utils)](https://github.com/Tatsh/yt-dlp-utils/tags)
 [![License](https://img.shields.io/github/license/Tatsh/yt-dlp-utils)](https://github.com/Tatsh/yt-dlp-utils/blob/master/LICENSE.txt)
-[![GitHub commits since latest release (by SemVer including pre-releases)](https://img.shields.io/github/commits-since/Tatsh/yt-dlp-utils/v0.0.3/master)](https://github.com/Tatsh/yt-dlp-utils/compare/v0.0.3...master)
+[![GitHub commits since latest release (by SemVer including pre-releases)](https://img.shields.io/github/commits-since/Tatsh/yt-dlp-utils/v0.0.5/master)](https://github.com/Tatsh/yt-dlp-utils/compare/v0.0.5...master)
 [![QA](https://github.com/Tatsh/yt-dlp-utils/actions/workflows/qa.yml/badge.svg)](https://github.com/Tatsh/yt-dlp-utils/actions/workflows/qa.yml)
 [![Tests](https://github.com/Tatsh/yt-dlp-utils/actions/workflows/tests.yml/badge.svg)](https://github.com/Tatsh/yt-dlp-utils/actions/workflows/tests.yml)
 [![Coverage Status](https://coveralls.io/repos/github/Tatsh/yt-dlp-utils/badge.svg?branch=master)](https://coveralls.io/github/Tatsh/yt-dlp-utils?branch=master)

{yt_dlp_utils-0.0.3 → yt_dlp_utils-0.0.5}/README.md

@@ -4,7 +4,7 @@
 [![PyPI - Version](https://img.shields.io/pypi/v/yt-dlp-utils)](https://pypi.org/project/yt-dlp-utils/)
 [![GitHub tag (with filter)](https://img.shields.io/github/v/tag/Tatsh/yt-dlp-utils)](https://github.com/Tatsh/yt-dlp-utils/tags)
 [![License](https://img.shields.io/github/license/Tatsh/yt-dlp-utils)](https://github.com/Tatsh/yt-dlp-utils/blob/master/LICENSE.txt)
-[![GitHub commits since latest release (by SemVer including pre-releases)](https://img.shields.io/github/commits-since/Tatsh/yt-dlp-utils/v0.0.3/master)](https://github.com/Tatsh/yt-dlp-utils/compare/v0.0.3...master)
+[![GitHub commits since latest release (by SemVer including pre-releases)](https://img.shields.io/github/commits-since/Tatsh/yt-dlp-utils/v0.0.5/master)](https://github.com/Tatsh/yt-dlp-utils/compare/v0.0.5...master)
 [![QA](https://github.com/Tatsh/yt-dlp-utils/actions/workflows/qa.yml/badge.svg)](https://github.com/Tatsh/yt-dlp-utils/actions/workflows/qa.yml)
 [![Tests](https://github.com/Tatsh/yt-dlp-utils/actions/workflows/tests.yml/badge.svg)](https://github.com/Tatsh/yt-dlp-utils/actions/workflows/tests.yml)
 [![Coverage Status](https://coveralls.io/repos/github/Tatsh/yt-dlp-utils/badge.svg?branch=master)](https://coveralls.io/github/Tatsh/yt-dlp-utils?branch=master)

{yt_dlp_utils-0.0.3 → yt_dlp_utils-0.0.5}/pyproject.toml

@@ -4,9 +4,8 @@ requires = ["poetry-core"]
 
 [project]
 classifiers = [
-  "Development Status :: 2 - Pre-Alpha",
+  "Development Status :: 4 - Beta",
   "Intended Audience :: Developers",
-  "License :: OSI Approved :: MIT License",
   "Programming Language :: Python",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
@@ -20,7 +19,7 @@ keywords = ["command line", "yt-dlp"]
 license = "MIT"
 name = "yt-dlp-utils"
 readme = "README.md"
-version = "0.0.3"
+version = "0.0.5"
 
 [[project.authors]]
 email = "audvare@gmail.com"
@@ -34,21 +33,18 @@ documentation = "https://yt-dlp-utils.readthedocs.org"
 homepage = "https://tatsh.github.io/yt-dlp-utils/"
 repository = "https://github.com/Tatsh/yt-dlp-utils"
 
-[tool]
-
 [tool.commitizen]
 tag_format = "v$version"
 version_files = [
   ".wiswa.jsonnet",
   "CITATION.cff",
   "README.md",
+  "docs/index.rst",
   "package.json",
   "yt_dlp_utils/__init__.py",
 ]
 version_provider = "pep621"
 
-[tool.coverage]
-
 [tool.coverage.report]
 exclude_also = ["if TYPE_CHECKING:"]
 omit = ["conftest.py", "tests.py", "tests/test_*.py"]
@@ -79,30 +75,26 @@ strict = true
 strict_optional = true
 warn_unreachable = true
 
-[tool.poetry]
-
 [tool.poetry.dependencies]
 python = ">=3.10,<3.14"
 requests = "^2.32.3"
-typing-extensions = "^4.13.1"
+typing-extensions = "^4.14.0"
 
 [tool.poetry.dependencies.yt-dlp]
 extras = ["default"]
-version = "^2025.3.31"
-
-[tool.poetry.group]
+version = "^2025.5.22"
 
 [tool.poetry.group.dev]
 optional = true
 
 [tool.poetry.group.dev.dependencies]
-commitizen = "^4.5.0"
+commitizen = "^4.8.2"
 djlint = "^1.36.4"
-mypy = ">=1.12,<1.16"
-ruff = "^0.11.7"
-types-requests = "^2.32.0.20250328"
+mypy = "^1.16.0"
+ruff = "^0.11.13"
+types-requests = "^2.32.0.20250602"
 yapf = "^0.43.0"
-yt-dlp-types = "^0"
+yt-dlp-types = "^0.0.17"
 
 [tool.poetry.group.docs]
 optional = true
@@ -114,28 +106,31 @@ docutils = "^0.21.2"
 esbonio = "^0.16.5"
 numpydoc = "^1.8.0"
 restructuredtext-lint = "^1.4.0"
-sphinx = "<8.2.0"
 sphinx-click = "^6.0.0"
 sphinx-datatables = "^0.2.1"
 sphinx-hoverxref = "^1.4.2"
-sphinx-immaterial = "^0.13.4"
+sphinx-immaterial = "^0.13.5"
 
 [tool.poetry.group.docs.dependencies.enum-tools]
 extras = ["sphinx"]
-version = "^0.12.0"
+version = "^0.13.0"
 
-[tool.poetry.group.docs.dependencies.erdantic]
-optional = true
-version = "<2.0"
+[[tool.poetry.group.docs.dependencies.sphinx]]
+python = ">=3.11"
+version = "^8.2.0"
+
+[[tool.poetry.group.docs.dependencies.sphinx]]
+python = "<3.11"
+version = "^7.2.5"
 
 [tool.poetry.group.tests]
 optional = true
 
 [tool.poetry.group.tests.dependencies]
 mock = "^5.2.0"
-pytest = "^8.3.5"
+pytest = "^8.4.0"
 pytest-cov = "^6.1.1"
-pytest-mock = "^3.14.0"
+pytest-mock = "^3.14.1"
 
 [tool.poetry.group.tests.dependencies.coveralls]
 python = "<3.13"
@@ -160,8 +155,6 @@ reportUnnecessaryTypeIgnoreComment = "none"
 typeCheckingMode = "off"
 useLibraryCodeForTypes = false
 
-[tool.pytest]
-
 [tool.pytest.ini_options]
 mock_use_standalone_module = true
 norecursedirs = ["node_modules"]
@@ -191,6 +184,7 @@ extend-select = [
   "CPY",
   "D",
   "DJ",
+  "DOC",
   "DTZ",
   "E",
   "EM",
@@ -198,6 +192,7 @@ extend-select = [
   "EXE",
   "F",
   "FA",
+  "FAST",
   "FBT",
   "FIX",
   "FLY",
@@ -229,11 +224,12 @@ extend-select = [
   "SLOT",
   "T10",
   "T20",
-  "TCH",
+  "TC",
   "TD",
   "TID",
   "TRY",
   "UP",
+  "W",
   "YTT",
 ]
 ignore = [
@@ -245,17 +241,11 @@ ignore = [
   "C901",
   "COM812",
   "CPY001",
-  "D100",
-  "D101",
-  "D102",
-  "D103",
-  "D104",
-  "D105",
-  "D106",
-  "D107",
+  "D201",
   "D203",
   "D204",
   "D212",
+  "DOC201",
   "EM101",
   "N818",
   "PLR0912",

{yt_dlp_utils-0.0.3 → yt_dlp_utils-0.0.5}/yt_dlp_utils/__init__.py

@@ -4,4 +4,4 @@ from __future__ import annotations
 from .lib import YoutubeDLLogger, get_configured_yt_dlp, setup_session
 
 __all__ = ('YoutubeDLLogger', 'get_configured_yt_dlp', 'setup_session')
-__version__ = '0.0.3'
+__version__ = '0.0.5'

{yt_dlp_utils-0.0.3 → yt_dlp_utils-0.0.5}/yt_dlp_utils/constants.py

@@ -1,3 +1,4 @@
+"""Constants."""
 from __future__ import annotations
 
 __all__ = ('DEFAULT_RETRY_BACKOFF_FACTOR', 'DEFAULT_RETRY_STATUS_FORCELIST', 'SHARED_HEADERS',

{yt_dlp_utils-0.0.3 → yt_dlp_utils-0.0.5}/yt_dlp_utils/lib.py

@@ -1,12 +1,13 @@
 """Utilities."""
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING
 import logging
 import re
 import sys
 
 from requests.adapters import HTTPAdapter
+from typing_extensions import Unpack
 from urllib3 import Retry
 from yt_dlp.cookies import extract_cookies_from_browser
 import requests
@@ -34,11 +35,7 @@ class YoutubeDLLogger(yt_dlp.cookies.YDLLogger):
         """Log an info message."""
         log.info('%s', re.sub(r'^\[info\]\s+', '', message))
 
-    def warning(
-            self,
-            message: str,
-            once: bool = False,  # noqa: FBT001, FBT002
-            only_once: bool = False) -> None:  # noqa: FBT001, FBT002
+    def warning(self, message: str, *, only_once: bool = False) -> None:  # type: ignore[override]
         """Log a warning message."""
         log.warning('%s', re.sub(r'^\[warn(?:ing)?\]\s+', '', message))
 
@@ -48,23 +45,24 @@ class YoutubeDLLogger(yt_dlp.cookies.YDLLogger):
 
 
 def get_configured_yt_dlp(sleep_time: int = 3,
-                          logger: Any = None,
                           *,
-                          debug: bool = False) -> yt_dlp.YoutubeDL:
+                          debug: bool = False,
+                          **kwargs: Unpack[yt_dlp._Params]) -> yt_dlp.YoutubeDL:
     """
     Get a configured ``YoutubeDL`` instance.
 
     This function sets up a ``yt_dlp.YoutubeDL`` instance with the user's configuration (e.g.
-    located at ``~/.config/yt-dlp/config``). It overrides the default logger, disables colours, and
-    sets the sleep time between requests. It also sets the verbose flag based on the ``debug``
+    located at ``~/.config/yt-dlp/config``). It overrides the default logger (``logger`` option),
+    disables colours (``color`` option), and sets the sleep time between requests
+    (``sleep_interval_requests`` option). It also sets the ``verbose`` flag based on the ``debug``
     parameter.
 
+    All other keyword arguments are passed directly to the ``yt_dlp.YoutubeDL`` constructor.
+
     Parameters
     ----------
     sleep_time : int
         The time to sleep between requests, in seconds. Default is 3 seconds.
-    logger : Any
-        The logger to use. See :py:class:`YoutubeDLLogger` for details.
     debug : bool
         Whether to enable debug mode. Default is False.
 
@@ -77,11 +75,11 @@ def get_configured_yt_dlp(sleep_time: int = 3,
     sys.argv = [sys.argv[0]]
     ydl_opts = yt_dlp.parse_options()[-1]
     ydl_opts['color'] = {'stdout': 'never', 'stderr': 'never'}
-    ydl_opts['logger'] = logger or YoutubeDLLogger()
+    ydl_opts['logger'] = kwargs.pop('logger', YoutubeDLLogger())
     ydl_opts['sleep_interval_requests'] = sleep_time
     ydl_opts['verbose'] = debug
     sys.argv = old_sys_argv
-    return yt_dlp.YoutubeDL(ydl_opts)
+    return yt_dlp.YoutubeDL(ydl_opts | kwargs)
 
 
 def setup_session(browser: str,