[IPython-dev] Flat is better than nested

[Carlos Córdoba]

El 20/05/13 15:46, Fernando Perez escribió:
> One more note: having these top-level entry points not only helps
> third-party users keep shorter imports, it also lets us reorganize
> things internally as needed without breaking the user-facing API.  It
> can be handy as the project evolves to move things around in deeply
> nested files: if projects are only importing those components from
> high-level entry points, nothing will break for them.

This is a very good point (that I didn't know): so __all__ is like the 
equivalent of header files in the C/C++ world, which expose public API, 
so that one can develop the implementation in as many c/cpp files as one 
wants.