Python Prompt Toolkit

Build Status Latest Version

prompt_toolkit is a library for building powerful interactive command lines and terminal applications in Python.

Read the documentation on readthedocs.

Ptpython

ptpython is an interactive Python Shell, build on top of prompt-toolkit.

https://github.com/jonathanslenders/python-prompt-toolkit/raw/master/docs/images/ptpython.png

prompt-toolkit features

prompt_toolkit could be a replacement for GNU readline, but it can be much more than that.

Some features:

  • Pure Python.
  • Syntax highlighting of the input while typing. (For instance, with a Pygments lexer.)
  • Multi-line input editing.
  • Advanced code completion.
  • Both Emacs and Vi key bindings. (Similar to readline.)
  • Reverse and forward incremental search.
  • Runs on all Python versions from 2.6 up to 3.5.
  • Works well with Unicode double width characters. (Chinese input.)
  • Selecting text for copy/paste. (Both Emacs and Vi style.)
  • Support for bracketed paste.
  • Mouse support for cursor positioning and scrolling.
  • Auto suggestions. (Like fish shell.)
  • Multiple input buffers.
  • No global state.
  • Lightweight, the only dependencies are Pygments, six and wcwidth.
  • Runs on Linux, OS X, OpenBSD and Windows systems.
  • And much more...

Feel free to create tickets for bugs and feature requests, and create pull requests if you have nice patches that you would like to share with others.

About Windows support

prompt_toolkit is cross platform, and everything that you build on top should run fine on both Unix and Windows systems. On Windows, it uses a different event loop (WaitForMultipleObjects instead of select), and another input and output system. (Win32 APIs instead of pseudo-terminals and VT100.)

It's worth noting that the implementation is a "best effort of what is possible". Both Unix and Windows terminals have their limitations. But in general, the Unix experience will still be a little better.

For Windows, it's recommended to use either cmder or conemu.

Installation

pip install prompt-toolkit

For Conda, do:

conda install -c https://conda.anaconda.org/conda-forge prompt_toolkit

Getting started

The most simple example of the library would look like this:

from prompt_toolkit import prompt

if __name__ == '__main__':
    answer = prompt('Give me some input: ')
    print('You said: %s' % answer)

For more complex examples, have a look in the examples directory. All examples are chosen to demonstrate only one thing. Also, don't be afraid to look at the source code. The implementation of the prompt function could be a good start.

Note for Python 2: all strings are expected to be unicode strings. So, either put a small u in front of every string or put from __future__ import unicode_literals at the start of the above example.

Projects using prompt-toolkit

Shells:

  • ptpython: Python REPL
  • ptpdb: Python debugger (pdb replacement)
  • pgcli: Postgres client.
  • mycli: MySql client.
  • wharfee: A Docker command line.
  • xonsh: A Python-ish, BASHwards-compatible shell.
  • saws: A Supercharged AWS Command Line Interface.
  • cycli: A Command Line Interface for Cypher.
  • crash: Crate command line client.
  • vcli: Vertica client.
  • aws-shell: An integrated shell for working with the AWS CLI.
  • softlayer-python: A command-line interface to manage various SoftLayer products and services.
  • ipython: The IPython REPL
  • click-repl: Subcommand REPL for click apps.
  • haxor-news: A Hacker News CLI.

Full screen applications:

  • pymux: A terminal multiplexer (like tmux) in pure Python.
  • pyvim: A Vim clone in pure Python.

(Want your own project to be listed here? Please create a GitHub issue.)

Philosophy

The source code of prompt_toolkit should be readable, concise and efficient. We prefer short functions focussing each on one task and for which the input and output types are clearly specified. We mostly prefer composition over inheritance, because inheritance can result in too much functionality in the same object. We prefer immutable objects where possible (objects don't change after initialisation). Reusability is important. We absolutely refrain from having a changing global state, it should be possible to have multiple independent instances of the same code in the same process. The architecture should be layered: the lower levels operate on primitive operations and data structures giving -- when correctly combined -- all the possible flexibility; while at the higher level, there should be a simpler API, ready-to-use and sufficient for most use cases. Thinking about algorithms and efficiency is important, but avoid premature optimization.

Special thanks to

  • Pygments: Syntax highlighter.
  • wcwidth: Determine columns needed for a wide characters.
::...
免责声明:
当前网页内容, 由 大妈 ZoomQuiet 使用工具: ScrapBook :: Firefox Extension 人工从互联网中收集并分享;
内容版权归原作者所有;
本人对内容的有效性/合法性不承担任何强制性责任.
若有不妥, 欢迎评注提醒:

或是邮件反馈可也:
askdama[AT]googlegroups.com



自怼圈/年番新

DU21.4
关于 ~ DebugUself with DAMA ;-)


关注公众号, 持续获得相关各种嗯哼:
zoomquiet


粤ICP备18025058号-1
公安备案号: 44049002000656 ...::