[IPython-dev] Heads-up for notebook users: on-disk format changes for version-control friendliness

MinRK benjaminrk at gmail.com
Fri Nov 11 00:25:03 EST 2011

On Thu, Nov 10, 2011 at 20:30, Satrajit Ghosh <satra at mit.edu> wrote:

> hey fernando,
>> We already have that in place, and once we release we'll be much stricter
>> with version number checks.
> awesome!
>> But we didn't actually bump the version number with this change (perhaps
>> we should have, I hope it won't be too much of a hassle since right now
>> only people running off git can use it, and it's a 'git pull' away).
> i'm ok with this, most of my collaborators currently are using the latest
> version anyway! (but from a principled perspective, it should change :) )

I didn't bump the version for two reasons:

1. it doesn't actually change the notebook format.  Every v2 notebook
written to JSON prior to this change remains perfectly valid, and will
continue to be so forever.  The only change is that notebooks *can* ( and
do when you save them via the web interface) split multi-line text into a
list of lines when writing to JSON.
2. The code has not been released, and tiny changes like this should be
acceptable, so that we don't proliferate a dozen notebook formats per
release (we already have two, and zero releases).

This does mean that users collaborating on notebooks right now have to
coordinate their next pull, but that doesn't seem unreasonable when
everyone affected is necessarily already running from git. But perhaps I
underestimate the popularity of the notebook for collaborating at this

We will certainly never make a change even this minuscule to a notebook
format that we have actually released, and we will probably get started on
v3 shortly after 0.12 is cut.


> cheers,
> satra
> ps. i'll get to making the feature requests perhaps on my way to dc
> tomorrow. sorry i have been way beyond busy. i need to change my life!
> _______________________________________________
> IPython-dev mailing list
> IPython-dev at scipy.org
> http://mail.scipy.org/mailman/listinfo/ipython-dev
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/ipython-dev/attachments/20111110/b5c26719/attachment.html>

More information about the IPython-dev mailing list