Skip to main content

Test your translation files.

Project description

version ci coverage license

PyTest Translations

A py.test plugin to check gettext po & mo files.

Test check for:

  • Spelling (using enchant & aspell)

  • Consistency of mo files

  • Obsolete translations

  • Fuzzy translations

Installation

Install the PyPi package.

pip install pytest-translations

The spell checking requires enchant and aspell including the correct dictionary.

On Linux simply install:

sudo apt-get install python3-enchant python-enchant aspell-{en|de|CHOSE YOUR LANGUAGE CODES}

To set up travis-ci simply add the apt packages to your travis-ci config YAML:

addons:
  apt:
    packages:
    - python-enchant
    - python3-enchant
    - aspell-en
    - aspell-de

On Mac you can use brew to install:

brew install aspell --with-lang-{en|de|CHOSE YOUR LANGUAGE CODES}
brew install enchant

Usage

To execute the translation tests simply run

py.test --translations

Every file ending in .mo and .po will be discovered and tested, starting from the command line arguments.

You also can execute only the translation-tests by using:

py.test -m translations --translations

Private Word Lists

You will almost certainly use words that are not included in the default dictionaries. That is why you can add your own word list that you want to add to the dictionary.

You may do so by adding a plain text file where each line is a word. Words beginning with a capital letter are case sensitive where lower case words are insensitive.

There can be one file for each language contained in a single folder. The files should be named like the proper language code.

For example:

.
└── .spelling
    ├── de
    ├── en_GB
    └── en_US

What’s left to do is to set an environment variable to point to right directory.

For example:

export PYTEST_TRANSLATIONS_PRIVATE_WORD_LIST=path/to/my/.spelling

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pytest-translations-2.0.0.tar.gz (8.5 kB view details)

Uploaded Source

File details

Details for the file pytest-translations-2.0.0.tar.gz.

File metadata

File hashes

Hashes for pytest-translations-2.0.0.tar.gz
Algorithm Hash digest
SHA256 8f5aa5e98746ccc5e400486ea2084fd71251ccb35c0c53e4e1026d8af380bc08
MD5 eb66ff6a737d8ed9c708fddb745de649
BLAKE2b-256 3074ff0345ec46d8f4bad6dc31384348ec10e5e93c2711c258593bba0d41693f

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page