Roman numerals

CLI - The library allows to convert Arabic numerals to Roman numerals and vice versa.

Install

npm i roman-numerals-convert

Usage

roman-numerals

Demo

API - JavaScript

The module exports an object with two methods:

• parse(str): Receives a String as a single argument and returns a number (Number) if it is a valid Roman numeral, otherwise it will throw an error specifying the cause.
• stringify(num): Receives a number (Number) and returns a String with the representation of the received number as a Roman numeral. In case the number is out of range (1 <= num <= 3999).

Example of use:

const { parse, stringify } = require('roman-numerals-convert');

console.log(parse('I') === 1); // true
console.log(parse('III') === 3); // true
console.log(parse('IV') === 4); // true
console.log(parse('IX') === 9); // true
console.log(parse('MCMXLIV') === 1944); // true

console.log(stringify(1) === 'I'); // true
console.log(stringify(3) === 'III'); // true
console.log(stringify(4) === 'IV'); // true
console.log(stringify(9) === 'IX'); // true
console.log(stringify(1944) === 'MCMXLIV'); // true

console.log(parse(stringify(1)) === 1); // true
console.log(parse(stringify(3)) === 3); // true
console.log(parse(stringify(4)) === 4); // true
console.log(parse(stringify(9)) === 9); // true
console.log(parse(stringify(1944)) === 1944); // true

CLI - Command Line Interface

The module can be installed with the npm i roman-numerals-convert command globally and also using the npx command (a tool that comes with node and npm).

This interface offers two sub-commands (parse and stringify) plus options to display help (--help) and the module version (--version).

Examples

Executing directly through the path relative to the script bin/global.js, using npm.

You can also execute directly with the romans-numerals command. The interface allows you to perform a quick search using the arrow keys or type to search for the desired option and then the tab key to auto-complete the search.

Comands

• parse

When selecting the parse option you must enter the Roman numeral you wish to convert.

• stringify

When selecting the stringify option you must enter the arabic number you want to convert.

Options

• --version

• --help

Install - NPM

You can download the package NPM.

License

roman-numerals is released under the MIT License.