currency-converter-lt
Version:
A nodejs currency converter library that doesn't require subscribing to any API calls.
123 lines (80 loc) • 4.64 kB
Markdown
<div align="center">
<h1>NodeJS Currency Converter</h1>
 [](https://snyk.io/test/github/paul-shuvo/nodejs-currency-converter?targetFile=package.json)  [](https://codecov.io/gh/paul-shuvo/nodejs-currency-converter)
 [](https://badge.fury.io/js/currency-converter-lt) 
<p>A minimal currency converter library for NodeJS that works out of the box.</p>
</div>
<!-- [](https://codeclimate.com/github/paul-shuvo/nodejs-currency-converter/maintainability) -->
<!--  -->
__Announcement__ : For crypto currency conversion, check my other package [Nodejs Crypto Converter](https://github.com/paul-shuvo/nodejs-crypto-converter).
### Typescript Support
Check out this [comment](https://github.com/paul-shuvo/nodejs-currency-converter/issues/35#issuecomment-1407626126)
## Getting started
### Installation
This package can be installed using `npm`
```bash
npm install currency-converter-lt
```
or, `yarn`
```bash
yarn add currency-converter-lt
```
### Usage
Import `currency-converter-lt`.
```javascript
const CC = require('currency-converter-lt')
```
Then instantiate with either the empty constructor
```javascript
let currencyConverter = new CC()
```
Or, with a json object
```javascript
let currencyConverter = new CC({from:"USD", to:"JPY", amount:100})
```
#### <p style='color:magenta'>!!! Note: if you get incorrect conversion described in this [issue](https://github.com/paul-shuvo/nodejs-currency-converter/issues/20) then make sure you pass `isDecimalComma: true` to the constructor as following:</p>
```javascript
let currencyConverter = new CC({from:"USD", to:"JPY", amount:100, isDecimalComma:true})
```
The convert method will return the conversion based on the last conversion rate and can be used as a promise.
```javascript
currencyConverter.convert().then((response) => {
console.log(response) //or do something else
})
```
`convert` can also take the amount as a parameter.
```javascript
currencyConverter.convert(100).then((response) => {
console.log(response) //or do something else
})
```
To find the rates use the `rates` method.
```javascript
currencyConverter.rates().then((response) => {
console.log(response) //or do something else
})
```
Rates can be cached for currency pairs. To implement rate caching, instantiate an object of CurrencyConverter only once in your project, in a CurrencyConverter file, and setup rates caching then import the instance of CurrencyConverter from the CurrencyConverter file in your project across the rest of your project. Use chaining to convert currencies when caching is implemented. Below is an example of a CurrencyConverter file.
Note: Rates are not actually deleted after the ratesCacheDuration. The rate remains in the rates cache of the CurrencyConverter object until a request is made for the same currency pair at which point, the old rate is overwritten.
```javascript
const CC = require('currency-converter-lt')
let currencyConverter = new CC()
let ratesCacheOptions = {
isRatesCaching: true, // Set this boolean to true to implement rate caching
ratesCacheDuration: 3600 // Set this to a positive number to set the number of seconds you want the rates to be cached. Defaults to 3600 seconds (1 hour)
}
currencyConverter = currencyConverter.setupRatesCache(ratesCacheOptions)
module.exports = currencyConverter
```
Chaining is also supported.
```javascript
currencyConverter.from("USD").to("GBP").amount(125).convert().then((response) => {
console.log(response) //or do something else
})
```
## Disclaimer
This package uses web scraping to provide the api.
## Issues
If any issues are found, they can be reported [here](https://github.com/paul-shuvo/nodejs-currency-converter/issues).
## License
This project is licensed under the [MIT](LICENSE) license.