Initial commit

Author: otherguy

.gitignore

@@ -0,0 +1,16 @@
+### VisualStudioCode template
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+
+### Composer template
+composer.phar
+/vendor/
+
+### JetBrains template
+.idea/
+
+### PHPUnit
+build

.travis.yml

@@ -0,0 +1,17 @@
+language: php
+
+php:
+  - 7.1
+  - 7.2
+  - 7.3
+
+install:
+  - curl -s http://getcomposer.org/installer | php
+  - php composer.phar install --dev --no-interaction
+
+script:
+  - mkdir -p build/logs
+  - vendor/bin/phpunit --coverage-clover build/logs/clover.xml
+
+after_success:
+  - travis_retry php vendor/bin/php-coveralls

LICENSE.md

@@ -0,0 +1,25 @@
+The MIT License (MIT)
+=====================
+
+Copyright © `2019` [`@otherguy`](https://github.com/otherguy/)
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the “Software”), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -0,0 +1,76 @@
+# PHP 7 API Wrapper for Popular Currency Rate APIs
+
+[![Version](https://img.shields.io/packagist/v/otherguy/php-currency-api.svg?style=flat-square)](https://packagist.org/packages/otherguy/php-currency-api)
+[![GitHub issues](https://img.shields.io/github/issues/otherguy/php-currency-api.svg?style=flat-square)](https://github.com/otherguy/php-currency-api/issues)
+[![Travis CI](https://img.shields.io/travis/otherguy/php-currency-api.svg?style=flat-square)](https://travis-ci.com/otherguy/php-currency-api)
+[![Coverage](https://img.shields.io/coveralls/otherguy/php-currency-api.svg?style=flat-square)](https://coveralls.io/github/otherguy/php-currency-api?branch=master)
+[![GitHub](https://img.shields.io/github/license/otherguy/php-currency-api.svg?style=flat-square)](LICENSE.md)
+
+Dont worry about your favorite currency conversion service suddenly shutting down or switching plans on you. Switch away easily.
+
+## Inspiration
+
+I needed a currency conversion API for [my travel website]() but couldn't find a good PHP package. The idea of the 
+[`Rackbeat/php-currency-api`](https://github.com/Rackbeat/php-currency-api) package came closest but unfortunately it 
+was just a stub and not implemented. 
+
+## Supported APIs
+
+* [FixerIO](https://fixer.io) (`fixerio`)
+* [CurrencyLayer](https://currencylayer.com) (`currencylayer`)
+* [Open Exchange Rates](https://openexchangerates.org) (`openexchangerates`)
+
+## Prerequisites
+
+* PHP 7.1+
+* An account with one of the APIs above
+
+## Installation
+
+Just require the package using composer and you're good to go!
+
+```bash
+$ composer require otherguy/php-currency-api
+```
+
+## Usage
+
+### Initialize instance
+
+```php
+$api = Otherguy\Currency\API::make('fixerio'); // driver from supported drivers.
+```
+
+### Set base currency (default = USD)
+
+```php
+$api->setBase(Otherguy\Currency\Symbol::USD);
+```
+
+### Set symbols to return (default = all/[])
+
+```php
+$api->setSymbols([ Otherguy\Currency\Symbol::DKK, Otherguy\Currency\Symbol::EUR, Otherguy\Currency\Symbol::USD ]);
+```
+
+*Please note, you are not required to use `Otherguy\Currency\Symbol` to specify symbols. It's simply a convenience helper.*
+
+### Get latest rates
+
+```php
+$api->get(); // Get latest rates for selected symbols, using set base currency
+$api->get('DKK');  // Get latest rates for selected symbols, using DKK as base currency
+```
+
+### Convert amount from one currency to another
+
+```php
+$api->convert($fromCurrency = 'DKK', $toCurrency = 'EUR', 10.00); // Convert 10 DKK to EUR
+```
+
+### Get rate on specific date
+
+```php
+$api->historical($date = '2018-01-01'); // Get currency rate for base on 1st of January 2018
+$api->historical($date = '2018-01-01', 'GBP'); // Get currency rate for GBP on 1st of January 2018
+```

composer.json

@@ -0,0 +1,44 @@
+{
+	"name": "otherguy/php-currency-api",
+	"description": "Wrapper for multiple currency rate APIs",
+	"keywords": [
+		"currency",
+		"currency rates",
+		"exchange rates",
+		"currency conversion",
+		"api"
+	],
+	"type": "library",
+	"license": "MIT",
+	"authors": [
+		{
+			"name": "Alexander Graf",
+			"email": "alex@otherguy.io"
+		}
+	],
+	"require": {
+		"php": ">=7.1",
+		"rmccue/requests": ">=1.7"
+	},
+	"require-dev": {
+		"php-coveralls/php-coveralls": "^2.1",
+		"phpunit/php-code-coverage": "^6.1",
+		"phpunit/phpunit": "^7.0"
+	},
+	"suggest": {
+		"ext-curl": "Faster HTTP requests"
+	},
+	"autoload": {
+		"psr-4": {
+			"Otherguy\\Currency\\": "src/"
+		}
+	},
+	"autoload-dev": {
+		"psr-4": {
+			"Currency\\Tests\\": "tests/"
+		}
+	},
+	"config": {
+		"sort-packages": true
+	}
+}