Skip to main content

Utilities for working with gettext PO and POT files to ease development and improve localization quality

Project description

Dennis is a set of utilities for working with PO files to ease development and improve quality. Translate POT files to find problems with localization in your code. Lint PO files for common problems like variable formatting, mismatched HTML, missing variables, etc.

dennis-cmd has the following subcommands:

  • lint: Lints PO and POT files for problems including errors that can cause your production system to crash and problems in strings that can lead to poor translations.

    The system allows for defining other variable formats.

  • status: Get a high-level status of a PO file including a list of unstranslated strings.

  • translate: Translates strings in PO files into something else! Comes with an HTML extractor (tokenizes strings so that only the text is translated) and a bunch of translations like Pirate!.

    This is helpful for l10n testing, development, finding unicode/layout problems, amazing your friends, hilarious April 1st shenanigans, etc.

    Specify the tokenizer/transform pipeline you want to use that combines things. Zombie? Sure! Shouty Zombie? Ok! Manic shouty Dubstep? Bring it on!

    This also works on strings passed in as command line arguments and as stdin—it doesn’t have to be a PO file or in a PO format format. For example, Dennis uses Dennis to translate all Dennis commit messages into Pirate!. That’s how cool Dennis is!

Quick start

Install:

$ pip install dennis

Lint a PO file for problems:

$ dennis-cmd lint locale/fr/LC_MESSAGES/messages.po

Lint all your PO files for errors:

$ dennis-cmd lint --errorsonly locale/

Lint a POT file for problems:

$ dennis-cmd lint locale/templates/LC_MESSAGES/messages.pot

Translate a PO file in place into Pirate!:

$ dennis-cmd translate --pipeline=html,pirate \
    locale/xx/LC_MESSAGES/messages.po

Get help:

$ dennis-cmd

Project details

Code:

https://github.com/mozilla/dennis

Documentation:

https://dennis.readthedocs.io/

Issue tracker:

https://github.com/mozilla/dennis/issues

License:

BSD 3-clause; see LICENSE file

Why is it called Dennis?

This is how @willkg names his software projects.

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

dennis-1.0.0.dev0.tar.gz (45.3 kB view details)

Uploaded Source

Built Distribution

dennis-1.0.0.dev0-py3-none-any.whl (32.1 kB view details)

Uploaded Python 3

File details

Details for the file dennis-1.0.0.dev0.tar.gz.

File metadata

  • Download URL: dennis-1.0.0.dev0.tar.gz
  • Upload date:
  • Size: 45.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.7

File hashes

Hashes for dennis-1.0.0.dev0.tar.gz
Algorithm Hash digest
SHA256 2f3f67c13e187d59ca3e5c60463887938dd87578023f7ece71a155214a578b66
MD5 1e65761b027bfc3a28df771ab61d9750
BLAKE2b-256 73f301be7fc02dd27b73f45f62d90650a5a228317122039737f5e6edb65d358a

See more details on using hashes here.

Provenance

File details

Details for the file dennis-1.0.0.dev0-py3-none-any.whl.

File metadata

  • Download URL: dennis-1.0.0.dev0-py3-none-any.whl
  • Upload date:
  • Size: 32.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.7

File hashes

Hashes for dennis-1.0.0.dev0-py3-none-any.whl
Algorithm Hash digest
SHA256 37a6a98d25e89f333da27905bd0cefe353cf9555d78afc35871d2b99bd9d4259
MD5 c4829575ed20972f1c33832aa2033a47
BLAKE2b-256 69737a5c2cf68e781d9ef01e393f3bb4ea64f58e28f4a6652b6a5ec7f5ec89f2

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