yt-dlp: incorrect visibility on parameters #16331

Activity

1. mahyarmirrashed

   changed the title [-]yt-dlp: Incorrect visibility on parameters[/-] [+]yt-dlp: incorrect visibility on parameters[/+] on Sep 1, 2026
2. donbarbos commented on Sep 6, 2026

   

   donbarbos

   on Sep 6, 2026

   Contributor

   More actions

   Hi! You can import _Params like this (via TYPE_CHECKING, _Params is 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:
3. BassArt1 commented on Oct 24, 2026

   

   BassArt1

   on Oct 24, 2026

   More actions

   # 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:

   Neither of these options work in many use cases.

   The first makes the type checker complain about _Params being private:

   "_Params" is private and used outside of the module in which it is declared [Pylance(reportPrivateUsage)]
   

   The second works but is simply not practicle in many use cases.
   P.S. For now I'm dealing with this problem by importing _Params and ignoring the error:

   from yt_dlp import _Params #pyright:ignore[reportPrivateUsage] This is temporary fix for https://github.com/python/typeshed/issues/16331
4. BassArt1 commented on Oct 24, 2026

   

   BassArt1

   on Oct 24, 2026

   Last edited by BassArt1

   More actions

   Nvm, this was fixed by adding a public YoutubeDLOptions interface in 778a456