bpython 0,0 travis-ci python

bpython - A fancy curses interface to the Python interactive interpreter

3 years after


.. |ImageLink| image:: https://travis-ci.org/bpython/bpython.svg?branch=master .. _ImageLink: https://travis-ci.org/bpython/bpython

bpython: A fancy curses interface to the Python interactive interpreter

bpython_ is a lightweight Python interpreter that adds several features common to IDEs. These features include syntax highlighting, expected parameter list, auto-indentation, and autocompletion. (See below for example usage).

.. image:: http://i.imgur.com/jf8mCtP.gif :alt: bpython :width: 646 :height: 300 :align: center

bpython does not aim to be a complete IDE - the focus is on implementing a few ideas in a practical, useful, and lightweight manner.

bpython is a great replacement to any occasion where you would normally use the vanilla Python interpreter - testing out solutions to people's problems on IRC, quickly testing a method of doing something without creating a temporary file, etc..

You can find more about bpython - including full documentation - at our homepage.

.. contents:: :local: :depth: 1 :backlinks: none

========================== Installation & Basic Usage

If you have pip_ installed, you can simply run:

.. code-block:: bash

$ pip install bpython

Start bpython by typing bpython in your terminal. You can exit bpython by using the exit() command or by pressing control-D like regular interactive Python.

=================== Features & Examples

  • Readline-like autocomplete, with suggestions displayed as you type.

  • In-line syntax highlighting. This uses Pygments for lexing the code as you type, and colours appropriately.

  • Expected parameter list. As in a lot of modern IDEs, bpython will attempt to display a list of parameters for any function you call. The inspect module is tried first, which works with any Python function, and then pydoc if that fails.

  • Rewind. This isn't called "Undo" because it would be misleading, but "Rewind" is probably as bad. The idea is that the code entered is kept in memory and when the Rewind function is called, the last line is popped and the entire session is re-evaluated. Use to rewind.

  • Edit the current line or your entire session in an editor. F7 opens the current session in a text editor, and if modifications are made, the session is rerun with these changes.

  • Pastebin code/write to file. Use the key to upload the screen's contents to pastebin, with a URL returned.

  • Reload imported Python modules. Use to clear sys.modules and rerun your session to test changes to code in a module you're working on.

============= Configuration

See the sample-config file for a list of available options. You should save your config file as ~/.config/bpython/config (i.e. $XDG_CONFIG_HOME/bpython/config) or specify at the command line::

bpython --config /path/to/bpython/config

============ Dependencies

  • Pygments
  • requests
  • curtsies >= 0.1.18
  • greenlet
  • six >= 1.5
  • Sphinx != 1.1.2 (optional, for the documentation)
  • mock (optional, for the testsuite)
  • babel (optional, for internationalization)
  • watchdog (optional, for monitoring imported modules for changes)
  • jedi (optional, for experimental multiline completion)

Python 2 before 2.7.7

If you are using Python 2 before 2.7.7, the following dependency is also required:

  • requests[security]


If you have problems installing cffi, which is needed by OpenSSL, please take a look at cffi docs_.


bpython-urwid requires the following additional packages:

  • urwid

========== Known Bugs

For known bugs please see bpython's known issues and FAQ_ page.

====================== Contact & Contributing

I hope you find it useful and please feel free to submit any bugs/patches suggestions to Robert or place them on the GitHub issues tracker.

For any other ways of communicating with bpython users and devs you can find us at the community page on the project homepage, or in the community.

Hope to see you there!

=================== CLI Windows Support


Curses_ Use the appropriate version compiled by Christoph Gohlke.

pyreadline_ Use the version in the cheeseshop.


Obtain the less program from GnuUtils. This makes the pager work as intended. It can be obtained from cygwin or GnuWin32 or msys

Current version is tested with

  • Curses 2.2
  • pyreadline 1.7

Curses Notes

The curses used has a bug where the colours are displayed incorrectly:

  • red is swapped with blue
  • cyan is swapped with yellow

To correct this I have provided a windows.theme file.

This curses implementation has 16 colors (dark and light versions of the colours)

============ Alternatives



Feel free to get in touch if you know of any other alternatives that people may be interested to try.

.. _ptpython: https://github.com/jonathanslenders/ptpython .. _ipython: https://ipython.org/ .. _homepage: http://www.bpython-interpreter.org .. _full documentation: http://docs.bpython-interpreter.org/ .. _cffi docs: https://cffi.readthedocs.org/en/release-0.8/#macos-x .. _issues tracker: http://github.com/bpython/bpython/issues/ .. _pip: https://pip.pypa.io/en/latest/index.html .. _project homepage: http://bpython-interpreter.org/community .. _community: http://docs.bpython-interpreter.org/community.html .. _Robert: [email protected] .. _bpython: http://www.bpython-interpreter.org/ .. _Curses: http://www.lfd.uci.edu/~gohlke/pythonlibs/ .. _pyreadline: http://pypi.python.org/pypi/pyreadline/ .. _known issues and FAQ: http://bpython-interpreter.org/known-issues-and-faq.html

Related Repositories



A curated list of awesome Python frameworks, libraries, software and resources ...



Python资源大全中文版,包括:Web框架、网络爬虫、模板引擎、数据库、数据可视化、图片处理等,由伯乐在线持续更新。 ...



The indiscriminate bicurious interactive python interpreter (bpython + ipython) ...



A terminal-based programmer's calculator endowed with unholy acting talent by th ...



:package: Slpkg is a user-friendly package manager for Slackware installations ...

Top Contributors

sebastinas thomasballinger Trundle ikanobori bobf mmaker marienz jasonLaster jsoref noelladsa eikehein jorgenpt amjith mlauter keyan lohmataja susinmotion krigstask techtonik tarekziade akaptur bragradon mjzffr invalid-email-address rhymeswithcycle myint llllllllll blueyed hndrewaall fokau


-   0.17-dev zip tar
-   0.16-release zip tar
-   0.16-dev zip tar
-   0.15-release zip tar
-   0.15-rc1 zip tar
-   0.15-dev zip tar
-   0.14.2-release zip tar
-   0.14.1-release zip tar
-   0.14-release zip tar
-   0.13.2-release zip tar
-   0.13.1-release zip tar
-   0.13-release zip tar
-   0.12-release zip tar
-   0.11-release zip tar
-   0.10.1-release zip tar
-   0.10-release zip tar
- zip tar
-   0.9.7-release zip tar
- zip tar
- zip tar
- zip tar
- zip tar
-   0.9.6 zip tar
-   0.9.6-release zip tar
- zip tar
- zip tar
- zip tar
- zip tar
-   0.9.5 zip tar
-   0.9.5-release zip tar