Brython (Browser Python) is an implementation of Python 3 running in the browser

Last update: Jan 02, 2023

Related tags

Overview

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 onload="brython()">

            <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.
Run the function brython() on page load, like <body onload="brython()">.
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.9.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/[email protected]/brython.min.js">
</script>
<script type="text/javascript"
    src="https://cdn.jsdelivr.net/npm/[email protected]/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"></script>
<script src="https://raw.githack.com/brython-dev/brython/master/www/src/brython_stdlib.js"></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, 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.

Comments

documentation on how to package libraries for brython

If I want to use a package from PyPI in Brython, what do I do? Right now I am manually adding packages or symlinks to a fork of brython, but it would be nice to be able to use Pip for this.

Until Brython has Pip (or something like it), at least some documentation around conventions for how to write and use libraries would be nice.

opened by glyph 42
Brython dict() can't handle nested JS Object Literals (dict's)
Hello,

I've attempted correcting this in the source, but I'm too new to Brython to make sure I'm doing a good job - I see the creation of a dict requires issues with future updates to the JSObj, etc.

The problem is simple to replicate. Assuming an Object Literal from a function like this:

do_list = function(){ return {1:'one', 2:'two', 3:'three', 4:{ 'big_bad_wolf':1 }} }

in Brython:

js_dict = window.do_list() print(js_dict)

I see in line 304 of py_dict.js looping across the object, assigning the value to the new dict. Everything is fine until it hits item 4, where I see it assigns an Object to the value, so it's packing an un-wrapped JS Object into the brython dict.

The error is expressed as:

Uncaught Error: TypeError: Cannot read property 'mro' of undefined

.. depending on how I'm accessing the dict, because it can't find what it for that object.

If someone with more skill with Brython could fix this for me, I'd appreciate it.

Thanks.
opened by cforger 37
nested scopes are overwritten when the enclosing function is called again

To start, let me say that I know that this is a terrible bug report; I tried to get a minimal reproducing case and I was unable to do so. I'm reporting it in the hopes that someone who knows brython's internals better than I do might be able to point me in the right direction to reproduce it.

I'm working on a Brython-compatible port of Twisted's Deferred, here: https://github.com/glyph/deferred/tree/brython. This is in service of creating a client-side framework sort sharing idioms with Twisted, here: https://github.com/glyph/brytly.

The problem is here:

https://github.com/glyph/brytly/blob/master/brytly/phantestic.py#L29

