Repository navigation
yt-dlp: incorrect visibility on parameters #16331
Description
Activity
- changed the title
[-]yt-dlp: Incorrect visibility on parameters[/-][+]yt-dlp: incorrect visibility on parameters[/+]on Sep 1, 2026 Hi! You can import
_Paramslike this (viaTYPE_CHECKING,_Paramsis not present at runtime):from typing import TYPE_CHECKING if TYPE_CHECKING: from yt_dlp import _Params
The issue isn't really with the name. The leading
_mostly indicates that this type doesn't exist at runtime.The problem is more likely related to the type checker being unable to narrow the type of the dictionary. When you create the dictionary, it is inferred as
dict[str, bool]. You can use either of the following approaches to ensure that the type is correct:# Annotate the variable: opts: _Params = {"quiet": True, "extract_flat": True} # Or use an inline dict: with yt_dlp.YoutubeDL({"quiet": True, "extract_flat": True}) as ydl:
_Paramsshould be public. Submitting a normal dict as a file will mismatch with the TypedDict because the type-checker will inferdict[str,bool]instead of_Params. See the example snippet:which results in
├╴E Argument of type "dict[str, bool]" cannot be assigned to parameter "params" of type "_Params | None" in function "__init__" │ Type "dict[str, bool]" is not assignable to type "_Params | None" │ "dict[str, bool]" is not assignable to "_Params" │ "dict[str, bool]" is not assignable to "None" basedpyright (reportArgumentType) [48, 27]