Incomplete or create empty class stubs?

[Spider84pr]

Hello.
I want to start annote rather large library an mos of classes is unannotated.

Please tell me what is better - use Incomplete of create an file with class stub like this

class SomeClass: ...

Thanks.

[srittau]

Generally, if you add a class, you should add all (public) fields and methods, even if they are left unannotated (or use Incomplete where that is not possible). stubgen and our scripts/create_baseline_stubs.py script do that for you. You can theoretically also use def __getitem__(self, name: str, /) -> Incomplete: ... for incomplete classes (and a few of our stubs might use that technique), but using stubgen is much preferred nowadays.

[JelleZijlstra]

__getattr__, not __getitem__ :)