ptpython
A better Python REPL
pip install ptpython
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).
Installation
Install it using pip:
pip install ptpython
Start it by typing ptpython.
Features
Syntax highlighting.
Multiline editing (the up arrow works).
Autocompletion.
Mouse support. [1]
Support for color schemes.
Support for bracketed paste [2].
Both Vi and Emacs key bindings.
Support for double width (Chinese) characters.
… and many other stuff.
[1] Disabled by default. (Enable in the menu.)
[2] If the terminal supports it (most terminals do), this allows pasting without going into paste mode. It will keep the indentation.
More screenshots
The configuration menu:
The history page and its help:
Autocompletion:
Embedding the REPL
Embedding the REPL in any Python application is easy:
from ptpython.repl import embed
embed(globals(), locals())Multiline editing
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 Alt+Enter, or 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 the options.)
Syntax validation
Before execution, ptpython will see whether the input is syntactically correct Python code. If not, it will show a warning, and move the cursor to the error.
Additional features
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 navigation mode.
Configuration
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: config.py
IPython support
Run 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. (pip install ipython)
Django support
django-extensions has a shell_plus management command. When ptpython has been installed, it will by default use ptpython or ptipython.
PDB
There is an experimental PDB replacement: ptpdb.
Windows support
prompt_toolkit and ptpython works better on Linux and OS X than on Windows. Some things might not work, but it is usable:
FAQ
Q: The Ctrl-S forward search doesn’t work and freezes my terminal.
A: Try to run stty -ixon in your terminal to disable flow control.
Q: The 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.
Alternatives
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 ptpython, also create a GitHub issue and maybe we’ll implement it.
Special thanks to
Pygments: Syntax highlighter.
Jedi: Autocompletion library.
Docopt: Command-line interface description language.
wcwidth: Determine columns needed for a wide characters.
prompt_toolkit for the interface.
1 maintainer
Metadata
1 maintainer
Release files for ptpython 0.37
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ptpython-0.37.tar.gz | 44.7 kB | Details |
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ptpython-0.37-py3-none-any.whl | Python 3 | none | any | Details |
| ptpython-0.37-py2-none-any.whl | Python 2 | none | any | Details |
Total release size: 138.5 kB
Release files / ptpython-0.37.tar.gz
| Download URL | ptpython-0.37.tar.gz |
|---|---|
| Size | 44.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
716be475945294f4fcc88314b443f216bdef20e11b7d88052233a9da9ead7457
|
|
BLAKE2b-256 checksum How to use checksums |
4dd08ca1319262170fface054d62bcbf3321110fda0a6f7eb138eb0046b06b08
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / ptpython-0.37-py3-none-any.whl
| Download URL | ptpython-0.37-py3-none-any.whl |
|---|---|
| Size | 46.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fc838130660c4e9abb31bf1d38bf40013d535b0cb17bf2b31313c68dca3a0e27
|
|
BLAKE2b-256 checksum How to use checksums |
d5d94b5494d1d721341b4e588a9aa3ac9a5d590b38429b1988c93219baa70e16
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / ptpython-0.37-py2-none-any.whl
| Download URL | ptpython-0.37-py2-none-any.whl |
|---|---|
| Size | 46.9 kB |
| Tags | Python 2 |
|
SHA-256 checksum How to use checksums |
c65df69b6b1214b08af75a41b7150ed71e6fba3910019f35dba94a7a73b3c4aa
|
|
BLAKE2b-256 checksum How to use checksums |
57970ec2b13cd07dda28f4198cc5ad2d64c14772a9ddb6408dbe762e8a19fdbf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
