grunt-poeditor-at

Grunt tasks to push to and pull from POEditor.

Getting Started

This plugin requires Grunt >=1.0.1.

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-poeditor-at --save-dev

Once installed, enable it in your gruntfile.js:

grunt.loadNpmTasks('grunt-poeditor-at');

Usage

grunt.initConfig({
  poeditor: {
    target1: {
      command: { // POEditor's API args
        action: 'list_languages',
        id: '9999'
      }
    },
    target2: {
      upload: { // special case for uploads
        id: '<%= poeditor.options.project_id %>',
        updating: 'terms_definitions',
        overwrite: 1, // set any POE's API option
        sync_terms: 1,
        intervalSecs: 5 // interval between uploads
        // (to avoid "Too many upload in a short period of time" API error)
      }
    },
    target3: {
      download: {
        project_id: '<%= poeditor.options.project_id %>',
        type: 'po', // export type (check out the doc)
        filters: ["proofread", "translated"], // https://poeditor.com/api_reference/#export
        tags: ["myTag", "myOtherTag"], // https://poeditor.com/api_reference/#export
        dest: '<%= conf.front %>/locale/?/LC_MESSAGES/django.po'
        // grunt style dest files
      }
    },
    options: {
      project_id: '1234',
      // matching POEditor's language codes with yours
      // applies to uploads & downloads
      languages: {
        'en-us': 'en',
        'es': 'es',
        'es-ar': 'es_AR',
        'fr': 'fr'
      },
      api_token: '[your API token here]'
    }
  },
});

Options

command

An object specifying the API command. Check out the doc: https://poeditor.com/api_reference/.

upload

Check out the doc, at the Upload command. https://poeditor.com/api_reference/#upload

download

Check out the doc too, at the Export command. https://poeditor.com/api_reference/#export Export type = po, pot, mo, xls, apple_strings, android_strings, resx, resw, properties, or json.

Release History

• 0.0.2 Updated dependencies.
• 0.0.1 Initial release, forked from grunt-poeditor-ab.

License

MIT License, see LICENSE-MIT for details.