8
8
:target: https://github.com/ambv/black
9
9
10
10
11
- ***********************************************************************
12
- bpython: A fancy curses interface to the Python interactive interpreter
13
- ***********************************************************************
11
+ ****************************************************************
12
+ bpython: A fancy interface to the Python interactive interpreter
13
+ ****************************************************************
14
14
15
15
`bpython `_ is a lightweight Python interpreter that adds several features common
16
16
to IDEs. These features include **syntax highlighting **, **expected parameter
34
34
You can find more about bpython - including `full documentation `_ - at our
35
35
`homepage `_.
36
36
37
- .. contents ::
38
- :local:
39
- :depth: 1
40
- :backlinks: none
41
-
42
37
==========================
43
38
Installation & Basic Usage
44
39
==========================
@@ -56,71 +51,6 @@ Start bpython by typing ``bpython`` in your terminal. You can exit bpython by
56
51
using the ``exit() `` command or by pressing control-D like regular interactive
57
52
Python.
58
53
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
-
124
54
===================
125
55
Features & Examples
126
56
===================
@@ -177,69 +107,73 @@ bpython-urwid
177
107
178
108
* urwid
179
109
180
- ==========
181
- Known Bugs
182
- ==========
183
- For known bugs please see bpython's `known issues and FAQ `_ page.
184
110
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
+ ===================================
191
114
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.
194
118
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:
196
123
197
- ===================
198
- CLI Windows Support
199
- ===================
124
+ .. code-block :: bash
200
125
201
- Dependencies
202
- ------------
203
- `Curses `_ Use the appropriate version compiled by Christoph Gohlke.
126
+ $ apt install bpython
204
127
205
- ` pyreadline `_ Use the version in the cheeseshop.
128
+ In case you are using an older version, run
206
129
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
211
131
212
- Current version is tested with
213
- ------------------------------
214
- * Curses 2.2
215
- * pyreadline 1.7
132
+ $ apt-get install bpython
216
133
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 `` :
220
137
221
- * red is swapped with blue
222
- * cyan is swapped with yellow
138
+ .. code-block :: bash
223
139
224
- To correct this I have provided a windows.theme file.
140
+ $ pacman -S bpython
225
141
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 ``.
228
145
146
+ .. code-block :: bash
229
147
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
233
156
234
- ` ptpython `_
157
+ $ sudo port install py-bpython
235
158
236
- `IPython `_
237
159
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!
240
176
241
- .. _ptpython : https://github.com/jonathanslenders/ptpython
242
- .. _ipython : https://ipython.org/
243
177
.. _homepage : http://www.bpython-interpreter.org
244
178
.. _full documentation : http://docs.bpython-interpreter.org/
245
179
.. _issues tracker : http://github.com/bpython/bpython/issues/
0 commit comments