/nodejs-currency-converter

:currency_exchange: A NodeJS currency converter library that doesn't require subscribing to any API calls.

Primary LanguageJavaScriptMIT LicenseMIT

NodeJS Currency Converter

Build Status Known Vulnerabilities codecov license: MIT Maintainability npm version npm

A minimal currency converter library for NodeJS that works out of the box.

Getting started

Installation

This package can be installed using npm

npm install currency-converter-lt

or, yarn

yarn add currency-converter-lt

Usage

Import currency-converter-lt.

const CC = require('currency-converter-lt')

Then instantiate with either the empty constructor

let currencyConverter = new CC()

Or, with a json object

let currencyConverter = new CC({from:"USD", to:"JPY", amount:100})

The convert method will return the conversion based on the last conversion rate and can be used as a promise.

currencyConverter.convert().then((response) => {
    console.log(response) //or do something else
})

convert can also take the amount as a parameter.

currencyConverter.convert(100).then((response) => {
    console.log(response) //or do something else
})

To find the rates use the rates method.

currencyConverter.rates().then((response) => {
    console.log(response) //or do something else
})

Chaining is also supported.

currencyConverter.from("USD").to("GBP").amount(125).convert().then((response) => {
    console.log(response) //or do something else
})

Issues

If any issues are found, they can be reported here.

License

This project is licensed under the MIT license.