Metadata-Version: 2.4
Name: cbfx
Version: 0.1.0
Summary: Get foreign exchange rates by parsing central bank websites
Author-email: Ian Gabaraev <iandevhkt@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/Ian-Gabaraev/cbfx
Project-URL: Repository, https://github.com/Ian-Gabaraev/cbfx
Project-URL: Issues, https://github.com/Ian-Gabaraev/cbfx/issues
Keywords: forex,exchange-rate,central-bank,currency,fx
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
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: Topic :: Office/Business :: Financial
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.31
Requires-Dist: beautifulsoup4>=4.12
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: build>=1.0; extra == "dev"
Requires-Dist: twine>=5.0; extra == "dev"
Dynamic: license-file

# cbfx

Get current foreign exchange rates (local currency → USD) by parsing central bank websites.

## Installation

```bash
pip install -e .
```

## Usage

```python
from cbfx import get_rate, supported

# By country code
rate = get_rate(country="VN")

# By currency code
rate = get_rate(currency="THB")

# See all supported countries
print(supported())  # {'PH': 'PHP', 'TH': 'THB', 'VN': 'VND'}
```

## Supported Countries

| Country | Code | Currency | Source |
|---------|------|----------|--------|
| Philippines | PH | PHP | Bangko Sentral ng Pilipinas |
| Thailand | TH | THB | Bank of Thailand |
| Vietnam | VN | VND | State Bank of Vietnam |

## License

MIT
