Brython #40

metaperl · 2024-08-04T17:57:58Z

metaperl
Aug 4, 2024
Maintainer

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>

    <head>
        <script type="text/javascript" src="/path/to/brython.js"></script>
    </head>

    <body>

        <script type="text/python">
        from browser import document, alert

        def echo(event):
            alert(document["zone"].value)

        document["mybutton"].bind("click", echo)
        </script>

        <input id="zone"><button id="mybutton">click !</button>

    </body>

</html>

To use Brython, all there is to do is:

Load the script brython.js.
Write Python code inside tags <script type="text/python">.

Main features

Brython supports the syntax of Python 3,
including comprehensions, generators, metaclasses, imports, etc.
and many modules of the CPython distribution.

Since version 3.8.0, Brython implements the Python version of the same major /
minor version number.

It includes libraries to interact with DOM elements and events,
and with existing Javascript libraries such as jQuery, D3, Highcharts, Raphael etc.
It supports the latest specs of HTML5/CSS3, and can use CSS Frameworks like
Bootstrap3, LESS, SASS etc.

Getting started

Zero install !

The most simple way to get started, without anything to install, is to use the
distribution available online through jsDelivr.
You can choose the latest stable release :

<script type="text/javascript"
    src="https://cdn.jsdelivr.net/npm/[email protected]/brython.min.js">
</script>

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:

<script type="text/javascript"
    src="https://cdn.jsdelivr.net/npm/[email protected]/brython_stdlib.js">
</script>

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

<script type="text/javascript"
    src="https://cdn.jsdelivr.net/npm/[email protected]/brython.min.js">
</script>
<script type="text/javascript"
    src="https://cdn.jsdelivr.net/npm/[email protected]/brython_stdlib.js">
</script>

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

<script type="text/javascript"
    src="https://cdn.jsdelivr.net/npm/brython@3/brython.min.js">
</script>
<script type="text/javascript"
    src="https://cdn.jsdelivr.net/npm/brython@3/brython_stdlib.js">
</script>

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

<script src="https://raw.githack.com/brython-dev/brython/master/www/src/brython.js"
        crossorigin="anonymous">
</script>
<script src="https://raw.githack.com/brython-dev/brython/master/www/src/brython_stdlib.js"
        crossorigin="anonymous">
</script>

Local install

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

pip install brython

then create a new directory and run

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:

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 and
French.

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.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Brython #40

{{title}}

Replies: 0 comments

Select a reply

Brython #40

metaperl Aug 4, 2024 Maintainer

brython

Main features

Getting started

Zero install !

Local install

Test Brython online

Gallery of examples

Documentation

Community (questions, feedback, issues, new features, ...)

Thank you

Replies: 0 comments

metaperl
Aug 4, 2024
Maintainer