mofile 0.2.1

Parse .mo files and find translated messages.

To use this package, run the following command in your project's root directory:

Manual usage
Put the following dependency into your project's dependences section:


D library for parsing .mo files and getting translated messages. Support for plural forms is present. Usage is similar to GNU gettext.

Build Status Coverage Status

Online documentation


import mofile;
// Parse .mo file
MoFile moFile = MoFile("");
// Find translation
string s = moFile.gettext("Hello, world");
// Trying out plural forms
s = moFile.ngettext("File", "Files", 1);
s = moFile.ngettext("File", "Files", 3);
s = moFile.ngettext("File", "Files", 5);


Commandline analogue of gettext and ngettext functions.

To run this example you must have some .mo file. For a quick start there's already template and Russian translation example files, so you only need to generate .mo file:

msgfmt --no-hash examples/ru.po -o examples/
# The library currently does not support lookup by hash, so we omit hash generation.

And then run:

dub examples/gettext.d examples/ "Hello, world"
dub examples/gettext.d examples/ "File" "Files" 1
dub examples/gettext.d examples/ "File" "Files" 3
dub examples/gettext.d examples/ "File" "Files" 5
dub examples/gettext.d examples/ "" # Get header

Generic use:

dub examples/gettext.d $MOFILE msgid # msgid is a string to translate
dub examples/gettext.d $MOFILE msgid msgid_plural n # msgid_plural is an untranslated plural form of message, n is a number to calculate a plural form from.

How to generate .mo file from source file

Mostly the same way as in C/C++ projects. Step by step process of generation .mo file from source file (gettext utilities must be installed):

MSGLOCALE=ru_RU.UTF-8 # Target locale
xgettext --from-code=UTF-8 --language=C "$SOURCE" -o "$TEMPLATE" # Create template file.
msginit --locale=$MSGLOCALE -i "$TEMPLATE" -o "$POFILE" --no-translator # Generate text translation file
# ... translate messages in editor
msgfmt "$POFILE" -o "$MOFILE" # Generate binary translation file

If source file has been changed run these commands to update translation files:

xgettext -j --from-code=UTF-8 --language=C "$SOURCE" -o "$TEMPLATE" # Update template file.
msgmerge --update $POFILE "$TEMPLATE"
# ... fix translations if needed
msgfmt "$POFILE" -o "$MOFILE"
  • Roman Chistokhodov
0.2.1 2018-Jun-17
0.2.0 2018-May-14
0.1.0 2018-May-10
~master 2021-Jun-09
Show all 4 versions
Download Stats:
  • 0 downloads today

  • 1 downloads this week

  • 5 downloads this month

  • 703 downloads total

Short URL: