‎ ‎ ‎ ‎ ‎

Version tools

A small module to check the information about versions, such as comparing, parsing version data, and checking if the two version is a major change.

Changelog (v1.4.1)

• Fixed conflict in docs.
• Added new function to readme.md.
• Added new function to tests.
• Updated tsconfig.json.
• Added new scripts to package.json.
• Some more linting.
• Added the version check for old node versions.

To-do

• Make parseVersion() function return version numbers as a int instead of a string.

Installation

npm i major-version-check

Usage

⚠ This library is ONLY compatible with node version 14 and above

First you must import the library using the following code:

const versionTools = require('major-version-check');
// or `import * as versionTools from 'major-version-check';` for Typescript users

Then all you have to do is call the function with some values:

const versionTools = require('major-version-check');
// or `import * as versionTools from 'major-version-check';` for Typescript users

// Will return true
console.log(versionTools.majorVer('1.0.0', '2.0.0'));

// Will return false
console.log(versionTools.majorVer('1.0.0', '1.0.1'));

// Will return info about the version
console.log(JSON.stringify(versionTools.parseVersion('1.0.0-beta')));

// Will return true
console.log(`Output:\n${versionTools.compare(versionTools.parseVersion('1.0.1'), versionTools.parseVersion('1.0.0'), { type: 'greaterThan' })}`);

// Will return false
console.log(`Output:\n${versionTools.compare(versionTools.parseVersion('1.0.1'), versionTools.parseVersion('1.0.0'), { type: 'lessThan' })}`);

Thats it! Now you have it running!

Parameters

Parameter info for majorVer()

| Parameters | Type | Usage | Description | |---------------|---------|----------------------------------------|-------------------------------| | oldVersion | string (required) | majorVer(oldVersion, ...); | The old version to compare | | newVersion | string (required) | majorVer(..., newVersion); | The new version to compare | | options.debug | boolean | majorVer(..., ..., { debug: boolean }); | Weather to log debug messages |

Parameter info for parseVersion()

| Parameters | Type | Usage | Description | |---------------|---------|----------------------------------------|-------------------------------| | version | string (required) | parseVersion(version, ...); | The version to parse | | options.debug | boolean | parseVersion(..., { debug: boolean }); | Weather to log debug messages |

Parameter info for compare()

| Parameters | Type | Usage | Description | |---------------|---------|----------------------------------------|-------------------------------| | version | object (required) | compare(version, ...); | The version to compare | | comparator | string (required) | compare(..., comparator, ...); | The second version to compare | | options.debug | boolean | compare(..., ..., { debug: boolean }); | Weather to log debug messages |