New setting "user_builtins_name": Ignore specific "name-defined" errors

[un-pogaz]

Feature

Adding a setting "user_builtins_name", or "builtins", that is a array of strings for which the error [name-defined] is ignored.

Pitch

It is possible to extend the list of builtins function, which can be very useful in some projects as we no longer need to import this function if it's used extensively in the rest of the project.

Example:

builtins.__dict__['prints'] = prints = PrefixedPrint()

builtins.__dict__['_'] = localization.gettext

Sadly, mypy don't support such exotic things. There is two solution:

1. Analyzer all the code to add dynamically the "user builtins name"
2. Add a user-controlled setting to globally ignore specific "name-defined" errors

The first would be the best, but also the harder to implement. The second would be easier to implement, but some ignored 'name-defined' error could be legitimate depending on the import and call stack. But since the very exotic and niche feature, the risks are low and we can assume that the user know what he do when he use this settings.

The use of a setting name that contain the word 'builtins' allows to explicitly specify the user case of such setting (when a generic "ignore_name_defined" could be misinterpreted and so misused)

Related Issues
#7931

[brianschubert]

Linking #16078, #12860 for related discussion

[A5rocks]

I assume using custom_typeshed_dir with a typeshed where you modify builtins.pyi is too cumbersome?

Maybe better than a list of names to ignore would be custom_typing_module for builtins -- I imagine you want types for the commonly used functions too!

[un-pogaz]

Cumbersome is a word to use, but Hacky and Over-exagered seems to me a better descriptors.

At first, I thought that the solution you suggested was that I import the more than 2000 line builtins.pyi to add the only 10 that describe custom builtins functions and then that mypy will dynamicly add/overide the corresponding module into their default typeshed. I'd have objections to that, but okay. It's a hacky way that could work fine, but that not very solve propely the issue.

But no, that worst than that since your suggestion need to import the +700 files of the native CPython/mypy??? For 2 functions??? Why do that for a such small change ??? O_o

So, I'm sure there are projects that are able and determined to do this kind of thing, but it's certainly because they have a very good reason to do it, like probably using custom versions of CPython/mypy. But that's not the case for everyone, especially given the disproportionate size ratio between the files added and the modifications specific to this project. Not to mention the maintenance that would have to be done in the event of a python version change.

No, you idea completly miss the use case for small and medium-sized projects, and probably the almost totality of any projects of any size, with a absurdly over-exagered way to solve a simple and small problem.

---

So Yes, checking the types for the custom builtins functions would be a must-have, and that's why the support of __builtins__.pyi (#16078) would be absolutely perfect, but I'm afraid I'm not good enough to make such edit. So a simple list of excluded name is not a perfect solution, but that one that work now (see PR #18936).

(and I don't understand why you propose to use "custom_typing_module", their is no type change implie in my proposal)