Metadata-Version: 2.4
Name: global-currency
Version: 0.1.4
Summary: Historical and current currency conversion across active and legacy world currencies with multi-provider fallbacks and complete provenance.
Author: Global Currency Contributors
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.31.0
Provides-Extra: dev
Requires-Dist: pytest>=7.4.0; extra == "dev"
Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
Dynamic: license-file

<p align="center">
  <img src="https://raw.githubusercontent.com/Sa1ndesh/CurrencyConverter/main/logo.png" width="180" alt="Global Currency Logo">
</p>
<h1 align="center">🌍 Global Currency Converter</h1>

<p align="center">
  <strong>Historical • Current • Legacy Currency Conversion</strong><br>
  High Precision Decimal Arithmetic • Complete Provenance • CLI + Python Library
</p>

<p align="center">
  <img src="https://img.shields.io/badge/Python-3.11+-blue" alt="Python">
  <img src="https://img.shields.io/badge/License-MIT-green" alt="License">
  <img src="https://img.shields.io/badge/version-0.1.2-orange" alt="Version">
  <img src="https://img.shields.io/badge/tests-21%20passed-brightgreen" alt="Tests">
</p>

---

# Overview

**Global Currency Converter** is an open-source Python library and command-line tool for retrieving and converting **current**, **historical**, and **legacy** exchange rates with complete provenance.

It supports:

- 🌍 Current exchange rates
- 📅 Historical exchange rates
- 💱 Legacy currencies (DEM, FRF, ITL, etc.)
- 🗺 Historical country currency mapping
- 💰 High-precision `Decimal` arithmetic
- 🗄 SQLite caching
- 🔍 Complete audit trail
- ⚡ CLI + Python API

---

# Features

| Feature | Supported |
|----------|:---------:|
| Current Rates | ✅ |
| Historical Rates | ✅ |
| Legacy Currencies | ✅ |
| Historical Country Mapping | ✅ |
| Decimal Precision | ✅ |
| SQLite Cache | ✅ |
| Frankfurter API v2 | ✅ |
| BIS SDMX | ✅ |
| IMF SDMX | ✅ |
| Cross-Rate Engine | ✅ |
| CLI | ✅ |
| Python API | ✅ |

---

# Installation

## PyPI

```bash
pip install global-currency
```

## TestPyPI

```bash
pip install -i https://test.pypi.org/simple global-currency
```
