rate-api-python 1.0.0__py3-none-any.whl → 1.0.2__py3-none-any.whl

rate_api/__init__.py

@@ -12,7 +12,7 @@ import urllib.error
 import urllib.parse
 import urllib.request
 
-__version__ = "1.0.0"
+__version__ = "1.0.2"
 __all__ = ["RateApiClient", "RateApiError", "RateLimitError", "RateApiTimeoutError"]
 
 
@@ -116,10 +116,16 @@ class RateApiClient:
     def _get(self, endpoint, query=None):
         return self._request(f"{self.base_url}/{self.api_key}/{endpoint}", query or {})
 
+    @staticmethod
+    def _normalize_headers(headers):
+        # urllib's HTTPMessage.get() is case-insensitive, but dict(...) is not — and
+        # Cloudflare/HTTP-2 send header names lowercased. Normalize to lowercase keys.
+        return {k.lower(): v for k, v in dict(headers or {}).items()}
+
     @staticmethod
     def _retry_after(headers, default=60):
         try:
-            return int(headers.get("Retry-After", default))
+            return int(headers.get("retry-after", default))
         except (TypeError, ValueError):
             return default
 
@@ -148,11 +154,15 @@ class RateApiClient:
             try:
                 with urllib.request.urlopen(req, timeout=self.timeout) as resp:
                     status = resp.status
-                    resp_headers = dict(resp.headers)
-                    data = json.loads(resp.read().decode("utf-8"))
+                    resp_headers = self._normalize_headers(resp.headers)
+                    raw = resp.read().decode("utf-8")
+                try:
+                    data = json.loads(raw)
+                except ValueError:
+                    raise RateApiError(f"Invalid JSON response (HTTP {status}).", status)
             except urllib.error.HTTPError as e:
                 status = e.code
-                resp_headers = dict(e.headers or {})
+                resp_headers = self._normalize_headers(e.headers)
                 # Retry transient statuses, honoring Retry-After.
                 if status in (429, 503) and attempt < self.max_retries:
                     attempt += 1
@@ -176,7 +186,7 @@ class RateApiClient:
                 err = data.get("error") or {}
                 msg = err.get("message") or data.get("message") or "Unknown API error"
                 etype = err.get("type")
-                rid = data.get("request_id") or resp_headers.get("X-Request-Id")
+                rid = data.get("request_id") or resp_headers.get("x-request-id")
                 if status == 429:
                     raise RateLimitError(msg, status, etype, rid, self._retry_after(resp_headers))
                 raise RateApiError(msg, status, etype, rid)

