prepid 1.0.0

A Python package for fetching and converting currency rates using the Prebid currency file.

Prebid Currency Converter

A Python package for fetching and converting currency rates using the Prebid currency file. The library provides a simple interface to convert amounts between different currencies, with automatic caching of currency data to minimize API requests.

Installation

pip install prepid

Quick Start

from prepid import CurrencyConverter

converter = CurrencyConverter()

# Convert 100 USD to EUR
amount = converter.convert_currency(100, "USD", "EUR")
print(f"100 USD = {amount:.2f} EUR")

Usage

Convert Currency

from prepid import CurrencyConverter, CurrencyError

converter = CurrencyConverter()

try:
    result = converter.convert_currency(250, "GBP", "USD")
    print(f"250 GBP = {result:.2f} USD")
except CurrencyError as e:
    print(f"Conversion failed: {e}")

Currency codes are case-insensitive — "usd", "USD", and " Usd " all work.

Get a Conversion Rate

rate = converter.get_conversion_rate("EUR", "GBP")
print(f"1 EUR = {rate:.4f} GBP")

List Available Currencies

currencies = converter.list_available_currencies()
print(", ".join(currencies))  # AED, ARS, AUD, ...

Caching

The library caches currency data both in-memory and on disk to avoid redundant API calls. By default, data expires after 6 hours:

# Set cache to expire after 24 hours
converter = CurrencyConverter(cache_duration_hours=24)

The disk cache is stored in a platform-appropriate user cache directory.

API Reference

CurrencyConverter(cache_duration_hours=6)

Method	Returns	Description
convert_currency(amount, from_currency, to_currency)	float	Convert an amount between currencies
get_conversion_rate(from_currency, to_currency)	float	Get the rate multiplier between two currencies
list_available_currencies()	list[str]	Sorted list of available currency codes
get_currency_rates()	dict	Raw currency data from the Prebid API

CurrencyError

Raised when a conversion fails (invalid currency code, network error, etc.).

Contributing

Contributions are welcome! Please feel free to submit a pull request or open an issue on the GitHub repository.

License

This project is licensed under the MIT License. See the LICENSE file for details.