arousa-language v1.1.2

arousa-language

With this package you can handle your languages easily

Join our Discord server by clicking here

Dependencies

• @vitalets/google-translate-api

Usage example:

const { Language, LanguageHandler } = require('arousa-language');

const english = new Language('/path/to/english.json', 'en');
const spanish = new Language('/path/to/spanish.json', 'es');

// ! file paths are taken by project's root directory

const handler = new LanguageHandler([ english ]);

const result1 = handler.translate('greeting', { language: 'en' });
const result2 = handler.translate('greeting', { language: 'es' });

console.log(result1, result2); // Output: Hello, Hola

JSON files must look something like this:

// english.json
{
    "default": "No traductions found",
    "translations": {
        "greeting": "Hello"
    }
}

// spanish.json
{
    "default": "No traductions found",
    "translations": {
        "greeting": "Hello"
    }
}

// ! default value is used when you provide a non existent translation key

You can fork languages to access them anywhere

// File one
const { Language, LanguageHandler } = require('arousa-language');

const english = new Language('/path/to/english.json', 'en');
const spanish = new Language('/path/to/spanish.json', 'es');

const handler = new LanguageHandler([ english ]);
handler.fork('myhandler');

// File 2
const { Forks } = require('arousa-languages');
const { myhandler } = Forks;

const result1 = myhandler.translate('greeting', 'en');
const result2 = myhandler.translate('greeting', 'es');

console.log(result1, result2); // Output: Hello, Hola

You can translate from google to:

const { LanguageHandler } = require('arousa-language');

const handler = new LanguageHandler();

handler.translate('Hola', { google: true, language: 'en' }).then((result) => console.log(result)); // Output: Hello

You can add and remove languages when you want

const { Language, LanguageHadler } = require('arousa-language');

const handler = new LanguageHandler();

// Adding one language
const english = new Language('/path/to/english.json', 'es');

handler.addLanguage(english);

// Adding an array of languages
const spanish = new Language('/path/to/spanish.json', 'es');
const japanese = new Language('/path/to/japanese.json', 'ja');

handler.addLanguages([ spanish, japanese ]);

// Removing one language
handler.removeLanguage('en');

// Removing an array of languages
handler.removeLanguages([ 'es', 'ja' ]);