cimpress-translations-cli

cimpress-translations-cli

cimpress-translations-cli is a convenient client for Cimpress' Translations service which can very easily be integrated into an existing build pipeline to automatically download latest translations for an application.

Getting Started

Include cimpress-translations-cli in your project using npm or yarn:

npm i -D cimpress-translations-cli

Supported options

  -V, --version                       output the version number
  -a, --application-id <id>           Cimpress Translation Application ID (as defined in https://translations.cimpress.io
  -c, --client-id <id>                Auth0 Client ID that suppors clients_grant.
  -s, --client-secret <secret>        Auth0 Client Secret for the client id.
  -t, --translations-file <filepath>  File where a single file with all languages is created.
  -h, --help                          output usage information

Integrate into your build pipeline

Here is a sample command you can run as part of your build process. The command assumes you have APP_ID, CLIENT_ID and CLIENT_SECRET as environment variables.

node ./node_modules/cimpress-translations-cli/lib/index -a ${APP_ID} -c ${CLIENT_ID} -s ${CLIENT_SECRET} -t "./src/locales/translations.json"

Steps performed by the client

1. Retrieve access token for CLIENT_ID/CLIENT_SECRET
2. Retrieve application description (including list of languages) from Cimpress Translaions service for application with id APP_ID
3. For each application language from 2), download the language blobs
4. Combine the language blobs into a single json
5. Save the combined language files in the translations file (specified with -t option)