##// END OF EJS Templates
Show More
Commit Commit message Age Author Refs
r26020:d0a0447a
make default
Matthias Bussonnier
0
r26019:59cbf86e
Update issue templates
Matthias Bussonnier
0
r26018:9d8fac9a
Merge pull request #12548 from GabrielSimonetto/pathlib_on_init_virtualenv
Matthias Bussonnier
0
r26017:410c70c4
reformat modified code
Matthias Bussonnier
0
r26016:3a310410
Update IPython/core/interactiveshell.py
Matthias Bussonnier
0
r26015:d51e575a
Merge pull request #12552 from rushabh-v/pathlib_fwpr
Matthias Bussonnier
0
r26014:50a8bd8a
run darker
rushabh-v
0
r26013:ac99f872
use pathlib in fixup_whats_new_pr.py
rushabh-v
0
r26012:a1f433a1
Introduce pathlib on init_virtualenv.
Gabriel Simonetto
0
r26011:bd584b2f
Merge pull request #12547 from meeseeksmachine/auto-backport-of-pr-12543-on-7.x
Matthias Bussonnier
7.x
0
< 1 2 3 4 5 6 7 .. 2603 >
https://codecov.io/github/ipython/ipython/coverage.svg?branch=master https://img.shields.io/pypi/v/IPython.svg https://img.shields.io/travis/ipython/ipython.svg https://www.codetriage.com/ipython/ipython/badges/users.svg https://raster.shields.io/badge/Follows-NEP29-brightgreen.png

IPython: Productive Interactive Computing

Overview

Welcome to IPython. Our full documentation is available on ipython.readthedocs.io and contains information on how to install, use, and contribute to the project.

IPython versions and Python Support

Starting with IPython 7.10, IPython follows NEP 29

IPython 7.17+ requires Python version 3.7 and above.

IPython 7.10+ requires Python version 3.6 and above.

IPython 7.0 requires Python version 3.5 and above.

IPython 6.x requires Python version 3.3 and above.

IPython 5.x LTS is the compatible release for Python 2.7. If you require Python 2 support, you must use IPython 5.x LTS. Please update your project configurations and requirements as necessary.

The Notebook, Qt console and a number of other pieces are now parts of Jupyter. See the Jupyter installation docs if you want to use these.

Development and Instant running

You can find the latest version of the development documentation on readthedocs.

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

$ python -m IPython

Or see the development installation docs for the latest revision on read the docs.

Documentation and installation instructions for older version of IPython can be found on the IPython website

IPython requires Python version 3 or above

Starting with version 6.0, IPython does not support Python 2.7, 3.0, 3.1, or 3.2.

For a version compatible with Python 2.7, please install the 5.x LTS Long Term Support version.

If you are encountering this error message you are likely trying to install or use IPython from source. You need to checkout the remote 5.x branch. If you are using git the following should work:

$ git fetch origin
$ git checkout 5.x

If you encounter this error message with a regular install of IPython, then you likely need to update your package manager, for example if you are using pip check the version of pip with:

$ pip --version

You will need to update pip to the version 9.0.1 or greater. If you are not using pip, please inquiry with the maintainers of the package for your package manager.

For more information see one of our blog posts:

https://blog.jupyter.org/release-of-ipython-5-0-8ce60b8d2e8e

As well as the following Pull-Request for discussion:

https://github.com/ipython/ipython/pull/9900

This error does also occur if you are invoking setup.py directly – which you should not – or are using easy_install If this is the case, use pip install . instead of setup.py install , and pip install -e . instead of setup.py develop If you are depending on IPython as a dependency you may also want to have a conditional dependency on IPython depending on the Python version:

install_req = ['ipython']
if sys.version_info[0] < 3 and 'bdist_wheel' not in sys.argv:
    install_req.remove('ipython')
    install_req.append('ipython<6')

setup(
    ...
    install_requires=install_req
)

Alternatives to IPython

IPython may not be to your taste; if that's the case there might be similar project that you might want to use:

  • the classic Python REPL.
  • bpython
  • mypython
  • ptpython and ptipython <https://pypi.org/project/ptpython/>
  • xonsh <https://xon.sh/>

Ignoring commits with git blame.ignoreRevsFile

As of git 2.23, it is possible to make formatting changes without breaking git blame. See the git documentation for more details.

To use this feature you must:

  • Install git >= 2.23
  • Configure your local git repo by running:
    • POSIX: tools\configure-git-blame-ignore-revs.sh
    • Windows: tools\configure-git-blame-ignore-revs.bat