1BPYTHON(1)                          bpython                         BPYTHON(1)
2
3
4

NAME

6       bpython  -  a  fancy  {curtsies, curses, urwid} interface to the Python
7       interactive 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              Hilights 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       In  addition  to the above options, bpython also supports the following
71       options:
72
73       -L, --log
74              Write debugging messages to the file bpython.log.  Use  -LL  for
75              more verbose logging.
76
77       -p file, --paste=file
78              Paste in the contents of a file at startup.
79
80       In addition to the common options, bpython-urwid also supports the fol‐
81       lowing options if Twisted is available:
82
83       -r <reactor>, --reactor=<reactor>
84              Use Twisted's <reactor> instead of urwid's event loop.
85
86       --help-reactors
87              Display a list of available Twisted reactors.
88
89       -p <plugin>, --plugin=<plugin>
90              Execute a twistd plugin. Use twistd to get a list  of  available
91              plugins. Use -- to pass options to the plugin.
92
93       -s <port>, --server=<port>
94              Run an eval server on port <port>. This option forces the use of
95              a Twisted reactor.
96

KEYS

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

FILES

102       $XDG_CONFIG_HOME/bpython/config
103
104       Your bpython config. See sample-config (in /usr/share/doc/bpython/exam‐
105       ples on Debian) for various options you can use, or  read  bpython-con‐
106       fig(5).
107

KNOWN BUGS

109       See  http://github.com/bpython/bpython/issues/  for  a  list  of  known
110       issues.
111

SEE ALSO

113       bpython-config(5), python(1)
114

AUTHOR

116       bpython    was    written    by    Robert    Anthony     Farrell     <‐
117       robertanthonyfarrel@gmail.com> and his bunch of loyal followers.
118
119       This   manual   page   was   written   by  Jørgen  Pedersen  Tjernø  <‐
120       jorgen@devsoft.no>, for the Debian project (but may be used by others).
121
123       2008-2015 Bob Farrell, Andreas Stuehrk et al.
124
125
126
127
128 0.18                            May 14, 2019                       BPYTHON(1)
Impressum