Merge pull request florianv#151 from uguurozkan/implement-national-bank-of-georgia-service

Implement National Bank of Georgia Service

Author: florianv

README.md

@@ -47,8 +47,10 @@ Here is the complete list of the currently implemented services:
 | [Abstract](https://www.abstractapi.com) | * | * | Yes |
 | [coinlayer](https://coinlayer.com) | * Crypto (Limited standard currencies) | * Crypto (Limited standard currencies) | Yes |
 | [European Central Bank](https://www.ecb.europa.eu/home/html/index.en.html) | EUR | * | Yes |
+| [National Bank of Georgia](https://nbg.gov.ge) | * | GEL | Yes |
 | [National Bank of the Republic of Belarus](https://www.nbrb.by) | * | BYN (from 01-07-2016),<br>BYR (01-01-2000 - 30-06-2016),<br>BYB (25-05-1992 - 31-12-1999) | Yes |
 | [National Bank of Romania](http://www.bnr.ro) | RON, AED, AUD, BGN, BRL, CAD, CHF, CNY, CZK, DKK, EGP, EUR, GBP, HRK, HUF, INR, JPY, KRW, MDL, MXN, NOK, NZD, PLN, RSD, RUB, SEK, TRY, UAH, USD, XAU, XDR, ZAR | RON, AED, AUD, BGN, BRL, CAD, CHF, CNY, CZK, DKK, EGP, EUR, GBP, HRK, HUF, INR, JPY, KRW, MDL, MXN, NOK, NZD, PLN, RSD, RUB, SEK, TRY, UAH, USD, XAU, XDR, ZAR | Yes |
+| [National Bank of Ukranie](https://bank.gov.ua) | * | UAH | Yes |
 | [Central Bank of the Republic of Turkey](http://www.tcmb.gov.tr) | * | TRY | Yes |
 | [Central Bank of the Republic of Uzbekistan](https://cbu.uz) | * | UZS | Yes |
 | [Central Bank of the Czech Republic](https://www.cnb.cz) | * | CZK | Yes |

src/Service/NationalBankOfGeorgia.php

@@ -0,0 +1,118 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of Exchanger.
+ *
+ * (c) Florian Voutzinos <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Exchanger\Service;
+
+use DateTime;
+use DateTimeInterface;
+use Exception;
+use Exchanger\Contract\ExchangeRate;
+use Exchanger\Contract\ExchangeRateQuery;
+use Exchanger\Contract\HistoricalExchangeRateQuery;
+use Exchanger\Exception\UnsupportedCurrencyPairException;
+use Exchanger\StringUtil;
+
+/**
+ * National Bank of Georgia Service.
+ *
+ * @author Uğur Özkan
+ */
+final class NationalBankOfGeorgia extends HttpService
+{
+    use SupportsHistoricalQueries;
+
+    private const BASE_URL = 'https://nbg.gov.ge/gw/api/ct/monetarypolicy/currencies/en/json';
+
+    /**
+     * @inheritDoc
+     */
+    public function getName(): string
+    {
+        return 'national_bank_of_georgia';
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function supportQuery(ExchangeRateQuery $exchangeQuery): bool
+    {
+        return 'GEL' === $exchangeQuery->getCurrencyPair()->getQuoteCurrency();
+    }
+
+    /**
+     * @inheritDoc
+     * @throws UnsupportedCurrencyPairException
+     */
+    protected function getLatestExchangeRate(ExchangeRateQuery $exchangeQuery): ExchangeRate
+    {
+        return $this->doCreateRate($exchangeQuery);
+    }
+
+    /**
+     * @inheritDoc
+     * @throws UnsupportedCurrencyPairException
+     */
+    protected function getHistoricalExchangeRate(HistoricalExchangeRateQuery $exchangeQuery): ExchangeRate
+    {
+        return $this->doCreateRate($exchangeQuery, $exchangeQuery->getDate());
+    }
+
+    /**
+     * Creates the rate.
+     *
+     * @param ExchangeRateQuery $exchangeQuery
+     * @param DateTimeInterface|null $requestedDate
+     *
+     * @return ExchangeRate
+     * @throws UnsupportedCurrencyPairException
+     * @throws Exception
+     */
+    private function doCreateRate(ExchangeRateQuery $exchangeQuery, DateTimeInterface $requestedDate = null): ExchangeRate
+    {
+        $currencyPair = $exchangeQuery->getCurrencyPair();
+
+        $content = $this->request($this->buildUrl($requestedDate));
+        $element = StringUtil::jsonToArray($content)[0];
+
+        $date = new DateTime((string) $element['date']);
+
+        $currencyInfo = array_values(array_filter($element['currencies'], function ($currency) use ($currencyPair) {
+            return $currency['code'] === $currencyPair->getBaseCurrency();
+        }));
+        if (!empty($currencyInfo)) {
+            $rate = (float) $currencyInfo[0]['rate'];
+            $unit = (int) $currencyInfo[0]['quantity'];
+
+            return $this->createRate($currencyPair, ($rate / $unit), $date);
+        }
+
+        throw new UnsupportedCurrencyPairException($currencyPair, $this);
+    }
+
+    /**
+     * Builds the url.
+     *
+     * @param DateTimeInterface|null $requestedDate
+     *
+     * @return string
+     */
+    private function buildUrl(DateTimeInterface $requestedDate = null): string
+    {
+        $date = '';
+        if (!is_null($requestedDate)) {
+            $date = '?date=' . $requestedDate->format('Y-m-d');
+        }
+
+        return self::BASE_URL . $date;
+    }
+}

src/Service/Registry.php

@@ -39,14 +39,15 @@ public static function getServices(): array
             'fixer' => Fixer::class,
             'fixer_apilayer' => FixerApiLayer::class,
             'forge' => Forge::class,
+            'national_bank_of_georgia' => NationalBankOfGeorgia::class,
             'national_bank_of_republic_belarus' => NationalBankOfRepublicBelarus::class,
             'national_bank_of_romania' => NationalBankOfRomania::class,
+            'national_bank_of_ukraine' => NationalBankOfUkraine::class,
             'open_exchange_rates' => OpenExchangeRates::class,
             'array' => PhpArray::class,
             'russian_central_bank' => RussianCentralBank::class,
             'webservicex' => WebserviceX::class,
             'xignite' => Xignite::class,
-            'national_bank_of_ukraine' => NationalBankOfUkraine::class,
             'coin_layer' => CoinLayer::class,
             'xchangeapi' => XchangeApi::class,
             'fastforex' => FastForex::class,