Guía de estilo de código

Esta guía incluye información y directrices para escribir código para BeeWare.

Código de estilo

BeeWare sigue PEP 8 en nuestro código base, excepto que la longitud de línea se ha ampliado de 79 a 88 caracteres. Utilizamos Ruff para aplicar las convenciones PEP 8 siempre que sea posible. Cuando confirmes tu código, pre-commit ejecutará comprobaciones, incluyendo Ruff. Siempre que sea posible, esto formateará automáticamente tu código para garantizar que cumple con nuestros estándares de formato y estilo. Puedes configurar algunos IDE para que ejecuten automáticamente Ruff al guardar, lo que puede ayudar en el proceso.

Ten en cuenta que la parte más importante de PEP 8 es Sección 0: La Consistencia Tonta es el Duende de las Mentes Pequeñas. Hay situaciones en las que ser consistente con PEP 8 no tiene sentido, y es importante entender que, cuando sea aplicable, es aceptable, y a veces preferible, escribir código que no esté en línea con las reglas listadas. Saber cuando ser inconsistente con esas reglas es tan importante como mantener la consistencia en la mayoría de las situaciones.

Seguimos la ortografía estadounidense para la denominación de API, variables, etc.

Lo que hay que evitar

Intentamos evitar los módulos utils en la medida de lo posible, aunque a veces son inevitables. La alternativa preferible es encontrar un lugar para la función en el código fuente, en lugar de utilizar un módulo utils.

Como regla general, intentamos evitar o aplazar cualquier código de inicialización costoso, con el fin de lograr un inicio más rápido de la aplicación. Por ejemplo, los módulos del paquete toga-core se cargan de forma diferida, es decir, solo se importan cuando se solicitan, en lugar de hacerlo por adelantado. Esto acelera el inicio y solo se dedica tiempo a lo que la aplicación está utilizando realmente.