Registry / serialization / gettext-to-messageformat

gettext-to-messageformat

library0.4.0jsnpmunverified

Converts gettext .po, .pot, and .mo files into messageformat-compatible JSON. Version 0.4.0, released as a stable library with no further updates expected. It uses gettext-parser under the hood and provides functions parsePo and parseMo that return headers, a plural function, and translations object. The plural function can be derived from the Plural-Forms header or provided manually. Key differentiator: bridges the gap between gettext tooling and messageformat-based internationalization in JavaScript, with support for plural forms and context.

serialization data

npm install gettext-to-messageformat

github ↗package ↗

INSTALL

IMPORT

SIG · GETTEXT-TO-MESSAGE

gettext-to-messageformat

serializationjavascriptv0.4.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

parsePo

✓ const { parsePo } = require('gettext-to-messageformat')

✗ const parsePo = require('gettext-to-messageformat').parsePo

CommonJS require works; no default export.

parseMo

✓ import { parseMo } from 'gettext-to-messageformat'

✗ import parseMo from 'gettext-to-messageformat'

ESM import only with named exports; no default export.

parsePo, parseMo

✓ import { parsePo, parseMo } from 'gettext-to-messageformat'

✗ const { parsePo, parseMo } = require('gettext-to-messageformat')

Both CJS and ESM supported.

Parses a .po file with plural forms and uses messageformat to format a pluralized message.

const { parsePo } = require('gettext-to-messageformat'); const { headers, pluralFunction, translations } = parsePo(` msgid "" msgstr "" "Language: pl\n" "Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n" msgid "Time: %1 second" msgid_plural "Time: %1 seconds" msgstr[0] "Czas: %1 sekunda" msgstr[1] "Czas: %1 sekundy" msgstr[2] "Czas: %1 sekund" `); const MessageFormat = require('messageformat'); const mf = new MessageFormat({ [headers.Language]: pluralFunction }); const messages = mf.compile(translations); console.log(messages['Time: %1 second']([1])); // 'Czas: 1 sekunda'

Debug

Known issues

breakingIn v0.4.0, the option `sortByMsgId` was renamed to `sort`.

fix

Use `sort` option instead of `sortByMsgId`.

affects: >=0.4.0

breakingIn v0.4.0, output headers now use canonical case instead of forced lower-case.

fix

Access header keys with canonical case (e.g., 'Language' instead of 'language').

affects: >=0.4.0

deprecatedNode.js 6.0 is the minimum engine; older versions may break with deps.

fix

Upgrade Node.js to >=6.0.

affects: >=0.3.0

gotchaIf no headers are found, pluralFunction may be null; you must handle that.

fix

Check if pluralFunction is null and provide a fallback if needed.

affects: all

Errors

Common errors & fixes

Cannot find module 'gettext-to-messageformat'

Package not installed or incorrect import path.

fix

Run `npm install gettext-to-messageformat` and ensure the import path is correct.

TypeError: parsePo is not a function

Incorrect import (default vs named).

fix

Use `const { parsePo } = require('gettext-to-messageformat')` or `import { parsePo } from 'gettext-to-messageformat'`.

Invalid or unexpected token

Input string is not valid gettext format.

fix

Ensure the input is a valid .po or .mo file content as a string or Buffer.

Upgrade

Version history

0.4.0latest on npm

Audit

Dependencies

gettext-parserrequiredParses .po/.mo files

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/eemeli/gettext-to-messageformat ↗

packagehttps://www.npmjs.com/package/gettext-to-messageformat ↗