Documentation Brython

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.11 et la version micro avec brython@3.11.0.

Brython est également disponible sur cdnjs:

<script src="https://cdnjs.cloudflare.com/ajax/libs/brython/3.11.0/brython.min.js">
</script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/brython/3.11.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

Pour cela il faut naturellement que tous les fichiers du package soient exécutables par Brython ; cela exclut les fichiers écrits en langage C par exemple.

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.

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

Modules intégrés propres à Brython