Skip to main content

Python REPL build on top of prompt_toolkit

Project description

A better Python REPL

pip install ptpython
https://github.com/jonathanslenders/ptpython/raw/master/docs/images/example1.png

Build Status

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:

https://github.com/jonathanslenders/ptpython/raw/master/docs/images/ptpython-menu.png

The history page and its help:

https://github.com/jonathanslenders/ptpython/raw/master/docs/images/ptpython-history-help.png

Autocompletion:

https://github.com/jonathanslenders/ptpython/raw/master/docs/images/file-completion.png

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.)

https://github.com/jonathanslenders/ptpython/raw/master/docs/images/multiline.png

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.

https://github.com/jonathanslenders/ptpython/raw/master/docs/images/validation.png

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)

https://github.com/jonathanslenders/ptpython/raw/master/docs/images/ipython.png

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:

https://github.com/jonathanslenders/ptpython/raw/master/docs/images/windows.png

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ptpython-0.32.tar.gz (43.0 kB view details)

Uploaded Source

Built Distributions

ptpython-0.32-py3-none-any.whl (45.7 kB view details)

Uploaded Python 3

ptpython-0.32-py2-none-any.whl (45.7 kB view details)

Uploaded Python 2

File details

Details for the file ptpython-0.32.tar.gz.

File metadata

  • Download URL: ptpython-0.32.tar.gz
  • Upload date:
  • Size: 43.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for ptpython-0.32.tar.gz
Algorithm Hash digest
SHA256 0dccac7b3f0ed6efe206ee61c4042950e52b4bee05680c499472115681d3efe8
MD5 20277576d05d4ec43d0ee16c01f99129
BLAKE2b-256 a4ed03de53c04a8a2376dbdb11aedaf16e40131c1f7478e5861ffbbefaa56051

See more details on using hashes here.

File details

Details for the file ptpython-0.32-py3-none-any.whl.

File metadata

File hashes

Hashes for ptpython-0.32-py3-none-any.whl
Algorithm Hash digest
SHA256 4a406723a3980eb51b48abc687ccc993a13a464871efd134b76999e700d8e504
MD5 c4089b39a59b629595d508ce94ba2fc4
BLAKE2b-256 cea02a99469073096761ca1ab48f260c9fc5dbd629f4975a9968dde1dcf783e2

See more details on using hashes here.

File details

Details for the file ptpython-0.32-py2-none-any.whl.

File metadata

File hashes

Hashes for ptpython-0.32-py2-none-any.whl
Algorithm Hash digest
SHA256 a3d656b8c69230fe415aace78e9b3726d000f80ba3cf6b8424e2f12d7d6ae01c
MD5 6619c7fe7c895398bf87103a7c1bb4e8
BLAKE2b-256 b86bd2b239da751da71bc9b9f52411a527fc0de08cd2a14fd4cfab9a58f22690

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page