‚̧Nibbling Pastry Monster
    Wondering what‚Äôs next for npm?Check out our public roadmap! ¬Ľ

    g11n-pipeline

    4.0.1¬†‚Äʬ†Public¬†‚Äʬ†Published

    Globalization Pipeline Client for JavaScript

    This is the JavaScript SDK for the Globalization Pipeline IBM Cloud service. The Globalization Pipeline service makes it easy for you to provide your global customers with IBM Cloud applications translated into the languages in which they work. This SDK currently supports:

    npm version Build Status Coverage Status Coverity Status

    News

    4.0.0

    • getClient() has been removed. Instead, use connect() which returns a Promise to a Client object.
    • The CLI is now in a separate package/repo. See https://github.com/IBM-Cloud/gp-js-cli for news and usage.

    Sample

    For a working IBM Cloud application sample, see gp-nodejs-sample.

    Quickstart

    • You should familiarize yourself with the service itself. A good place to begin is by reading the Quick Start Guide and the official Getting Started with IBM Globalization documentation. The documentation explains how to find the service on IBM Cloud, create a new service instance, create a new bundle, and access the translated messages.

    • Next, add g11n-pipeline to your project, as well as cfenv and optional.

      npm install --save g11n-pipeline cfenv optional

    • Load the client object as follows (using cfenv ).

    var optional = require('optional');
    var appEnv = require('cfenv').getAppEnv();
    var gpClient = await require('g11n-pipeline').connect(
      optional('./local-credentials.json')   // if it exists, use local-credentials.json
        || {appEnv: appEnv}                  // otherwise, the appEnv
    );
    • For local testing, create a local-credentials.json file with the credentials as given in the bound service:

      {
        "credentials": {
          "url": "https://…",
          "userId": "…",
          "password": "……",
          "instanceId": "………"
        }
      }
      

    Using

    To fetch the strings for a bundle named "hello", first create a bundle accessor:

        const mybundle = gpClient.bundle('hello');

    Then, call the getStrings function:

        const {resourceStrings} = await mybundle.getStrings({ languageId: 'es'});
        console.dir(resourceStrings);

    This code snippet will output the translated strings such as the following:

        {
            hello:   '¡Hola!',
            goodbye: '¡Adiós!',
            …
        }

    Translation Requests

    To create a Translation request:

        const tr = await gpClient.tr({
          name: 'My first TR',
          domains: [ 'HEALTHC' ],
     
          emails: ['my_real_email@me.example.com'],
          partner: 'IBM',
          targetLanguagesByBundle: {
              bundle1: [ 'es', 'fr', 'de' ], // review bundle1’s Spanish, etc… 
              bundle2: [ 'zh-Hans' ]   // review bundle2’s Simplified Chinese…
          },
          notes: [ 'This is a mobile health advice application.' ],
          status: 'SUBMITTED' // request to submit it right away.
        })
        .create();
        console.log('TR submitted with ID:', tr.id);
        console.log('Estimated completion:', 
            tr.estimatedCompletion.toLocaleString());

    To then check on the status of that request:

        const {status} = await gpClient.tr('333cfaecabdedbd8fa16a24b626848d6')
            .getInfo();
     
        console.log('Current status:', status);

    Async

    Note that all calls that are async (or take a callback) are asynchronous. For example, the following code:

    var bundle = client.bundle('someBundle');
    bundle.create().then(…);
    bundle.uploadStrings().then(…);

    …will fail, because the bundle someBundle hasn’t been created by the time the uploadStrings call is made. Instead, make sure create is called before uploadStrings:

    var bundle = client.bundle('someBundle');
    await bundle.create();
    await bundle.uploadStrings();

    Testing

    See TESTING.md

    Browserify

    The gp-js-client can be used in a web browser via browserify.

    You can call the g11n-pipeline API just as from Node.js:

    // mycode.js
    const gp = require('g11n-pipeline');
    gp.connect({/*...*/})
    .then(client => {
        // do some great stuff here
    });

    And then, package up the code for the browser:

    npm i --save g11n-pipeline
    npm i -g browserify
    browserify mycode.js > bundle.js
    

    Finally, include the bundle in your HTML:

    <script src="./bundle.js"></script>

    API

    See API.md for more details.

    CLI

    You can use the GP CLI to perform some operations from the commandline. See https://github.com/IBM-Cloud/gp-js-cli for more details.

    Community

    Contributing

    See CONTRIBUTING.md.

    License

    Apache 2.0. See LICENSE.txt

    Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

    Keywords

    Install

    npm i g11n-pipeline

    DownloadsWeekly Downloads

    21,167

    Version

    4.0.1

    License

    Apache-2.0

    Unpacked Size

    318 kB

    Total Files

    54

    Last publish

    Collaborators

    • avatar