##// END OF EJS Templates
upstream » ipython
RSS

Clone from https://github.com/ipython/ipython.git

Add -q option (suppress print upon creation) to %macro...
Add -q option (suppress print upon creation) to %macro Macros are very, very useful and "Matlab" like (as well as other similar math computing environs). Often I (or my students) use a macro to load long complex code from a url -- e.g., large data sets, simulated data, preprocessing of data, special plotting commands, grading routines... Currently, this requires defining the macro at the end of the notebook so when the "print upon creation" occurs it doesn't overwhelm the notebook (except at the end). The -q option suppresses the print contents upon creation. Example with a Matplotlib example: In[1]: %macro tmp http://matplotlib.org/mpl_examples/api/date_demo.py Macro `tmp` created. To execute, type its name (without quotes). === Macro contents: === """ Show how to make date plots in matplotlib using date tick locators and formatters. See major_minor_demo1.py for more information on controlling major and minor ticks ... In[2]: %macro -q tmp2 http://matplotlib.org/mpl_examples/api/date_demo.py (nothing) Perhaps, though, the first line should print -- e.g., Macro `tmp` created. To execute, type its name (without quotes). In the docstraing, I also fixed a typo (an "as" that should be an "at") and clarified how to produce an example output.
Jeff Knisley -
r10962:f96aac3a
Show More
Name Size Modified Last Commit Author
IPython
docs
examples
git-hooks
scripts
setupext
tools
.gitattributes Loading ...
.gitignore Loading ...
.gitmodules Loading ...
.mailmap Loading ...
.travis.yml Loading ...
COPYING.txt Loading ...
MANIFEST.in Loading ...
README.rst Loading ...
setup.py Loading ...
setupbase.py Loading ...
setupegg.py Loading ...
tox.ini Loading ...

IPython: Productive Interactive Computing

Overview

Welcome to IPython. Our full documentation is available on our website; if you downloaded a built source distribution the docs/source directory contains the plaintext version of these manuals. If you have Sphinx installed, you can build them by typing cd docs; make html for local browsing.

Dependencies and supported Python versions

For full details, see the installation section of the manual. The basic parts of IPython only need the Python standard library, but much of its more advanced functionality requires extra packages.

Officially, IPython requires Python version 2.6, 2.7, or 3.1 and above.

Instant running

You can run IPython from this directory without even installing it system-wide by typing at the terminal:

$ python -m IPython

Development installation

If you want to hack on certain parts, e.g. the IPython notebook, in a clean environment (such as a virtualenv) you can use pip to grab the necessary dependencies quickly:

$ pip install -e .[notebook]

This installs the necessary packages and symlinks IPython into your current environment so that you can work on your local repo copy and run it from anywhere:

$ ipython notebook

The same process applies for other parts, such as the qtconsole (the extras_require attribute in the setup.py file lists all the possibilities).

Git Hooks and Submodules

IPython now uses git submodules to ship its javascript dependencies. If you run IPython from git master, you may need to update submodules once in a while with:

$ git submodule update

or:

$ python setup.py submodule

We have some git hooks for helping keep your submodules always in sync, see our git-hooks directory for more info.