|Number of watchers on Github||2520|
|Number of open issues||120|
|Average time to close an issue||about 1 month|
|Average time to merge a PR||4 days|
|Open pull requests||19+|
|Closed pull requests||20+|
|Last commit||over 2 years ago|
|Repo Created||over 5 years ago|
|Repo Last Updated||almost 2 years ago|
|Organization / Author||jonathanslenders|
|Do you use ptpython? Leave a review!|
|View open issues (120)|
|View ptpython activity|
|View on github|
|Fresh, new opensource launches 🚀🚀🚀|
Trendy new open source projects in your inbox! View examples
better docs are needed
A better Python REPL
pip install ptpython
.. image :: https://github.com/jonathanslenders/ptpython/raw/master/docs/images/example1.png
Ptpython is an advanced Python REPL. It should work on all Python versions from 2.6 up to 3.5 and work cross platform (Linux, BSD, OS X and Windows).
Install it using pip:
pip install ptpython
Start it by typing
bracketed paste <https://cirw.in/blog/bracketed-paste>_ .
 Disabled by default. (Enable in the menu.)
 If the terminal supports it (most terminals do), this allows pasting without going into paste mode. It will keep the indentation.
The configuration menu:
.. image :: https://github.com/jonathanslenders/ptpython/raw/master/docs/images/ptpython-menu.png
The history page and its help:
.. image :: https://github.com/jonathanslenders/ptpython/raw/master/docs/images/ptpython-history-help.png
.. image :: https://github.com/jonathanslenders/ptpython/raw/master/docs/images/file-completion.png
Embedding the REPL
Embedding the REPL in any Python application is easy:
.. code:: python
from ptpython.repl import embed embed(globals(), locals())
Multi-line editing mode will automatically turn on when you press enter after a colon.
To execute the input in multi-line mode, you can either press
Esc followed by
Enter. (If you want the first to work in the OS X
terminal, you have to check the
Use option as meta key checkbox in your
terminal settings. For iTerm2, you have to check
Left option acts as +Esc in
.. image :: https://github.com/jonathanslenders/ptpython/raw/master/docs/images/multiline.png
ptpython will see whether the input is syntactically
correct Python code. If not, it will show a warning, and move the cursor to the
.. image :: https://github.com/jonathanslenders/ptpython/raw/master/docs/images/validation.png
Running system commands: Press
Meta-! in Emacs mode or just
! in Vi
navigation mode to see the
Shell command prompt. There you can enter system
commands without leaving the REPL.
Selecting text: Press
Control+Space in Emacs mode on
V (major V) in Vi
It is possible to create a
~/.ptpython/config.py file to customize the configuration.
Have a look at this example to see what is possible:
ptipython (prompt_toolkit - IPython), to get a nice interactive shell
with all the power that IPython has to offer, like magic functions and shell
integration. Make sure that IPython has been installed. (
.. image :: https://github.com/jonathanslenders/ptpython/raw/master/docs/images/ipython.png
shell_plus management command. When
ptpython has been installed,
it will by default use
There is an experimental PDB replacement:
ptpython works better on Linux and OS X than on
Windows. Some things might not work, but it is usable:
.. image :: https://github.com/jonathanslenders/ptpython/raw/master/docs/images/windows.png
Ctrl-S forward search doesn't work and freezes my terminal.
A: Try to run
stty -ixon in your terminal to disable flow control.
Meta-key doesn't work.
A: For some terminals you have to enable the Alt-key to act as meta key, but you
can also type
Escape before any key instead.
If you find another alternative, you can create an issue and we'll list it
here. If you find a nice feature somewhere that is missing in
also create a GitHub issue and maybe we'll implement it.
Special thanks to
Pygments <http://pygments.org/>_: Syntax highlighter.
Jedi <http://jedi.readthedocs.io/en/latest/>_: Autocompletion library.
Docopt <http://docopt.org/>_: Command-line interface description language.
wcwidth <https://github.com/jquast/wcwidth>_: Determine columns needed for a wide characters.
prompt_toolkit <http://github.com/jonathanslenders/python-prompt-toolkit>_ for the interface.
.. |Build Status| image:: https://api.travis-ci.org/jonathanslenders/ptpython.svg?branch=master :target: https://travis-ci.org/jonathanslenders/ptpython#
.. |PyPI| image:: https://pypip.in/version/prompt-toolkit/badge.svg :target: https://pypi.python.org/pypi/prompt-toolkit/ :alt: Latest Version