npmpackage.info

Gathering detailed insights and metrics for y18n

Other packages similar to y18n

i18next-cli-language-detector

1.1.8

i18next language detector module for CLI

y18n-browser

1.0.2

the bare-bones internationalization library used by yargs, made browser friendly

lokales

1.2.4

Lightweight barebones i18n localization written in Typescript.

babel-plugin-as-macro

1.0.3

add macro power to javascript code

Gathering detailed insights and metrics for y18n

y18n

📒 the bare-bones i18n library used by yargs

5.0.8

146

ISC

JavaScript

1.14 kB

12,403,982,925 4.1

Installations

npm install y18n

Pull Requests

Open

12

Total

125

Closed

51

Merged

62

Issues

Open

5

Total

27

Closed

22

Releases

y18n v5.0.8

v5.0.8

Published on 07 Apr 2021

y18n y18n-v4.0.3

y18n-v4.0.3

Published on 07 Apr 2021

y18n v5.0.7

v5.0.7

Published on 07 Apr 2021

y18n y18n-v4.0.2

y18n-v4.0.2

Published on 07 Apr 2021

y18n v5.0.6

v5.0.6

Published on 05 Apr 2021

y18n v4.0.1

v4.0.1

Published on 25 Oct 2020

View all 11 releases

Developer

yargs

Developer Guide

BETA

Module System

ESM

Min. Node Version

>=10

Typescript Support

No

Node Version

14.16.0

NPM Version

6.14.11 Statistics

146 Stars

113 Commits

48 Forks

17 Watching

85 Branches

20 Contributors

Updated on 19 Jul 2024

Bundle Size

2.93 kB

Minified

1.14 kB

Minified + Gzipped

Bundlephobia

Languages

JavaScript (59.97%)

TypeScript (40.03%)

Total Downloads

Cumulative downloads

Total Downloads

12,403,982,925

Last day

-8.8%

12,873,570

Compared to previous day

Last week

76,103,904

Compared to previous week

Last month

13.9%

311,479,535

Compared to previous month

Last year

7.2%

3,150,594,906

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dev Dependencies

@types/node @wessberg/rollup-plugin-ts c8 chai cross-env gts mocha rimraf rollup standardx ts-transform-default-export typescript

Versions

y18n

The bare-bones internationalization library used by yargs.

Inspired by i18n.

Examples

simple string translation:

1const __ = require('y18n')().__;
2
3console.log(__('my awesome string %s', 'foo'));

output:

my awesome string foo

using tagged template literals

1const __ = require('y18n')().__;
2
3const str = 'foo';
4
5console.log(__`my awesome string ${str}`);

output:

my awesome string foo

pluralization support:

1const __n = require('y18n')().__n;
2
3console.log(__n('one fish %s', '%d fishes %s', 2, 'foo'));

output:

2 fishes foo

Deno Example

As of v5 y18n supports Deno:

1import y18n from "https://deno.land/x/y18n/deno.ts";
2
3const __ = y18n({
4  locale: 'pirate',
5  directory: './test/locales'
6}).__
7
8console.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 args.

This function can also be used as a tag for a template literal. You can use it like this: __`hello ${'world'}`. 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. Here's a post on why we think this is important.

License

ISC

Stable Version

The latest stable version of the package.

Stable Version

5.0.8

HIGH

7.3/10

Summary

Prototype Pollution in y18n

Affected Versions

>= 5.0.0, < 5.0.5

Patched Versions

5.0.5

HIGH

7.3/10

Summary

Prototype Pollution in y18n

Affected Versions

= 4.0.0

Patched Versions

4.0.1

HIGH

7.3/10

Summary

Prototype Pollution in y18n

Affected Versions

< 3.2.2

Patched Versions

3.2.2

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

10

License

Determines if the project has defined a license.

3

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 0

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:46: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:47: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:55: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:56: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yaml:61: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/release-please.yml:10: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/release-please.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-please.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/release-please.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-please.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/release-please.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-please.yml:34: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/release-please.yml/master?enable=pin
Warn: npmCommand not pinned by hash: .github/workflows/ci.yaml:23
Warn: npmCommand not pinned by hash: .github/workflows/ci.yaml:41
Warn: npmCommand not pinned by hash: .github/workflows/ci.yaml:51
Warn: npmCommand not pinned by hash: .github/workflows/ci.yaml:60
Warn: npmCommand not pinned by hash: .github/workflows/release-please.yml:21
Warn: npmCommand not pinned by hash: .github/workflows/release-please.yml:40
Info: 0 out of 13 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 2 third-party GitHubAction dependencies pinned
Info: 0 out of 6 npmCommand dependencies pinned

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

SAST

Determines if the project uses static code analysis.

Score

4.1

/10

Last Scanned on 2024-11-18

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More