--- name: "bpython3-config" section: "5" platform: "linux" package: "bpython3" version: "0.17.1-1" release: "Debian 10 (Buster)" platforms: ["linux"] url: "https://new.carta.tech/bpython3-config" --- # bpython3-config(5) user configuration file for bpython ## NAME bpython-config - user configuration file for bpython ## SYNOPSIS **$XDG\_CONFIG\_HOME/bpython/config** ## DESCRIPTION The configuration file contains various options controlling the behaviour of **bpython**. ## GENERAL This refers to the **\[general\]** section in your *$XDG\_CONFIG\_HOME/bpython/config* file. ### arg\_spec Display the arg spec (list of arguments) for callables, when possible (default: True). ### auto\_display\_list Display the autocomplete list as you type (default: True). When this is off, you can hit tab to see the suggestions. ### autocomplete\_mode There are three modes for autocomplete. simple, substring, and fuzzy. Simple matches methods with a common prefix, substring matches methods with a common subsequence, and fuzzy matches methods with common characters (default: simple). As of version 0.14 this option has no effect, but is reserved for later use. New in version 0.12. ### color\_scheme See themes for more information. Color schemes should be put in **$XDG\_CONFIG\_HOME/bpython/**. For example, to use the theme **$XDG\_CONFIG\_HOME/bpython/foo.theme** set **color\_scheme = foo** Leave blank or set to "default" to use the default (builtin) theme. ### complete\_magic\_methods Whether magic methods should be auto completed (default: True). ### dedent\_after Number of blank lines required before next line will be dedented (default: 1). If set to 0, automatic dedenting never occurs. ### editor Editor for externally editing the current line, session, or config file. New in version 0.13. ### flush\_output Whether to flush all output to stdout on exit (default: True). Only relevant to bpython-curses and bpython-urwid. ### highlight\_show\_source Whether the source code of an object should be syntax highlighted (default: True). ### hist\_duplicates Whether to store duplicate entries in the history (default: True). ### hist\_file History file (default: **~/.pythonhist**). ### hist\_length Number of lines to store in history (set to 0 to disable) (default: 100). ### paste\_time The time between keypresses before pastemode is deactivated in bpython-curses (default: 0.02). ### pastebin\_confirm Whether pasting to a pastebin needs to be confirmed before sending the data (default: True). ### pastebin\_expiry Time duration after which a paste should expire. Valid values are **1day**, **1week** and **1month** (default: **1week**). New in version 0.14. ### pastebin\_helper The name of a helper executable that should perform pastebin upload on bpython's behalf. If set, this overrides *pastebin\_url*. It also overrides *pastebin\_show\_url*, as the helper is expected to return the full URL to the pastebin as the first word of its output. The data is supplied to the helper via STDIN. An example helper program is **pastebinit**, available for most systems. The following helper program can be used to create *gists*: ``` #!/usr/bin/env python import sys import urllib2 import json def do_gist_json(s): """ Use json to post to github. """ gist_public = False gist_url = 'https://api.github.com/gists' data = {'description': None, 'public': None, 'files' : { 'sample': { 'content': None } }} data['description'] = 'Gist from BPython' data['public'] = gist_public data['files']['sample']['content'] = s req = urllib2.Request(gist_url, json.dumps(data), {'Content-Type': 'application/json'}) try: res = urllib2.urlopen(req) except HTTPError, e: return e try: json_res = json.loads(res.read()) return json_res['html_url'] except HTTPError, e: return e if __name__ == "__main__": s = sys.stdin.read() print do_gist_json(s) ``` New in version 0.12. ### pastebin\_show\_url The url under which the new paste can be reached. **$paste\_id** will be replaced by the ID of the new paste (default: *https://bpaste.net/show/$paste\_id/*). ### pastebin\_removal\_url The url under which a paste can be removed. **$removal\_id** will be replaced by the removal ID of the paste (default: *https://bpaste.net/remova/$removal\_id/*). New in version 0.14. ### pastebin\_url The pastebin url to post to (without a trailing slash). This pastebin has to be a pastebin which uses provides a similar interface to **bpaste.net**'s JSON interface (default: *https://bpaste.net/json/new*). ### save\_append\_py Whether to append **.py** to the filename while saving the input to a file. New in version 0.13. ### single\_undo\_time Time duration an undo must be predicted to take before prompting to undo multiple lines at once. Use -1 to never prompt, or 0 to always prompt. (default: 1.0) New in version 0.14. ### syntax Syntax highlighting as you type (default: True). ### tab\_length Soft tab size (default 4, see PEP-8). ### unicode\_box Whether to use Unicode characters to draw boxes. New in version 0.14. ## KEYBOARD This section refers to the **\[keyboard\]** section in your **$XDG\_CONFIG\_HOME/bpython/config**. You can set various keyboard shortcuts to be used by bpython. However, we have yet to map all keys to their respective control codes. If you configure a key combination which is not yet supported by bpython it will raise an exception telling you the key does not exist in bpython.keys. Valid keys are: - • Control + any alphanumeric character (C-a through C-z, also a few others). - • Any function key ranging from F1 to F12. ### backspace Default: C-h Delete character in front of the cursor. New in version 0.14. ### beginning\_of\_line Default: C-a Move to the beginning of the line. New in version 0.14. ### clear\_line Default: C-u Clears to the beginning of the line. ### clear\_screen Default: C-l Clears the screen to the top. ### clear\_word Default: C-w Clear the word the cursor is currently on. ### copy\_clipboard Default: F10 Copy the entire session to clipboard. New in version 0.14. ### cut\_to\_buffer Default: C-k Cuts the current line to the buffer. ### delete Default: C-d Delete character under the cursor. ### down\_one\_line Default: C-n Move the cursor down, by one line. ### edit\_config Default: F3 Edit bpython configuration in external editor. New in version 0.14. ### edit\_current\_block Default: C-x Edit current block in external editor. New in version 0.14. ### end\_of\_line Default: C-e Move to the of the line. New in version 0.14. ### exit Default: C-d Exits bpython (use on empty line) ### external\_editor Default: F7 Edit the entire session in an external editor. New in version 0.13. ### help Default: F1 Brings up sincerely cheerful description of bpython features and current key bindings. New in version 0.14. ### incremental\_search Default: M-s Perform incremental search on all stored lines in the history. New in version 0.15. ### last\_output Default: F9 Shows the last output in the systems $PAGER. Only works in bpython-curses. ### left Default: C-b Move a character to the left. New in version 0.14. ### pastebin Default: F8 ### reimport Default: F6 Reruns entire session, reloading all modules by clearing the sys.modules cache. New in version 0.14. ### reverse\_incremental\_search Default: M-r Perform reverse incremental search on all stored lines in the history. New in version 0.15. ### right Default: C-f Move a character to the right. New in version 0.14. ### save Default: C-s Saves the current session to a file (prompts for filename) ### search Default: C-o Search up for any lines containing what is on the current line. ### show\_source Default: F2 Shows the source of the currently being completed (python) function. ### toggle\_file\_watch Default: F5 Toggles file watching behaviour; re-runs entire bpython session whenever an imported module is modified. New in version 0.14. ### transpose\_chars Default: C-t Transpose current character with the one left of it. New in version 0.14. ### undo Default: C-r Rewinds the last action. ### up\_one\_line Default: C-p Move the cursor up, by one line. ### yank\_from\_buffer Default: C-y Pastes the current line from the buffer (the one you previously cutted) ## CLI This refers to the **\[cli\]** section in your config file. ### suggestion\_width Default: 0.8 The width of the suggestion window in percent of the terminal width. New in version 0.9.8. ### trim\_prompts Default: False Trims lines starting with '\>\>\> ' when set to True. ## CURTSIES This refers to the **\[curtsies\]** section in your config file. New in version 0.13. ### list\_above Default: False When there is space above the current line, whether the suggestions list will be displayed there instead of below the current line. ### right\_arrow\_completion Default: True Full line suggestion and completion (like fish shell and many web browsers). Full line completions are displayed under the cursor in gray. When the cursor is at the end of a line, pressing right arrow or ctrl-f will complete the full line. This option also turns on substring history search, highlighting the matching section in previous result. ## SAMPLE CONFIG ``` # This is a standard python config file # Valid values can be True, False, integer numbers, strings # By default bpython will look for $XDG_CONFIG_HOME/bpython/config # ($XDG_CONFIG_HOME defaults to ~/.config) or you can specify a file with the # --config option on the command line # # see http://docs.bpython-interpreter.org/configuration.html # for all configurable options # General section tag [general] # Display the autocomplete list as you type (default: True). # When this is off, you can hit tab to see the suggestions. # auto_display_list = True # Syntax highlighting as you type (default: True). # syntax = True # Display the arg spec (list of arguments) for callables, # when possible (default: True). # arg_spec = True # History file (default: ~/.pythonhist): # hist_file = ~/.pythonhist # Number of lines to store in history (set to 0 to disable) (default: 100): # hist_length = 100 # Soft tab size (default: 4, see pep-8): # tab_length = 4 # Color schemes should be put in $XDG_CONFIG_HOME/bpython/ e.g. to use the theme # $XDG_CONFIG_HOME/bpython/foo.theme set color_scheme = foo. Leave blank or set # to "default" to use the default theme # color_scheme = default # External editor to use for editing the current line, block, or full history # Default is to try $EDITOR and $VISUAL, then vi - but if you uncomment # the line below that will take precedence # editor = vi # Whether to append .py to the filename while saving session to a file. # (default: False) # save_append_py = False # The name of a helper executable that should perform pastebin upload on # bpython's behalf. If unset, bpython uploads pastes to bpaste.net. (default: ) #pastebin_helper = gist.py # How long an undo must be expected to take before prompting for how # many lines should be undone. Set to -1 to never prompt, or 0 to # always prompt. # single_undo_time = 1.0 # Enable autoreload feature by default (default: False). # default_autoreload = False [keyboard] # All key bindings are shown commented out with their default binding # pastebin = F8 # last_output = F9 # reimport = F6 # help = F1 # toggle_file_watch = F5 # save = C-s # undo = C-r # up_one_line = C-p # down_one_line = C-n # cut_to_buffer = C-k # search = C-o # yank_from_buffer = C-y # backspace = C-h # clear_word = C-w # clear_line = C-u # clear_screen = C-l # show_source = F2 # exit = C-d # external_editor = F7 # edit_config = F3 # reverse_incremental_search = M-r # incremental_search = M-s [curtsies] # Allow the the completion and docstring box above the current line # (default: False) # list_above = False # Enables two fish (the shell) style features: # Previous line key will search for the current line (like reverse incremental # search) and right arrow will complete the current line with the first match # from history. (default: True) # right_arrow_completion = True ``` ## AUTHOR **bpython** was written by Robert Anthony Farrell \<*robertanthonyfarrel@gmail.com*\> and his bunch of loyal followers. This manual page was written by Jørgen Pedersen Tjernø \<*jorgen@devsoft.no*\>, for the Debian project (but may be used by others). ## COPYRIGHT 2008-2018 Bob Farrell, Andreas Stuehrk et al.