cbar-rates 1.2.0__tar.gz

cbar_rates-1.2.0/CHANGES.md

@@ -0,0 +1,19 @@
+cbar-rates
+=====
+
+v1.2.0 (2024-12-02)
+-----
+* Ensured that the order of currencies in the "currencies" dictionary matches the order specified in the input currencies list by using `OrderedDict`.
+
+v1.1.0 (2024-12-01)
+-----
+* Added functionality to retrieve CBAR rates with the difference between values for two different dates.
+
+v1.0.1 (2024-11-25)
+-----
+* Refactored type hints for better clarity and consistency.
+* Added validation to raise TypeError if currencies is not a list of strings.
+
+v1.0.0 (2024-11-24)
+-----
+* Initial release.

cbar_rates-1.2.0/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Tahir Jalilov
+
+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.

cbar_rates-1.2.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include CHANGES.md
+include LICENSE.md
+include MANIFEST.in
+include README.md
+recursive-include tests *.py

cbar_rates-1.2.0/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.1
+Name: cbar-rates
+Version: 1.2.0
+Summary: Python library to work with AZN (Azerbaijani manat) official rates
+Author-email: Tahir Jalilov <tahir.jalilov@gmail.com>
+Project-URL: Homepage, https://github.com/TahirJalilov/cbar-rates/
+Project-URL: Repository, https://github.com/TahirJalilov/cbar-rates/
+Project-URL: Issues, https://github.com/TahirJalilov/cbar-rates/issues
+Project-URL: Changelog, https://github.com/TahirJalilov/cbar-rates/blob/main/CHANGES.md
+Keywords: cbar-rates,AZN,Azerbaijan,AZN-Rates,CBAR,Manat,Mezenne
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: typing_extensions>=4.7.0; python_version < "3.9"
+Requires-Dist: requests>=2.20.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.4; extra == "dev"
+
+# CBAR Rates
+
+A Python library to work with Azerbaijani manat (AZN) official exchange rates based on [CBAR](https://cbar.az/currency/rates?language=en) (The Central Bank of the Republic of Azerbaijan).
+
+## Features
+- Retrieve official CBAR exchange rates for the Azerbaijani manat (AZN).
+- Compare exchange rates between two dates and calculate differences.
+- Filter results by specific currency codes (e.g., USD, EUR).
+
+## Requirements
+- Python 3.7 or higher
+- `requests` library
+
+## Installation
+
+Install the library using pip:
+
+```bash
+pip install cbar-rates --upgrade
+```
+
+For isolated installations, use a virtual environment:
+
+```bash
+python3 -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+pip install cbar-rates
+```
+
+## Examples
+
+### Usage of `get_rates()`
+```python
+from datetime import date
+import cbar
+
+rates_date = date.today()
+currencies = ["USD", "EUR"]
+
+rates = cbar.get_rates(rates_date, currencies)
+
+print(rates)
+# Output:
+{
+    "date": "18.11.2024",
+    "currencies": {
+        "USD": {
+            "nominal": "1",
+            "rate": 1.7
+        },
+        "EUR": {
+            "nominal": "1",
+            "rate": 1.7919
+        },
+    }
+}
+```
+
+### Usage of `get_rates_with_diff()`
+```python
+from datetime import date
+import cbar
+
+previous_date = date(2024, 11, 25)
+date_ = date(2024, 11, 26)
+currencies = ["USD", "EUR"]
+
+rates = cbar.get_rates_with_diff(previous_date, date_, currencies)
+
+print(rates)
+# Output:
+{
+    "previous_date": "25.11.2024",
+    "date": "26.11.2024",
+    "currencies": {
+        "USD": {
+            "nominal": "1",
+            "previous_rate": 1.7,
+            "rate": 1.7,
+            "difference": 0.0,
+        },
+        "EUR": {
+            "nominal": "1",
+            "previous_rate": 1.7814,
+            "rate": 1.7815,
+            "difference": 0.0001,
+        },
+    }
+}
+```
+
+You can find all available currency codes on the [CBAR website](https://www.cbar.az/currency/rates?language=en)
+
+## License
+This project is licensed under the [MIT License](https://github.com/TahirJalilov/cbar-rates?tab=MIT-1-ov-file#MIT-1-ov-file).

cbar_rates-1.2.0/README.md

@@ -0,0 +1,95 @@
+# CBAR Rates
+
+A Python library to work with Azerbaijani manat (AZN) official exchange rates based on [CBAR](https://cbar.az/currency/rates?language=en) (The Central Bank of the Republic of Azerbaijan).
+
+## Features
+- Retrieve official CBAR exchange rates for the Azerbaijani manat (AZN).
+- Compare exchange rates between two dates and calculate differences.
+- Filter results by specific currency codes (e.g., USD, EUR).
+
+## Requirements
+- Python 3.7 or higher
+- `requests` library
+
+## Installation
+
+Install the library using pip:
+
+```bash
+pip install cbar-rates --upgrade
+```
+
+For isolated installations, use a virtual environment:
+
+```bash
+python3 -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+pip install cbar-rates
+```
+
+## Examples
+
+### Usage of `get_rates()`
+```python
+from datetime import date
+import cbar
+
+rates_date = date.today()
+currencies = ["USD", "EUR"]
+
+rates = cbar.get_rates(rates_date, currencies)
+
+print(rates)
+# Output:
+{
+    "date": "18.11.2024",
+    "currencies": {
+        "USD": {
+            "nominal": "1",
+            "rate": 1.7
+        },
+        "EUR": {
+            "nominal": "1",
+            "rate": 1.7919
+        },
+    }
+}
+```
+
+### Usage of `get_rates_with_diff()`
+```python
+from datetime import date
+import cbar
+
+previous_date = date(2024, 11, 25)
+date_ = date(2024, 11, 26)
+currencies = ["USD", "EUR"]
+
+rates = cbar.get_rates_with_diff(previous_date, date_, currencies)
+
+print(rates)
+# Output:
+{
+    "previous_date": "25.11.2024",
+    "date": "26.11.2024",
+    "currencies": {
+        "USD": {
+            "nominal": "1",
+            "previous_rate": 1.7,
+            "rate": 1.7,
+            "difference": 0.0,
+        },
+        "EUR": {
+            "nominal": "1",
+            "previous_rate": 1.7814,
+            "rate": 1.7815,
+            "difference": 0.0001,
+        },
+    }
+}
+```
+
+You can find all available currency codes on the [CBAR website](https://www.cbar.az/currency/rates?language=en)
+
+## License
+This project is licensed under the [MIT License](https://github.com/TahirJalilov/cbar-rates?tab=MIT-1-ov-file#MIT-1-ov-file).

cbar_rates-1.2.0/cbar/__init__.py

@@ -0,0 +1,5 @@
+from cbar.core import get_rates, get_rates_with_diff
+
+__all__ = ["get_rates", "get_rates_with_diff"]
+
+__version__ = "1.2.0"

cbar_rates-1.2.0/cbar/core.py

@@ -0,0 +1,173 @@
+"""Core components for cbar rates."""
+
+import requests
+import xml.etree.ElementTree as ET
+from collections import OrderedDict
+from datetime import date, timedelta
+from typing import Dict, List, Optional, Union
+
+
+def _get_cbar_data(
+    date_: date,
+) -> Dict[str, Union[str, Dict[str, Dict[str, Union[float, str]]]]]:
+    """Get xml file with rates from CBAR parse it and return as dictionary.
+
+    Args:
+        date_ (date): Date of the rates.
+
+    Returns:
+        dict: Parsed data including the date and currency rates.
+
+    Raises:
+      HTTPError: If a request error occurs.
+    """
+    request_url = "https://cbar.az/currencies/{}.xml".format(date_.strftime("%d.%m.%Y"))
+    response = requests.get(request_url, timeout=10)
+    response.raise_for_status()
+    tree = ET.fromstring(response.text)
+    currencies = {}
+    for currency in tree.iter("Valute"):
+        currencies[currency.get("Code")] = {
+            "nominal": currency.find("Nominal").text,
+            "rate": float(currency.find("Value").text),
+        }
+
+    cbar_data = {"date": tree.attrib.get("Date"), "currencies": currencies}
+
+    return cbar_data
+
+
+def get_rates(
+    date_: Optional[date] = None, currencies: Optional[List[str]] = None
+) -> Dict[str, Union[str, Dict[str, Dict[str, Union[int, float]]]]]:
+    """Get exchange rates for a given date and optionally filter by currency codes.
+
+    Args:
+        date_ (Optional[date]): Date of the rates. Defaults to today's date.
+        currencies (Optional[List[str]]): List of ISO 4217 currency codes
+                                          (https://www.cbar.az/currency/rates?language=en) to filter results.
+                                          Defaults to all available currencies.
+
+    Returns:
+        OrderedDict: Exchange rates structured as:
+            {
+                "date": "18.11.2024",
+                "currencies": {
+                    "USD": {
+                        "nominal": "1",
+                        "rate": 1.7
+                    },
+                    "EUR": {
+                        "nominal": "1",
+                        "rate": 1.85
+                    },
+                }
+            }
+    Raises:
+        TypeError: If currencies is not a list of strings.
+    """
+    if date_ is None:
+        date_ = date.today()
+
+    rates = _get_cbar_data(date_)
+
+    if currencies is not None:
+        if not isinstance(currencies, list) or not all(
+            isinstance(s, str) for s in currencies
+        ):
+            raise TypeError(
+                "Currencies must be a list of strings (ISO 4217 currency codes)."
+            )
+
+        currencies_set = {s.upper() for s in currencies}
+
+        filtered_currencies = {
+            currency: rates["currencies"].get(currency)
+            for currency in currencies_set
+            if currency in rates["currencies"]
+        }
+
+        rates["currencies"] = OrderedDict(
+            (currency, filtered_currencies[currency]) for currency in currencies_set
+        )
+
+    return rates
+
+
+def get_rates_with_diff(
+    previous_date: Optional[date] = None,
+    date_: Optional[date] = None,
+    currencies: Optional[List[str]] = None,
+) -> Dict[str, Union[str, Dict[str, Dict[str, Union[int, float]]]]]:
+    """Get exchange rates with difference for given dates and optionally filter by currency codes.
+
+    Args:
+        previous_date (Optional[date]): Previous date of the rates. Defaults to date_ - 1 day.
+        date_ (Optional[date]): Date of the rates. Defaults to previous_date + 1 day.
+                                            If both previous_date and date_ are None, today - 1 day and today.
+        currencies (Optional[List[str]]): List of ISO 4217 currency codes
+                                          (https://www.cbar.az/currency/rates?language=en) to filter results.
+                                          Defaults to all available currencies.
+
+    Returns:
+        OrderedDict: Exchange rates with differences structured as:
+            {
+                "previous_date": "25.11.2024",
+                "date": "26.11.2024",
+                "currencies": {
+                    "USD": {
+                        "nominal": "1",
+                        "previous_rate": 1.7,
+                        "rate": 1.7,
+                        "difference": 0.0,
+                    },
+                    "EUR": {
+                        "nominal": "1",
+                        "previous_rate": 1.7814,
+                        "rate": 1.7815,
+                        "difference": 0.0001,
+                    },
+                }
+            }
+    Raises:
+        TypeError: If currencies is not a list of strings.
+        ValueError: If date inputs are inconsistent.
+    """
+
+    if previous_date is None and date_ is None:
+        date_ = date.today()
+        previous_date = date_ - timedelta(days=1)
+    elif previous_date is not None and date_ is None:
+        date_ = previous_date + timedelta(days=1)
+    elif previous_date is None and date_ is not None:
+        previous_date = date_ - timedelta(days=1)
+
+    if previous_date >= date_:
+        raise ValueError("previous_date must be earlier than date_.")
+
+    previous_result = get_rates(previous_date, currencies)
+    result = get_rates(date_, currencies)
+
+    rates = {
+        "previous_date": previous_result["date"],
+        "date": result["date"],
+        "currencies": {},
+    }
+
+    for currency, data in previous_result["currencies"].items():
+        previous_rate = data["rate"]
+        rate = result["currencies"][currency]["rate"]
+        difference = rate - previous_rate
+
+        rates["currencies"][currency] = {
+            "nominal": data["nominal"],
+            "previous_rate": previous_rate,
+            "rate": rate,
+            "difference": round(difference, 4),
+        }
+
+    rates["currencies"] = OrderedDict(
+        (currency, rates["currencies"][currency]) for currency in currencies
+    )
+
+    return rates

cbar_rates-1.2.0/cbar_rates.egg-info/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.1
+Name: cbar-rates
+Version: 1.2.0
+Summary: Python library to work with AZN (Azerbaijani manat) official rates
+Author-email: Tahir Jalilov <tahir.jalilov@gmail.com>
+Project-URL: Homepage, https://github.com/TahirJalilov/cbar-rates/
+Project-URL: Repository, https://github.com/TahirJalilov/cbar-rates/
+Project-URL: Issues, https://github.com/TahirJalilov/cbar-rates/issues
+Project-URL: Changelog, https://github.com/TahirJalilov/cbar-rates/blob/main/CHANGES.md
+Keywords: cbar-rates,AZN,Azerbaijan,AZN-Rates,CBAR,Manat,Mezenne
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: typing_extensions>=4.7.0; python_version < "3.9"
+Requires-Dist: requests>=2.20.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.4; extra == "dev"
+
+# CBAR Rates
+
+A Python library to work with Azerbaijani manat (AZN) official exchange rates based on [CBAR](https://cbar.az/currency/rates?language=en) (The Central Bank of the Republic of Azerbaijan).
+
+## Features
+- Retrieve official CBAR exchange rates for the Azerbaijani manat (AZN).
+- Compare exchange rates between two dates and calculate differences.
+- Filter results by specific currency codes (e.g., USD, EUR).
+
+## Requirements
+- Python 3.7 or higher
+- `requests` library
+
+## Installation
+
+Install the library using pip:
+
+```bash
+pip install cbar-rates --upgrade
+```
+
+For isolated installations, use a virtual environment:
+
+```bash
+python3 -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+pip install cbar-rates
+```
+
+## Examples
+
+### Usage of `get_rates()`
+```python
+from datetime import date
+import cbar
+
+rates_date = date.today()
+currencies = ["USD", "EUR"]
+
+rates = cbar.get_rates(rates_date, currencies)
+
+print(rates)
+# Output:
+{
+    "date": "18.11.2024",
+    "currencies": {
+        "USD": {
+            "nominal": "1",
+            "rate": 1.7
+        },
+        "EUR": {
+            "nominal": "1",
+            "rate": 1.7919
+        },
+    }
+}
+```
+
+### Usage of `get_rates_with_diff()`
+```python
+from datetime import date
+import cbar
+
+previous_date = date(2024, 11, 25)
+date_ = date(2024, 11, 26)
+currencies = ["USD", "EUR"]
+
+rates = cbar.get_rates_with_diff(previous_date, date_, currencies)
+
+print(rates)
+# Output:
+{
+    "previous_date": "25.11.2024",
+    "date": "26.11.2024",
+    "currencies": {
+        "USD": {
+            "nominal": "1",
+            "previous_rate": 1.7,
+            "rate": 1.7,
+            "difference": 0.0,
+        },
+        "EUR": {
+            "nominal": "1",
+            "previous_rate": 1.7814,
+            "rate": 1.7815,
+            "difference": 0.0001,
+        },
+    }
+}
+```
+
+You can find all available currency codes on the [CBAR website](https://www.cbar.az/currency/rates?language=en)
+
+## License
+This project is licensed under the [MIT License](https://github.com/TahirJalilov/cbar-rates?tab=MIT-1-ov-file#MIT-1-ov-file).

cbar_rates-1.2.0/cbar_rates.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+CHANGES.md
+LICENSE.md
+MANIFEST.in
+README.md
+pyproject.toml
+cbar/__init__.py
+cbar/core.py
+cbar_rates.egg-info/PKG-INFO
+cbar_rates.egg-info/SOURCES.txt
+cbar_rates.egg-info/dependency_links.txt
+cbar_rates.egg-info/requires.txt
+cbar_rates.egg-info/top_level.txt
+tests/__init__.py
+tests/test_core.py

cbar_rates-1.2.0/cbar_rates.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cbar_rates-1.2.0/cbar_rates.egg-info/requires.txt

@@ -0,0 +1,7 @@
+requests>=2.20.0
+
+[:python_version < "3.9"]
+typing_extensions>=4.7.0
+
+[dev]
+pytest>=7.4.4

cbar_rates-1.2.0/cbar_rates.egg-info/top_level.txt

@@ -0,0 +1 @@
+cbar

cbar_rates-1.2.0/pyproject.toml

@@ -0,0 +1,78 @@
+[build-system]
+requires = ["setuptools>=65.0.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cbar-rates"
+description = "Python library to work with AZN (Azerbaijani manat) official rates"
+authors = [
+    { name = "Tahir Jalilov", email = "tahir.jalilov@gmail.com" },
+]
+
+readme = { file = "README.md", content-type = "text/markdown" }
+requires-python = ">=3.7"
+keywords = ["cbar-rates", "AZN", "Azerbaijan", "AZN-Rates", "CBAR", "Manat", "Mezenne"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Information Technology",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Python :: Implementation :: PyPy",
+    "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "typing_extensions >= 4.7.0; python_version < '3.9'",
+    "requests >= 2.20.0"
+]
+dynamic = ["version"]
+
+[project.urls]
+Homepage = "https://github.com/TahirJalilov/cbar-rates/"
+Repository = "https://github.com/TahirJalilov/cbar-rates/"
+Issues = "https://github.com/TahirJalilov/cbar-rates/issues"
+Changelog = "https://github.com/TahirJalilov/cbar-rates/blob/main/CHANGES.md"
+
+[project.optional-dependencies]
+dev = ["pytest>=7.4.4"]
+
+[tool.setuptools.packages.find]
+include = ["cbar*"]
+
+[tool.setuptools.dynamic]
+version = { attr = "cbar.__version__" }
+
+[tool.pytest.ini_options]
+pythonpath = ["."]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 88
+
+[tool.tox]
+legacy_tox_ini = """
+    [tox]
+    minversion = 4.15.0
+
+    [testenv]
+    description = Run the tests with pytest
+    package = wheel
+    wheel_build_env = .pkg
+    changedir = tests
+    deps =
+        pytest>=6
+    commands =
+        pytest {tty:--color=yes} --basetemp="{envtmpdir}" {posargs}
+"""

cbar_rates-1.2.0/setup.cfg

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

cbar_rates-1.2.0/tests/test_core.py

@@ -0,0 +1,58 @@
+import pytest
+import requests
+import cbar
+
+from datetime import date
+
+
+def test_cbar_xml():
+    r = requests.get("https://cbar.az/currencies/18.11.2024.xml", timeout=10)
+
+    assert r.status_code == 200
+    assert r.text.startswith('<?xml version="1.0" encoding="UTF-8"?>')
+
+
+def test_get_rates():
+    date_ = date(2024, 11, 18)
+    rates = cbar.get_rates(date_=date_, currencies=["USD"])
+
+    assert isinstance(rates, dict)
+    assert rates["date"] == "18.11.2024"
+    assert rates["currencies"] == {"USD": {"nominal": "1", "rate": 1.7}}
+
+
+def test_get_rates_type_error():
+    with pytest.raises(
+        TypeError,
+        match="Currencies must be a list of strings \(ISO 4217 currency codes\).",
+    ):
+        cbar.get_rates(currencies=1)
+
+
+def test_get_rates_with_diff():
+    previous_date = date(2024, 11, 25)
+    date_ = date(2024, 11, 26)
+    rates = cbar.get_rates_with_diff(
+        previous_date=previous_date, date_=date_, currencies=["EUR"]
+    )
+
+    assert isinstance(rates, dict)
+    assert rates["previous_date"] == "25.11.2024"
+    assert rates["date"] == "26.11.2024"
+    assert rates["currencies"] == {
+        "EUR": {
+            "nominal": "1",
+            "previous_rate": 1.7814,
+            "rate": 1.7815,
+            "difference": 0.0001,
+        }
+    }
+
+
+def test_get_rates_with_diff_value_error():
+    with pytest.raises(
+        ValueError, match="previous_date must be earlier than date_."
+    ):
+        previous_date = date(2025, 1, 1)
+        date_ = date(2024, 1, 1)
+        cbar.get_rates_with_diff(previous_date, date_)