Home

Awesome

Locale

Utilities for working with LC environment variables.

Install

npm install cli-locale

Test

npm test

API

var lc = require('cli-locale')('en_us');
var lang = lc.find(['LC_ALL', 'LC_MESSAGES']);

Suppose you load files based on the language identifier and prefer using hyphens to underscores, you can pass a filter function:

var lc = require('cli-locale')('en_us');
var lang = lc.find(['LC_ALL', 'LC_MESSAGES'], function(lang) {
  return lang.replace(/_/g, '-');
});

You could also use this functionality to convert between language identifiers or to take action on an unsupported language.

find(search, [filter])

Find the value of an LC environment variable and return a sanitized represention of the locale. If no variable value is found in the search array then this method returns the first available LC variable. If no LC variables are available in the environment this method returns the default language.

Return a language identifier.

The rules for locating a language identifier are:

language

A language identifier to use when no value could be extracted via the environment, default value is en.

sanitize(lang, [filter], [strict])

Sanitize the value of an LC variable removing any character encoding portion, such that en_GB.UTF-8 becomes en_gb.

Returns a sanitized language identifier.

License

Everything is MIT. Read the license if you feel inclined.