Validate your project's software requirements.
$ npm install -D requirements$ yarn add --dev requirementsScaffold a new requirements.config.js configuration file
$ npx requirements --initConfigure the requirements.config.js file in your project root.
module.exports = {
software: {
node: '*',
yarn: '~1.17.3',
nginx: {
semver: '>= 1.16.x',
optional: true, // optional (won't fail)
installMessage: '<install instruction>', // custom message when binary is not found
updateMessage: '<update instruction>', // custom message when binary has wrong version
},
httpd: {
semver: '^1.x',
flag: '-v', // custom version flag
},
},
};Run requirements command in the project root. By default it will try to find the requirements.config.js file.
$ npx requirementsOr use a custom path:
$ npx requirements --config <filepath>$ npx requirements --helpOptions:
--help, -h Show help [boolean]
--version, -v Show version number [boolean]
--init, -i Create a requirements.config.js file
--config, -c Path to the configuration file
[default: "requirements.config.js"]
--force, -f Succeeds even if not all requirements are satisfied
[boolean] [default: false]
--quiet, -q Only output when errors are present [boolean]
--debug Print raw data [boolean]
const { checkSoftware, renderTable } = require('requirements');
(async () => {
const result = await checkSoftware({ node: '*' });
console.log(renderTable(result));
})();checkSoftware() returns an Array with results
[
{
bin: 'node',
semver: '*',
installed: true,
version: '12.8.1',
satisfies: true,
},
];# test functionality
yarn build
node bin/requirements.js --config tests/requirements.config.js
# unit tests
yarn testThe MIT License (MIT)
Copyright (c) 2017-2020 Steven Chim
![renovate[bot] avatar](https://avatars.githubusercontent.com/in/2740?v=4 "renovate[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent