88:target: https://github.com/ambv/black
99
1010
11- ***********************************************************************
12- bpython: A fancycurses interface to the Python interactive interpreter
13- ***********************************************************************
11+ ****************************************************************
12+ bpython: A fancy interface to the Python interactive interpreter
13+ ****************************************************************
1414
1515`bpython `_ is a lightweight Python interpreter that adds several features common
1616to IDEs. These features include **syntax highlighting **, **expected parameter
3434You can find more about bpython - including `full documentation `_ - at our
3535`homepage `_.
3636
37- ..contents ::
38- :local:
39- :depth: 1
40- :backlinks: none
41-
4237==========================
4338Installation & Basic Usage
4439==========================
@@ -56,71 +51,6 @@ Start bpython by typing ``bpython`` in your terminal. You can exit bpython by
5651using the ``exit() `` command or by pressing control-D like regular interactive
5752Python.
5853
59- Installation via OS Package Manager
60- -----------------------------------
61-
62- The majority of desktop computer operating systems come with package management
63- systems. If you use one of these OSes, you can install ``bpython `` using the
64- package manager.
65-
66- Ubuntu/Debian
67- ~~~~~~~~~~~~~
68- Ubuntu/Debian family Linux users can install ``bpython `` using the ``apt ``
69- package manager, using the command with ``sudo `` privileges:
70-
71- ..code-block ::bash
72-
73- $ apt install bpython
74-
75- In case you are using an older version, run
76-
77- ..code-block ::bash
78-
79- $ apt-get install bpython
80-
81- Arch Linux
82- ~~~~~~~~~~
83- Arch Linux uses ``pacman `` as the default package manager; you can use it to install ``bpython ``:
84-
85- ..code-block ::bash
86-
87- $ pacman -S bpython
88-
89- Fedora
90- ~~~~~~~~~~
91- Fedora users can install ``bpython `` directly from the command line using ``dnf ``.
92-
93- ..code-block ::bash
94-
95- $ dnf install bpython
96-
97- Windows
98- ~~~~~~~
99- **Caveats: ** As ``bpython `` makes use of the ncurses library of\* nix-family operating systems,
100- bpython on Windows is not officially supported and tested.
101-
102- However, you may still use bpython on Windows using a workaround. In brief, you should install
103- these two packages using ``pip ``:
104-
105- ..code-block ::bash
106-
107- $ pip install bpython windows-curses
108-
109- Then you should invoke a program called ``bpython-curses.exe `` instead of ``bpython.exe `` to use bpython:
110-
111- ..code-block ::bash
112-
113- $ bpython-curses
114-
115- Mac OS
116- ~~~~~~
117- Like Windows, Mac OS does not include a package manager by default. If you have installed any
118- third-party package manager like MacPorts, you can install it via
119-
120- ..code-block ::bash
121-
122- $ sudo port install py-bpython
123-
12454===================
12555Features & Examples
12656===================
@@ -177,69 +107,73 @@ bpython-urwid
177107
178108* urwid
179109
180- ==========
181- Known Bugs
182- ==========
183- For known bugs please see bpython's `known issues and FAQ `_ page.
184110
185- ======================
186- Contact & Contributing
187- ======================
188- I hope you find it useful and please feel free to submit any bugs/patches
189- suggestions to `Robert `_ or place them on the GitHub
190- `issues tracker `_.
111+ ===================================
112+ Installation via OS Package Manager
113+ ===================================
191114
192- For any other ways of communicating with bpython users and devs you can find us
193- at the community page on the `project homepage `_, or in the `community `_.
115+ The majority of desktop computer operating systems come with package management
116+ systems. If you use one of these OSes, you can install ``bpython `` using the
117+ package manager.
194118
195- Hope to see you there!
119+ Ubuntu/Debian
120+ -------------
121+ Ubuntu/Debian family Linux users can install ``bpython `` using the ``apt ``
122+ package manager, using the command with ``sudo `` privileges:
196123
197- ===================
198- CLI Windows Support
199- ===================
124+ ..code-block ::bash
200125
201- Dependencies
202- ------------
203- `Curses `_ Use the appropriate version compiled by Christoph Gohlke.
126+ $ apt install bpython
204127
205- ` pyreadline `_ Use the version in the cheeseshop.
128+ In case you are using an older version, run
206129
207- Recommended
208- -----------
209- Obtain the less program from GnuUtils. This makes the pager work as intended.
210- It can be obtained from cygwin or GnuWin32 or msys
130+ ..code-block ::bash
211131
212- Current version is tested with
213- ------------------------------
214- * Curses 2.2
215- * pyreadline 1.7
132+ $ apt-get install bpython
216133
217- Curses Notes
218- ------------
219- The curses used has a bug where the colours are displayed incorrectly :
134+ Arch Linux
135+ ----------
136+ Arch Linux uses `` pacman `` as the default package manager; you can use it to install `` bpython `` :
220137
221- * red is swapped with blue
222- * cyan is swapped with yellow
138+ ..code-block ::bash
223139
224- To correct this I have provided a windows.theme file.
140+ $ pacman -S bpython
225141
226- This curses implementation has 16 colors (dark and light versions of the
227- colours)
142+ Fedora
143+ ------
144+ Fedora users can install ``bpython `` directly from the command line using ``dnf ``.
228145
146+ ..code-block ::bash
229147
230- ============
231- Alternatives
232- ============
148+ $ dnf install bpython
149+
150+ macOS
151+ -----
152+ macOS does not include a package manager by default. If you have installed any
153+ third-party package manager like MacPorts, you can install it via
154+
155+ ..code-block ::bash
233156
234- ` ptpython `_
157+ $ sudo port install py-bpython
235158
236- `IPython `_
237159
238- Feel free to get in touch if you know of any other alternatives that people
239- may be interested to try.
160+ ==========
161+ Known Bugs
162+ ==========
163+ For known bugs please see bpython's `known issues and FAQ `_ page.
164+
165+ ======================
166+ Contact & Contributing
167+ ======================
168+ I hope you find it useful and please feel free to submit any bugs/patches
169+ suggestions to `Robert `_ or place them on the GitHub
170+ `issues tracker `_.
171+
172+ For any other ways of communicating with bpython users and devs you can find us
173+ at the community page on the `project homepage `_, or in the `community `_.
174+
175+ Hope to see you there!
240176
241- .. _ptpython :https://github.com/jonathanslenders/ptpython
242- .. _ipython :https://ipython.org/
243177.. _homepage :http://www.bpython-interpreter.org
244178.. _full documentation :http://docs.bpython-interpreter.org/
245179.. _issues tracker :http://github.com/bpython/bpython/issues/