Version

Introduction

Installation

Limitations du protocole "file"

Questions fréquemment posées

Syntaxe, mots-clés et fonctions intégrées

Distribution standard

Implémentation de import

Packages Brython

Interface avec le navigateur

Introduction - API DOM
Créer un document
Accéder aux éléments
Attributs, propriétés et méthodes

Evénements
Evénements souris
Evénements clavier
Evénements focus
Evénements pour glisser-déposer

Chaine de requête

Interactions avec Javascript

Modules intégrés propres à Brython

browser
browser.aio
browser.ajax
browser.html
browser.local_storage
browser.markdown
browser.object_storage
browser.session_storage
browser.svg
browser.template
browser.timer
browser.webcomponent
browser.websocket
browser.worker

Widgets
browser.widgets.dialog
browser.widgets.menu

interpreter
javascript

Travailler avec Brython

Options d'exécution
Test et débogage
Deployer une application

Recettes

Salut !
Insérer du contenu dans un élément
Mise en forme HTML (gras, italique...)
Table HTML
Attacher / détacher des événements
Gérer la sélection d'options dans un SELECT
Glisser-déposer
Obtenir le contenu d'un élément
Lire le contenu d'un fichier
Stocker des objets localement
Exemple de onmouseover
 

Sans installation

On peut utiliser Brython sans avoir à installer quoi que ce soit, il suffit d'inclure les scripts Brython dans la page HTML depuis un CDN. 

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

On peut aussi préciser la version mineure avec brython@3.13 et la version micro avec brython@3.13.0.

Brython est également disponible sur cdnjs: 

<script src="https://cdnjs.cloudflare.com/ajax/libs/brython/3.13.0/brython.min.js">
</script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/brython/3.13.0/brython_stdlib.min.js">
</script>

Installation locale

Pour installer Brython localement:

  • si votre PC peut utiliser CPython et pip, installez le package brython par

    pip install brython

Le package installe un logiciel client brython-cli (équivalent à python -m brython).

puis dans un répertoire vide, exécutez

brython-cli install

  • si vous ne pouvez pas utiliser cette méthode, aller sur la page des publications sur Github, sélectionnez la dernière version, téléchargez et dézippez le fichier Brython-x.y.z.zip.

Dans les deux cas vous disposez des fichiers suivants :

  • brython.js : le moteur Brython, à inclure dans la page HTML
  • brython_stdlib.js : regroupe tous les fichiers de la distribution Python standard supportés par Brython
  • demo.html : une page qui donne quelques exemples d'utilisation de Brython

brython.js contient quelques modules très utilisés : browser, browser.html, javascript.

Si votre application utilise des modules de la distribution standard, il faut inclure brython_stdlib.js en plus de brython.js: 

<script type="text/javascript" src="brython.js"></script>
<script type="text/javascript" src="brython_stdlib.js"></script>

Mises à jour

Quand une nouvelle version de Brython est publiée, la mise à jour s'effectue par la commande habituelle: 

pip install brython --upgrade

Dans le répertoire de l'application, vous pouvez ensuite mettre à jour les fichiers Brython (brython.js et brython_stdlib.js) par: 

brython-cli update

Installer un package CPython

Un package CPython installé par pip peut être installé dans une application Brython par la commande --add_package <nom du package>.

Par exemple:

pip install attrs
brython-cli add_package attrs

Avertissement important : Brython exécute des programmes écrits en Python, mais pas ceux écrits en C. Cela signifie que par exemple numpy et les paquetages de data science qui l'utilisent ne fonctionneront pas.

En outre, la capacité des navigateurs à envoyer des requêtes est limitée pour des raisons de sécurité. Des packages comme requests, ou le module urllib.request de la distribution standard, ne peuvent pas envoyer de requête arbitraire à n'importe quelle url. Cette limitation est commune à toutes les implémentations de Python dans le navigateur.

Autres commandes

make_modules

crée une distribution propre à l'application, pour remplacer brython_stdlib.js par un fichier moins volumineux. Voir la section import

make_dist

génère un package CPython, distribuable par PyPI, pour installer une application Brython. Voir la section Déployer une application

make_package

génère un "package Brython" permettant de distribuer très simplement un module ou un package. Voir la section Packages Brython

-- version

affiche la version de Brython

Serveur web

Les fichiers HTML peuvent être ouverts directement dans le navigateur, mais il est préférable de lancer un serveur web dans le répertoire de l'application.

Pour cela vous pouvez utiliser le module http.server de la distribution standard: 

python -m http.server

Par défaut le port utilisé est 8000. Pour choisir un autre port: 

python -m http.server 8001

Vous pouvez alors accéder aux pages en entrant http://localhost:8001/demo.html dans la barre d'adresse du navigateur.