In fact, you write all of your python like you really have something to hide ;) Like `_Todo`.
Where did you get this pattern?
(I’m way more curious than accusatory. Are people embracing private modules these days as a convention, and I just missed it?)
I honestly love when I see a package do stuff like this: it's very clear then what is public interface, and I should consider usable (without sin) and what is supposed to be an internal detail.
Same with the modules: then it is very clear that the re-export of those names in __init__.py is where they're meant to be consumed, and the other modules are just for organizational purposes, not API purposes.
_Todo is then a private type.
Very clean.
The way I see it there are two schools:
- The whitelist school: You write everything without _ prefix, then you whitelist what you want accessible with __all__.
- The explicit school: You forget about all and just use _ for symbols, modules, etc.
I find the latter more readable and consistent (can be applied to attributes, free functions, modules...
Not sure where I got it from, it just seems clean. I don't think I see this super frequently in the ecosystem at large, although anything I've had a hand in will tend to use this style!