@fleetbase/intl-lint
v0.0.1
Published
Internationalization translation file linter script for Fleetbase Extensions and Application
Downloads
340
Readme
@fleetbase/intl-lint
Description
@fleetbase/intl-lint
is a Node.js script designed for Ember projects, aimed at validating internationalization (i18n) keys. The script checks that all i18n keys used in JavaScript and Handlebars files of an Ember project are defined in the specified YAML translation file. This validation helps ensure that there are no missing translations in the application, thereby preventing runtime errors and improving the overall quality of internationalization efforts.
Features
- Recursively processes JavaScript (.js) and Handlebars (.hbs) files in the specified Ember project directory.
- Extracts translation keys using tailored regular expressions.
- Checks if each extracted key exists in the specified YAML translation file.
- Logs missing translation keys and optionally throws an error.
- Silent mode to suppress error throwing and complete the script execution even if missing keys are found.
Installation
To install @fleetbase/intl-lint
, run the following command:
npm install @fleetbase/intl-lint
Or, if you are using pnpm, you can install it using:
pnpm add @fleetbase/intl-lint
Usage
Once installed, @fleetbase/intl-lint
can be run directly from the command line or used as a Node.js module.
Command Line Interface
Run the script in your project's root directory:
fleetbase-intl-lint --path "./path-to-ember-project" --translation-path "./path-to-translation.yaml"
Optional flags:
--silent
or-s
: Runs the script in silent mode. The script will not throw an error if missing translation keys are found.--path
or-p
: Specifies the path to the Ember project. Default is ./app.--translation-path
: Specifies the path to the YAML translation file. Default is ./translations/en-us.yaml.
As a Node.js Module
You can also require @fleetbase/intl-lint
in your Node.js script and use it programmatically:
const lint = require('@fleetbase/intl-lint');
lint({
silent: true, // or false
path: './path-to-ember-project',
translationPath: './path-to-translation.yaml',
});
Authors
- Fleetbase Pte Ltd [email protected]
- Ronald A. Richardson [email protected]
Contact
For issues or questions regarding @fleetbase/intl-lint
, feel free to contact the authors or raise an issue on the project repository.
License
@fleetbase/intl-lint
is open-source and distributed under the MIT license. See the LICENSE file in the repository for full license text.