ben-gibson/bryn

A PHP library for calculating monetary conversions. This repository contains the interfaces and domain models only.

Bryn

![Software License][ico-license] ![Total Downloads][ico-downloads], _(*1)

A PHP library acting as an abstraction layer for calculating monetary conversions. This repository contains the interfaces and domain models only., _(*2)

Demo

See a demo application using Bryn at https://bryn-demo.herokuapp.com/., _(*3)

Install

Use composer to install this library., _(*4)

``` bash $ composer require ben-gibson/bryn, <sub>(*5)</sub>

## Usage

An exchange rate calculator needs to be installed alongside this library like the ones below.

| Source        | Link           |  
| ------------- |:-------------:|   
| The European Central Bank | https://github.com/ben-gibson/bryn-european-central-bank-calculator |
| Yahoo's YQL Finance API | https://github.com/ben-gibson/bryn-yahoo-calculator |

To increase reliability the [bryn-fallback-calculator](https://github.com/ben-gibson/bryn-fallback-calculator) can be used by registering multiple calculators in priority order.

## Caching

TODO

## Change log

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

## Testing

``` bash
$ composer test

Contributing

Please see CONTRIBUTING for details., <sub>(*6)</sub>

Security

If you discover any security related issues, please email ben.gibson.2011@gmail.com instead of using the issue tracker., <sub>(*7)</sub>

Credits

• Ben Gibson
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*8)</sub>