django-fakemessages - 为您的 Django项目 生成假语言文件

简介

在您的Django项目中寻找缺失的翻译？让我们看看做了什么，还剩下什么！

资源

• PyPI上的包： https://pypi.ac.cn/project/django-fakemessages/
• GitHub上的项目： https://github.com/pfouque/django-fakemessages

需求

• Django >=3.2
• Python >=3.8
• Translate-toolkit >=3.8.5

如何

1. 安装

   $ pip install "django-fakemessages"
   

2. 在Django应用列表中注册fakemessage

   INSTALLED_APPS = [
       # ...
       "fakemessages",
       # ...
   ]
   

3. 更新您的设置

   if DEBUG:
       """Add our fake language to Django"""
       from django.conf.locale import LANG_INFO
   
       FAKE_LANGUAGE_CODE = "kl"
   
       LANG_INFO[FAKE_LANGUAGE_CODE] = {
           "bidi": False,
           "code": FAKE_LANGUAGE_CODE,
           "name": "▮▮▮▮▮▮▮▮",
           "name_local": "🖖 ▮▮▮▮▮▮▮",
       }
       LANGUAGES.append((FAKE_LANGUAGE_CODE, "🖖 ▮▮▮▮▮▮▮"))
   

4. 🎉 好了！

贡献

原则

• 对开发者简单易用
• 一致的样式（black, ruff）
• 面向未来（pyupgrade）
• 完整的类型提示（mypy）

编码风格

我们使用 pre-commit 来运行代码质量工具。您可以按任何方式安装 pre-commit（例如，使用系统 Python 的 pip install pre-commit），然后设置 pre-commit，以便每次提交时都运行。

> pre-commit install

然后您可以运行所有工具

> pre-commit run --all-files

它包括以下内容

• poetry 用于依赖管理
• Ruff、black 和 pyupgrade 检查风格
• mypy 用于类型检查
• Github Actions 用于构建和持续集成

提供了 linting 和 mypy 的默认配置文件。

测试

测试包

包测试本身位于主库代码之外，在一个自身就是 Django 应用的包中（它包含 models、settings 以及运行测试所需的任何其他工件（例如 urls）。）在适当的情况下，这个测试应用可以作为 Django 项目运行 - 这样开发者就可以启动测试应用，查看管理员界面是什么样的，测试迁移等。

运行测试

测试本身使用 pytest 作为测试执行器。如果您已安装 poetry 环境，您可以这样运行它们：

$ poetry run pytest

或

$ poetry shell
(django-fakemessages-py3.10) $ pytest

持续集成

• .github/workflows/lint.yml：在 Github 上定义并确保编码规则。

• .github/workflows/test.yml：在 Github 矩阵中运行所有兼容的 Django（3.2+）和 Python（3.8+）组合的测试。

• .github/workflows/coverage.yml：对最新版本计算覆盖率。