"certifi",
"mutagen",
"pycryptodomex",
- "requests>=2.31.0,<3",
+ "requests>=2.32.2,<3",
"urllib3>=1.26.17,<3",
"websockets>=12.0",
]
[project.optional-dependencies]
default = []
-curl_cffi = ["curl-cffi==0.5.10; implementation_name=='cpython'"]
+curl-cffi = ["curl-cffi==0.5.10; implementation_name=='cpython'"]
secretstorage = [
"cffi",
"secretstorage",
"build",
"hatchling",
"pip",
+ "setuptools",
"wheel",
]
dev = [
- "flake8",
- "isort",
- "pytest",
+ "pre-commit",
+ "yt-dlp[static-analysis]",
+ "yt-dlp[test]",
+]
+static-analysis = [
+ "autopep8~=2.0",
+ "ruff~=0.5.0",
+]
+test = [
+ "pytest~=8.1",
+]
+pyinstaller = [
+ "pyinstaller>=6.7.0", # for compat with setuptools>=70
+]
+py2exe = [
+ "py2exe>=0.12",
]
-pyinstaller = ["pyinstaller>=6.3"]
-pyinstaller_macos = ["pyinstaller==5.13.2"] # needed for curl_cffi builds
-py2exe = ["py2exe>=0.12"]
[project.urls]
Documentation = "https://github.com/yt-dlp/yt-dlp#readme"
[tool.hatch.version]
path = "yt_dlp/version.py"
pattern = "_pkg_version = '(?P<version>[^']+)'"
+
+[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-static-analysis]
+detached = true
+features = ["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 = ["test"]
+dependencies = [
+ "pytest-randomly~=3.15",
+ "pytest-rerunfailures~=14.0",
+ "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.8",
+ "3.9",
+ "3.10",
+ "3.11",
+ "3.12",
+ "pypy3.8",
+ "pypy3.9",
+ "pypy3.10",
+]
+
+[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
+ "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
+ "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
+ "PLE0604", # invalid-all-object (false positives)
+ "PLE0643", # potential-index-error (false positives)
+ "PLW0603", # global-statement
+ "PLW1510", # subprocess-run-without-check
+ "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
+]
+"yt_dlp/jsinterp.py" = [
+ "UP031", # printf-string-formatting
+]
+
+[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",
+ "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."
+
+[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",
+]
+
+[tool.pytest.ini_options]
+addopts = "-ra -v --strict-markers"
+markers = [
+ "download",
+]