brython

brython
=======

Brython (Browser Python) is an implementation of Python 3 running in the
browser, with an interface to the DOM elements and events.

Here is a simple example of an HTML page running Python:

``html










click !




`

To use Brython, all there is to do is:

1. Load the script brython.js.
2. Run the function brython() on page load, like .
3. Write Python code inside tags
`

The previous code will allow you to use raw python code, but if you import
modules from the standard library you have to load a single javascript file
with the available stdlib:

`html

`

jsDelivr supports version ranges, so if you want the latest of the
3.10.x versions:

`html


`

or the latest of the 3.x.y versions:

`html


`

If you want to use the latest development version, you can load these scripts
instead:
`html


`

Local install
-------------
To install Brython locally, if you have a CPython distribution with pip :

`bash
pip install brython
`

then create a new directory and run

`bash
brython-cli --install
``

or by loading the latest version of the Brython zip file from the
releases page.

In both cases, the distribution includes __brython.js__ (the core Brython engine)
and __brython_stdlib.js__ (a bundle of all the files in the standard distribution).

It also includes the page __demo.html__ that shows a few examples of how you
can interact with a web page using Python as the scripting language : create
new elements, access and modify existing elements, create graphics, animations,
send Ajax requests, etc.

Test Brython online
===================
If you want to test Brython online you can visit the following:

- Editor
- Console


Gallery of examples
===================
There is a gallery of examples
where you can see simple and advanced examples using vanilla Brython or
interacting with Javascript libraries.


Documentation
=============
You can start by reading the official Brython tutorial.

Full documentation is available on the official site.
You can read the docs in English,
French and
Spanish.

The most updated docs usually are the English and French versions so if you
want to be up-to-date, please, use these versions.

Curious about how Brython works ?

A tutorial
explains how to build Android applications with Brython.

Community (questions, feedback, issues, new features, ...)
==========================================================
You can subscribe and post to the
mailing list.

If you find a bug/issue or do you want to see a new feature in Brython, please,
open a new issue.

If you want to contribute to Brython, please read the contributing guide.

Thank you
=========

- BrowserStack for providing an access
to their online testing environment.