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

Travailler avec Brython

Recettes

  

Première installation

Pour installer Brython :

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

    pip install brython

puis dans un répertoire vide, exécutez

python -m brython --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: 

python -m brython --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
python -m brython --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

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

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.