Guide de style de code

Ce guide contient des informations et des lignes directrices pour l'écriture de code pour BeeWare.

Style du code

BeeWare suit la norme PEP 8 dans notre base de code, sauf que la longueur des lignes est passée de 79 à 88 caractères. Nous utilisons Ruff pour appliquer les conventions PEP 8 dans la mesure du possible. Lorsque vous validez votre code, pre-commit effectue des vérifications, notamment avec Ruff. Dans la mesure du possible, cela formatera automatiquement votre code afin de garantir qu'il respecte nos normes de formatage et de style. Vous pouvez configurer certains IDE pour qu'ils exécutent automatiquement Ruff lors de l'enregistrement, ce qui peut faciliter le processus.

Gardez à l'esprit que la partie la plus importante de la PEP 8 est la Section 0 : Une cohérence stupide est le hobgobelin des petits esprits. Il existe des situations où rester cohérent avec la PEP 8 n'a pas de sens, et il est important de comprendre que, le cas échéant, il est acceptable, et parfois préférable, d'écrire du code qui n'est pas conforme aux règles énumérées. Savoir quand être incohérent avec ces règles est aussi important que de maintenir la cohérence dans la plupart des situations.

Nous suivons l'orthographe américaine pour les noms d'API, les variables, etc.

Ce qu'il faut éviter

Nous essayons d'éviter les modules utils autant que possible, tout en sachant qu'ils sont parfois inévitables. L'alternative préférée est de trouver la fonctionnalité ailleurs dans le code source, au lieu d'utiliser un module utils.

En règle générale, nous essayons d'éviter ou de différer tout code d'initialisation coûteux, afin d'accélérer le démarrage de l'application. Par exemple, les modules du paquet toga-core sont « chargés à la demande » : ils ne sont importés qu'une fois demandés, plutôt que tous d'un coup. Cela accélère le démarrage et ne consacre du temps qu'à ce que l'application utilise réellement.