1BPYTHON(1) 0.24"" BPYTHON(1)
2
6 bpython - a fancy {curtsies, curses, urwid} interface to the Python in‐
7 teractive interpreter
8
10 bpython [options] [file [args]]
11 bpython-curses [options] [file [args]]
13 bpython-urwid [options] [file [args]]
15
17 The idea is to provide the user with all the features in-line, much
18 like modern IDEs, but in a simple, lightweight package that can be run
19 in a terminal window.
20 In-line syntax highlighting.
22 Highlights commands as you type!
23 Readline-like autocomplete with suggestions displayed as you type.
25 Press tab to complete expressions when there's only one sugges‐
26 tion.
27 Expected parameter list.
29 This displays a list of parameters for any function you call. It
30 uses the inspect module, then tries pydoc.
31 Rewind.
33 This is a bit misleading, but it code that has been entered is
34 remembered, and when you Rewind, it pops the last line and
35 re-evaluates the entire code. This is error-prone, and mostly
36 useful for defining classes and functions.
37 Pastebin code/write to file.
39 This posts the current buffer to a pastebin (bpaste.net) or
40 writes it to a file.
41 Flush curses screen to stdout.
43 Unlike other curses apps, bpython dumps the screen data to std‐
44 out when you quit, so you see what you've done in the buffer of
45 your terminal.
46
48 The long and short forms of options, shown here as alternatives, are
49 equivalent. If bpython sees an argument it does not know, execution
50 falls back to the regular Python interpreter.
51 The following options are supported by all frontends:
53 --config=<config>
55 Use <config> instead of default config file.
56 -h, --help
58 Show the help message and exit.
59 -i, --interactive
61 Drop to bpython shell after running file instead of exiting. The
62 PYTHONSTARTUP file is not read.
63 -q, --quiet
65 Do not flush the output to stdout.
66 -V, --version
68 Print bpython's version and exit.
69 -l <level>, --log-level=<level>
71 Set logging level
72 -L <file>, --log-output=<file>
74 Set log output file
75 In addition to the above options, bpython also supports the following
77 options:
78 -p file, --paste=file
80 Paste in the contents of a file at startup.
81 In addition to the common options, bpython-urwid also supports the fol‐
83 lowing options if Twisted is available:
84 -r <reactor>, --reactor=<reactor>
86 Use Twisted's <reactor> instead of urwid's event loop.
87 --help-reactors
89 Display a list of available Twisted reactors.
90 -p <plugin>, --plugin=<plugin>
92 Execute a twistd plugin. Use twistd to get a list of available
93 plugins. Use -- to pass options to the plugin.
94 -s <port>, --server=<port>
96 Run an eval server on port <port>. This option forces the use of
97 a Twisted reactor.
98
100 bpython's keys are fully configurable. See
101 http://docs.bpython-interpreter.org/configuration.html#keyboard
102
104 $XDG_CONFIG_HOME/bpython/config
105 Your bpython config. See sample-config (in /usr/share/doc/bpython/exam‐
107 ples on Debian) for various options you can use, or read bpython-con‐
108 fig(5).
109
111 See http://github.com/bpython/bpython/issues/ for a list of known is‐
112 sues.
113
115 bpython-config(5), python(1)
116
118 bpython was written by Robert Anthony Farrell <‐
119 robertanthonyfarrel@gmail.com> and his bunch of loyal followers.
120 This manual page was written by Jørgen Pedersen Tjernø <‐
122 jorgen@devsoft.no>, for the Debian project (but may be used by others).
123
125 2008-2023 Bob Farrell, Andreas Stuehrk, Sebastian Ramacher, Thomas
126 Ballinger, et al.
127 Jul 19, 2023 BPYTHON(1)