[IPython-dev] Flat is better than nested

[Brian Granger]

Hi,

Fernando, Min and I met on Google+ hangout today to talk about some of
the notebook reorganization.

We plan on using Google+ more often, but want to make sure that we
summarize decisions made there either on ipython-dev or an appropriate
GitHub PR/issue.  This email is to summarize the decisions from our G+
hangout.

During that discussion we ended up talking about the deep nesting that
we have in IPython.frontend

Deep inside the notebook frontend, we end up with imports of the sort:

IPython.frontend.html.notebook.handlers

The qt frontend has similarly deep nesting.

To solve this problem, we decided to flatten this out a bit.  Here is
what we decided:

IPython.frontend.qt -> IPython.qt
IPython.frontend.html.notebook -> IPython.html
IPython.frontend.terminal -> IPython.terminal

Future HTML frontends (like an HTML terminal) will go inside
IPython.html because they need to share a lot of static assets
(js/less/css).

This will happen *after* my notebook re-org pull requests are landed.

Comments?  Questions?

Cheers,

Brian

--
Brian E. Granger
Cal Poly State University, San Luis Obispo
bgranger at calpoly.edu and ellisonbg at gmail.com