README.rst
80 lines
| 2.6 KiB
| text/x-rst
|
RstLexer
Matthias Bussonnier
|
r19865 | .. image:: https://img.shields.io/coveralls/ipython/ipython.svg | ||
:target: https://coveralls.io/r/ipython/ipython?branch=master | ||||
.. image:: https://img.shields.io/pypi/dm/IPython.svg | ||||
:target: https://pypi.python.org/pypi/ipython | ||||
.. image:: https://img.shields.io/pypi/v/IPython.svg | ||||
:target: https://pypi.python.org/pypi/ipython | ||||
.. image:: https://img.shields.io/travis/ipython/ipython.svg | ||||
:target: https://travis-ci.org/ipython/ipython | ||||
Fernando Perez
|
r4459 | =========================================== | ||
IPython: Productive Interactive Computing | ||||
=========================================== | ||||
fperez
|
r0 | |||
Brian E Granger
|
r1250 | Overview | ||
======== | ||||
darren.dale
|
r864 | |||
Fernando Perez
|
r6599 | Welcome to IPython. Our full documentation is available on `our website | ||
<http://ipython.org/documentation.html>`_; 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 | ||||
Aaron Meurer
|
r7825 | ``cd docs; make html`` for local browsing. | ||
Brian Granger
|
r1719 | |||
Fernando Perez
|
r2481 | |||
Fernando Perez
|
r2573 | 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. | ||||
MinRK
|
r12475 | Officially, IPython requires Python version 2.7, or 3.3 and above. | ||
IPython 1.x is the last IPython version to support Python 2.6 and 3.2. | ||||
Fernando Perez
|
r2573 | |||
Aaron Meurer
|
r7825 | |||
Fernando Perez
|
r2536 | Instant running | ||
=============== | ||||
Fernando Perez
|
r2481 | |||
You can run IPython from this directory without even installing it system-wide | ||||
MinRK
|
r3345 | by typing at the terminal:: | ||
Fernando Perez
|
r2481 | |||
MinRK
|
r10575 | $ python -m IPython | ||
Dražen Lučanin
|
r10139 | |||
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:: | ||||
MinRK
|
r12475 | $ git clone --recursive https://github.com/ipython/ipython.git | ||
$ cd ipython | ||||
Ezequiel (Zac) Panepucci
|
r16278 | $ pip install -e ".[notebook]" --user | ||
Dražen Lučanin
|
r10139 | |||
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 | ||||
Kyle Kelley
|
r10224 | The same process applies for other parts, such as the qtconsole (the | ||
Dražen Lučanin
|
r10139 | ``extras_require`` attribute in the setup.py file lists all the possibilities). | ||
MinRK
|
r10558 | |||
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. | ||||