Basically, I have the same lambda callback either way; but if I define it in the arg list of addBoth, then it appears self takes on the wrong value in its closure. You can see that if you load up test.html in a browser (after symlinking both these projects into site-packages in a brython checkout, which is the only way I've figured out how to "install" stuff, hence my filing of #119) with the assigned-to-a-variable lambda, the test run completes, but with the defined-in-the-arg-list lambda, it gets stuck and runs SuiteRun.keepGoing for MyTest twice, instead of properly running it once for MyTest and then once for the Root suite generated by the framework.

Again, sorry I couldn't make this example more minimal; it seems to be a very tricky failure mode.

By the way, I should note that Brython has come a long way in the last year - when I first took a look at doing this it would have been basically impossible. So thanks a lot for all the hard work!

opened by glyph 35

Perfomance Issue

I have tested the simple code with Brython and Javascript:

<!doctype html>
<html>
    <head>
        <meta charset="utf-8">
        <script src="brython.js"></script>
        <script src="brython_modules.js"></script>
    </head>

    <body onload="brython(1)">
        <script type="text/python">
            from browser import console

            console.time('python')
            list = []
            i = 0
            while i < 100000:
                list.append(i)
                i += 1
            console.timeEnd('python')
        </script>
        <script>
            console.time('javascript')
            var list = [];
            for (var i = 0; i <= 100000; i++) {
                list.push(i);
            }
            console.timeEnd('javascript')
        </script>
        <div id="root"></div>
    </body>
</html>

And the results in Chrome are the following:

javascript: 2.59716796875ms
brython.js:5316 using indexedDB for stdlib modules cache
brython.js:9073 python: 289.85302734375ms

Profiling from Chrome is attached:

Profile-20200617T123405.zip

Also according the report Brython seems to be only 3 times slower ... strange ...

Seems like it should be investigated as time will be ...

opened by redradist 33

including source maps, to allow for debugging python with in-browser debugger

I've been trying to debug #121 and it has been very challenging to do so because it's not possible to get a JavaScript debugger to set a breakpoint in a Python file.

If you could easily do ahead-of-time compilation (emitting, let's say, .pyc.js files next to the .py files), it would at least be possible to set breakpoints in the generated JavaScript source. Even better, with pre-generated source files we could potentially have source maps which would facilitate actually debugging Python code with a JavaScript debugger.

Is this already possible? I searched the documentation, but maybe I'm just not looking for the right string.

opened by glyph 28
Research and Implement simplified way to add Brython to a page
Research and Implement a simplified way to add Brython to a page.

1 line added to add Brython to a existing page. K.I.S.S.

Move the onLoad somewhere?, bind a callback?, on url parameter?, something else?

Update Docs to reflect that change. Add Async and Defer script tag attributes to Docs?

Context: https://github.com/brython-dev/brython/commit/5c5c44e905da4560712118f630ad5566a65fbb72#commitcomment-8631942

https://github.com/brython-dev/brython/commit/e770f9e55b1a8647e532295a300b59dd712852a5

:pensive:
opened by ghost 25
The dictionary implementation is painfully slow

The performance is really suboptimal. Looking at the code, it quickly becomes clear why: To find an object, the whole dictionary is searched in a loop (i.e. https://github.com/brython-dev/brython/blob/e1dc7b4575280dd7a00e3012890c7c2533d48e32/src/py_dict.js#L68). I expected to find some sort of hash map. Don't python objects have hash functions or the like? I don't know, but I guess it would be possible to find something. :-) Anyhow - I converted the hash maps into arrays to solve the performance issues and am very happy with Brython, it is a great project. To who it may concern: Thank you for all the hard work and making it available open source!
enhancement help wanted in progress

opened by Pfiver 21
possible silent overflow of larger ints

Hi, I only recently tested Brython and am pretty amazed - thanks for providing this implementation!

While experimentig in the interactive mode, I noticed an unexpected behaviour for larger ints, which may indicate silent overflows; floats are more sensible in this case. cf. the following results (using Opera 27 dev on win 7):

Brython 3.0.0 on Netscape 5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/40.0.2188.2 Safari/537.36 OPR/27.0.1683.0 (Edition developer)

[(x,2**x) for x in range(68,80)] [(68, 295147905179352830000), (69, 590295810358705700000), (70, 1), (71, 2), (72, 4), (73, 9), (74, 1), (75, 3), (76, 7), (77, 1), (78, 3), (79, 6)] [(x,2.0**x) for x in range(68,80)] [(68, 295147905179352830000.0), (69, 590295810358705700000.0), (70, 1.1805916207174113e+21), (71, 2.3611832414348226e+21), (72, 4.722366482869645e+21), (73, 9.44473296573929e+21), (74, 1.888946593147858e+22), (75, 3.777893186295716e+22), (76, 7.555786372591432e+22), (77, 1.5111572745182865e+23), (78, 3.022314549036573e+23), (79, 6.044629098073146e+23)]

Some oddities also appear at the bounds of the float type - the integers start to appear as NaNs:

[(x,2**x) for x in range(1020,1030)] [(1020, 1), (1021, 2), (1022, 4), (1023, 8), (1024, NaN), (1025, NaN), (1026, NaN), (1027, NaN), (1028, NaN), (1029, NaN)] [(x,2.0**x) for x in range(1020,1030)] [(1020, 1.1235582092889474e+307), (1021, 2.247116418577895e+307), (1022, 4.49423283715579e+307), (1023, 8.98846567431158e+307), (1024, inf), (1025, inf), (1026, inf), (1027, inf), (1028, inf), (1029, inf)]

I currently don't have usecases for such calculations in Brython, but I'd prefer a more transparent handling of these cases; probably raising an exception (as the generally unlimited precission of int in python probably isn't available in the underlying javascript).

regards, vbr
bug help wanted

opened by vbr 20
code.interact() does not work right
And neither does import pdb; pdb.set_trace(), which is what I really wanted, but I get further with interact().

I put

import code code.interact()

in the <script> tag. On page load, I get the expected >>> prompt (in a pop up, but OK, it's a web page). If I give it a simple input, like 1, I get another >>> prompt, as expected, but the 1 doesn't seem to have printed anywhere, not even in the browser developer tools' JS console, which is where you see the output of a print call, even though the interact banner printed to the console.

Python 3.3.0 (default, 2018-04-17 08:26:29.400878) [Javascript 1.5] on Brython on brython Type "help", "copyright", "credits" or "license" for more information. (InteractiveConsole)

However, entering print(1) at the pop-up prompt does produce output in the JS console.

Also, multi-line inputs completely crash. If I enter def foo(): I expect the next prompt to be ... so I can do the next line, but this just crashes. I don't get another prompt.

If Brython's aim is to be a drop-in replacement for client-side JavaScript, we need some kind of interactive console. Python's just not the same without it. It seems like this should be possible, considering that a bookmarklet like Firebug Lite could inject developer tools in the web page and we already have a demo console. It doesn't seem like much of a stretch to have something like IDLE embedded in a bookmarklet, but pdb.set_trace() didn't work right in the demo console either, so I don't know.
opened by gilch 19
import is very slow

I tried to report this on #123 along with a whole bunch of other related issues, but I think it would be good to have a separate issue that calls out this one specific thing.

Importing modules on brython is slow. Unacceptably slow, in my opinion, because one of the major advantages of Python over JS for in-browser development is the very nice module system, and brython punishes you for using it with very slow import times.

The solution proposed on #123 is to implement a way to pre-generate .pyc.js files, since the transpiler is a clear bottleneck in import; but that is a proposed solution, so this issue is specifically for the problem of import being slow, if others wish to address it some other way.

opened by glyph 19
Some general questions/suggestions

Hi, great and interesting project, just few questions/suggestions: 1- Why you don't use the default python tokenizer module converted to Javascript because it is much simpler and battle tested, the current implementation is a bit bloated, plus there are many bugs which I can of course contribute/report (mainly related with error tokens and the start/end range). 2- Why not using ANTLR to generate the parse tree (ANTLR python grammar is already defined and battle tested and the Javascript or python runtimes are also available+ possibility to interface any python version like 2.x which is out the scope of this project + possibility to get inspired from other projects like Jython) and thus the whole project will consist of a visitor which will have all the transform methods migrated to. 3- Implementing 2 will give an easier out-of-the-box implementation of the ast module which is unimplemented currently. 4- Why not using a safer typed language like Typescript and divide the transpiler into smaller chunks using better OOP paradigms(an ultimate goal is the whole project written in python and which it can transpile itself to Javascript)

opened by deadlocklogic 18
String encode utf-8 boundary case errors
The following test cases are failing. The problem seems to be in py_bytes.js, where < should be changed to <=.

assert '\u007f'.encode('utf-8') == b'\x7f' assert '\u07ff'.encode('utf-8') == b'\xdf\xbf' assert '\uffff'.encode('utf-8') == b'\xef\xbf\xbf'
opened by mircea3 0

The calendar module is not working

Hello,

The calendar module is not working. I can import the module, but when I try to generate a calendar it fails.

Script:

import calendar

cal = calendar.calendar(2023)

Error message:

brython.min.js:1 Traceback (most recent call last):
  File "http://127.0.0.1:5500/a-model.html#__main__", line 3, in <module>
    cal = calendar.calendar(2023)
  File "VFS.calendar.py", line 389, in formatyear
    a(formatstring(names,colwidth,c).rstrip())
      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "VFS.calendar.py", line 646, in formatstring
    return spacing.join(c.center(colwidth)for c in cols)
           ^^^^^^^^^^^^
AttributeError: 'int' object has no attribute 'join'

opened by tdmsilvino 0

modules used on a worker thread are not cached in indexedDB

As far as I can tell, the modules used on a worker thread are not cached into the indexedDB. Is this a known limitation? In my case, most of my python code is running in a worker, so I expect my load times would improve with indexedDB caching of worker thread modules.

opened by benjie-git 1
import datetime is very slow

As the subject says. (I do not if that qualifies as a bug, more a hint for improvements) I have profiled all import times for all "customers" of a web site made in Brython and came to this conclusion.

opened by lefranco 6
Brython recent version cannot run on Midori

Lubuntu 2210

brython-cli --version -> Brython version 3.11.0

sudo snap install midori -> midori browser installed

run midori go to site made with brython https://diplomania-gen.fr/ working fine with edge, safari, firefox, chrome

no page CTRL + shift + I

three errors :

SyntaxError: No identifiers allowed directly after numeric literal brython.js:8021

ReferenceError: Can't find variable: BRYTHON brython_modules.js:1

ReferenceError: Can't find variable: brython onload diplomania-gen.fr:21

(no such errors at least on chrome/firefox) Is midora missng a feature required by brython produces code ?

opened by lefranco 1
Problem with ajax

In version 3.10.7 ajax.form_data() does not work. (I am aware that you know this) In version 3.11.0 this problem is solved, but it now creates now an error on ajax.file_upload() in the same program. No errors with 3.10.7

JavaMessages.txt

opened by rpietsch1953 2

Releases(3.11)

3.11(Oct 24, 2022)
This version, released on the same day as CPython 3.11, supports most of its new features, notably:

PEP 654 – Exception Groups and except *

PEP 657 – Include Fine Grained Error Locations in Tracebacks

PEP 678 – Enriching Exceptions with Notes

Source code(tar.gz)
Source code(zip)
Brython-3.11.0.tar.bz2(1.24 MB)
Brython-3.11.0.tar.gz(1.43 MB)
Brython-3.11.0.zip(1.45 MB)
changelog_3.11.0.txt(7.24 KB)
3.10.7(Sep 17, 2022)

The main visible feature in this release is a major performance improvement for operations on basic types (integers, floats, strings).

It also includes a new Implementation of many important internal features (execution frames, exception management).

The Travis CI tools have been updated and restored (thanks to Evan Mallory and Christian Clauss), making sure that the integrated test suite runs without error for each commit.
Source code(tar.gz)
Source code(zip)
Brython-3.10.7.tar.bz2(1.25 MB)
Brython-3.10.7.tar.gz(1.43 MB)
Brython-3.10.7.zip(1.45 MB)
changelog_3.10.7.txt(12.25 KB)
3.10.6(May 31, 2022)
The main features in this release are:

the Python-to-Javascript engine now uses the Abstract Syntax Tree introduced in version 3.10.4 to generate Javascript code. Methods transform() and to_js() of context classes in py2js.js are removed, as well as code related to name binding

rewriting of the interface of brython-cli : eg "brython-cli make_modules" instead of "brython-cli --modules" (by ennec-e)

an alternative algorithm to generate the AST based on standard Python grammar is available by adding a new script, brython_standard_parser.js. It does not replace the current algorithm because of performance issues. More details in this post.

for a script loaded by <script type="text/python" src='my_script.py' id='my_script'></script>, subsequent scripts can import my_script

experimental - add a new version of the interactive interpreter (tests/console_input.html) that supports input() inside the interpreter and time.sleep(). More details in this post

Source code(tar.gz)
Source code(zip)
Brython-3.10.6.tar.bz2(1.21 MB)
Brython-3.10.6.tar.gz(1.39 MB)
Brython-3.10.6.zip(1.41 MB)
changelog_3.10.6.txt(7.07 KB)
3.10.5(Mar 8, 2022)

The main new feature in this release is the ability to generate Javascript code from the Python-compliant AST structure introduced in version 3.10.4.

The feature is not used yet in this release because it still needs testing, but should be used in the next release.
Source code(tar.gz)
Source code(zip)
Brython-3.10.5.tar.bz2(1.21 MB)
Brython-3.10.5.tar.gz(1.39 MB)
Brython-3.10.5.zip(1.41 MB)
changelog_3.10.5.txt(5.33 KB)
3.10.4(Dec 31, 2021)

The main change in this version is the support of the Python ast module. Brython implementation has been adapted and simplified to adapt to the standard AST structure.
Source code(tar.gz)
Source code(zip)
Brython-3.10.4.tar.bz2(1.21 MB)
Brython-3.10.4.tar.gz(1.39 MB)
Brython-3.10.4.zip(1.41 MB)
changelog_3.10.4.txt(5.01 KB)
3.10.3(Nov 2, 2021)

This is almost the same version as 3.10.2, but the minifier used by CDNs produced an unusable version of brython.min.js...
Source code(tar.gz)
Source code(zip)
Brython-3.10.3.tar.bz2(1.20 MB)
Brython-3.10.3.tar.gz(1.37 MB)
Brython-3.10.3.zip(1.39 MB)
changelog_3.10.3.txt(670 bytes)
3.10.2(Oct 31, 2021)
The main visible feature in this version is the implementation of "suggestions" introduced in Python 3.10 : in case of a NameError, if the namespace has a name similar to the wrong name, the interpreter suggests "did you mean <similar name> ?".

Brython 3.10.1 on Netscape 5.0 (Windows) >>> data = 0 >>> datz Traceback (most recent call last): File <string>, line 1, in <module> NameError: name 'datz' is not defined. Did you mean: 'data'? >>>

The same applies to AttributeError:

Brython 3.10.1 on Netscape 5.0 (Windows) >>> x = 12 >>> x.bitlength() Traceback (most recent call last): File <string>, line 1, in <module> AttributeError: 'int' object has no attribute 'bitlength'. Did you mean: 'bit_length'? >>>

Another important change is a complete refactoring of comprehensions. The previous version was difficult to undestand / maintain and was not adapted to a future implemention of Python ast.
Source code(tar.gz)
Source code(zip)
Brython-3.10.2.tar.bz2(1.20 MB)
Brython-3.10.2.tar.gz(1.37 MB)
Brython-3.10.2.zip(1.39 MB)
changelog_3.10.2.txt(3.87 KB)
3.10.1(Oct 31, 2021)
The main visible feature in this version is the implementation of "suggestions" introduced in Python 3.10 : in case of a NameError, if the namespace has a name similar to the wrong name, the interpreter suggests "did you mean <similar name> ?".

Brython 3.10.1 on Netscape 5.0 (Windows) >>> data = 0 >>> datz Traceback (most recent call last): File <string>, line 1, in <module> NameError: name 'datz' is not defined. Did you mean: 'data'? >>>

The same applies to AttributeError:

Brython 3.10.1 on Netscape 5.0 (Windows) >>> x = 12 >>> x.bitlength() Traceback (most recent call last): File <string>, line 1, in <module> AttributeError: 'int' object has no attribute 'bitlength'. Did you mean: 'bit_length'? >>>

Another important change is a complete refactoring of comprehensions. The previous version was difficult to undestand / maintain and was not adapted to a future implemention of Python ast.
Source code(tar.gz)
Source code(zip)
Brython-3.10.1.tar.bz2(1.20 MB)
Brython-3.10.1.tar.gz(1.37 MB)
Brython-3.10.1.zip(1.39 MB)
changelog_3.10.1.txt(3.87 KB)
3.10.0(Oct 5, 2021)

This version implements most of the features of Python 3.10, including pattern matching (match / case).
Source code(tar.gz)
Source code(zip)
Brython-3.10.0.tar.bz2(1.18 MB)
Brython-3.10.0.tar.gz(1.32 MB)
Brython-3.10.0.zip(1.34 MB)
changelog_3.10.0.txt(1.36 KB)
3.9.6(Sep 28, 2021)
Apart from the usual bug fixes, this version includes:

important internal implementation changes (strings, conflicts with reserved Javascript names)

major improvement in loading time for programs that use stdlib modules

anticipation of Python 3.10 features

preliminary work to provide a Python-compliant ast module

Source code(tar.gz)
Source code(zip)
Brython-3.9.6.tar.bz2(1.15 MB)
Brython-3.9.6.tar.gz(1.30 MB)
Brython-3.9.6.zip(1.32 MB)
changelog_3.9.6.txt(5.73 KB)
3.9.5(Jul 5, 2021)

This version is published mainly to fix an issue that broke the interactive interpreter (#1699).
Source code(tar.gz)
Source code(zip)
Brython-3.9.5.tar.bz2(1.15 MB)
Brython-3.9.5.tar.gz(1.30 MB)
Brython-3.9.5.zip(1.32 MB)
changelog_3.9.5.txt(2.58 KB)
3.9.4(Jun 16, 2021)
Main new features in this version:

tokenisation of Python code is now compliant with the standard CPython API, with tokens similar to those produced by CPython tokenize module. Rewriting of py2js.js to use these tokens, produced in new script python_tokenizer.js

improvements to module browser.ajax + support of binary mode for the built-in function open()

rewriting of many special methods for operations (__add__() etc.) on built-in types for better compliance with CPython

Source code(tar.gz)
Source code(zip)
Brython-3.9.4.tar.bz2(1.15 MB)
Brython-3.9.4.tar.gz(1.30 MB)
Brython-3.9.4.zip(1.32 MB)
changelog_3.9.4.txt(2.90 KB)
3.9.3(May 16, 2021)

This release fixes a critical bug on iOS.
Source code(tar.gz)
Source code(zip)
Brython-3.9.3.tar.bz2(1.15 MB)
Brython-3.9.3.tar.gz(1.29 MB)
Brython-3.9.3.zip(1.31 MB)
changelog_3.9.3.txt(1.39 KB)
3.9.2(Apr 22, 2021)

The main new feature is a rewriting of the re module. The previous version used a pure-Python version of the CPython module _sre; it took a long time to import and was slow on execution. The new module (libs/python_re.js) loads immediately and its execution is much faster (at least 30 times), although still much slower than the CPython module.

The version also introduces a change in the implementation of strings with code points adressable with more than 2 bytes ("surrogate pairs").
Source code(tar.gz)
Source code(zip)
Brython-3.9.2.tar.bz2(1.15 MB)
Brython-3.9.2.tar.gz(1.29 MB)
Brython-3.9.2.zip(1.31 MB)
changelog_3.9.2.txt(5.44 KB)
3.9.1(Jan 4, 2021)
The main new feature is the implementation of the warnings API.

Other important changes:

many modules from the CPython standard library have been upgraded to 3.9.

bug fixes in the math and cmath modules; all the tests in Lib/test/test_cmath.py pass

rewriting of the import mechanism, more compliant with the specification (finders, loaders, module specs etc.)

support of Unicode escapes in strings (\u0000 etc.) and of identifier names with characters represented by surrogate pairs (eg 𝔘𝔫𝔦𝔠𝔬𝔡)

The option of function brython() to specify the scripts that should be run is now documented as ids (ipy_id is kept for compatibility).
Source code(tar.gz)
Source code(zip)
Brython-3.9.1.tar.bz2(1.07 MB)
Brython-3.9.1.tar.gz(1.20 MB)
Brython-3.9.1.zip(1.22 MB)
changelog_3.9.1.txt(6.83 KB)
3.9.0(Oct 6, 2020)

Apart from a couple of bug fixes, this release is compliant with Python 3.9, published yesterday: implementation of all the PEPs that are relevant for Brython + update of the standard library.
Source code(tar.gz)
Source code(zip)
Brython-3.9.0.tar.bz2(1.00 MB)
Brython-3.9.0.tar.gz(1.14 MB)
Brython-3.9.0.zip(1.16 MB)
changelog_3.9.0.txt(3.69 KB)
3.8.10(Aug 29, 2020)
The main features in this release are:

a complete rewriting of the implementation of generators. The first versions of Brython were written at a time when Javascript didn't have generators, the implementation was difficult to maintain. This release uses the Javascript "yield" keyword. Note that asynchronous generator are not supported in old versions of Microsoft Edge (they raise a SyntaxError for Javascript's "async function*()")

a rewriting of the interface with Javascript objects, mostly in the script js_objects.js

the module json, previously based on a slow pure-Python package, is replaced by a much faster Javascript version

Source code(tar.gz)
Source code(zip)
Brython-3.8.10.tar.bz2(1.00 MB)
Brython-3.8.10.tar.gz(1.14 MB)
Brython-3.8.10.zip(1.15 MB)
changelog_3.8.10.txt(7.50 KB)
3.8.9(May 20, 2020)

The main features in this version are the inclusion of a module interpreter to open a Python interpreter, and the use of modules dialog and menu in package browser.widgets in demos and documentation.

The CPython brython package can now be used by brython-cli instead of python -m brython.
Source code(tar.gz)
Source code(zip)
Brython-3.8.9.tar.bz2(1.00 MB)
Brython-3.8.9.tar.gz(1.13 MB)
Brython-3.8.9.zip(1.15 MB)
changelog_3.8.9.txt(4.63 KB)
3.8.8(Mar 16, 2020)

The main feature in this release is the support of tracing functions, such as set with sys.settrace(), allowing the support of the Python debugger (pdb) and of the breakpoint() built-in function.

Many bugs in this release were discovered when trying to run the sympy package, which is now supported, although not really usable (it imports too many modules).
Source code(tar.gz)
Source code(zip)
Brython-3.8.8.tar.bz2(1006.43 KB)
Brython-3.8.8.tar.gz(1.11 MB)
Brython-3.8.8.zip(1.12 MB)
changelog_3.8.8.txt(5.13 KB)
3.8.7(Feb 5, 2020)
The main changes in this version are:

the introduction of a Brython tutorial on the web site

a rewriting of dict implementation to preserve insertion order

the introduction of the trace function (with sys.settrace()), preliminary work to support the Python debugger

Source code(tar.gz)
Source code(zip)
Brython-3.8.7.tar.bz2(961.03 KB)
Brython-3.8.7.tar.gz(1.06 MB)
Brython-3.8.7.zip(1.07 MB)
changelog_3.8.7.txt(400 bytes)
3.8.6(Dec 16, 2019)

This is the same as 3.8.5 except that it fixes a regression for Web Workers.
Source code(tar.gz)
Source code(zip)
Brython-3.8.6.tar.bz2(961.54 KB)
Brython-3.8.6.tar.gz(1.06 MB)
Brython-3.8.6.zip(1.08 MB)
changelog_3.8.6.txt(400 bytes)
3.8.5(Dec 16, 2019)

Apart from a few bug fixes, this release is published to solve the problem reported in issue #1262 : the CPython brython package required CPython 3.8. It should now be usable with older versions of Python3.
Source code(tar.gz)
Source code(zip)
Brython-3.8.5.tar.bz2(962.32 KB)
Brython-3.8.5.tar.gz(1.06 MB)
Brython-3.8.5.zip(1.08 MB)
changelog_3.8.5.txt(860 bytes)
3.8.4(Dec 6, 2019)

As reported in issue #1260, pip install brython was broken in version 3.8.1... After two unsuccessful tries (3.8.2 and 3.8.3) I am releasing this version only to fix this critical issue.
Source code(tar.gz)
Source code(zip)
Brython-3.8.4.tar.bz2(961.53 KB)
Brython-3.8.4.tar.gz(1.06 MB)
Brython-3.8.4.zip(1.08 MB)
changelog_3.8.4.txt(175 bytes)
3.8.1(Dec 1, 2019)

This is mostly a bugfix version, with a few internal improvements and no significant new feature for users.
Source code(tar.gz)
Source code(zip)
Brython-3.8.1.tar.bz2(961.48 KB)
Brython-3.8.1.tar.gz(1.06 MB)
Brython-3.8.1.zip(1.08 MB)
changelog_3.8.1.txt(4.41 KB)
3.8.0(Oct 15, 2019)

Brython-3.8.0 is the first version synchronized with the same CPython version. It implements the new features in CPython, notably the "walrus operator" := for assignment expressions, the definition of positional-only function parameters, and a new f-string specifier f"{x=}" for debugging purposes.
Source code(tar.gz)
Source code(zip)
Brython-3.8.0.tar.bz2(961.42 KB)
Brython-3.8.0.tar.gz(1.06 MB)
Brython-3.8.0.zip(1.07 MB)
changelog_3.8.0.txt(5.70 KB)
3.7.5(Sep 10, 2019)

The main change in this release is the new way of distributing Brython packages : see this post for more information.

It also introduces 2 backwards-incompatible changes: . the API of browser.webcomponent has changed (cf issue #1163) . the keyword argument async in functions get(), post() and the like in the browser.ajax module has been replaced by blocking. async is now a Python keyword and can't be used as a variable name. blocking means the opposite of async
Source code(tar.gz)
Source code(zip)
Brython-3.7.5.tar.bz2(940.94 KB)
Brython-3.7.5.tar.gz(1.04 MB)
Brython-3.7.5.zip(1.05 MB)
changelog_3.7.5.txt(5.70 KB)
3.7.4(Jul 11, 2019)

This is mostly a bugfix version. The main new feature is the implementation and documentation of Web Components, a standard technology to define custom HTML tags, in a dedicated module browser.webcomponent.
Source code(tar.gz)
Source code(zip)
Brython-3.7.4.tar.bz2(944.48 KB)
Brython-3.7.4.tar.gz(1.04 MB)
Brython-3.7.4.zip(1.05 MB)
changelog_3.7.4.txt(3.91 KB)
3.7.3(May 22, 2019)

This release is the same as 3.7.2, except for the critical bug reported in issue #1118 by Andy Lewis.
Source code(tar.gz)
Source code(zip)
Brython-3.7.3.tar.bz2(939.84 KB)
Brython-3.7.3.tar.gz(1.04 MB)
Brython-3.7.3.zip(1.05 MB)
changelog_3.7.3.txt(201 bytes)
3.7.2(May 22, 2019)

The main new feature in this release in a new implementation of the interface to Web Workers, a standard web technology to run tasks in a separate thread to keep the main program responsive. It is implemented in a new module, browser.worker, which replaces the previous implementation in browser.webworker.
Source code(tar.gz)
Source code(zip)
Brython-3.7.2.tar.bz2(939.89 KB)
Brython-3.7.2.tar.gz(1.04 MB)
Brython-3.7.2.zip(1.05 MB)
changelog_3.7.2.txt(6.04 KB)
3.7.1(Feb 25, 2019)

The main change in this version is the support of asynchronous programming. The keywords async (in async def, async for and async while) and await are supported.

To run asynchronous programs, a new module, browser.aio, has been introduced as a replacement for the CPython asyncio module, which can't be ported in a browser context (no blocking functions, no user-defined event loop).
Source code(tar.gz)
Source code(zip)
Brython-3.7.1.tar.bz2(909.42 KB)
Brython-3.7.1.tar.gz(1.00 MB)
Brython-3.7.1.zip(1.01 MB)
changelog_3.7.1.txt(3.61 KB)