Introduction

Installation

Questions fréquemment posées

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

Distribution standard

Implémentation de import

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

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.