Simple CLI tools for check `ngx-translate` keys
Simple tools for check ngx-translate keys in Angular applications in whole app which use regexp.
for
react-intl
usereact-intl-lint
for
react-i18next
usereact-i18next-lint
There are a lot of translation ngx-translate
keys in the whole app.
This repository contains a proposal to check all translation keys in the whole app
which should exist in all languages files.
npm install ngx-translate-lint -g
The source code are available for download at GitHub Releases and GitHub pages as well.
Usage: ngx-translate-lint [options]
Simple CLI tools for check `ngx-translate` keys in app
Options:
-p, --project [glob] (required)
The path to project folder
Possible Values: <relative path|absolute path>
(default: "./src/app/**/*.{html,ts}")
-l, --languages [glob] (required)
The path to languages folder
Possible Values: <relative path|absolute path>
(default: "./src/assets/i18n/*.json")
-kv, --keysOnViews [enum]
Described how to handle the error of missing keys on view
Possible Values: <disable|warning|error>
(default: "error")
-zk, --zombieKeys [enum]
Described how to handle the error of zombies keys
Possible Values: <disable|warning|error>
(default: "warning")
-ek, --emptyKeys [enum]
Described how to handle empty value on translate keys
Possible Values: <disable|warning|error>
(default: "warning")
-i, --ignore [glob]
Ignore projects and languages files
Possible Values: <relative path|absolute path>
--maxWarning [glob]
Max count of warnings in all files. If this value more that count of warnings, then an error is return
Possible Values: <number>
(default: "0")
-mk, --misprintKeys [enum]
Try to find matches with misprint keys on views and languages keys. CCan be longer process!!
Possible Values: <disable|warning|error>
(default: "disable")
-ds, --deepSearch [enum]
Add each translate key to global regexp end try to find them on project. Can be longer process!!
Possible Values: <disable|enable>
(default: "disable")
-mc, --misprintCoefficient [number]
Coefficient for misprint option can be from 0 to 1.0.
(default: "0.9")
-c, --config [path]
Path to the config file.
-V, --version output the version number
-h, --help output usage information
Examples:
$ npx ngx-translate-lint -p ./src/app/**/*.{html,ts} -l ./src/assets/i18n/*.json
$ ngx-translate-lint -p ./src/app/**/*.{html,ts} -l ./src/assets/i18n/*.json
$ ngx-translate-lint -p ./src/app/**/*.{html,ts} -z disable -v error
NOTE: For
project
andlanguages
options need to include file types like on the example. WARNING!:BETA
flag working only with angular 11 and higher!
Default Config is:
{
"rules": {
"keysOnViews": "error",
"zombieKeys": "warning",
"misprintKeys": "disable",
"deepSearch": "disable",
"emptyKeys": "warning",
"maxWarning": "0",
"misprintCoefficient": "0.9",
"ignoredKeys": [ "IGNORED.KEY.(.*)" ], // can be string or RegExp
"ignoredMisprintKeys": [],
"customRegExpToFindKeys": [ "(?<=marker\\(['\"])([A-Za-z0-9_\\-.]+)(?=['\"]\\))"], // to find: marker('TRSNLATE.KEY');
},
"project": "./src/app/**/*.{html,ts}",
"languages": "./src/assets/i18n/*.json"
}
We have (?<=marker\\(['\"])([A-Za-z0-9_\\-.]+)(?=['\"]\\))
RegExp witch contains of 3 parts:
Prefix - (?<=marker\\(['\"])
(?<=
and end )
.marker\\(['\"]
- tells that we try to find word market
witch have on the second character '
or "
market
and commas '
or "
Matching for key: ([A-Za-z0-9_\\-.]+)
_
or -
.(.*)
If it's enough for your projectPostfix - (?=['\"]\\))
(the same as prefix, but need to be ended)
(?=
and end )
['\"]\\)
- tells that we try to find word comas '
or "
and ended with )
'
or "
and )
Example RegExp will find following keys
marker('TRSNLATE.KEY')
marker("TRSNLATE.KEY-2")
The CLI process may exit with the following codes:
0
: Linting succeeded without errors (warnings may have occurred)1
: Linting failed with one or more rule violations with severity error2
: An invalid command line argument or combination thereof was usedimport { ToggleRule, NgxTranslateLint, IRulesConfig, ResultCliModel, ErrorTypes, LanguagesModel } from 'ngx-translate-lint';
const viewsPath: string = './src/app/**/*.{html,ts}';
const languagesPath: string = './src/assets/i18n/*.json';
const ignoredLanguagesPath: string = "./src/assets/i18n/ru.json, ./src/assets/i18n/ru-RU.json";
const ruleConfig: IRulesConfig = {
keysOnViews: ErrorTypes.error,
zombieKeys: ErrorTypes.warning,
misprintKeys: ErrorTypes.disable,
deepSearch: ToggleRule.disable,
emptyKeys: ErrorTypes.warning,
maxWarning: 0,
misprintCoefficient: 0.9,
ignoredKeys: [ 'EXAMPLE.KEY', 'IGNORED.KEY.(.*)' ], // can be string or RegExp
ignoredMisprintKeys: [],
customRegExpToFindKeys: [ "(?<=marker\\(['\"])([A-Za-z0-9_\\-.]+)(?=['\"]\\))" ] // to find: marker('TRSNLATE.KEY');
};
const ngxTranslateLint = new NgxTranslateLint(viewsPath, languagesPath, ignoredLanguagesPath, ruleConfig)
const resultLint: ResultCliModel = ngxTranslateLint.lint(); // Run Lint
const languages: LanguagesModel[] = ngxTranslateLint.getLanguages() // Get Languages with all keys and views
If you have error Can't resolve 'fs' in ...
. Please add next setting to you project:
angular.webpack.json
)config.externals = {
...config.externals,
"fs": 'require("fs")',
"path": 'require("path")'
};
{
"skipLibCheck": true
}
You may contribute in several ways like requesting new features, adding tests, fixing bugs, improving documentation or examples. Please check our contributing guidelines.
Here can be your extensions: