forexrates 0.0.1.dev0__tar.gz

forexrates-0.0.1.dev0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Debmalya Pramanik
+
+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.

forexrates-0.0.1.dev0/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: forexrates
+Version: 0.0.1.dev0
+Summary: A unified codebase for fetching FOREX rates.
+Home-page: https://github.com/sharkutilities/forexrates
+Author: shark-utilities developers
+Author-email: shark-utilities developers <neuralNOD@outlook.com>
+License: MIT License
+Project-URL: Homepage, https://github.com/sharkutilities/forexrates
+Project-URL: Issue Tracker, https://github.com/sharkutilities/forexrates/issues
+Project-URL: Org. Homepage, https://github.com/sharkutilities
+Keywords: forex,api,exchange rates,foreign exchange rates,wrappers,data science,data analysis,data scientist,data analyst
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: Unix
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.11
+License-File: LICENSE
+Requires-Dist: numpy==2.4.2
+Requires-Dist: pandas==3.0.0
+Requires-Dist: psycopg==3.3.2
+Requires-Dist: psycopg-binary==3.3.2
+Requires-Dist: requests==2.32.5
+Requires-Dist: SQLAlchemy==2.0.0
+Requires-Dist: tqdm==4.67.3
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python

forexrates-0.0.1.dev0/forexrates/__init__.py

@@ -0,0 +1,16 @@
+# -*- encoding: utf-8 -*-
+
+"""
+A Python Package to Fetch FOREX Rates from API Sources
+
+An one place that integrates different paid/open source API sources
+to fetch foreign exchange rates.
+"""
+
+# ? package follows https://peps.python.org/pep-0440/
+# ? https://python-semver.readthedocs.io/en/latest/advanced/convert-pypi-to-semver.html
+__version__ = "v0.0.1.dev0"
+
+# init-time options registrations
+from forexrates import io
+from forexrates import api

forexrates-0.0.1.dev0/forexrates/api/__init__.py

@@ -0,0 +1 @@
+from forexrates.api.exchangerates import ExchangeRatesAPI

forexrates-0.0.1.dev0/forexrates/api/base.py

@@ -0,0 +1,142 @@
+# -*- encoding: utf-8 -*-
+
+"""
+Base API Class Wrapper and Structure for API Integration
+
+The base class is designed to be uniform for all integrated external
+data sources with abstract class methods and properties.
+"""
+
+import time
+import requests
+import warnings
+
+from typing import Iterable
+from abc import ABC, abstractmethod
+
+# GH#2 disable SSL warnings for self-signed certificates
+from urllib3.exceptions import InsecureRequestWarning
+
+class BaseAPI(ABC):
+    def __init__(self, apikey : str) -> None:
+        self.apikey = apikey
+
+        # create request sessions object for further use
+        self._session = requests.Session()
+
+
+    @property
+    @abstractmethod
+    def uri(self) -> str:
+        pass
+
+
+    @property
+    @abstractmethod
+    def headers(self) -> dict:
+        pass
+
+
+    @property
+    @abstractmethod
+    def endpoint(self) -> str:
+        pass
+
+
+    @property
+    @abstractmethod
+    def params(self) -> dict:
+        pass
+
+
+    def __format_error__(self, e : requests.exceptions.RequestException) -> str:
+        """
+        Format the Base Error Response Structure to Hide Sensitive Data
+
+        The make request exposes some sensitive information in the URL
+        string, which is not desired for security reasons. Referring
+        to an existing issue, the problem is not yet resolved and may
+        require an alternate approach.
+
+        Override the method in the child class to preserve the sensitive
+        information from leaking, or leave it to the parent class to
+        return the value as is.
+
+        :type  e: requests.exceptions.RequestException
+        :param e: Exception to be formatted, to hide sensitive
+            information from the URL string.
+        """
+
+        return e
+
+
+    def make_request(self, method : str, **kwargs) -> requests.Response:
+        sleep = kwargs.get("sleep", 2) # sleep b/w requests, in seconds
+        retries = kwargs.get("retries", 3) # no. of retry attempts
+
+        # GH#2 give user the ability to disable SSL verification
+        # ? this is not recommended, but can be useful for testing
+        verify = kwargs.get("verify", True) # verify SSL certificate
+
+        if _ := kwargs.get("suppresswarning", False):
+            warnings.filterwarnings(
+                "ignore", category = InsecureRequestWarning
+            )
+            
+            requests.packages.urllib3.disable_warnings(
+                InsecureRequestWarning
+            )
+
+        # create uri and append the endpoint to the url::
+        uri = self.uri + self.endpoint
+
+        # create url load like headers and params
+        dataload = {"headers" : self.headers, "params" : self.params}
+
+        # retry on the uri with header and param loads
+        for attempt in range(retries):
+            try:
+                response = self._session.request(
+                    method, uri, **dataload, verify = verify
+                )
+                response.raise_for_status()
+
+                return response # data received, return response
+
+            except requests.exceptions.RequestException as e:
+                e = self.__format_error__(e)
+                print(f"Request Failed (Attempt: {attempt + 1}) : {e}")
+
+                if attempt == retries - 1:
+                    print("Max Retries Reached.")
+                    raise e
+
+                time.sleep(sleep)
+                continue # continue until retries are exhausted
+
+            except requests.exceptions.Timeout as e:
+                print(f"Request Timed Out (Attempt: {attempt + 1}) : {e}")
+
+                if attempt == retries - 1:
+                    print("Max Retries Reached.")
+                    raise e
+
+                time.sleep(sleep)
+                continue # continue until retries are exhausted
+
+
+    def get(self, **kwargs) -> Iterable:
+        """
+        Get the Base Response from an External API Source
+
+        The base response is fetched and the data is returned as
+        a JSON/Dictionary object to the enduser. The response can be
+        further processed and formatted into a desired structure using
+        the IO module.
+        """
+
+        return self.make_request("GET", **kwargs).json()
+
+
+    def close(self) -> None:
+        self._session.close()

forexrates-0.0.1.dev0/forexrates/api/exchangerates.py

@@ -0,0 +1,65 @@
+# -*- encoding: utf-8 -*-
+
+"""
+API Handling for the Exchangerates API (https://exchangeratesapi.io/)
+
+Exchange Rates API provides historic and real-time exchange rates and
+currency conversions. More information about the API is available at
+https://exchangeratesapi.io/documentation/.
+"""
+
+import requests
+
+import datetime as dt
+from typing import Iterable
+from forexrates.api.base import BaseAPI
+
+class ExchangeRatesAPI(BaseAPI):
+    def __init__(self, apikey : str, **kwargs) -> None:
+        super().__init__(apikey)
+
+        # ! override default endpoint with endpoint
+        # ? the endpoint can be date (%Y-%m-%d) for historic rates
+        self._endpoint = kwargs.get("endpoint", "latest")
+
+        # ? each base class accepts parameters as keyword arguments
+        self._base = kwargs.get("base", "EUR")
+
+
+    @property
+    def uri(self) -> str:
+        return "https://api.exchangeratesapi.io/v1/"
+    
+
+    @property
+    def endpoint(self) -> str:
+        # ? endpoint can be date (%Y-%m-%d) for historic rates
+        retval = self._endpoint
+
+        # if date object, then parse as string
+        if isinstance(retval, dt.date):
+            retval = retval.strftime("%Y-%m-%d")
+
+        return retval
+    
+
+    @property
+    def params(self) -> dict:
+        return {
+            "base" : self._base,
+            "access_key" : self.apikey
+        }
+    
+
+    @property
+    def headers(self) -> None:
+        pass
+
+
+    def get(self, **kwargs) -> Iterable:
+        return super().get(**kwargs)
+
+
+    def __format_error__(self, e : requests.exceptions.RequestException) -> str:
+        server_message = e.response.json()["error"]["message"]
+        return f"{e.response} : {e.response.reason} - {server_message}"

forexrates-0.0.1.dev0/forexrates/io/__init__.py

@@ -0,0 +1,10 @@
+# -*- encoding: utf-8 -*-
+
+"""
+A Short Module to Handle Input/Output for JSON Response
+
+The response received from the external API sources are parsed and
+returned as per user requirements.
+"""
+
+from forexrates.io import dataframe

forexrates-0.0.1.dev0/forexrates/io/base.py

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+"""
+Base Class Wrapper and Structure for IO Integration
+
+The base class is designed to be uniform for all integrated external
+data sources with abstract class methods and properties.
+"""
+
+import pandas as pd
+
+from typing import Iterable
+from abc import ABC, abstractmethod
+
+class BaseIO(ABC):
+    def __init__(self, data : dict | Iterable[dict]) -> None:
+        self.data = self.__parse_data__(data)
+
+
+    @staticmethod
+    def __parse_data__(data : dict | Iterable[dict]) -> pd.DataFrame:
+        assert isinstance(data, (dict, list)), \
+            "Data must be a dictionary or a list of dictionaries."
+
+        return [data] if isinstance(data, dict) else data
+
+
+    @abstractmethod
+    def dataframe(self, *args, **kwargs) -> pd.DataFrame:
+        pass

forexrates-0.0.1.dev0/forexrates/io/dataframe.py

@@ -0,0 +1,137 @@
+# -*- encoding: utf-8 -*-
+
+"""
+Operations to Parse Data as :mod:``pandas.DataFrame`` Object
+"""
+
+import datetime as dt
+
+from tqdm import tqdm as TQ
+from typing import Iterable
+
+import pandas as pd
+
+from forexrates.io.base import BaseIO
+
+class ExchangeRatesIO(BaseIO):
+    """
+    An IO Parser for the API Response from ExchangeRatesAPI
+
+    The IO parser transforms the API response into a desired format
+    by calling any internal methods or processes.
+
+    A single response is received as a JSON (dictionary equivalent)
+    from the API and is parsed in a desired format.A typical response
+    structure is like:
+
+    .. code-block:: json
+
+        {
+            "base" : "EUR",
+            "date" : "2020-01-01",
+            "rates" : {
+                "USD" : 1.2345,
+                "INR" : 1.2345,
+                [...]
+            }
+        }
+
+    In case of multiple response parsed under a single call, the
+    function is adjusted with parameter to handle such a response. A
+    sample response is like:
+
+    .. code-block:: json
+
+        [
+            {
+                "base" : "EUR",
+                "date" : "2020-01-01",
+                "rates" : {
+                    "USD" : 1.2345,
+                    "INR" : 1.2345,
+                    [...]
+                }
+            },
+            [...]
+        ]
+
+    :type  data: dict
+    :param data: A single JSON response from the ExchangeRatesAPI.
+        More information about the reponse is available here:
+        https://exchangeratesapi.io/documentation/.
+    """
+
+    def __init__(self, data : dict | Iterable[dict]) -> None:
+        super().__init__(data)
+
+
+    def dataframe(self, verbose : bool = False, **kwargs) -> pd.DataFrame:
+        """
+        Parse a JSON (DICTIONARY) Response from ExchangeRatesAPI
+
+        The function provide method to parse a single/multiple
+        responses of the module and return a single
+        :mod:``pandas.DataFrame`` object.
+
+        :type  verbose: bool
+        :param verbose: If set to ``True``, the function will print
+            additional information about the parsed dataframe.
+
+        Keyword Arguments
+        -----------------
+        Currently only setting the column and index names are supported
+        using keyword arguments. More control is available in the future
+        release and changes over dataframe.
+
+            * **index** (*str*): Name of the index column for parsed
+                dataframe. Defaults to ``foreign_exchange_rate``.
+            * **column** (*str*): Name of the column for parsed dataframe.
+                Defaults to ``target_currency_code``.
+            * **basecolumn** (*str*): Name of the base currency column for
+                parsed dataframe. Defaults to ``base_currency_code``.
+            * **datecolumn** (*str*): Name of the date column for parsed
+                dataframe. Defaults to ``effective_date``.
+
+
+        :rtype:  :mod:``pandas.DataFrame``
+        :return: A :mod:``pandas.DataFrame`` object with parsed data.
+        """
+
+        index = kwargs.get("index", "foreign_exchange_rate")
+        column = kwargs.get("column", "target_currency_code")
+        basecolumn = kwargs.get("basecolumn", "base_currency_code")
+        datecolumn = kwargs.get("datecolumn", "effective_date")
+
+        frames = []
+        for data in TQ(self.data, desc = "Parsing Records..."):
+            base = data["base"]
+            date = data["date"]
+
+            # the data["date"] is a string in the format "%Y-%m-%d"
+            # convert it to a datetime object and return parsed frame
+            date = dt.datetime.strptime(date, "%Y-%m-%d")
+
+            frame = pd.DataFrame(
+                data["rates"], index = [index]
+            ).T.reset_index().rename(columns = {"index" : column})
+
+            frame[basecolumn] = base
+            frame[datecolumn] = date
+
+            frames.append(frame[[datecolumn, basecolumn, column, index]])
+
+        frames = pd.concat(frames, ignore_index = True)
+
+        if verbose:
+            print(f"Total Parsed Records: {frames.shape[0]:,}")
+
+            min_ = frames[datecolumn].min().date()
+            max_ = frames[datecolumn].max().date()
+            print(f"  >> Date Range: {min_} - {max_}")
+
+            unique_bases_= frames[basecolumn].unique()
+            n_unique_targets_ = frames[column].nunique()
+            print(f"  >> Base Currency: {unique_bases_}")
+            print(f"  >> # UQ Targets: {n_unique_targets_:,}")
+
+        return frames

