Frequently asked questions

Syntax, keywords and built-in functions

Standard distribution

import implementation

Brython packages

Browser interface

Brython-specific built-in modules

Working with Brython



Options of function brython()

To run the Python scripts in the page, you must call the function brython() on page load.

<body onload="brython([options])">

options can be an integer, in this case it is the debug level :

  • 0 (default) : no debugging. Use this when the application is debugged, it slightly speeds up execution
  • 1 : error messages are printed in the browser console (or to the output stream specified by sys.stderr)
  • 2 : the translation of Python code into Javascript code is printed in the console
  • 10 : the translation of Python code and of the imported modules is printed in the console

options can be a Javascript object, its keys can be

  • debug : debug level (see above)
  • static_stdlib_import : boolean, indicates if, in order to import modules or packages from the standard library, the static mapping table in the script stdlib_paths.js should be used. Defaults to true
  • pythonpath : a list of paths where imported modules should be searched
  • ipy_id : by default, the function brython() runs all the scripts in the page. This option specifies a list of element identifiers (tag attribute id) whose text content must be run as Python code. See brythonmagic for more information
  • indexedDB : specifies if the program can use the indexedDB database to store a compiled version of the modules located in brython_stdlib.js or brython_modules.js. Defaults to true.

Example of brython options usage:

brython({debug:1, ipy_id:['hello']})

will run the content of the element with id "hello" with debug level 1