Introduction
Cauldron is called the unnotebook because it
differs from traditional notebooks two key ways:
Multiple Files
Cauldron notebooks are made up of multiple files
Notebooks were first developed at a time when sharing code was cumbersome.
The single-file format made it easier send code.
But today code-hosting services like
GitHub
and
BitBucket
are the much better solution. The single-file format has now become the
cumbersome way to share code because they don't play nicely with these code
hosting services in a number of ways. Collaboration results in unnecessary
merge conflicts. Code can't be easily reviewed by peers. And extra display
data is stored in every commit whether you want it or not.
Cauldron notebooks are folders that contain multiple project files instead of
storing everything in one file. A typical notebook would look something like:
my_notebook
cauldron.json
data.csv
S01-Premable.md
S02-Load-Data.py
S03-Plot-Data.py
where:
my_notebook
is the folder for all of the notebook's files
cauldron.json
stores all of the notebook's settings
data.csv
locally stored data and other files reside in the notebook folder
for easy access
S01-Preamble.md, S02-Load-Data.py & S03-Plot-Data.py
Each notebook cell is stored in its own file
Display data is also stored in separate files. They can be saved, or
not, when and where you choose to avoid polluting the version control system
with meaningless updates caused by re-running unmodified steps.
Editing and Display Separation
Cauldron separates authoring from display and lets you use the code editor
of your choice
Cauldron has no code editing capabilities of its own. There is absolutely no
reason to reinvent the wheel with so many fantastic code editors with
productivity features that far exceed anything available in notebooks. The
process of developing an analysis in Cauldron works like this:
Write Code
in the code editor of your choice
Execute Code
in Cauldron and see the results in the display
Repeat
iterating and expanding on on the analysis like all notebooks like
any other notebook until you're finished