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

Brython implémente la version 3 de Python en se basant sur la Référence du Langage Python

Mots clés et fonctions intégrées

• les fonctions Javascript ne peuvent pas bloquer l'exécution pendant une durée donnée, ou en attendant qu'un événement se produise, avant de passer à l'instruction suivante. Pour cette raison:
  • on ne peut pas utiliser time.sleep() (il faut utiliser à la place les fonctions du module browser.timer telles que set_timeout() ou set_interval())
  • la fonction intégrée input() est simulée par la fonction Javascript prompt(). Un exemple dans la galerie montre comment simuler la fonction input dans une boite de dialogue personnalisée

• pour la même raison, et aussi parce que le navigateur possède une boucle d'événements implicite, le module asyncio de la distribution standard ne peut pas être utilisé. A la place, pour la programmation asynchrone, le module browser.aio est fourni.

• la fonction open() prend comme argument l'url du fichier à ouvrir ; comme on utilise un appel Ajax, elle doit être dans le même domaine que le script. L'objet retourné par open() possède les méthodes de lecture et d'accès habituelles : read, readlines, seek, tell, close.

• par défaut, print() affiche sur la console du navigateur, et les messages d'erreur sont également affichés sur cette console. sys.stderr et sys.stdout peuvent être affectés à un objet qui implémente une méthode write(), ce qui permet par exemple d'afficher les messages d'erreur dans une fenêtre

• par défaut, sys.stdout.write() et sys.stderr.write() n'affichent pas immédiatement dans la console parce qu'il y aurait un saut de ligne à chaque appel. Le message est stocké dans un buffer, pour afficher dans la console il faut appeler la méthode flush() de sys.stdout ou sys.stderr

• pour lancer une impression sur imprimante, utiliser la méthode print() de l'objet window défini dans le module browser :

from browser import window
window.print(text)

• le cycle de vie des objets est géré par le ramasse-miettes de Javascript, Brython ne gère pas le comptage de référence comme CPython, donc la méthode __del__() n'est pas appelée quand une instance de classe n'est plus référencée.

Bibliothèque standard

Valeur intégrée __name__

<script type="text/python" id="monscript">
assert __name__ == 'monscript'
</script>

• si aucun autre script n'a un id qui vaut __main__, pour le premier script sans id, __name__ prend la valeur "__main__". Ainsi, s'il n'y a qu'un script dans la page, il pourra exécuter le test habituel :

<script type="text/python">
if __name__=='__main__':
    print('hello !')
</script>

• pour les autres scripts sans id, __name__ prend une valeur aléatoire qui commence par __main__