Merge pull request florianv#150 from uguurozkan/implement-the-central-bank-of-the-republic-of-uzbekistan-service

Implement the Central Bank of the Republic of Uzbekistan Service

Author: florianv

README.md

@@ -49,6 +49,7 @@ Here is the complete list of the currently implemented services:
 | [European Central Bank](https://www.ecb.europa.eu/home/html/index.en.html) | EUR | * | 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 |
 | [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 |
 | [Central Bank of Russia](https://cbr.ru) | * | RUB | Yes |
 | [Bulgarian National Bank](http://bnb.bg) | * | BGN | Yes |

src/Service/CentralBankOfRepublicUzbekistan.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;
+
+/**
+ * The Central Bank of the Republic of Uzbekistan Service.
+ *
+ * @author Uğur Özkan
+ */
+final class CentralBankOfRepublicUzbekistan extends HttpService
+{
+    use SupportsHistoricalQueries;
+
+    private const BASE_URL = 'https://cbu.uz/common/json';
+
+    /**
+     * @inheritDoc
+     */
+    public function getName(): string
+    {
+        return 'central_bank_of_republic_uzbekistan';
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function supportQuery(ExchangeRateQuery $exchangeQuery): bool
+    {
+        return 'UZS' === $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);
+
+        $currencyInfo = array_values(array_filter($element, function ($currency) use ($currencyPair) {
+            return $currency['Ccy'] === $currencyPair->getBaseCurrency();
+        }));
+        if (!empty($currencyInfo)) {
+            $rate = (float) $currencyInfo[0]['Rate'];
+            $unit = (int) $currencyInfo[0]['Nominal'];
+
+            $date = new DateTime((string) $currencyInfo[0]['Date']);
+
+            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('d.m.Y');
+        }
+
+        return self::BASE_URL . $date;
+    }
+}

src/Service/Registry.php

@@ -21,14 +21,15 @@
 final class Registry
 {
     /**
-     * Returns a map of all supports services.
+     * Returns a map of all supported services.
      */
     public static function getServices(): array
     {
         return [
             'bulgarian_national_bank' => BulgarianNationalBank::class,
             'central_bank_of_czech_republic' => CentralBankOfCzechRepublic::class,
             'central_bank_of_republic_turkey' => CentralBankOfRepublicTurkey::class,
+            'central_bank_of_republic_uzbekistan' => CentralBankOfRepublicUzbekistan::class,
             'cryptonator' => Cryptonator::class,
             'currency_converter' => CurrencyConverter::class,
             'currency_data_feed' => CurrencyDataFeed::class,