rate_api_python-1.0.2.dist-info/METADATA

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: rate-api-python
+Version: 1.0.2
+Summary: Official Python client for the Rate-API.com exchange-rate & crypto API
+Author-email: Vilgar <digitalbrainsam@gmail.com>
+License: MIT
+Project-URL: Homepage, https://rate-api.com
+Project-URL: Documentation, https://rate-api.com/en/docs
+Project-URL: Repository, https://github.com/Vilgar/rate-api.com
+Project-URL: Issues, https://rate-api.com/en/docs
+Keywords: exchange-rate,currency,forex,crypto,api,rate-api
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Programming Language :: Python :: 3
+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
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# rate-api-python
+
+Official Python client for [Rate-API.com](https://rate-api.com). Standard library only — no dependencies. Python 3.8+.
+
+## Install
+
+```bash
+pip install rate-api-python
+```
+
+## Usage
+
+```python
+from rate_api import RateApiClient, RateApiError
+
+client = RateApiClient("YOUR_API_KEY")
+
+rates = client.latest("USD", ["EUR", "GBP"])
+print(rates["rates"]["EUR"])
+
+client.convert("USD", "EUR", 100)                 # Pro+
+client.historical("2026-01-15", "USD", ["EUR"])   # Pro+
+client.pair("USD", "EUR")                          # single pair
+client.timeseries("2026-01-01", "2026-01-31")     # Business+
+client.fluctuation("2026-01-01", "2026-01-31")    # Business+
+client.crypto(["BTC", "ETH"])                      # Pro+
+client.currencies()                                # supported currencies
+client.health()                                    # public
+
+try:
+    client.timeseries("2020-01-01", "2026-12-31")
+except RateApiError as e:
+    print(e, e.status)   # "Date range too large. Maximum is 366 days." 400
+```
+
+## v2 features
+
+The client exposes the v2 endpoints directly (they resolve to `/api/v2` regardless of base URL):
+
+```python
+# Latest with 24h change, metadata and precision
+r = client.latest_v2("USD", ["EUR", "GBP"], include_change=True, include_metadata=True, precision=4)
+print(r["changes_pct"]["EUR"])
+
+# Historical comparison between two dates (Pro+)
+cmp = client.historical_compare("2026-01-15", "2026-01-01", "USD", ["EUR"])
+
+# Batch conversion — up to 100 pairs in one call (Pro+)
+batch = client.batch_convert([
+    {"from": "USD", "to": "EUR", "amount": 100},
+    {"from": "GBP", "to": "JPY", "amount": 50},
+])
+
+# Your configured rate alerts (Business+)
+alerts = client.alerts()
+```
+
+## Errors
+
+Every failure raises `RateApiError` (or a subclass), so a single `except RateApiError` catches everything:
+
+```python
+import time
+from rate_api import RateApiClient, RateApiError, RateLimitError, RateApiTimeoutError
+
+try:
+    client.latest("USD", ["EUR"])
+except RateLimitError as e:
+    time.sleep(e.retry_after)                  # honour the server's backoff
+except RateApiTimeoutError:
+    ...                                        # request exceeded `timeout`
+except RateApiError as e:
+    print(e, e.status, e.type, e.request_id)
+```
+
+| Class | When | Extra attributes |
+|---|---|---|
+| `RateApiError` | any API/HTTP error | `status` (HTTP code; `None` on network/timeout), `type` (stable `error.type` slug), `request_id` (`X-Request-Id` — quote it when contacting support) |
+| `RateLimitError` | HTTP 429 | `retry_after` (seconds to wait) |
+| `RateApiTimeoutError` | request exceeded `timeout` | — |
+
+## Configuration
+
+```python
+RateApiClient(api_key, base_url="https://rate-api.com/api/v1", timeout=15, max_retries=2)
+```
+
+| Argument | Default | Notes |
+|---|---|---|
+| `base_url` | `https://rate-api.com/api/v1` | pass `…/api/v2` to target v2 directly |
+| `timeout` | `15` | per-request socket timeout in seconds (covers headers and body) |
+| `max_retries` | `2` | automatically retries 429/503/network/timeout with exponential backoff, honouring the server's `Retry-After` header |
+
+## License
+
+MIT

rate_api_python-1.0.2.dist-info/RECORD

@@ -0,0 +1,6 @@
+rate_api/__init__.py,sha256=xSMMweBtuXdST6akKoehVNA69X6omsVmwEtDzclie-U,8314
+rate_api_python-1.0.2.dist-info/licenses/LICENSE,sha256=nCjIn_oDw98qUrGtfT5o19Qk02nDpkr3xbKgFtu3Z0A,1069
+rate_api_python-1.0.2.dist-info/METADATA,sha256=2FJ6y1wYPZdAGji2Cqs4K0xA3s2C5369mf71MI7VAo8,4357
+rate_api_python-1.0.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+rate_api_python-1.0.2.dist-info/top_level.txt,sha256=y8GBQa9yzwxT17UjU9xreA4yPbHqup7c0ryMbx1gYzI,9
+rate_api_python-1.0.2.dist-info/RECORD,,

rate_api_python-1.0.0.dist-info/METADATA

@@ -1,71 +0,0 @@
-Metadata-Version: 2.4
-Name: rate-api-python
-Version: 1.0.0
-Summary: Official Python client for the Rate-API.com exchange-rate & crypto API
-License: MIT
-Project-URL: Homepage, https://rate-api.com
-Project-URL: Documentation, https://rate-api.com/en/docs
-Project-URL: Repository, https://github.com/Vilgar/rate-api.com
-Keywords: exchange-rate,currency,forex,crypto,api,rate-api
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: license-file
-
-# rate-api-python
-
-Official Python client for [Rate-API.com](https://rate-api.com). Standard library only — no dependencies. Python 3.8+.
-
-## Install
-
-```bash
-pip install rate-api-python
-```
-
-## Usage
-
-```python
-from rate_api import RateApiClient, RateApiError
-
-client = RateApiClient("YOUR_API_KEY")
-
-rates = client.latest("USD", ["EUR", "GBP"])
-print(rates["rates"]["EUR"])
-
-client.convert("USD", "EUR", 100)                 # Pro+
-client.historical("2026-01-15", "USD", ["EUR"])   # Pro+
-client.timeseries("2026-01-01", "2026-01-31")     # Business+
-client.crypto(["BTC", "ETH"])                      # Pro+
-client.health()                                    # public
-
-try:
-    client.timeseries("2020-01-01", "2026-12-31")
-except RateApiError as e:
-    print(e, e.status)   # "Date range too large. Maximum is 366 days." 400
-```
-
-## v2 features
-
-The client exposes the v2 endpoints directly (they resolve to `/api/v2` regardless of base URL):
-
-```python
-# Latest with 24h change, metadata and precision
-r = client.latest_v2("USD", ["EUR", "GBP"], include_change=True, include_metadata=True, precision=4)
-print(r["changes_pct"]["EUR"])
-
-# Historical comparison between two dates (Pro+)
-cmp = client.historical_compare("2026-01-15", "2026-01-01", "USD", ["EUR"])
-
-# Batch conversion — up to 100 pairs in one call (Pro+)
-batch = client.batch_convert([
-    {"from": "USD", "to": "EUR", "amount": 100},
-    {"from": "GBP", "to": "JPY", "amount": 50},
-])
-
-# Your configured rate alerts (Business+)
-alerts = client.alerts()
-```
-
-## License
-
-MIT

rate_api_python-1.0.0.dist-info/RECORD

@@ -1,6 +0,0 @@
-rate_api/__init__.py,sha256=J9mVlZ0hKr_S1jq3mnXNBnZFTwa5ro_EswEcR1IipXo,7806
-rate_api_python-1.0.0.dist-info/licenses/LICENSE,sha256=nCjIn_oDw98qUrGtfT5o19Qk02nDpkr3xbKgFtu3Z0A,1069
-rate_api_python-1.0.0.dist-info/METADATA,sha256=0Z9I8Lyh_JiGDXwFhCX6fPobnXUnUaFug01nTh1VCkY,2030
-rate_api_python-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-rate_api_python-1.0.0.dist-info/top_level.txt,sha256=y8GBQa9yzwxT17UjU9xreA4yPbHqup7c0ryMbx1gYzI,9
-rate_api_python-1.0.0.dist-info/RECORD,,