forexrates-0.0.1.dev0/forexrates.egg-info/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: forexrates
+Version: 0.0.1.dev0
+Summary: A unified codebase for fetching FOREX rates.
+Home-page: https://github.com/sharkutilities/forexrates
+Author: shark-utilities developers
+Author-email: shark-utilities developers <neuralNOD@outlook.com>
+License: MIT License
+Project-URL: Homepage, https://github.com/sharkutilities/forexrates
+Project-URL: Issue Tracker, https://github.com/sharkutilities/forexrates/issues
+Project-URL: Org. Homepage, https://github.com/sharkutilities
+Keywords: forex,api,exchange rates,foreign exchange rates,wrappers,data science,data analysis,data scientist,data analyst
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: Unix
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.11
+License-File: LICENSE
+Requires-Dist: numpy==2.4.2
+Requires-Dist: pandas==3.0.0
+Requires-Dist: psycopg==3.3.2
+Requires-Dist: psycopg-binary==3.3.2
+Requires-Dist: requests==2.32.5
+Requires-Dist: SQLAlchemy==2.0.0
+Requires-Dist: tqdm==4.67.3
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python

forexrates-0.0.1.dev0/forexrates.egg-info/SOURCES.txt

@@ -0,0 +1,17 @@
+LICENSE
+pyproject.toml
+setup.py
+forexrates/__init__.py
+forexrates.egg-info/PKG-INFO
+forexrates.egg-info/SOURCES.txt
+forexrates.egg-info/dependency_links.txt
+forexrates.egg-info/requires.txt
+forexrates.egg-info/top_level.txt
+forexrates/api/__init__.py
+forexrates/api/base.py
+forexrates/api/exchangerates.py
+forexrates/io/__init__.py
+forexrates/io/base.py
+forexrates/io/dataframe.py
+main/config.py
+main/erapi.py

forexrates-0.0.1.dev0/forexrates.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

forexrates-0.0.1.dev0/forexrates.egg-info/requires.txt

@@ -0,0 +1,7 @@
+numpy==2.4.2
+pandas==3.0.0
+psycopg==3.3.2
+psycopg-binary==3.3.2
+requests==2.32.5
+SQLAlchemy==2.0.0
+tqdm==4.67.3

forexrates-0.0.1.dev0/forexrates.egg-info/top_level.txt

@@ -0,0 +1,4 @@
+dist
+docs
+forexrates
+main

forexrates-0.0.1.dev0/main/config.py

@@ -0,0 +1,49 @@
+# -*- encoding: utf-8 -*-
+
+"""
+A Set of Configuration Function(s) for Main Files
+"""
+
+import logging
+import logging.handlers
+
+def setLogger(
+        name : str = None,
+        level : int = logging.DEBUG,
+        filename : str = "./status.log"
+    ) -> object:
+    """
+    Setup a logger with pre-built configurations that can be used and
+    extended by any endpoints to capture data update, deletion and
+    other maintenance logs, using the :mod:`logger` module.
+
+    :type  name: str
+    :param name: Name of the logger, else defaults to file name as the
+        name (``__name__`` of the execution script).
+
+    :type  level: int
+    :param level: Any one of the allowed levels from the :mod:`logger`
+        can be used, defaults to debugging mode.
+
+    :type  filename: str
+    :param filename: Full absolute/relative path of the logger file to
+        store the message, defaults to ``./status.log`` file.
+    """
+
+    logger = logging.getLogger(name or __name__)
+    logger.setLevel(level)
+    
+    filehandler = logging.handlers.RotatingFileHandler(
+        filename,
+        maxBytes = 1024 * 1024,
+        backupCount = 1,
+        encoding = "utf8"
+    )
+
+    formatter = logging.Formatter(
+        "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
+    )
+
+    filehandler.setFormatter(formatter)
+    logger.addHandler(filehandler)
+    return logger

