poeditor-utils
higher-level POEditor utilities for Node.js
- uses POEditor API v1 via poeditor-client
- API is still a subject to change
Usage
const languageCodeOverrides = 'pt-br': 'pt'const translations = await utilsconst translationsByLanguage = utilstranslationsByLanguage
utils.Translation
projectName: string
languageCode: string
term: string
value: string
Translation of a single term to a single language.
utils.getTranslations(apiToken, projectNames[, options])
apiToken: string
projectNames: string[]
options: Object
languageCodes: string[]
- returns
Promise<Translation[]>
Gets translations for multiple projects. Gets translations for all the project languages or only languages specified with options.languageCodes
.
utils.groupTranslations(translations, grouper)
translations: Translation[]
grouper: (translation: Translation) => string
- returns
Map<string, Translation[]>
Groups translations by keys produced by grouper
.
utils.formatTranslationsAsJson(translations[, options])
translations: Translation[]
options: Object
indent: number | string
- returns
string
Formats translations to string as stable sorted JSON.
Obsolete API
utils.Client(apiToken) [DEPRECATED]
apiToken: string
- POEditor API token
Exposes the poeditor-client Client
. See their docs for more.
utils.getProject(apiToken, projectName) [DEPRECATED]
apiToken: string
- POEditor API tokenprojectName: string
- POEditor project name
Returns a promise which resolves with a poeditor-client Project
representation of the project. See their docs for more.
utils.pullTranslations(apiToken, projectName, getPathCallback) [DEPRECATED]
apiToken: string
- POEditor API tokenprojectName: string
- POEditor project namegetPathCallback: (translation: Translation) => string
- produces destination file path for given translation
Gets translations for all the project languages and writes them to files by getPathCallback
as a stable sorted JSON. Returns a promise which resolves with an array of file paths written.
utils