pytest-translate 1.0.1

pytest terminal output in your language — 134 languages supported, zero configuration

🌍 pytest-translate

pytest terminal output in your language — automatically. Zero config. 134 languages.

Why should pytest speak only English?

A Chinese developer, a Japanese tester, an Arabic QA engineer — they all use pytest. They all read FAILED and short test summary info in English. Not anymore.

---

💡 Why pytest-translate?

• Inclusive by design — your non-English-speaking team reads pytest output natively
• Zero config — installs as a pytest plugin, auto-detects your OS locale
• 134 languages — from Mandarin to Yiddish, from Arabic to Sanskrit
• No vendor lock-in — pure pytest plugin, MIT licensed, no SaaS, no telemetry
• Smart cache — translations cached locally, no redundant API calls

---

⚡ Quick Start

pip install pytest-translate

That's it. pytest now speaks your OS language automatically.

pytest tests/                    # auto-detects your OS locale
pytest tests/ --lang=zh_CN       # force Chinese
pytest tests/ --lang=fr_FR       # force French
pytest tests/ --lang=ja          # force Japanese
pytest tests/ --lang=ar          # force Arabic
pytest tests/ --lang=yi          # force Yiddish (yes, really)
pytest tests/ --lang=sa          # force Sanskrit (Hindu priests approved)
pytest tests/ --lang=off         # back to English

---

🗺️ How it works

pytest-translate hooks into pytest's terminal reporter and translates:

• Test statuses — PASSED, FAILED, SKIPPED, ERROR
• Summary line — 6 failed, 1 passed in 142s
• Section headers — FAILURES SUMMARY, short test summary

Translation is done via Google Translate through deep-translator — 134 languages supported, zero configuration required.

---

🌐 Language detection priority

1. --lang=zh_CN CLI argument
2. PYTEST_LANG=zh_CN environment variable
3. OS locale (automatic — fr_FR on a French system, zh_CN on a Chinese system)
4. English fallback if detection fails

---

📦 Installation

pip install pytest-translate

Or with pip + deep-translator explicitly:

pip install pytest-translate deep-translator

---

⚙️ Configuration

CLI

pytest tests/ --lang=zh_CN

Environment variable

export PYTEST_LANG=zh_CN
pytest tests/

pyproject.toml (permanent)

[tool.pytest.ini_options]
addopts = "--lang=zh_CN"

---

🗾 Supported languages (134)

Afrikaans, Albanian, Amharic, Arabic, Armenian, Azerbaijani, Basque, Bengali, Bosnian, Bulgarian, Catalan, Chinese (Simplified), Chinese (Traditional), Croatian, Czech, Danish, Dutch, English, Esperanto, Estonian, Filipino, Finnish, French, Galician, Georgian, German, Greek, Gujarati, Haitian Creole, Hausa, Hawaiian, Hebrew, Hindi, Hungarian, Icelandic, Indonesian, Irish, Italian, Japanese, Javanese, Kannada, Kazakh, Khmer, Korean, Kurdish, Kyrgyz, Lao, Latin, Latvian, Lithuanian, Macedonian, Malagasy, Malay, Malayalam, Maltese, Maori, Marathi, Mongolian, Myanmar, Nepali, Norwegian, Persian, Polish, Portuguese, Punjabi, Romanian, Russian, Sanskrit, Serbian, Sinhala, Slovak, Slovenian, Somali, Spanish, Swahili, Swedish, Tajik, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Uzbek, Vietnamese, Welsh, Yiddish, Yoruba, Zulu...

---

🤝 Contributors

Contributor	Contribution
Julien Mer	Original author

---

_{Tags: pytest plugin · i18n · l10n · internationalization · localization · multilingual testing · pytest in chinese · pytest in japanese · pytest in french · pytest in arabic · global qa · accessible testing · 134 languages · zero configuration · deep-translator · automatic locale detection · terminal reporter}

---

📄 License

MIT — do whatever you want with it.

---

Created by Julien Mer — JMer Consulting

QA Architect · 20+ years · Katalon Top Partner Europe

Also check out qa-autopilot — AI-powered diagnostic for Playwright test failures in 134 languages.