hdx-python-country 4.2.8__tar.gz → 4.2.9__tar.gz

{hdx_python_country-4.2.8 → hdx_python_country-4.2.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: hdx-python-country
-Version: 4.2.8
+Version: 4.2.9
 Summary: HDX Python country code and exchange rate (fx) utilities
 Project-URL: Homepage, https://github.com/OCHA-DAP/hdx-python-country
 Project-URL: Repository, https://github.com/OCHA-DAP/hdx-python-country
@@ -26,12 +26,12 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.11
-Requires-Dist: hdx-python-utilities<5,>=4.2.6
+Requires-Dist: hdx-python-utilities<5,>=4.2.7
 Requires-Dist: tenacity
 Provides-Extra: docs
 Requires-Dist: mkapi; extra == 'docs'
 Provides-Extra: wfp
-Requires-Dist: data-bridges-client<10,>=9.0.0; extra == 'wfp'
+Requires-Dist: data-bridges-client<10,>=9.0.3; extra == 'wfp'
 Description-Content-Type: text/markdown
 
 [![Build Status](https://github.com/OCHA-DAP/hdx-python-country/actions/workflows/run-python-tests.yaml/badge.svg)](https://github.com/OCHA-DAP/hdx-python-country/actions/workflows/run-python-tests.yaml)

{hdx_python_country-4.2.8 → hdx_python_country-4.2.9}/pyproject.toml

@@ -35,13 +35,13 @@ dynamic = ["version"]
 requires-python = ">=3.11"
 
 dependencies = [
-    "hdx-python-utilities>=4.2.6,<5",
+    "hdx-python-utilities>=4.2.7,<5",
     "tenacity",
 ]
 
 [project.optional-dependencies]
 docs = ["mkapi"]
-wfp = ["data-bridges-client>=9.0.0,<10"]
+wfp = ["data-bridges-client>=9.0.3,<10"]
 
 [dependency-groups]
 dev = [
@@ -49,7 +49,7 @@ dev = [
     "pytest-cov",
     "pre-commit",
     "ruff==0.17.3",
-    "data-bridges-client>=9.0.0,<10",
+    "data-bridges-client>=9.0.3,<10",
 ]
 
 [project.urls]

{hdx_python_country-4.2.8 → hdx_python_country-4.2.9}/src/hdx/location/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '4.2.8'
-__version_tuple__ = version_tuple = (4, 2, 8)
+__version__ = version = '4.2.9'
+__version_tuple__ = version_tuple = (4, 2, 9)
 
 __commit_id__ = commit_id = None

hdx_python_country-4.2.9/src/hdx/location/wfp_api.py

@@ -0,0 +1,481 @@
+import csv
+import io
+import logging
+import types
+from collections.abc import Callable
+from datetime import date, datetime, timedelta
+from functools import cache, partial
+from os import getenv
+from typing import Annotated, Any, ClassVar, Union, get_args, get_origin
+
+from data_bridges_client import (
+    ApiClient,
+    ApiException,
+    CommoditiesApi,
+    Configuration,
+    CurrencyApi,
+    MarketPricesApi,
+    MarketsApi,
+)
+from data_bridges_client.exceptions import ServiceException
+from data_bridges_client.models.commodity_dto import CommodityDTO
+from data_bridges_client.models.currency_dto import CurrencyDTO
+from data_bridges_client.models.market_dto import MarketDTO
+from data_bridges_client.models.usd_indirect_quotation import UsdIndirectQuotation
+from data_bridges_client.models.view_extended_monthly_aggregated_price import (
+    ViewExtendedMonthlyAggregatedPrice,
+)
+from data_bridges_client.token import WfpApiToken
+from hdx.utilities.retriever import Retrieve
+from tenacity import (
+    Retrying,
+    after_log,
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_fixed,
+)
+
+logger = logging.getLogger(__name__)
+
+_CSV_DATE_FORMAT = "%m/%d/%Y %I:%M:%S %p"
+_PRICES_START_DATE = date(1990, 1, 1)
+
+
+def _default_end_date() -> date:
+    # WFP has forecast prices a year or more ahead
+    return date(date.today().year + 5, 12, 31)
+
+
+def _to_date(value: date | None, default: date) -> date:
+    if value is None:
+        return default
+    if isinstance(value, datetime):
+        return value.date()
+    return value
+
+
+def _csv_datetime(value: str) -> datetime:
+    return datetime.strptime(value, _CSV_DATE_FORMAT)
+
+
+def _csv_bool(value: str) -> bool:
+    return value == "True"
+
+
+def _csv_none(value: str) -> None:
+    return None
+
+
+def _field_types(annotation: Any) -> set:
+    origin = get_origin(annotation)
+    if origin is Annotated:
+        return _field_types(get_args(annotation)[0])
+    if origin in (Union, types.UnionType):
+        return set().union(
+            *(_field_types(x) for x in get_args(annotation) if x is not type(None))
+        )
+    return {origin or annotation}
+
+
+@cache
+def _csv_converters(model_cls: type) -> dict[str, Callable]:
+    """Map the JSON key of each non-string field of a data_bridges_client
+    model to a function that converts its CSV string value, based on the
+    field's type. List fields (CommodityDTO's qualities and processing) are
+    not in WFP's CSV output, so are always None.
+
+    Args:
+        model_cls: data_bridges_client model class
+
+    Returns:
+        Map from JSON key to converter function
+    """
+    converters = {}
+    for name, field in model_cls.model_fields.items():
+        if name == "additional_properties":
+            continue
+        field_types = _field_types(field.annotation)
+        if list in field_types:
+            converter = _csv_none
+        elif bool in field_types:
+            converter = _csv_bool
+        elif float in field_types:
+            converter = float
+        elif int in field_types:
+            converter = int
+        elif datetime in field_types:
+            converter = _csv_datetime
+        else:
+            continue
+        converters[field.alias or name] = converter
+    return converters
+
+
+def _parse_csv(text: str, model_cls: type) -> list:
+    """Parse WFP's CSV output into data_bridges_client model objects. CSV
+    headers are the JSON keys with the first letter capitalised and every
+    value is a string. Blank strings are kept as "" (as JSON returns them)
+    but blank values of non-string fields become None.
+
+    Args:
+        text: CSV text
+        model_cls: data_bridges_client model class of each row
+
+    Returns:
+        List of model_cls objects
+    """
+    converters = _csv_converters(model_cls)
+    reader = csv.reader(io.StringIO(text))
+    keys = [header[0].lower() + header[1:] for header in next(reader, [])]
+    columns = [(key, converters.get(key)) for key in keys]
+    items = []
+    for row in reader:
+        if not row:
+            continue
+        obj = {}
+        for (key, converter), value in zip(columns, row):
+            if converter:
+                value = converter(value) if value else None
+            obj[key] = value
+        items.append(model_cls.from_dict(obj))
+    return items
+
+
+class WFPAPI:
+    """Light wrapper around WFP's data-bridges-client library. All data is
+    requested as CSV, which returns every row in one response, rather than
+    JSON, whose paging returns some rows twice and leaves others out. It
+    needs a retriever used only to decide whether to load from disk or hit
+    the network and whether to persist the network result (as the CSV
+    returned by WFP). Token refreshing is delegated to data_bridges_client's
+    own WfpApiToken.
+
+    Args:
+        retriever: Retrieve object for interacting with WFP API
+    """
+
+    default_retry_params: ClassVar[dict[str, Any]] = {
+        "retry": retry_if_exception_type(ApiException),
+        "after": after_log(logger, logging.INFO),
+    }
+
+    def __init__(
+        self,
+        retriever: Retrieve,
+        wfp_key: str | None = None,
+        wfp_secret: str | None = None,
+    ):
+        self.retriever = retriever
+        self.retry_params = {"attempts": 1, "wait": 1}
+        if wfp_key:
+            self._wfp_key = wfp_key
+        else:
+            self._wfp_key = getenv("WFP_KEY")
+        if wfp_secret:
+            self._wfp_secret = wfp_secret
+        else:
+            self._wfp_secret = getenv("WFP_SECRET")
+        self.token = WfpApiToken(api_key=self._wfp_key, api_secret=self._wfp_secret)
+        self.configuration = Configuration()
+        self.api_client = ApiClient(self.configuration)
+        self.currency_api = CurrencyApi(self.api_client)
+        self.markets_api = MarketsApi(self.api_client)
+        self.commodities_api = CommoditiesApi(self.api_client)
+        self.market_prices_api = MarketPricesApi(self.api_client)
+
+    def get_retry_params(self) -> dict:
+        return self.retry_params
+
+    def update_retry_params(self, attempts: int, wait: int) -> dict:
+        self.retry_params["attempts"] = attempts
+        self.retry_params["wait"] = wait
+        return self.retry_params
+
+    def refresh_token(self) -> None:
+        self.configuration.access_token = self.token.refresh()
+
+    def _with_retry(self, api_method: Callable, **kwargs: Any) -> Any:
+        retryer = Retrying(
+            retry=self.default_retry_params["retry"],
+            after=self.default_retry_params["after"],
+            stop=stop_after_attempt(self.retry_params["attempts"]),
+            wait=wait_fixed(self.retry_params["wait"]),
+        )
+        for attempt in retryer:
+            with attempt:
+                try:
+                    return api_method(**kwargs)
+                except ApiException as err:
+                    if err.status not in (104, 401, 403):
+                        raise
+                    self.refresh_token()
+                    return api_method(**kwargs)
+
+    @staticmethod
+    def _get_csv(api_method: Callable, **kwargs: Any) -> str:
+        """Call a data_bridges_client API method's _without_preload_content
+        variant with format CSV, raising ApiException (as the methods that
+        parse JSON do) if the response is not OK.
+
+        Args:
+            api_method: Bound _without_preload_content method
+            **kwargs: Parameters to pass to api_method
+
+        Returns:
+            CSV text
+        """
+        response = api_method(format="CSV", **kwargs)
+        text = response.data.decode("utf-8-sig")
+        if response.status != 200:
+            ApiException.from_response(http_resp=response, body=text, data=None)
+        return text
+
+    def _call(
+        self, csv_method: Callable, filename: str, log: str, **kwargs: Any
+    ) -> str | None:
+        """Get CSV text from csv_method, loading from or saving to disk as
+        Retrieve does.
+
+        Args:
+            csv_method: Function returning CSV text
+            filename: Filename of saved file
+            log: Text to use in log string to describe the call
+            **kwargs: Parameters to pass to csv_method
+
+        Returns:
+            CSV text, or None if there is no saved data
+        """
+        filename, _ = self.retriever.get_filename("", filename)
+        saved_path = self.retriever.saved_dir / filename
+        if self.retriever.use_saved:
+            logger.info(f"Using saved {log} in {saved_path}")
+            try:
+                with open(saved_path, encoding="utf-8", newline="") as f:
+                    return f.read()
+            except FileNotFoundError:
+                return None
+        text = self._with_retry(csv_method, **kwargs)
+        if self.retriever.save:
+            logger.info(f"Saving {log} in {saved_path}")
+            with open(saved_path, "w", encoding="utf-8", newline="") as f:
+                f.write(text)
+        return text
+
+    @staticmethod
+    def _countryiso3s(countryiso3: str | None) -> list:
+        if countryiso3 == "PSE":  # hack as PSE is treated by WFP as 2 areas
+            return ["PSW", "PSG"]
+        return [countryiso3]
+
+    def _get_all(
+        self,
+        api_method: Callable,
+        model_cls: type,
+        base_filename: str,
+        countryiso3: str | None,
+        country_param: str,
+        extra_params: dict,
+        get_csv: Callable | None = None,
+    ) -> list:
+        csv_method = partial(get_csv or self._get_csv, api_method)
+        all_items = []
+        for country in self._countryiso3s(countryiso3):
+            kwargs = dict(extra_params)
+            if country is None:
+                filename = f"{base_filename}.csv"
+                log = base_filename
+            else:
+                kwargs[country_param] = country
+                filename = f"{base_filename}_{country}.csv"
+                log = f"{base_filename} for {country}"
+            text = self._call(csv_method, filename, log, **kwargs)
+            if text:
+                all_items.extend(_parse_csv(text, model_cls))
+        return all_items
+
+    def get_currencies(
+        self, countryiso3: str | None = None, currency: str | None = None
+    ) -> list[CurrencyDTO]:
+        """Get list of currencies from the WFP API.
+
+        Args:
+            countryiso3: Country for which to obtain data. Defaults to all countries.
+            currency: Currency 3-letter code to filter by. Defaults to all currencies.
+
+        Returns:
+            List of currencies from the WFP API
+        """
+        if currency:
+            base_filename = f"Currency_List_{currency.upper()}"
+            extra_params = {"currency_name": currency}
+        else:
+            base_filename = "Currency_List"
+            extra_params = {}
+        return self._get_all(
+            self.currency_api.currency_list_get_without_preload_content,
+            CurrencyDTO,
+            base_filename,
+            countryiso3,
+            "country_code",
+            extra_params,
+        )
+
+    def get_currency_usd_indirect_quotations(
+        self, currency: str, countryiso3: str | None = None
+    ) -> list[UsdIndirectQuotation]:
+        """Get USD indirect quotations for a currency from the WFP API.
+
+        Args:
+            currency: Currency 3-letter code
+            countryiso3: Country for which to obtain data. Defaults to all countries.
+
+        Returns:
+            List of USD indirect quotations from the WFP API
+        """
+        return self._get_all(
+            self.currency_api.currency_usd_indirect_quotation_get_without_preload_content,
+            UsdIndirectQuotation,
+            f"Currency_UsdIndirectQuotation_{currency.upper()}",
+            countryiso3,
+            # this endpoint uses country_iso3, unlike every other one here which
+            # uses country_code - don't "fix" this to country_code
+            "country_iso3",
+            {"currency_name": currency},
+        )
+
+    def get_markets(self, countryiso3: str | None = None) -> list[MarketDTO]:
+        """Get list of markets from the WFP API.
+
+        Args:
+            countryiso3: Country for which to obtain data. Defaults to all countries.
+
+        Returns:
+            List of markets from the WFP API
+        """
+        return self._get_all(
+            self.markets_api.markets_list_get_without_preload_content,
+            MarketDTO,
+            "Markets_List",
+            countryiso3,
+            "country_code",
+            {},
+        )
+
+    def get_commodities(self, countryiso3: str | None = None) -> list[CommodityDTO]:
+        """Get list of commodities from the WFP API. WFP's CSV output does not
+        include qualities and processing, so they are None.
+
+        Args:
+            countryiso3: Country for which to obtain data. Defaults to all countries.
+
+        Returns:
+            List of commodities from the WFP API
+        """
+        return self._get_all(
+            self.commodities_api.commodities_list_get_without_preload_content,
+            CommodityDTO,
+            "Commodities_List",
+            countryiso3,
+            "country_code",
+            {},
+        )
+
+    def get_commodity_categories(
+        self, countryiso3: str | None = None
+    ) -> list[CommodityDTO]:
+        """Get list of commodity categories from the WFP API.
+
+        Args:
+            countryiso3: Country for which to obtain data. Defaults to all countries.
+
+        Returns:
+            List of commodity categories from the WFP API
+        """
+        return self._get_all(
+            self.commodities_api.commodities_categories_list_get_without_preload_content,
+            CommodityDTO,
+            "Commodities_Categories_List",
+            countryiso3,
+            "country_code",
+            {},
+        )
+
+    def _get_prices_csv_range(
+        self, api_method: Callable, start_date: date, end_date: date, **kwargs: Any
+    ) -> list[str]:
+        """Get monthly aggregated market prices between two dates (inclusive)
+        as CSV. If the API gateway times out (504), the date range is split in
+        two and each half is requested.
+
+        Args:
+            api_method: Bound market_prices_price_monthly_get_without_preload_content
+            start_date: Start date
+            end_date: End date
+            **kwargs: Parameters to pass to api_method
+
+        Returns:
+            List of CSV texts, one per date range, in date order
+        """
+        try:
+            return [
+                self._get_csv(
+                    api_method, start_date=start_date, end_date=end_date, **kwargs
+                )
+            ]
+        except ServiceException as err:
+            if err.status != 504 or start_date >= end_date:
+                raise
+        middle = start_date + (end_date - start_date) // 2
+        logger.info(
+            f"Timeout getting prices from {start_date} to {end_date}, splitting at {middle}"
+        )
+        return self._get_prices_csv_range(
+            api_method, start_date, middle, **kwargs
+        ) + self._get_prices_csv_range(
+            api_method, middle + timedelta(days=1), end_date, **kwargs
+        )
+
+    def _get_prices_csv(
+        self,
+        api_method: Callable,
+        start_date: date | None = None,
+        end_date: date | None = None,
+        **kwargs: Any,
+    ) -> str:
+        first, *rest = self._get_prices_csv_range(
+            api_method,
+            _to_date(start_date, _PRICES_START_DATE),
+            _to_date(end_date, _default_end_date()),
+            **kwargs,
+        )
+        if not rest:
+            return first
+        # keep only the first range's header row
+        parts = [first.rstrip("\r\n")]
+        parts.extend(text.partition("\n")[2].rstrip("\r\n") for text in rest)
+        return "\r\n".join(part for part in parts if part) + "\r\n"
+
+    def get_market_prices_monthly(
+        self, countryiso3: str | None = None, **kwargs: Any
+    ) -> list[ViewExtendedMonthlyAggregatedPrice]:
+        """Get monthly aggregated market prices from the WFP API.
+
+        Args:
+            countryiso3: Country for which to obtain data. Defaults to all countries.
+            **kwargs: Additional filters accepted by
+                data_bridges_client's MarketPricesApi.market_prices_price_monthly_get,
+                e.g. market_id, commodity_id, price_type_name, currency_id,
+                price_flag, start_date, end_date, latest_value_only
+
+        Returns:
+            List of monthly aggregated market prices from the WFP API
+        """
+        return self._get_all(
+            self.market_prices_api.market_prices_price_monthly_get_without_preload_content,
+            ViewExtendedMonthlyAggregatedPrice,
+            "MarketPrices_PriceMonthly",
+            countryiso3,
+            "country_code",
+            kwargs,
+            self._get_prices_csv,
+        )

hdx_python_country-4.2.9/tests/fixtures/wfp/Currency_List.csv

@@ -0,0 +1,129 @@
+"Id","Name","ExtendedName","CreateDate","UpdateDate"
+"131","AED","United Arab Emirates Dirham","8/2/2021 6:24:29 PM","10/5/2023 4:05:48 PM"
+"87","AFN","Afghan Afghani","4/22/2020 10:02:26 PM","10/5/2023 4:06:06 PM"
+"130","ALL","Albanian Lek","8/2/2021 6:22:53 PM","10/5/2023 4:06:11 PM"
+"37","AMD","Armenian Dram","4/22/2020 10:02:26 PM","10/5/2023 4:06:16 PM"
+"96","AOA","Angolan Kwanza","4/22/2020 10:02:26 PM","10/5/2023 3:07:06 PM"
+"106","ARS","Argentine Peso","4/22/2020 10:02:26 PM","10/5/2023 4:06:22 PM"
+"133","AUD","Australian Dollar","8/2/2021 6:28:54 PM","10/5/2023 4:06:28 PM"
+"36","AZN","Azerbaijani Manat","4/22/2020 10:02:26 PM","10/5/2023 4:06:33 PM"
+"25","BDT","Bangladeshi Taka","4/22/2020 10:02:26 PM","10/5/2023 4:06:39 PM"
+"132","BGN","Bulgarian Lev","8/2/2021 6:27:55 PM","10/5/2023 4:06:45 PM"
+"138","BHD","Bahraini Dinar","10/4/2021 6:28:31 PM","10/5/2023 4:06:52 PM"
+"32","BIF","Burundian Franc","4/22/2020 10:02:26 PM","10/5/2023 4:05:30 PM"
+"46","BOB","Boliviano","4/22/2020 10:02:26 PM","10/5/2023 4:07:16 PM"
+"159","BRL","Brazilian Real","1/19/2024 10:08:31 AM",""
+"144","BSD","Bahamian Dollar","11/16/2021 1:56:25 PM","10/5/2023 4:09:05 PM"
+"76","BTN","Bhutanese Ngultrum","4/22/2020 10:02:26 PM","10/5/2023 4:07:41 PM"
+"148","BWP","Botswana Pula","9/9/2022 8:56:59 AM",""
+"107","BYR","Belarusian Ruble","4/22/2020 10:02:26 PM","10/5/2023 4:08:22 PM"
+"27","CDF","Congolese Franc","4/22/2020 10:02:26 PM","10/5/2023 4:08:43 PM"
+"108","CLP","Chilean Peso","4/22/2020 10:02:26 PM","10/5/2023 4:08:58 PM"
+"109","CNY","Renminbi","4/22/2020 10:02:26 PM","10/5/2023 4:09:23 PM"
+"67","COP","Colombian Peso","4/22/2020 10:02:26 PM","10/5/2023 4:09:51 PM"
+"92","CRC","Costa Rican Colon","4/22/2020 10:02:26 PM","10/5/2023 4:10:04 PM"
+"134","CUC","Cuban Convertible Pesos","8/2/2021 7:18:01 PM","10/5/2023 4:10:15 PM"
+"127","CUP","Cuban Peso","7/23/2021 10:23:48 AM","7/23/2021 10:24:03 AM"
+"57","CVE","Cape Verdean Escudo","4/22/2020 10:02:26 PM","10/5/2023 4:10:33 PM"
+"59","DJF","Djiboutian Franc","4/22/2020 10:02:26 PM","10/5/2023 4:10:45 PM"
+"85","DOP","Dominican Peso","4/22/2020 10:02:26 PM","10/5/2023 4:11:12 PM"
+"91","DZD","Algerian Dinar","4/22/2020 10:02:26 PM","10/5/2023 4:11:26 PM"
+"38","EGP","Egyptian Pound","4/22/2020 10:02:26 PM","10/5/2023 4:11:39 PM"
+"110","ERN","Eritrean Nakfa","4/22/2020 10:02:26 PM","10/5/2023 4:11:53 PM"
+"47","ETB","Ethiopian Birr","4/22/2020 10:02:26 PM","10/5/2023 4:12:07 PM"
+"111","EUR","Euro","4/22/2020 10:02:26 PM","10/5/2023 4:12:17 PM"
+"146","FJD","Fijian dollar","11/16/2021 1:59:56 PM",""
+"50","GEL","Georgian Lari","4/22/2020 10:02:26 PM","10/5/2023 4:12:32 PM"
+"35","GHS","Ghanaian Cedi","4/22/2020 10:02:26 PM","10/5/2023 4:12:51 PM"
+"42","GMD","Gambian Dalasi","4/22/2020 10:02:26 PM","10/5/2023 4:13:02 PM"
+"54","GNF","Guinean Franc","4/22/2020 10:02:26 PM","10/5/2023 4:13:27 PM"
+"82","GTQ","Guatemalan Quetzal","4/22/2020 10:02:26 PM","10/5/2023 4:13:42 PM"
+"112","HNL","Honduran Lempira","4/22/2020 10:02:26 PM","10/5/2023 4:14:02 PM"
+"24","HTG","Haitian Gourde","4/22/2020 10:02:26 PM","10/5/2023 4:16:54 PM"
+"34","IDR","Indonesian Rupiah","4/22/2020 10:02:26 PM","10/5/2023 4:51:09 PM"
+"73","ILS","New Israeli Shekel","4/22/2020 10:02:26 PM","9/20/2021 5:55:14 PM"
+"68","INR","Indian Rupee","4/22/2020 10:02:26 PM","10/5/2023 4:51:24 PM"
+"84","IQD","Iraqi Dinar","4/22/2020 10:02:26 PM","10/5/2023 4:51:42 PM"
+"89","IRR","Iranian Rial","4/22/2020 10:02:26 PM","10/5/2023 4:52:01 PM"
+"139","JMD","Jamaican Dollar","11/16/2021 1:50:01 PM","11/16/2021 1:51:47 PM"
+"58","JOD","Jordanian Dinar","4/22/2020 10:02:26 PM","10/5/2023 4:52:13 PM"
+"113","JPY","Japanese Yen","4/22/2020 10:02:26 PM","10/5/2023 4:52:25 PM"
+"30","KES","Kenyan Shilling","4/22/2020 10:02:26 PM","10/5/2023 5:20:23 PM"
+"61","KGS","Kyrgyzstani Som","4/22/2020 10:02:26 PM","10/5/2023 5:20:37 PM"
+"60","KHR","Cambodian Riel","4/22/2020 10:02:26 PM","10/5/2023 5:20:54 PM"
+"149","KMF","Comorian Franc","9/9/2022 8:58:07 AM",""
+"141","KPW","North Korean Won","11/16/2021 1:53:56 PM",""
+"145","KYD","Cayman Islands Dollar","11/16/2021 1:57:58 PM","10/5/2023 5:21:02 PM"
+"99","KZT","Kazakhstani Tenge","4/22/2020 10:02:26 PM","10/5/2023 5:21:22 PM"
+"63","LAK","Lao Kip","4/22/2020 10:02:26 PM","10/5/2023 5:21:33 PM"
+"90","LBP","Lebanese Pound","4/22/2020 10:02:26 PM","10/5/2023 5:21:44 PM"
+"55","LKR","Sri Lankan Rupee","4/22/2020 10:02:26 PM","10/5/2023 5:21:55 PM"
+"40","LRD","Liberian Dollar","4/22/2020 10:02:26 PM","10/5/2023 5:22:08 PM"
+"56","LSL","Lesotho Loti","4/22/2020 10:02:26 PM","10/5/2023 5:22:20 PM"
+"97","LYD","Libyan Dinar","4/22/2020 10:02:26 PM","10/5/2023 5:22:34 PM"
+"101","MAD","Moroccan Dirham","4/22/2020 10:02:26 PM","10/5/2023 5:22:45 PM"
+"100","MDL","Moldovan Leu","4/22/2020 10:02:26 PM","10/5/2023 5:22:56 PM"
+"65","MGA","Malagasy Ariary","4/22/2020 10:02:26 PM","10/5/2023 5:23:11 PM"
+"74","MMK","Myanmar Kyat","4/22/2020 10:02:26 PM","10/5/2023 5:23:21 PM"
+"114","MNT","Mongolian Tögrög","4/22/2020 10:02:26 PM","10/5/2023 5:23:37 PM"
+"64","MRO","Mauritanian Ouguiya","4/22/2020 10:02:26 PM","10/5/2023 5:23:52 PM"
+"147","MRU","Ouguiya","5/18/2022 2:54:28 PM","5/20/2022 2:29:42 PM"
+"66","MWK","Malawian Kwacha","4/22/2020 10:02:26 PM","10/5/2023 5:24:11 PM"
+"115","MXN","Mexican Peso","4/22/2020 10:02:26 PM","10/5/2023 5:24:27 PM"
+"51","MZN","Mozambican Metical","4/22/2020 10:02:26 PM","10/6/2023 1:09:29 PM"
+"116","NAD","Namibian Dollar","4/22/2020 10:02:26 PM","10/6/2023 1:09:36 PM"
+"95","NGN","Nigerian Naira","4/22/2020 10:02:26 PM","10/6/2023 1:09:47 PM"
+"86","NIO","Nicaraguan Córdoba","4/22/2020 10:02:26 PM","10/6/2023 1:10:00 PM"
+"152","NOK","Norwegian krone","10/6/2023 1:10:24 PM",""
+"62","NPR","Nepalese Rupee","4/22/2020 10:02:26 PM","10/6/2023 1:10:37 PM"
+"153","NZD","New Zealand Dollar","10/6/2023 1:11:01 PM",""
+"154","OMR","Omani Rial","10/6/2023 1:11:20 PM",""
+"117","PAB","Panamanian Balboa","4/22/2020 10:02:26 PM","10/6/2023 1:11:45 PM"
+"33","PEN","Peruvian Sol","4/22/2020 10:02:26 PM","10/6/2023 1:11:54 PM"
+"140","PGK","Papua New Guinean Kina","11/16/2021 1:51:13 PM","11/16/2021 1:51:20 PM"
+"29","PHP","Philippine Peso","4/22/2020 10:02:26 PM","10/6/2023 1:12:31 PM"
+"45","PKR","Pakistani Rupee","4/22/2020 10:02:26 PM","10/6/2023 1:12:45 PM"
+"155","PLN","Polish złoty","10/6/2023 1:12:59 PM",""
+"161","PRB","Transnistrian ruble","4/25/2025 3:32:06 PM","4/28/2025 12:12:16 PM"
+"118","PYG","Paraguayan Guaraní","4/22/2020 10:02:26 PM","10/6/2023 1:13:08 PM"
+"156","RON","Romanian Leu","10/6/2023 1:14:01 PM",""
+"102","RUB","Russian Ruble","4/22/2020 10:02:26 PM","10/6/2023 1:13:29 PM"
+"77","RWF","Rwandan Franc","4/22/2020 10:02:26 PM","10/6/2023 1:14:15 PM"
+"103","SAR","Saudi Riyal","4/22/2020 10:02:26 PM","10/6/2023 1:14:24 PM"
+"150","SBD","Solomon Islands Dollar","9/9/2022 10:23:48 AM","10/6/2023 1:14:30 PM"
+"157","SCR","Seychelles Rupee","10/6/2023 1:14:55 PM",""
+"75","SDG","Sudanese Pound","4/22/2020 10:02:26 PM","10/6/2023 1:15:03 PM"
+"158","SEK","Swedish Krona ","10/6/2023 1:15:21 PM",""
+"53","SLL","Sierra Leonean Leone ","4/22/2020 10:02:26 PM","5/13/2026 12:17:23 PM"
+"81","SLS","Somaliland Shilling","4/22/2020 10:02:26 PM","5/13/2020 7:08:07 PM"
+"79","SOS","Somali Shilling","4/22/2020 10:02:26 PM","10/6/2023 1:15:54 PM"
+"137","SRD","Surinamese dollar","9/3/2021 4:47:19 PM",""
+"83","SSP","South Sudanese Pound","4/22/2020 10:02:26 PM","10/6/2023 1:16:09 PM"
+"142","STN","São Tomé and Príncipe Dobra","11/16/2021 1:54:49 PM","2/4/2022 6:49:22 PM"
+"78","SYP","Syrian Pound","4/22/2020 10:02:26 PM","10/6/2023 1:16:20 PM"
+"23","SZL","Swazi Lilangeni","4/22/2020 10:02:26 PM","10/6/2023 1:16:32 PM"
+"119","THB","Thai Baht","4/22/2020 10:02:26 PM","10/6/2023 1:16:43 PM"
+"49","TJS","Tajikistani Somoni","4/22/2020 10:02:26 PM","10/6/2023 1:16:53 PM"
+"105","TMT","Turkmenistan Manat","4/22/2020 10:02:26 PM","10/6/2023 1:17:03 PM"
+"104","TND","Tunisian Dinar","4/22/2020 10:02:26 PM","10/6/2023 1:17:16 PM"
+"88","TRY","Turkish Lira","4/22/2020 10:02:26 PM","10/6/2023 1:17:27 PM"
+"143","TTD","Trinidad and Tobago dollar","11/16/2021 1:55:49 PM",""
+"22","TZS","Tanzanian Shilling","4/22/2020 10:02:26 PM","10/6/2023 1:17:41 PM"
+"93","UAH","Ukrainian Hryvnia","4/22/2020 10:02:26 PM","10/6/2023 1:17:49 PM"
+"39","UGX","Ugandan Shilling","4/22/2020 10:02:26 PM","10/6/2023 1:18:00 PM"
+"28","USD","United States Dollar","4/22/2020 10:02:26 PM","10/6/2023 1:18:14 PM"
+"120","UYU","Uruguayan Peso","4/22/2020 10:02:26 PM","2/4/2022 7:02:54 PM"
+"121","UZS","Uzbekistan Sum","4/22/2020 10:02:26 PM","10/6/2023 1:18:39 PM"
+"98","VEF","","4/22/2020 10:02:26 PM",""
+"135","VES","Venezuelan Bolivar","8/27/2021 3:20:05 PM",""
+"122","VND","Vietnamese Dong","4/22/2020 10:02:26 PM","10/6/2023 1:19:04 PM"
+"151","VUV","Vanuatu Vatu","9/9/2022 10:27:13 AM",""
+"123","WST","Samoan Tala","4/22/2020 10:02:26 PM","10/6/2023 1:19:15 PM"
+"48","XAF","CFA franc BEAC","4/22/2020 10:02:26 PM","10/6/2023 1:19:28 PM"
+"129","XCD","East Caribbean dollar","8/2/2021 6:17:10 PM",""
+"26","XOF","CFA franc BCEAO","4/22/2020 10:02:26 PM","10/6/2023 1:19:46 PM"
+"31","YER","Yemeni Rial","4/22/2020 10:02:26 PM","10/6/2023 1:19:55 PM"
+"124","ZAR","South African Rand","4/22/2020 10:02:26 PM","10/6/2023 1:20:04 PM"
+"160","ZiG","Zimbabwe Gold","5/10/2024 4:34:21 PM","5/16/2024 8:03:21 PM"
+"94","ZMW","Zambian Kwacha","4/22/2020 10:02:26 PM","9/9/2022 10:19:57 AM"
+"125","ZWL","Zimbabwean Dollar","4/22/2020 10:02:26 PM","5/10/2024 4:34:31 PM"