gulp-pofill

Transform given set of PO files using simple callbacks

Install

Install with npm

npm install --save-dev gulp-pofill

API

var gulp = require('gulp');
var pofill = require('gulp-pofill');

gulp.task('translations', function () {
    return gulp.src('po/**/*.po')
        .pipe(pofill({
            comments: function(comment) {
                // manipulate comment or return a new one
                return comment;
                // Or a promise which resolves to `comment`
            },
            headers: function(header) {
                // manipulate header or return a new one
                return header;
                // Or a promise which resolves to `header`
            },
            items: function(item) {
                // manipulate item or return a new one
                // item is instance of [PO.Item][2]
                return item;
                // Or a promise which resolves to `item`
            }
        }))
        .pipe(gulp.dest('dist/translations/'));
});

Note that all callbacks are async, i.e. you can return a promise which resolves to the manipulated comment, header, or item.

Example

For example, the gulp-angular-gettext plugin will output an empty json if PO file contains empty translations. In some cases this is expected, and you'd write something like following:

var gulp = require('gulp');
var pofill = require('gulp-pofill');
var gettext = require('gulp-angular-gettext');

gulp.task('translations', function () {
    return gulp.src('po/**/*.po')
        .pipe(gettext.compile({format: 'json'}))
        .pipe(gulp.dest('dist/translations/'));
});

But in many other cases, you want to fillup the translation strings with the same strings as translations:

var gulp = require('gulp');
var pofill = require('gulp-pofill');
var gettext = require('gulp-angular-gettext');

gulp.task('translations', function () {
    return gulp.src('po/**/*.po')
        .pipe(pofill({
            items: function(item) {
                // If msgstr is empty, use identity translation
                if (!item.msgstr.length) {
                  item.msgstr = [''];
                }
                if (!item.msgstr[0]) {
                    item.msgstr[0] = item.msgid;
                }
                return item;
            }
        }))
        .pipe(gettext.compile({format: 'json'}))
        .pipe(gulp.dest('dist/translations/'));
});

This can be useful when verifying translations in angular-translate using useMissingTranslationHandler.

By the way, due to its async nature it can also be used to auto-fill translations using online translation APIs.

Checkout my gulp-pofill-yandex plugin for dynamically fetching translations from yandex - a free translation service.

End Matter

Afterword

Well, I created this library as a building block for dynamically fetching missing translations from a webservice. However, this library is written in a way that it can be used with any other sync / async operations for filling up missing translations or even transforming existing translations.

Author

Mihir Gokani

License

Licensed under MIT.