代码风格指南

本指南包含为 BeeWare 编写代码的信息和指南。

代码风格

BeeWare 在代码库中遵循 PEP 8 规范，但行长度从 79 扩展至 88 个字符。 我们尽可能使用Ruff工具强制执行PEP 8规范。提交代码时，pre-commit会自动运行包括Ruff在内的检查程序。该工具会自动格式化代码以确保符合我们的格式与风格标准。您可配置某些IDE在保存时自动运行Ruff，这将有效提升开发效率。

请记住，PEP 8 中最重要的部分是第 0 节：愚蠢的一致性是小脑袋的妖怪。在某些情况下，与 PEP 8 保持一致是没有意义的，重要的是要明白，在适用的情况下，编写不符合所列规则的代码是可以接受的，有时甚至是首选。在大多数情况下，了解 * 何时 * 与这些规则不一致与保持一致性同样重要。

在 API 命名、变量等方面，我们采用美国拼写法。

应避免的事项

我们尽量避免使用 utils 模块，但也知道有时它们是不可避免的。首选的替代方法是在源代码的其他地方为该功能找到合适的位置，而不是使用 utils 模块。

通常情况下，我们尽量避免或延迟执行任何耗时的初始化代码，以实现更快的应用启动速度。例如，toga-core包中的模块采用"延迟加载"机制——它们仅在被请求时才被导入，而非预先全部加载。这种方式既能加速启动过程，又能确保资源仅消耗在应用实际使用的功能上。