Permalink
Cannot retrieve contributors at this time
127 lines (78 sloc)
3.14 KB
Name already in use
A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
codeql-action/node_modules/y18n/README.md
Go to fileThis commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
# y18n | |
[![NPM version][npm-image]][npm-url] | |
[![js-standard-style][standard-image]][standard-url] | |
[](https://conventionalcommits.org) | |
The bare-bones internationalization library used by yargs. | |
Inspired by [i18n](https://www.npmjs.com/package/i18n). | |
## Examples | |
_simple string translation:_ | |
```js | |
const __ = require('y18n')().__; | |
console.log(__('my awesome string %s', 'foo')); | |
``` | |
output: | |
`my awesome string foo` | |
_using tagged template literals_ | |
```js | |
const __ = require('y18n')().__; | |
const str = 'foo'; | |
console.log(__`my awesome string ${str}`); | |
``` | |
output: | |
`my awesome string foo` | |
_pluralization support:_ | |
```js | |
const __n = require('y18n')().__n; | |
console.log(__n('one fish %s', '%d fishes %s', 2, 'foo')); | |
``` | |
output: | |
`2 fishes foo` | |
## Deno Example | |
As of `v5` `y18n` supports [Deno](https://github.com/denoland/deno): | |
```typescript | |
import y18n from "https://deno.land/x/y18n/deno.ts"; | |
const __ = y18n({ | |
locale: 'pirate', | |
directory: './test/locales' | |
}).__ | |
console.info(__`Hi, ${'Ben'} ${'Coe'}!`) | |
``` | |
You will need to run with `--allow-read` to load alternative locales. | |
## JSON Language Files | |
The JSON language files should be stored in a `./locales` folder. | |
File names correspond to locales, e.g., `en.json`, `pirate.json`. | |
When strings are observed for the first time they will be | |
added to the JSON file corresponding to the current locale. | |
## Methods | |
### require('y18n')(config) | |
Create an instance of y18n with the config provided, options include: | |
* `directory`: the locale directory, default `./locales`. | |
* `updateFiles`: should newly observed strings be updated in file, default `true`. | |
* `locale`: what locale should be used. | |
* `fallbackToLanguage`: should fallback to a language-only file (e.g. `en.json`) | |
be allowed if a file matching the locale does not exist (e.g. `en_US.json`), | |
default `true`. | |
### y18n.\_\_(str, arg, arg, arg) | |
Print a localized string, `%s` will be replaced with `arg`s. | |
This function can also be used as a tag for a template literal. You can use it | |
like this: <code>__`hello ${'world'}`</code>. This will be equivalent to | |
`__('hello %s', 'world')`. | |
### y18n.\_\_n(singularString, pluralString, count, arg, arg, arg) | |
Print a localized string with appropriate pluralization. If `%d` is provided | |
in the string, the `count` will replace this placeholder. | |
### y18n.setLocale(str) | |
Set the current locale being used. | |
### y18n.getLocale() | |
What locale is currently being used? | |
### y18n.updateLocale(obj) | |
Update the current locale with the key value pairs in `obj`. | |
## Supported Node.js Versions | |
Libraries in this ecosystem make a best effort to track | |
[Node.js' release schedule](https://nodejs.org/en/about/releases/). Here's [a | |
post on why we think this is important](https://medium.com/the-node-js-collection/maintainers-should-consider-following-node-js-release-schedule-ab08ed4de71a). | |
## License | |
ISC | |
[npm-url]: https://npmjs.org/package/y18n | |
[npm-image]: https://img.shields.io/npm/v/y18n.svg | |
[standard-image]: https://img.shields.io/badge/code%20style-standard-brightgreen.svg | |
[standard-url]: https://github.com/feross/standard |