forexrates-0.0.1.dev0/main/erapi.py

@@ -0,0 +1,96 @@
+# -*- encoding: utf-8 -*-
+
+"""
+A Script to Update Data for ExchangeRatesIO on MacroDB Schema
+
+Given a database schema with keys and other definitions intact as in
+https://github.com/aivenio/macrodb, the query can be used to update
+the data using CRON schedulers, or GitHub actions.
+"""
+
+import os
+import sys
+
+import pandas as pd
+import datetime as dt
+import sqlalchemy as sa
+
+# append additional files, check actions for more information
+sys.path.append(
+    os.path.join(os.path.dirname(__file__), "..")
+)
+sys.path.append("dtutils")
+
+import forexrates # get the module from repository root
+
+# https://ds-gringotts.readthedocs.io/en/latest/modules/utils/dtutils.html
+import datetime_ as dt_ # cloned using git, ./dtutils
+
+from config import setLogger # already exists in the current path
+
+if __name__ == "__main__":
+    API_KEY = os.environ["EXCHANGERATES_IO_API_KEY"]
+    
+    # create a logger for the erapi module
+    logger = setLogger(name = "ERAPI")
+
+    # get configurations for database connection elements, and build
+    DATABASE = os.environ["AIVENIO_MACRODB_DATABASE"]
+    HOSTNAME = os.environ["AIVENIO_MACRODB_HOSTNAME"]
+    PASSWORD = os.environ["AIVENIO_MACRODB_PASSWORD"]
+    PORTNAME = os.environ["AIVENIO_MACRODB_PORTNAME"]
+    USERNAME = os.environ["AIVENIO_MACRODB_USERNAME"]
+
+    engine = sa.create_engine(
+        f"postgresql+psycopg://{USERNAME}:{PASSWORD}@{HOSTNAME}:{PORTNAME}/{DATABASE}"
+    )
+
+    try:
+        engine.connect()
+    except Exception as err:
+        logger.critical(f"Cannot connect to database. Error: {err}")
+    else:
+        logger.info(f"Connection established to {DATABASE}")
+
+
+    # get the last available date from the database, and then set a
+    # context to fetch the date period for which data is required
+    statement = """
+        SELECT MAX(effective_date)::DATE AS last_date
+        FROM common.forex_rate_tx
+    """
+
+    with engine.connect() as connection:
+        start_date = connection.execute(
+            sa.text(statement)
+        ).fetchone()[0]
+        start_date += dt.timedelta(days = 1)
+
+    last_date = dt.datetime.now().date() - dt.timedelta(days = 1)
+    dates = list(dt_.date_range(start = start_date, end = last_date))
+
+    logger.info(f"Trying to fetch data from {start_date} to {last_date}")
+    logger.info(f"This will consume {len(dates):,} calls for the API")
+
+    data = [
+        forexrates.api.ExchangeRatesAPI(
+            apikey = API_KEY, endpoint = date.strftime("%Y-%m-%d")
+        ).get(
+            verify = False, suppresswarning = True
+        ) for date in dates
+    ]
+
+    parser = forexrates.io.dataframe.ExchangeRatesIO(data)
+    dataframe = parser.dataframe(
+        index = "exchange_rate", verbose = True
+    )
+    dataframe["data_source_id"] = "ERAPI"
+
+    with engine.connect() as connection:
+        metadata = sa.Table(
+            "forex_rate_tx", sa.MetaData(schema = "common"),
+            autoload_with = connection
+        )
+
+        connection.execute(metadata.insert(), dataframe.to_dict(orient = "records"))
+        connection.commit()

forexrates-0.0.1.dev0/pyproject.toml

