Metadata-Version: 2.2
Name: unirate-api
Version: 0.1.0
Summary: Official Python client for the Unirate API
Home-page: https://github.com/unirateapi/unirate-python
Author: Unirate Team
Author-email: admin@unirateapi.com
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.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
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.25.0
Requires-Dist: python-dateutil>=2.8.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Unirate API Client

Official Python client for the Unirate API. This library provides a simple and intuitive way to interact with the Unirate currency conversion service.

## Installation

```bash
pip install unirate-api
```

## Quick Start

```python
from unirate import UnirateClient

# Initialize the client
client = UnirateClient(api_key="your-api-key")

# Get current exchange rate
rate = client.get_rate("USD", "EUR")
print(f"Current USD to EUR rate: {rate}")

# Convert amount
converted = client.convert(amount=100, from_currency="USD", to_currency="EUR")
print(f"100 USD = {converted} EUR")

# Get supported currencies
currencies = client.get_supported_currencies()
print("Supported currencies:", currencies)
```

## Features

- Simple and intuitive API
- Real-time currency conversion
- Support for multiple currency pairs
- Comprehensive error handling

## Documentation

For detailed documentation, please visit our [documentation site](https://unirateapi.com/apidocs/).

## Authentication

To use this client, you'll need an API key. You can obtain one by registering at [Unirate](https://unirateapi.com).

## Error Handling

The client includes comprehensive error handling:

```python
from unirate.exceptions import UnirateError

try:
    rate = client.get_rate("INVALID", "EUR")
except UnirateError as e:
    print(f"An error occurred: {e}")
```

## Available Methods

### Get Exchange Rate
```python
rate = client.get_rate("USD", "EUR")
```

### Convert Amount
```python
converted = client.convert(100, "USD", "EUR")
```

### Get Supported Currencies
```python
currencies = client.get_supported_currencies()
```
