mirror of
https://github.com/yt-dlp/yt-dlp.git
synced 2026-04-07 17:33:41 +00:00
5f6a214616
* Add `pin`, `pin-curl-cffi`, `pin-secretstorage` and `pin-deno` extras * Check in a `uv.lock` for devs * Add `devscripts/update_requirements.py` for dependency upgrades Authored by: bashonly, Grub4K Co-authored-by: Simon Sawicki <contact@grub4k.dev>
475 lines
16 KiB
TOML
475 lines
16 KiB
TOML
[build-system]
|
|
requires = ["hatchling>=1.27.0"]
|
|
build-backend = "hatchling.build"
|
|
|
|
[project]
|
|
name = "yt-dlp"
|
|
authors = [
|
|
{name = "pukkandan", email = "pukkandan.ytdlp@gmail.com"},
|
|
]
|
|
maintainers = [
|
|
{email = "maintainers@yt-dlp.org"},
|
|
{name = "Grub4K", email = "contact@grub4k.dev"},
|
|
{name = "bashonly", email = "bashonly@protonmail.com"},
|
|
{name = "coletdjnz", email = "coletdjnz@protonmail.com"},
|
|
]
|
|
description = "A feature-rich command-line audio/video downloader"
|
|
readme = "README.md"
|
|
requires-python = ">=3.10"
|
|
keywords = [
|
|
"cli",
|
|
"downloader",
|
|
"youtube-dl",
|
|
"youtube-downloader",
|
|
"sponsorblock",
|
|
"yt-dlp",
|
|
]
|
|
license = "Unlicense"
|
|
license-files = ["LICENSE"]
|
|
classifiers = [
|
|
"Topic :: Multimedia :: Video",
|
|
"Development Status :: 5 - Production/Stable",
|
|
"Environment :: Console",
|
|
"Programming Language :: Python",
|
|
"Programming Language :: Python :: 3 :: Only",
|
|
"Programming Language :: Python :: 3.10",
|
|
"Programming Language :: Python :: 3.11",
|
|
"Programming Language :: Python :: 3.12",
|
|
"Programming Language :: Python :: 3.13",
|
|
"Programming Language :: Python :: 3.14",
|
|
"Programming Language :: Python :: Implementation",
|
|
"Programming Language :: Python :: Implementation :: CPython",
|
|
"Programming Language :: Python :: Implementation :: PyPy",
|
|
"Operating System :: OS Independent",
|
|
]
|
|
dynamic = ["version"]
|
|
dependencies = []
|
|
|
|
[project.optional-dependencies]
|
|
default = [
|
|
"brotli ; implementation_name == 'cpython' and sys_platform != 'ios'",
|
|
"brotlicffi ; implementation_name != 'cpython'",
|
|
"certifi",
|
|
"mutagen",
|
|
"pycryptodomex",
|
|
"requests>=2.32.2,<3",
|
|
"urllib3>=2.0.2,<3",
|
|
"websockets>=13.0",
|
|
"yt-dlp-ejs==0.8.0",
|
|
]
|
|
curl-cffi = [
|
|
"curl-cffi>=0.5.10,!=0.6.*,!=0.7.*,!=0.8.*,!=0.9.*,<0.16 ; implementation_name == 'cpython'",
|
|
]
|
|
secretstorage = [
|
|
"secretstorage",
|
|
]
|
|
deno = [
|
|
"deno>=2.6.6",
|
|
]
|
|
pin = [
|
|
"brotli==1.2.0 ; implementation_name == 'cpython' and sys_platform != 'ios'",
|
|
"brotlicffi==1.2.0.1 ; implementation_name != 'cpython'",
|
|
"certifi @ https://files.pythonhosted.org/packages/9a/3c/c17fb3ca2d9c3acff52e30b309f538586f9f5b9c9cf454f3845fc9af4881/certifi-2026.2.25-py3-none-any.whl#sha256=027692e4402ad994f1c42e52a4997a9763c646b73e4096e4d5d6db8af1d6f0fa",
|
|
"cffi==2.0.0 ; implementation_name != 'cpython'",
|
|
"charset-normalizer==3.4.6",
|
|
"idna @ https://files.pythonhosted.org/packages/0e/61/66938bbb5fc52dbdf84594873d5b51fb1f7c7794e9c0f5bd885f30bc507b/idna-3.11-py3-none-any.whl#sha256=771a87f49d9defaf64091e6e6fe9c18d4833f140bd19464795bc32d966ca37ea",
|
|
"mutagen @ https://files.pythonhosted.org/packages/b0/7a/620f945b96be1f6ee357d211d5bf74ab1b7fe72a9f1525aafbfe3aee6875/mutagen-1.47.0-py3-none-any.whl#sha256=edd96f50c5907a9539d8e5bba7245f62c9f520aef333d13392a79a4f70aca719",
|
|
"pycparser @ https://files.pythonhosted.org/packages/0c/c3/44f3fbbfa403ea2a7c779186dc20772604442dde72947e7d01069cbe98e3/pycparser-3.0-py3-none-any.whl#sha256=b727414169a36b7d524c1c3e31839a521725078d7b2ff038656844266160a992 ; implementation_name != 'PyPy' and implementation_name != 'cpython'",
|
|
"pycryptodomex==3.23.0",
|
|
"requests @ https://files.pythonhosted.org/packages/56/5d/c814546c2333ceea4ba42262d8c4d55763003e767fa169adc693bd524478/requests-2.33.0-py3-none-any.whl#sha256=3324635456fa185245e24865e810cecec7b4caf933d7eb133dcde67d48cee69b",
|
|
"urllib3 @ https://files.pythonhosted.org/packages/39/08/aaaad47bc4e9dc8c725e68f9d04865dbcb2052843ff09c97b08904852d84/urllib3-2.6.3-py3-none-any.whl#sha256=bf272323e553dfb2e87d9bfd225ca7b0f467b919d7bbd355436d3fd37cb0acd4",
|
|
"websockets==16.0",
|
|
"yt-dlp-ejs @ https://files.pythonhosted.org/packages/e3/bd/520769863744b669440a924271a6159ddd82ad5ae26b4ac4d4b69e9f8d44/yt_dlp_ejs-0.8.0-py3-none-any.whl#sha256=79300e5fca7f937a1eeede11f0456862c1b41107ce1d726871e0207424f4bdb4",
|
|
]
|
|
pin-curl-cffi = [
|
|
"certifi @ https://files.pythonhosted.org/packages/9a/3c/c17fb3ca2d9c3acff52e30b309f538586f9f5b9c9cf454f3845fc9af4881/certifi-2026.2.25-py3-none-any.whl#sha256=027692e4402ad994f1c42e52a4997a9763c646b73e4096e4d5d6db8af1d6f0fa ; implementation_name == 'cpython'",
|
|
"cffi==2.0.0 ; implementation_name == 'cpython'",
|
|
"curl-cffi==0.15.0 ; implementation_name == 'cpython'",
|
|
"markdown-it-py @ https://files.pythonhosted.org/packages/94/54/e7d793b573f298e1c9013b8c4dade17d481164aa517d1d7148619c2cedbf/markdown_it_py-4.0.0-py3-none-any.whl#sha256=87327c59b172c5011896038353a81343b6754500a08cd7a4973bb48c6d578147 ; implementation_name == 'cpython'",
|
|
"mdurl @ https://files.pythonhosted.org/packages/b3/38/89ba8ad64ae25be8de66a6d463314cf1eb366222074cfda9ee839c56a4b4/mdurl-0.1.2-py3-none-any.whl#sha256=84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8 ; implementation_name == 'cpython'",
|
|
"pycparser @ https://files.pythonhosted.org/packages/0c/c3/44f3fbbfa403ea2a7c779186dc20772604442dde72947e7d01069cbe98e3/pycparser-3.0-py3-none-any.whl#sha256=b727414169a36b7d524c1c3e31839a521725078d7b2ff038656844266160a992 ; implementation_name == 'cpython'",
|
|
"pygments @ https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl#sha256=86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b ; implementation_name == 'cpython'",
|
|
"rich @ https://files.pythonhosted.org/packages/14/25/b208c5683343959b670dc001595f2f3737e051da617f66c31f7c4fa93abc/rich-14.3.3-py3-none-any.whl#sha256=793431c1f8619afa7d3b52b2cdec859562b950ea0d4b6b505397612db8d5362d ; implementation_name == 'cpython'",
|
|
]
|
|
pin-secretstorage = [
|
|
"cffi==2.0.0 ; platform_python_implementation != 'PyPy'",
|
|
"cryptography==46.0.6",
|
|
"jeepney @ https://files.pythonhosted.org/packages/b2/a3/e137168c9c44d18eff0376253da9f1e9234d0239e0ee230d2fee6cea8e55/jeepney-0.9.0-py3-none-any.whl#sha256=97e5714520c16fc0a45695e5365a2e11b81ea79bba796e26f9f1d178cb182683",
|
|
"pycparser @ https://files.pythonhosted.org/packages/0c/c3/44f3fbbfa403ea2a7c779186dc20772604442dde72947e7d01069cbe98e3/pycparser-3.0-py3-none-any.whl#sha256=b727414169a36b7d524c1c3e31839a521725078d7b2ff038656844266160a992 ; implementation_name != 'PyPy' and platform_python_implementation != 'PyPy'",
|
|
"secretstorage @ https://files.pythonhosted.org/packages/b7/46/f5af3402b579fd5e11573ce652019a67074317e18c1935cc0b4ba9b35552/secretstorage-3.5.0-py3-none-any.whl#sha256=0ce65888c0725fcb2c5bc0fdb8e5438eece02c523557ea40ce0703c266248137",
|
|
"typing-extensions @ https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl#sha256=f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548 ; python_full_version < '3.11'",
|
|
]
|
|
pin-deno = [
|
|
"deno==2.7.8",
|
|
]
|
|
|
|
[dependency-groups]
|
|
build = [
|
|
"build",
|
|
"hatchling>=1.27.0",
|
|
]
|
|
static-analysis = [
|
|
"autopep8~=2.0",
|
|
"ruff~=0.15.0",
|
|
]
|
|
test = [
|
|
"pytest~=8.1",
|
|
"pytest-rerunfailures~=14.0",
|
|
]
|
|
dev = [
|
|
"pre-commit",
|
|
{include-group = "static-analysis"},
|
|
{include-group = "test"},
|
|
]
|
|
pyinstaller = [
|
|
"pyinstaller>=6.17.0",
|
|
]
|
|
delocate = [
|
|
"delocate>=0.13.0 ; sys_platform == 'darwin'",
|
|
]
|
|
|
|
[project.urls]
|
|
Documentation = "https://github.com/yt-dlp/yt-dlp#readme"
|
|
Repository = "https://github.com/yt-dlp/yt-dlp"
|
|
Tracker = "https://github.com/yt-dlp/yt-dlp/issues"
|
|
Funding = "https://github.com/yt-dlp/yt-dlp/blob/master/Maintainers.md#maintainers"
|
|
|
|
[project.scripts]
|
|
yt-dlp = "yt_dlp:main"
|
|
|
|
[project.entry-points.pyinstaller40]
|
|
hook-dirs = "yt_dlp.__pyinstaller:get_hook_dirs"
|
|
|
|
[tool.hatch.build.targets.sdist]
|
|
include = [
|
|
"/yt_dlp",
|
|
"/devscripts",
|
|
"/test",
|
|
"/.gitignore", # included by default, needed for auto-excludes
|
|
"/Changelog.md",
|
|
"/LICENSE", # included as license
|
|
"/pyproject.toml", # included by default
|
|
"/README.md", # included as readme
|
|
"/supportedsites.md",
|
|
]
|
|
artifacts = [
|
|
"/yt_dlp/extractor/lazy_extractors.py",
|
|
"/completions",
|
|
"/AUTHORS", # included by default
|
|
"/README.txt",
|
|
"/yt-dlp.1",
|
|
]
|
|
|
|
[tool.hatch.build.targets.wheel]
|
|
packages = ["yt_dlp"]
|
|
artifacts = [
|
|
"/yt_dlp/extractor/lazy_extractors.py",
|
|
]
|
|
exclude = [
|
|
"/yt_dlp/**/*.md",
|
|
]
|
|
|
|
[tool.hatch.build.targets.wheel.shared-data]
|
|
"completions/bash/yt-dlp" = "share/bash-completion/completions/yt-dlp"
|
|
"completions/zsh/_yt-dlp" = "share/zsh/site-functions/_yt-dlp"
|
|
"completions/fish/yt-dlp.fish" = "share/fish/vendor_completions.d/yt-dlp.fish"
|
|
"README.txt" = "share/doc/yt_dlp/README.txt"
|
|
"yt-dlp.1" = "share/man/man1/yt-dlp.1"
|
|
|
|
[tool.hatch.version]
|
|
path = "yt_dlp/version.py"
|
|
pattern = "_pkg_version = '(?P<version>[^']+)'"
|
|
|
|
[tool.hatch.metadata]
|
|
allow-direct-references = true
|
|
|
|
[tool.hatch.envs.default]
|
|
features = [
|
|
"curl-cffi",
|
|
"default",
|
|
]
|
|
dependencies = [
|
|
"pre-commit",
|
|
]
|
|
path = ".venv"
|
|
installer = "uv"
|
|
|
|
[tool.hatch.envs.default.scripts]
|
|
setup = "pre-commit install --config .pre-commit-hatch.yaml"
|
|
yt-dlp = "python -Werror -Xdev -m yt_dlp {args}"
|
|
|
|
[tool.hatch.envs.hatch-uv]
|
|
dependencies = [
|
|
"uv>=0.10",
|
|
]
|
|
|
|
[tool.hatch.envs.hatch-static-analysis]
|
|
detached = true
|
|
dependency-groups = [
|
|
"static-analysis",
|
|
]
|
|
dependencies = [] # override hatch ruff version
|
|
config-path = "pyproject.toml"
|
|
|
|
[tool.hatch.envs.hatch-static-analysis.scripts]
|
|
format-check = "autopep8 --diff {args:.}"
|
|
format-fix = "autopep8 --in-place {args:.}"
|
|
lint-check = "ruff check {args:.}"
|
|
lint-fix = "ruff check --fix {args:.}"
|
|
|
|
[tool.hatch.envs.hatch-test]
|
|
features = [
|
|
"curl-cffi",
|
|
"default",
|
|
]
|
|
dependency-groups = [
|
|
"test",
|
|
]
|
|
dependencies = [
|
|
"pytest-randomly~=3.15",
|
|
"pytest-xdist[psutil]~=3.5",
|
|
]
|
|
|
|
[tool.hatch.envs.hatch-test.scripts]
|
|
run = "python -m devscripts.run_tests {args}"
|
|
run-cov = "echo Code coverage not implemented && exit 1"
|
|
|
|
[[tool.hatch.envs.hatch-test.matrix]]
|
|
python = [
|
|
"3.10",
|
|
"3.11",
|
|
"3.12",
|
|
"3.13",
|
|
"3.14",
|
|
"pypy3.11",
|
|
]
|
|
|
|
[tool.uv]
|
|
exclude-newer = "7 days"
|
|
|
|
[tool.uv.exclude-newer-package]
|
|
protobug = false
|
|
yt-dlp-ejs = false
|
|
|
|
[tool.ruff]
|
|
line-length = 120
|
|
|
|
[tool.ruff.lint]
|
|
ignore = [
|
|
"E402", # module-import-not-at-top-of-file
|
|
"E501", # line-too-long
|
|
"E731", # lambda-assignment
|
|
"E741", # ambiguous-variable-name
|
|
"UP031", # printf-string-formatting
|
|
"UP036", # outdated-version-block
|
|
"B006", # mutable-argument-default
|
|
"B008", # function-call-in-default-argument
|
|
"B011", # assert-false
|
|
"B017", # assert-raises-exception
|
|
"B023", # function-uses-loop-variable (false positives)
|
|
"B028", # no-explicit-stacklevel
|
|
"B904", # raise-without-from-inside-except
|
|
"A005", # stdlib-module-shadowing
|
|
"C401", # unnecessary-generator-set
|
|
"C402", # unnecessary-generator-dict
|
|
"PIE790", # unnecessary-placeholder
|
|
"SIM102", # collapsible-if
|
|
"SIM108", # if-else-block-instead-of-if-exp
|
|
"SIM112", # uncapitalized-environment-variables
|
|
"SIM113", # enumerate-for-loop
|
|
"SIM114", # if-with-same-arms
|
|
"SIM115", # open-file-with-context-handler
|
|
"SIM117", # multiple-with-statements
|
|
"SIM223", # expr-and-false
|
|
"SIM300", # yoda-conditions
|
|
"TD001", # invalid-todo-tag
|
|
"TD002", # missing-todo-author
|
|
"TD003", # missing-todo-link
|
|
"PLC0415", # import-outside-top-level
|
|
"PLE0604", # invalid-all-object (false positives)
|
|
"PLE0643", # potential-index-error (false positives)
|
|
"PLW0603", # global-statement
|
|
"PLW1510", # subprocess-run-without-check
|
|
"PLW1641", # eq-without-hash
|
|
"PLW2901", # redefined-loop-name
|
|
"RUF001", # ambiguous-unicode-character-string
|
|
"RUF012", # mutable-class-default
|
|
"RUF100", # unused-noqa (flake8 has slightly different behavior)
|
|
]
|
|
select = [
|
|
"E", # pycodestyle Error
|
|
"W", # pycodestyle Warning
|
|
"F", # Pyflakes
|
|
"I", # isort
|
|
"Q", # flake8-quotes
|
|
"N803", # invalid-argument-name
|
|
"N804", # invalid-first-argument-name-for-class-method
|
|
"UP", # pyupgrade
|
|
"B", # flake8-bugbear
|
|
"A", # flake8-builtins
|
|
"COM", # flake8-commas
|
|
"C4", # flake8-comprehensions
|
|
"FA", # flake8-future-annotations
|
|
"ISC", # flake8-implicit-str-concat
|
|
"ICN003", # banned-import-from
|
|
"PIE", # flake8-pie
|
|
"T20", # flake8-print
|
|
"RSE", # flake8-raise
|
|
"RET504", # unnecessary-assign
|
|
"SIM", # flake8-simplify
|
|
"TID251", # banned-api
|
|
"TD", # flake8-todos
|
|
"PLC", # Pylint Convention
|
|
"PLE", # Pylint Error
|
|
"PLW", # Pylint Warning
|
|
"RUF", # Ruff-specific rules
|
|
]
|
|
|
|
[tool.ruff.lint.per-file-ignores]
|
|
"devscripts/lazy_load_template.py" = [
|
|
"F401", # unused-import
|
|
]
|
|
"!yt_dlp/extractor/**.py" = [
|
|
"I", # isort
|
|
"ICN003", # banned-import-from
|
|
"T20", # flake8-print
|
|
"A002", # builtin-argument-shadowing
|
|
"C408", # unnecessary-collection-call
|
|
]
|
|
|
|
[tool.ruff.lint.isort]
|
|
known-first-party = [
|
|
"bundle",
|
|
"devscripts",
|
|
"test",
|
|
]
|
|
relative-imports-order = "closest-to-furthest"
|
|
|
|
[tool.ruff.lint.flake8-quotes]
|
|
docstring-quotes = "double"
|
|
multiline-quotes = "single"
|
|
inline-quotes = "single"
|
|
avoid-escape = false
|
|
|
|
[tool.ruff.lint.pep8-naming]
|
|
classmethod-decorators = [
|
|
"yt_dlp.utils.classproperty",
|
|
]
|
|
|
|
[tool.ruff.lint.flake8-import-conventions]
|
|
banned-from = [
|
|
"base64",
|
|
"datetime",
|
|
"functools",
|
|
"glob",
|
|
"hashlib",
|
|
"itertools",
|
|
"json",
|
|
"math",
|
|
"os",
|
|
"pathlib",
|
|
"random",
|
|
"re",
|
|
"string",
|
|
"sys",
|
|
"time",
|
|
"urllib.parse",
|
|
"uuid",
|
|
"xml",
|
|
]
|
|
|
|
[tool.ruff.lint.flake8-tidy-imports.banned-api]
|
|
"yt_dlp.compat.compat_str".msg = "Use `str` instead."
|
|
"yt_dlp.compat.compat_b64decode".msg = "Use `base64.b64decode` instead."
|
|
"yt_dlp.compat.compat_urlparse".msg = "Use `urllib.parse` instead."
|
|
"yt_dlp.compat.compat_parse_qs".msg = "Use `urllib.parse.parse_qs` instead."
|
|
"yt_dlp.compat.compat_urllib_parse_unquote".msg = "Use `urllib.parse.unquote` instead."
|
|
"yt_dlp.compat.compat_urllib_parse_urlencode".msg = "Use `urllib.parse.urlencode` instead."
|
|
"yt_dlp.compat.compat_urllib_parse_urlparse".msg = "Use `urllib.parse.urlparse` instead."
|
|
"yt_dlp.compat.compat_shlex_quote".msg = "Use `yt_dlp.utils.shell_quote` instead."
|
|
"yt_dlp.utils.error_to_compat_str".msg = "Use `str` instead."
|
|
"yt_dlp.utils.bytes_to_intlist".msg = "Use `list` instead."
|
|
"yt_dlp.utils.intlist_to_bytes".msg = "Use `bytes` instead."
|
|
"yt_dlp.utils.jwt_encode_hs256".msg = "Use `yt_dlp.utils.jwt_encode` instead."
|
|
"yt_dlp.utils.decodeArgument".msg = "Do not use"
|
|
"yt_dlp.utils.decodeFilename".msg = "Do not use"
|
|
"yt_dlp.utils.encodeFilename".msg = "Do not use"
|
|
"yt_dlp.compat.compat_os_name".msg = "Use `os.name` instead."
|
|
"yt_dlp.compat.compat_realpath".msg = "Use `os.path.realpath` instead."
|
|
"yt_dlp.compat.functools".msg = "Use `functools` instead."
|
|
"yt_dlp.utils.decodeOption".msg = "Do not use"
|
|
"yt_dlp.utils.compiled_regex_type".msg = "Use `re.Pattern` instead."
|
|
|
|
[tool.autopep8]
|
|
max_line_length = 120
|
|
recursive = true
|
|
exit-code = true
|
|
jobs = 0
|
|
select = [
|
|
"E101",
|
|
"E112",
|
|
"E113",
|
|
"E115",
|
|
"E116",
|
|
"E117",
|
|
"E121",
|
|
"E122",
|
|
"E123",
|
|
"E124",
|
|
"E125",
|
|
"E126",
|
|
"E127",
|
|
"E128",
|
|
"E129",
|
|
"E131",
|
|
"E201",
|
|
"E202",
|
|
"E203",
|
|
"E211",
|
|
"E221",
|
|
"E222",
|
|
"E223",
|
|
"E224",
|
|
"E225",
|
|
"E226",
|
|
"E227",
|
|
"E228",
|
|
"E231",
|
|
"E241",
|
|
"E242",
|
|
"E251",
|
|
"E252",
|
|
"E261",
|
|
"E262",
|
|
"E265",
|
|
"E266",
|
|
"E271",
|
|
"E272",
|
|
"E273",
|
|
"E274",
|
|
"E275",
|
|
"E301",
|
|
"E302",
|
|
"E303",
|
|
"E304",
|
|
"E305",
|
|
"E306",
|
|
"E502",
|
|
"E701",
|
|
"E702",
|
|
"E704",
|
|
"W391",
|
|
"W504",
|
|
]
|
|
exclude = "*/extractor/lazy_extractors.py,*venv*,*/test/testdata/sigs/player-*.js,.idea,.vscode"
|
|
|
|
[tool.pytest.ini_options]
|
|
addopts = [
|
|
"-ra", # summary: all except passed
|
|
"--verbose",
|
|
"--strict-markers",
|
|
]
|
|
markers = [
|
|
"download",
|
|
]
|