@@ -0,0 +1,68 @@
+[build-system]
+requires = [
+    "numpy==2.4.2",
+    "pandas==3.0.0",
+    "psycopg==3.3.2",
+    "psycopg-binary==3.3.2",
+    "requests==2.32.5",
+    "setuptools==82.0.0",
+    "SQLAlchemy==2.0.0",
+    "tqdm==4.67.3",
+    "wheel==0.46.3",
+]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "forexrates"
+dynamic = ["version"]
+authors = [
+  { name = "shark-utilities developers", email = "neuralNOD@outlook.com" }
+]
+description = "A unified codebase for fetching FOREX rates."
+# readme = "README.md"  # Uncomment if you have a README.md
+requires-python = ">=3.11"
+license = { text = "MIT License" }
+keywords = [
+    "forex", "api", "exchange rates", "foreign exchange rates",
+    "wrappers", "data science", "data analysis", "data scientist", "data analyst"
+]
+classifiers = [
+    "Development Status :: 1 - Planning",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Education",
+    "Intended Audience :: End Users/Desktop",
+    "Intended Audience :: Information Technology",
+    "Intended Audience :: Science/Research",
+    "Operating System :: Unix",
+    "Operating System :: POSIX",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "License :: OSI Approved :: MIT License",
+]
+dependencies = [
+    "numpy==2.4.2",
+    "pandas==3.0.0",
+    "psycopg==3.3.2",
+    "psycopg-binary==3.3.2",
+    "requests==2.32.5",
+    "SQLAlchemy==2.0.0",
+    "tqdm==4.67.3",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/sharkutilities/forexrates"
+"Issue Tracker" = "https://github.com/sharkutilities/forexrates/issues"
+"Org. Homepage" = "https://github.com/sharkutilities"
+
+[tool.setuptools]
+py-modules = []
+
+[tool.setuptools.packages.find]
+exclude = ["tests*", "examples*"]
+
+[tool.setuptools.dynamic]
+version = {attr = "forexrates.__version__"}

forexrates-0.0.1.dev0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

forexrates-0.0.1.dev0/setup.py

@@ -0,0 +1,69 @@
+#!/usr/bin/env python
+#
+# Copywright (C) 2024 Debmalya Pramanik <neuralNOD@gmail.com>
+# LICENSE: MIT License
+
+import os
+import sys
+
+from setuptools import setup
+from setuptools import find_packages
+
+sys.path.append(
+    os.path.join(os.path.dirname(__file__))
+)
+
+import forexrates
+
+setup(
+    name = "forexrates",
+    version = forexrates.__version__,
+    author = "shark-utilities developers",
+    author_email = "neuralNOD@outlook.com",
+    description = "A unified codebase for fetching FOREX rates.",
+    # long_description = open("README.md", "r").read(),
+    # long_description_content_type = "text/markdown",
+    url = "https://github.com/sharkutilities/forexrates",
+    packages = find_packages(
+        exclude = ["tests*", "examples*"]
+    ),
+    install_requires = [
+        "numpy==2.4.2",
+        "pandas==3.0.0",
+        "psycopg==3.3.2",
+        "psycopg-binary==3.3.2",
+        "requests==2.32.5",
+        "SQLAlchemy==2.0.0",
+        "tqdm==4.67.3",
+    ],
+    classifiers = [
+        "Development Status :: 1 - Planning",
+        "Intended Audience :: Developers",
+        "Intended Audience :: Education",
+        "Intended Audience :: End Users/Desktop",
+        "Intended Audience :: Information Technology",
+        "Intended Audience :: Science/Research",
+        "Operating System :: Unix",
+        "Operating System :: POSIX",
+        "Operating System :: Microsoft :: Windows",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3 :: Only",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "License :: OSI Approved :: MIT License"
+    ],
+    project_urls = {
+        "Issue Tracker" : "https://github.com/sharkutilities/forexrates/issues",
+        # "Code Documentations" : "https://.readthedocs.io/en/latest/index.html",
+        "Org. Homepage" : "https://github.com/sharkutilities"
+    },
+    keywords = [
+        # keywords for finding the package::
+        "forex", "api", "exchange rates", "foreign exchange rates",
+        # keywords for finding the package relevant to usecases::
+        "wrappers", "data science", "data analysis", "data scientist", "data analyst"
+    ],
+    python_requires = ">=3.11"
+)