.. image:: https://img.shields.io/pypi/v/bpython
:target: https://pypi.org/project/bpython
.. image:: https://readthedocs.org/projects/bpython/badge/?version=latest
:target: https://docs.bpython-interpreter.org/en/latest/
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
:target: https://github.com/ambv/black
****************************************************************
bpython: A fancy 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:: https://bpython-interpreter.org/images/math.gif
:alt: bpython
:width: 566
:height: 348
: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`_.
==========================
Installation & Basic Usage
==========================
Installation using Pip
----------------------
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 (which
works with any Python function) is tried first, 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 <control-R> 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 <F8> key to upload the screen's contents
to pastebin, with a URL returned.
* Reload imported Python modules. Use <F6> 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
* curtsies >= 0.4.0
* greenlet
* pyxdg
* requests
* Sphinx >= 1.5 (optional, for the documentation)
* babel (optional, for internationalization)
* jedi (optional, for experimental multiline completion)
* watchdog (optional, for monitoring imported modules for changes)
* pyperclip (optional, for copying to the clipboard)
bpython-urwid
-------------
``bpython-urwid`` requires the following additional packages:
* urwid
===================================
Installation via OS Package Manager
===================================
The majority of desktop computer operating systems come with package management
systems. If you use one of these OSes, you can install ``bpython`` using the
package manager.
Ubuntu/Debian
-------------
Ubuntu/Debian family Linux users can install ``bpython`` using the ``apt``
package manager, using the command with ``sudo`` privileges:
.. code-block:: bash
$ apt install bpython
In case you are using an older version, run
.. code-block:: bash
$ apt-get install bpython
Arch Linux
----------
Arch Linux uses ``pacman`` as the default package manager; you can use it to install ``bpython``:
.. code-block:: bash
$ pacman -S bpython
Fedora
------
Fedora users can install ``bpython`` directly from the command line using ``dnf``.
.. code-block:: bash
$ dnf install bpython
GNU Guix
----------
Guix users can install ``bpython`` on any GNU/Linux distribution directly from the command line:
.. code-block:: bash
$ guix install bpython
macOS
-----
macOS does not include a package manager by default. If you have installed any
third-party package manager like MacPorts, you can install it via
.. code-block:: bash
$ sudo port install py-bpython
==========
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!
.. _homepage: http://www.bpython-interpreter.org
.. _full documentation: http://docs.bpython-interpreter.org/
.. _issues tracker: http://github.com/bpython/bpython/issues/
.. _pip: https://pip.pypa.io/en/latest/index.html
.. _project homepage: http://bpython-interpreter.org
.. _community: http://docs.bpython-interpreter.org/community.html
.. _Robert: robertanthonyfarrell@gmail.com
.. _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
Raw data
{
"_id": null,
"home_page": "https://www.bpython-interpreter.org/",
"name": "bpython",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "",
"author": "Bob Farrell, Andreas Stuehrk, Sebastian Ramacher, Thomas Ballinger, et al.",
"author_email": "bpython@googlegroups.com",
"download_url": "https://files.pythonhosted.org/packages/cf/76/54e0964e2974becb673baca69417b6c6293e930d4ebcf2a2a68c1fe9704a/bpython-0.24.tar.gz",
"platform": null,
"description": ".. image:: https://img.shields.io/pypi/v/bpython\n :target: https://pypi.org/project/bpython\n\n.. image:: https://readthedocs.org/projects/bpython/badge/?version=latest\n :target: https://docs.bpython-interpreter.org/en/latest/\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n :target: https://github.com/ambv/black\n\n\n****************************************************************\nbpython: A fancy interface to the Python interactive interpreter\n****************************************************************\n\n`bpython`_ is a lightweight Python interpreter that adds several features common\nto IDEs. These features include **syntax highlighting**, **expected parameter\nlist**, **auto-indentation**, and **autocompletion**. (See below for example\nusage).\n\n.. image:: https://bpython-interpreter.org/images/math.gif\n :alt: bpython\n :width: 566\n :height: 348\n :align: center\n\nbpython does **not** aim to be a complete IDE - the focus is on implementing a\nfew ideas in a practical, useful, and lightweight manner.\n\nbpython is a great replacement to any occasion where you would normally use the\nvanilla Python interpreter - testing out solutions to people's problems on IRC,\nquickly testing a method of doing something without creating a temporary file,\netc.\n\nYou can find more about bpython - including `full documentation`_ - at our\n`homepage`_.\n\n==========================\nInstallation & Basic Usage\n==========================\n\nInstallation using Pip\n----------------------\n\nIf you have `pip`_ installed, you can simply run:\n\n.. code-block:: bash\n\n $ pip install bpython\n\nStart bpython by typing ``bpython`` in your terminal. You can exit bpython by\nusing the ``exit()`` command or by pressing control-D like regular interactive\nPython.\n\n===================\nFeatures & Examples\n===================\n* Readline-like autocomplete, with suggestions displayed as you type.\n\n* In-line syntax highlighting. This uses Pygments for lexing the code as you\n type, and colours appropriately.\n\n* Expected parameter list. As in a lot of modern IDEs, bpython will attempt to\n display a list of parameters for any function you call. The inspect module (which\n works with any Python function) is tried first, and then pydoc if that fails.\n\n* Rewind. This isn't called \"Undo\" because it would be misleading, but \"Rewind\"\n is probably as bad. The idea is that the code entered is kept in memory and\n when the Rewind function is called, the last line is popped and the entire\n session is re-evaluated. Use <control-R> to rewind.\n\n* Edit the current line or your entire session in an editor. F7 opens the current\n session in a text editor, and if modifications are made, the session is rerun\n with these changes.\n\n* Pastebin code/write to file. Use the <F8> key to upload the screen's contents\n to pastebin, with a URL returned.\n\n* Reload imported Python modules. Use <F6> to clear sys.modules and rerun your\n session to test changes to code in a module you're working on.\n\n=============\nConfiguration\n=============\nSee the sample-config file for a list of available options. You should save\nyour config file as **~/.config/bpython/config** (i.e.\n``$XDG_CONFIG_HOME/bpython/config``) or specify at the command line::\n\n bpython --config /path/to/bpython/config\n\n============\nDependencies\n============\n* Pygments\n* curtsies >= 0.4.0\n* greenlet\n* pyxdg\n* requests\n* Sphinx >= 1.5 (optional, for the documentation)\n* babel (optional, for internationalization)\n* jedi (optional, for experimental multiline completion)\n* watchdog (optional, for monitoring imported modules for changes)\n* pyperclip (optional, for copying to the clipboard)\n\nbpython-urwid\n-------------\n``bpython-urwid`` requires the following additional packages:\n\n* urwid\n\n\n===================================\nInstallation via OS Package Manager\n===================================\n\nThe majority of desktop computer operating systems come with package management\nsystems. If you use one of these OSes, you can install ``bpython`` using the\npackage manager.\n\nUbuntu/Debian\n-------------\nUbuntu/Debian family Linux users can install ``bpython`` using the ``apt``\npackage manager, using the command with ``sudo`` privileges:\n\n.. code-block:: bash\n\n $ apt install bpython\n\nIn case you are using an older version, run\n\n.. code-block:: bash\n\n $ apt-get install bpython\n\nArch Linux\n----------\nArch Linux uses ``pacman`` as the default package manager; you can use it to install ``bpython``:\n\n.. code-block:: bash\n\n $ pacman -S bpython\n\nFedora\n------\nFedora users can install ``bpython`` directly from the command line using ``dnf``.\n\n.. code-block:: bash\n\n $ dnf install bpython\n \nGNU Guix\n----------\nGuix users can install ``bpython`` on any GNU/Linux distribution directly from the command line:\n\n.. code-block:: bash\n\n $ guix install bpython\n\nmacOS\n-----\nmacOS does not include a package manager by default. If you have installed any\nthird-party package manager like MacPorts, you can install it via\n\n.. code-block:: bash\n\n $ sudo port install py-bpython\n\n\n==========\nKnown Bugs\n==========\nFor known bugs please see bpython's `known issues and FAQ`_ page.\n\n======================\nContact & Contributing\n======================\nI hope you find it useful and please feel free to submit any bugs/patches\nsuggestions to `Robert`_ or place them on the GitHub\n`issues tracker`_.\n\nFor any other ways of communicating with bpython users and devs you can find us\nat the community page on the `project homepage`_, or in the `community`_.\n\nHope to see you there!\n\n.. _homepage: http://www.bpython-interpreter.org\n.. _full documentation: http://docs.bpython-interpreter.org/\n.. _issues tracker: http://github.com/bpython/bpython/issues/\n.. _pip: https://pip.pypa.io/en/latest/index.html\n.. _project homepage: http://bpython-interpreter.org\n.. _community: http://docs.bpython-interpreter.org/community.html\n.. _Robert: robertanthonyfarrell@gmail.com\n.. _bpython: http://www.bpython-interpreter.org/\n.. _Curses: http://www.lfd.uci.edu/~gohlke/pythonlibs/\n.. _pyreadline: http://pypi.python.org/pypi/pyreadline/\n.. _known issues and FAQ: http://bpython-interpreter.org/known-issues-and-faq.html\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "",
"version": "0.24",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0cd9b42a98f329a61a1b0c7d335644025773b05837669f775851d7eaece7973d",
"md5": "00d3aad5cf1607409dacf99b715794a3",
"sha256": "0d196ae3d1ce3dcd559a3fb89ed2c468dfbd1504af0d680b906dd65a9c7a32eb"
},
"downloads": -1,
"filename": "bpython-0.24-py3-none-any.whl",
"has_sig": false,
"md5_digest": "00d3aad5cf1607409dacf99b715794a3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 194939,
"upload_time": "2023-01-18T12:49:52",
"upload_time_iso_8601": "2023-01-18T12:49:52.584744Z",
"url": "https://files.pythonhosted.org/packages/0c/d9/b42a98f329a61a1b0c7d335644025773b05837669f775851d7eaece7973d/bpython-0.24-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "cf7654e0964e2974becb673baca69417b6c6293e930d4ebcf2a2a68c1fe9704a",
"md5": "bb7a556715be0b974436eb0d920769c0",
"sha256": "98736ffd7a8c48fd2bfb53d898a475f4241bde0b672125706af04d9d08fd3dbd"
},
"downloads": -1,
"filename": "bpython-0.24.tar.gz",
"has_sig": false,
"md5_digest": "bb7a556715be0b974436eb0d920769c0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 222879,
"upload_time": "2023-01-18T12:49:55",
"upload_time_iso_8601": "2023-01-18T12:49:55.171265Z",
"url": "https://files.pythonhosted.org/packages/cf/76/54e0964e2974becb673baca69417b6c6293e930d4ebcf2a2a68c1fe9704a/bpython-0.24.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-18 12:49:55",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "bpython"
}
JSON