1BPYTHON(1)                          0.24""                          BPYTHON(1)
2
3
4

NAME

6       bpython - a fancy {curtsies, curses, urwid} interface to the Python in‐
7       teractive interpreter
8

SYNOPSIS

10       bpython [options] [file [args]]
11
12       bpython-curses [options] [file [args]]
13
14       bpython-urwid [options] [file [args]]
15

DESCRIPTION

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
21       In-line syntax highlighting.
22              Highlights commands as you type!
23
24       Readline-like autocomplete with suggestions displayed as you type.
25              Press tab to complete expressions when there's only one  sugges‐
26              tion.
27
28       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
32       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
38       Pastebin code/write to file.
39              This  posts  the  current  buffer  to a pastebin (bpaste.net) or
40              writes it to a file.
41
42       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

OPTIONS

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
52       The following options are supported by all frontends:
53
54       --config=<config>
55              Use <config> instead of default config file.
56
57       -h, --help
58              Show the help message and exit.
59
60       -i, --interactive
61              Drop to bpython shell after running file instead of exiting. The
62              PYTHONSTARTUP file is not read.
63
64       -q, --quiet
65              Do not flush the output to stdout.
66
67       -V, --version
68              Print bpython's version and exit.
69
70       -l <level>, --log-level=<level>
71              Set logging level
72
73       -L <file>, --log-output=<file>
74              Set log output file
75
76       In  addition  to the above options, bpython also supports the following
77       options:
78
79       -p file, --paste=file
80              Paste in the contents of a file at startup.
81
82       In addition to the common options, bpython-urwid also supports the fol‐
83       lowing options if Twisted is available:
84
85       -r <reactor>, --reactor=<reactor>
86              Use Twisted's <reactor> instead of urwid's event loop.
87
88       --help-reactors
89              Display a list of available Twisted reactors.
90
91       -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
95       -s <port>, --server=<port>
96              Run an eval server on port <port>. This option forces the use of
97              a Twisted reactor.
98

KEYS

100       bpython's       keys       are       fully       configurable.      See
101       http://docs.bpython-interpreter.org/configuration.html#keyboard
102

FILES

104       $XDG_CONFIG_HOME/bpython/config
105
106       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

KNOWN BUGS

111       See http://github.com/bpython/bpython/issues/ for a list of  known  is‐
112       sues.
113

SEE ALSO

115       bpython-config(5), python(1)
116

AUTHOR

118       bpython     was     written    by    Robert    Anthony    Farrell    <‐
119       robertanthonyfarrel@gmail.com> and his bunch of loyal followers.
120
121       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
128
129
130
131                                 Jul 19, 2023                       BPYTHON(1)
Impressum