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

Skip to content
 
Sign up

  * Why GitHub?
    Features -
      + Mobile -
      + Actions -
      + Codespaces -
      + Packages -
      + Security -
      + Code review -
      + Issues -
      + Integrations -
      + GitHub Sponsors -
      + Customer stories-
  * Team
  * Enterprise
  * Explore
      + Explore GitHub -

    Learn and contribute

      + Topics -
      + Collections -
      + Trending -
      + Learning Lab -
      + Open source guides -

    Connect with others

      + The ReadME Project -
      + Events -
      + Community forum -
      + GitHub Education -
      + GitHub Stars program -
  * Marketplace
  * Pricing
    Plans -
      + Compare plans -
      + Contact Sales -
      + Education -

[                    ] [search-key]

  *  
    #
    In this repository All GitHub |
    Jump to |

  * No suggested jump to results

  *  
    #
    In this repository All GitHub |
    Jump to |
  *  
    #
    In this organization All GitHub |
    Jump to |
  *  
    #
    In this repository All GitHub |
    Jump to |

Sign in
Sign up
{{ message }}

brython-dev / brython

  * Notifications
  * Star 4.7k
  * Fork 420

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

BSD-3-Clause License
4.7k stars 420 forks
Star
Notifications

  * Code
  * Issues 32
  * Pull requests 1
  * Actions
  * Projects 0
  * Wiki
  * Security
  * Insights

More

  * Code
  * Issues
  * Pull requests
  * Actions
  * Projects
  * Wiki
  * Security
  * Insights

master
Switch branches/tags
[                    ]
Branches Tags
Could not load branches
Nothing to show
{{ refName }} default View all branches
Could not load tags
Nothing to show
{{ refName }} default
View all tags
5 branches 57 tags
Code
 
Clone
HTTPS GitHub CLI
[https://github.com/b]

Use Git or checkout with SVN using the web URL.

[gh repo clone brytho]

Work fast with our official CLI. Learn more.

  * Open with GitHub Desktop
  * Download ZIP

Launching GitHub Desktop

If nothing happens, download GitHub Desktop and try again.

Go back

Launching GitHub Desktop

If nothing happens, download GitHub Desktop and try again.

Go back

Launching Xcode

If nothing happens, download Xcode and try again.

Go back

Launching Visual Studio Code

Your codespace will open once ready.

There was a problem preparing your codespace, please try again.

Latest commit

PierreQuentel Fixes #1726 : is TypedDict supported?
...
bfc3ede Jul 14, 2021
Fixes #1726 : is TypedDict supported?
bfc3ede

Git stats

  * 6,119 commits

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
cgi-bin/ovh
Move CGI scripts from /cgi-bin to www/cgi-bin
Jul 28, 2020
npm
Change version to 3.9.5
Jul 5, 2021
releases
Update style in demo.tmpl
Aug 29, 2020
scripts
Change version to 3.9.5
Jul 5, 2021
setup
Change version to 3.9.5
Jul 5, 2021
www
Fixes #1726 : is TypedDict supported?
Jul 14, 2021
.gitconfig
Add configs useful for development
Oct 30, 2014
.gitignore
Fix javascript.JSON.parse containing null value
Jul 6, 2019
.testem.json
Reduce output from testem so that Jenkins build succeeds
Oct 18, 2018
.travis.yml
Travis CI: Modernize .travis.yml
Jul 9, 2020
CONTRIBUTING.md
Remove mention of Travis CI in CONTRIBUTING.md
Jun 29, 2021
LICENCE.txt
Web Groups Styles
Sep 26, 2014
LICENSE math lgamma.txt
Fixes #1591 : math.lgamma(1e3)
Mar 6, 2021
Pipfile
Remove plumbum from Pipfile and update Pipfile.lock
Mar 31, 2021
Pipfile.lock
Remove plumbum from Pipfile and update Pipfile.lock
Mar 31, 2021
README.md
Change version to 3.9.5
Jul 5, 2021
README_pt_br.md
Fix typo in README_pt_br.md
Sep 29, 2020
bower.json
Update bower.json, add package.json
May 16, 2016
manage.py
Add a ./manage.py command to unify calling helper scripts.
May 5, 2018
manifest.json
Add a ./manage.py command to unify calling helper scripts.
May 5, 2018
server.py
Minor cleanings in server.py (excuse to initialize a DOI with Zenodo)
Oct 28, 2020
server_modular_send_head.py
Minor changes in server
Dec 27, 2019
small_node_app.py
Fixed issues found during code review
Jun 17, 2020
View code
brython Main features Getting started Zero install ! Local install
Test Brython online Gallery of examples Documentation Community
(questions, feedback, issues, new features, ...) Thank you

README.md

 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:

 1. Load the script brython.js.
 2. Run the function brython() on page load, like <body onload=
    "brython()">.
 3. 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/brython@3.9.5/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/brython@3.9.5/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/brython@3.9/brython.min.js">
</script>
<script type="text/javascript"
    src="https://cdn.jsdelivr.net/npm/brython@3.9/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"></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:

  * 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.

About

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

Resources

Readme

License

BSD-3-Clause License

Releases 57

 
Brython-3.9.5 Latest
Jul 5, 2021
+ 56 releases

Packages 0

No packages published

Used by 323

 

  * @jvdwetering
  * @JocobZling
  * @balqui
  * @ricardomattar
  * @ludovicparra
  * @asadityasingh60
  * @s40723135
  * @ygupta1999

+ 315

Contributors 79

  * @PierreQuentel
  * @earney
  * @jonathanverner
  * @kikocorreoso
  * @olemis
  * @schmave
  * @aroberge
  * @mementum
  * @addowhite
  * @amrdraz
  * @cclauss

+ 68 contributors

Languages

  * Python 70.3%
  * HTML 17.8%
  * JavaScript 11.6%
  * CSS 0.1%
  * PLSQL 0.1%
  * Roff 0.1%

  * (c) 2021 GitHub, Inc.
  * Terms
  * Privacy
  * Security
  * Status
  * Docs

 

  * Contact GitHub
  * Pricing
  * API
  * Training
  * Blog
  * About

You can't perform that action at this time.
You signed in with another tab or window. Reload to refresh your
session. You signed out in another tab or window. Reload to refresh
your session.