ecbfx 0.2.0__tar.gz → 0.3.0__tar.gz

ecbfx-0.3.0/.github/workflows/ci.yml

@@ -0,0 +1,76 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  test:
+    # One job per advertised Python. The classifiers in pyproject.toml claim
+    # 3.9-3.14; until this matrix went green the claim was never checked, and
+    # date.fromisoformat had already been shown to behave differently across it.
+    # Keep the matrix and the classifier list in sync — a version in one and not
+    # the other is the bug this job exists to prevent.
+    name: test (py${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      # Report every failing version, not just the first: knowing whether 3.9
+      # alone breaks or the whole lower half does is the point of the matrix.
+      fail-fast: false
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install
+        run: python -m pip install --upgrade pip && python -m pip install -e ".[dev]"
+
+      - name: Test
+        run: python -m pytest
+
+  lint:
+    # Ruff's result does not vary by interpreter, so it runs once rather than
+    # six times. The pinned version is the linter's runtime, not the package's.
+    name: lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install
+        run: python -m pip install --upgrade pip && python -m pip install -e ".[dev]"
+
+      - name: Ruff
+        run: python -m ruff check src/ tests/
+
+  build:
+    # Catches packaging breakage before a tag rather than after: the wheel must
+    # install and the console script must run in an environment that never saw
+    # the source tree.
+    name: build + smoke-test artifacts
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Build
+        run: python -m pip install --upgrade pip build && python -m build
+
+      - name: Install the wheel into a clean environment
+        run: |
+          python -m venv /tmp/smoke
+          /tmp/smoke/bin/pip install dist/*.whl
+          /tmp/smoke/bin/python -c "import ecbfx; print(ecbfx.__version__)"
+          /tmp/smoke/bin/ecbfx --version

{ecbfx-0.2.0 → ecbfx-0.3.0}/.gitignore

@@ -9,3 +9,8 @@ htmlcov/
 .mypy_cache/
 .pytest_cache/
 *.pyc
+CLAUDE.md
+audit.md
+TODO.md
+.ruff_cache
+github/

ecbfx-0.3.0/CHANGELOG.md

@@ -0,0 +1,40 @@
+# Changelog
+
+## 0.3.0 — 2026-08-01
+- Removed `_validate_currency`, the deprecated alias for `validate_currency`
+- Added `--timeout N`, and a `timeout` parameter on the three fetch functions
+- Added `--decimals` as an alias for `--decimal`
+- Added `py.typed` — annotations are now visible to type checkers
+- Added Python 3.14 classifier; CI runs the suite on 3.9–3.14
+- Added `User-Agent: ecbfx/<version>` on outgoing requests
+- `--pairs` accepts quoted fields — spreadsheet exports work as-is
+- Currency codes must now be exactly three letters (`US`, `USDD` were accepted)
+- Dates must now be `YYYY-MM-DD` — `20250115` and ISO week dates parsed only on 3.11+
+- `fetch_rates()` collapses duplicate currencies, matching `fetch_rates_for_pairs()`
+- Library installs a `logging.NullHandler`; skipped non-positive rates are logged
+- Fixed: CLI was unusable on Python 3.9 — argparse rejected the `nargs="*"` positional
+- Fixed: `--direct` lost precision above ratio 10 — KRW gave `0.0007`, not `0.0006656`
+- Fixed: table output misaligned in both tty and non-tty modes
+- Fixed: mistyped dates reported as invalid currency codes, exit 1 instead of 2
+- Fixed: `USD 2025-01-15 --latest` exited 1 — the unreachable `DATE` positional is gone
+- Fixed: `--pairs` with a malformed `--from`/`--to` crashed with a traceback
+- Fixed: `fetch_latest()` rejected padded codes (`" usd "`)
+- Fixed: `fetch_rates()` with `start` after `end` fetched, then returned `[]`
+- Fixed: HTML error pages from the ECB are retried instead of failing outright
+- Fixed: a UTF-8 BOM could be reported as a bad payload
+- Fixed: HTTP session is closed on every exit path (`ResourceWarning` under `-W error`)
+- Fixed: gap-fill error says "calendar days"; `resolve_rate()` docstring matches the code
+
+Minor bump, not a patch: currency and date validation both narrowed, duplicate
+currencies collapse, an inverted range raises instead of returning `[]`, and
+direct-mode output changes for rates above 10 (JPY, HUF, KRW). Rates below 10 —
+USD, GBP, CHF and the rest — are byte-identical to 0.2.0.
+
+## 0.2.0 — 2026-05-01
+- Added `fetch_rates_for_pairs()` — sparse transaction date support
+- Added `fetch_latest()` — most recent available rate
+- Added `validate_currency()` — public input validation
+- Added `--pairs`, `--latest`, `--quiet`, `--decimal`, `--no-gap-fill` CLI flags
+- LOCF gap-filling — always uses prior trading day, never look-ahead
+- HTTP session reuse, exponential backoff with jitter
+- Fixed: `re.fullmatch` for currency validation (trailing newline bypass)

{ecbfx-0.2.0 → ecbfx-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ecbfx
-Version: 0.2.0
+Version: 0.3.0
 Summary: ECB foreign exchange rate lookup — CLI and Python API with gap-fill, strict mode, and scripting support
 Project-URL: Homepage, https://github.com/edvinassvedas-dev/ecbfx
 Project-URL: Repository, https://github.com/edvinassvedas-dev/ecbfx
@@ -20,6 +20,7 @@ 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: Programming Language :: Python :: 3.14
 Classifier: Topic :: Office/Business :: Financial
 Classifier: Topic :: Utilities
 Requires-Python: >=3.9
@@ -28,6 +29,7 @@ Provides-Extra: dev
 Requires-Dist: pytest-cov; extra == 'dev'
 Requires-Dist: pytest>=7; extra == 'dev'
 Requires-Dist: responses; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
 Description-Content-Type: text/markdown
 
 # ecbfx
@@ -47,12 +49,11 @@ rates directly from the [ECB SDMX API](https://data-api.ecb.europa.eu).
 pip install ecbfx
 ```
 
-**For development** (includes test dependencies):
+Working on `ecbfx`:
 
 ```bash
 git clone https://github.com/edvinassvedas-dev/ecbfx.git
-cd ecbfx
-pip install -e ".[dev]"
+cd ecbfx && pip install -e ".[dev]"
 pytest
 ```
 
@@ -64,10 +65,8 @@ pytest
 # If today's rate isn't available yet, use --latest instead.
 ecbfx USD
 
-# Specific date
+# Specific date, and multiple currencies at once
 ecbfx USD 2025-01-15
-
-# Multiple currencies, specific date
 ecbfx USD GBP CHF 2025-01-15
 
 # Date range
@@ -80,27 +79,14 @@ ecbfx USD 2025-01-15 --direct
 ecbfx USD --latest
 
 # Single value only — ideal for shell scripting
-ecbfx USD --latest --quiet
 RATE=$(ecbfx USD --quiet)
 
-# Control decimal precision (default: 4)
-ecbfx USD 2025-01-15 --decimal 6
-
-# Strict mode — error instead of gap-filling on weekends/holidays
-ecbfx USD 2025-01-15 --no-gap-fill
-
 # CSV output (pipe-friendly)
-ecbfx USD --from 2025-01-01 --to 2025-01-31 --csv
 ecbfx USD --from 2025-01-01 --to 2025-01-31 --csv > rates.csv
 
-# Read pairs from a file — one HTTP call per currency
+# Read (date, currency) pairs from a file or stdin — one HTTP call per currency
 ecbfx --pairs transactions.csv --direct --csv
-
-# Read pairs from stdin
 cat transactions.csv | ecbfx --pairs - --direct --csv
-
-# Combine with date filter
-ecbfx --pairs transactions.csv --from 2025-01-01 --to 2025-03-31 --csv
 ```
 
 ### Convention
@@ -118,13 +104,17 @@ direction explicit for downstream pipelines.
 
 | Flag | Default | Description |
 |---|---|---|
+| `--from YYYY-MM-DD` | — | Start of date range (inclusive). Also filters `--pairs` input |
+| `--to YYYY-MM-DD` | — | End of date range (inclusive). Requires `--from` in range mode |
 | `--direct` | off | EUR per 1 foreign unit instead of ECB native |
 | `--latest` | off | Most recent available rate, regardless of date |
 | `--quiet` / `-q` | off | Print rate value(s) only — ideal for scripting |
-| `--decimal N` | 4 | Decimal places in output rate |
+| `--decimal N` / `--decimals N` | 4 | Output precision. Decimal places normally; with `--direct` a floor on *significant* digits, so high-ratio currencies (JPY, HUF, KRW) keep full precision instead of collapsing to `0.0007` |
+| `--timeout N` | 30 | HTTP timeout in seconds, per attempt (3 attempts with backoff) |
 | `--no-gap-fill` | off | Raise an error on weekends/holidays instead of substituting the nearest rate |
 | `--csv` | off | CSV output instead of formatted table |
-| `--pairs FILE\|-` | — | Read `date,currency` pairs from a file or stdin |
+| `--pairs FILE\|-` | — | Read `date,currency` pairs from a file or stdin. Comma, tab or space separated; surrounding quotes are tolerated, so spreadsheet exports work as-is |
+| `--version` | — | Print the installed version and exit |
 
 ### Weekend and holiday gap-filling
 
@@ -133,11 +123,14 @@ uses the most recent prior trading day's rate (Last Observation Carried Forward)
 when a requested date falls on a weekend or public holiday — including the first
 date in a range that starts on a holiday such as January 1st.
 
-Use `--no-gap-fill` to disable this and receive an explicit error instead —
-useful in audit workflows where a substituted rate is not acceptable.
-
----
+A future date is never substituted, so a rate is never influenced by information
+that did not exist on the date requested. If no trading day exists within 5
+calendar days before the target — the widest real gap in the ECB calendar — the
+lookup fails rather than reaching further back for a staler rate.
 
+Use `--no-gap-fill` to disable substitution entirely and receive an explicit
+error instead — useful in audit workflows where a substituted rate is not
+acceptable.
 
 ### Exit codes
 
@@ -152,6 +145,8 @@ Useful for scripting:
 ecbfx USD --quiet || echo "fetch failed, exit $?"
 ```
 
+---
+
 ## Python API
 
 ```python
@@ -172,22 +167,28 @@ pairs = [
     (date(2025, 1, 15), "USD"),
     (date(2025, 1, 20), "GBP"),
     (date(2025, 2,  3), "USD"),
-    (date(2025, 2,  3), "CHF"),
 ]
 rows = fetch_rates_for_pairs(pairs, direct=True)
 
-# Custom decimal precision
-rows = fetch_rates(["USD"], date(2025, 1, 15), date(2025, 1, 15), decimals=6)
-
-# Strict mode — raises ECBError on weekends/holidays
+# Strict mode — raises ECBError on weekends/holidays instead of substituting
 rows = fetch_rates(["USD"], date(2025, 1, 13), date(2025, 1, 13), gap_fill=False)
-rows = fetch_rates_for_pairs([(date(2025, 1, 13), "USD")], gap_fill=False)
 
 for r in rows:
     print(r["date"], r["currency"], r["convention"], r["rate"])
 ```
 
-Each row is a dict: `{date, currency, rate, convention}`.
+Both fetch functions accept `direct`, `decimals`, `gap_fill`, `timeout` and an
+optional `session` for connection reuse.
+
+### Behaviour worth knowing
+
+- **`fetch_rates` is all-or-nothing across currencies.** A malformed code raises
+  before any request. A well-formed code the ECB will not serve raises partway
+  through: rows already fetched are discarded and later currencies are never
+  requested. Call once per currency if you need per-currency isolation.
+- **Duplicate currencies collapse.** `["USD", "usd"]` is one HTTP call and one
+  row per date.
+- **Output order differs between the two functions** — see the table below.
 
 ### Input validation
 
@@ -195,13 +196,14 @@ Each row is a dict: `{date, currency, rate, convention}`.
 from ecbfx import validate_currency, ECBError
 
 # Normalises and validates a currency code — raises ECBError if invalid
-print(validate_currency("usd"))   # → "USD"
-print(validate_currency("  GBP ")) # → "GBP"
+print(validate_currency("usd"))    # → "USD"
+print(validate_currency("  GBP "))  # → "GBP"
 
 try:
     validate_currency("US$")
 except ECBError as e:
-    print(e)  # Invalid currency code 'US$'. Expected 2–4 ASCII letters.
+    print(e)
+    # Invalid currency code 'US$'. Expected a 3-letter ISO 4217 code, e.g. USD, GBP, CHF.
 ```
 
 Use `ECBError` in `try/except` blocks when calling any `ecbfx` function
@@ -213,11 +215,15 @@ to handle API failures, network errors, or invalid inputs cleanly.
 |---|---|---|
 | Input | currency list + date range | list of `(date, currency)` tuples |
 | Returns | every calendar day in range | exactly the requested dates |
+| Order | sorted by `(date, currency)` | matches input order, repeats included |
 | Best for | daily pipelines, backfill | transaction enrichment, broker CSVs |
-| HTTP calls | one per currency | one per currency (full span, regardless of gaps) |
 
-> **Note:** `fetch_rates_for_pairs` always fetches the full date span from the earliest to the latest date per currency in a single HTTP call. For very sparse data (e.g. two transactions 10 years apart), this fetches the entire intervening range. A warning is logged when the span exceeds one year.
+Both make one HTTP call per currency.
 
+> **Note:** `fetch_rates_for_pairs` fetches the full span from the earliest to
+> the latest date per currency in that single call. For very sparse data (e.g.
+> two transactions 10 years apart) this pulls the entire intervening range; a
+> warning is logged when the span exceeds one year.
 
 ---
 

{ecbfx-0.2.0 → ecbfx-0.3.0}/README.md

@@ -15,12 +15,11 @@ rates directly from the [ECB SDMX API](https://data-api.ecb.europa.eu).
 pip install ecbfx
 ```
 
-**For development** (includes test dependencies):
+Working on `ecbfx`:
 
 ```bash
 git clone https://github.com/edvinassvedas-dev/ecbfx.git
-cd ecbfx
-pip install -e ".[dev]"
+cd ecbfx && pip install -e ".[dev]"
 pytest
 ```
 
@@ -32,10 +31,8 @@ pytest
 # If today's rate isn't available yet, use --latest instead.
 ecbfx USD
 
-# Specific date
+# Specific date, and multiple currencies at once
 ecbfx USD 2025-01-15
-
-# Multiple currencies, specific date
 ecbfx USD GBP CHF 2025-01-15
 
 # Date range
@@ -48,27 +45,14 @@ ecbfx USD 2025-01-15 --direct
 ecbfx USD --latest
 
 # Single value only — ideal for shell scripting
-ecbfx USD --latest --quiet
 RATE=$(ecbfx USD --quiet)
 
-# Control decimal precision (default: 4)
-ecbfx USD 2025-01-15 --decimal 6
-
-# Strict mode — error instead of gap-filling on weekends/holidays
-ecbfx USD 2025-01-15 --no-gap-fill
-
 # CSV output (pipe-friendly)
-ecbfx USD --from 2025-01-01 --to 2025-01-31 --csv
 ecbfx USD --from 2025-01-01 --to 2025-01-31 --csv > rates.csv
 
-# Read pairs from a file — one HTTP call per currency
+# Read (date, currency) pairs from a file or stdin — one HTTP call per currency
 ecbfx --pairs transactions.csv --direct --csv
-
-# Read pairs from stdin
 cat transactions.csv | ecbfx --pairs - --direct --csv
-
-# Combine with date filter
-ecbfx --pairs transactions.csv --from 2025-01-01 --to 2025-03-31 --csv
 ```
 
 ### Convention
@@ -86,13 +70,17 @@ direction explicit for downstream pipelines.
 
 | Flag | Default | Description |
 |---|---|---|
+| `--from YYYY-MM-DD` | — | Start of date range (inclusive). Also filters `--pairs` input |
+| `--to YYYY-MM-DD` | — | End of date range (inclusive). Requires `--from` in range mode |
 | `--direct` | off | EUR per 1 foreign unit instead of ECB native |
 | `--latest` | off | Most recent available rate, regardless of date |
 | `--quiet` / `-q` | off | Print rate value(s) only — ideal for scripting |
-| `--decimal N` | 4 | Decimal places in output rate |
+| `--decimal N` / `--decimals N` | 4 | Output precision. Decimal places normally; with `--direct` a floor on *significant* digits, so high-ratio currencies (JPY, HUF, KRW) keep full precision instead of collapsing to `0.0007` |
+| `--timeout N` | 30 | HTTP timeout in seconds, per attempt (3 attempts with backoff) |
 | `--no-gap-fill` | off | Raise an error on weekends/holidays instead of substituting the nearest rate |
 | `--csv` | off | CSV output instead of formatted table |
-| `--pairs FILE\|-` | — | Read `date,currency` pairs from a file or stdin |
+| `--pairs FILE\|-` | — | Read `date,currency` pairs from a file or stdin. Comma, tab or space separated; surrounding quotes are tolerated, so spreadsheet exports work as-is |
+| `--version` | — | Print the installed version and exit |
 
 ### Weekend and holiday gap-filling
 
@@ -101,11 +89,14 @@ uses the most recent prior trading day's rate (Last Observation Carried Forward)
 when a requested date falls on a weekend or public holiday — including the first
 date in a range that starts on a holiday such as January 1st.
 
-Use `--no-gap-fill` to disable this and receive an explicit error instead —
-useful in audit workflows where a substituted rate is not acceptable.
-
----
+A future date is never substituted, so a rate is never influenced by information
+that did not exist on the date requested. If no trading day exists within 5
+calendar days before the target — the widest real gap in the ECB calendar — the
+lookup fails rather than reaching further back for a staler rate.
 
+Use `--no-gap-fill` to disable substitution entirely and receive an explicit
+error instead — useful in audit workflows where a substituted rate is not
+acceptable.
 
 ### Exit codes
 
@@ -120,6 +111,8 @@ Useful for scripting:
 ecbfx USD --quiet || echo "fetch failed, exit $?"
 ```
 
+---
+
 ## Python API
 
 ```python
@@ -140,22 +133,28 @@ pairs = [
     (date(2025, 1, 15), "USD"),
     (date(2025, 1, 20), "GBP"),
     (date(2025, 2,  3), "USD"),
-    (date(2025, 2,  3), "CHF"),
 ]
 rows = fetch_rates_for_pairs(pairs, direct=True)
 
-# Custom decimal precision
-rows = fetch_rates(["USD"], date(2025, 1, 15), date(2025, 1, 15), decimals=6)
-
-# Strict mode — raises ECBError on weekends/holidays
+# Strict mode — raises ECBError on weekends/holidays instead of substituting
 rows = fetch_rates(["USD"], date(2025, 1, 13), date(2025, 1, 13), gap_fill=False)
-rows = fetch_rates_for_pairs([(date(2025, 1, 13), "USD")], gap_fill=False)
 
 for r in rows:
     print(r["date"], r["currency"], r["convention"], r["rate"])
 ```
 
-Each row is a dict: `{date, currency, rate, convention}`.
+Both fetch functions accept `direct`, `decimals`, `gap_fill`, `timeout` and an
+optional `session` for connection reuse.
+
+### Behaviour worth knowing
+
+- **`fetch_rates` is all-or-nothing across currencies.** A malformed code raises
+  before any request. A well-formed code the ECB will not serve raises partway
+  through: rows already fetched are discarded and later currencies are never
+  requested. Call once per currency if you need per-currency isolation.
+- **Duplicate currencies collapse.** `["USD", "usd"]` is one HTTP call and one
+  row per date.
+- **Output order differs between the two functions** — see the table below.
 
 ### Input validation
 
@@ -163,13 +162,14 @@ Each row is a dict: `{date, currency, rate, convention}`.
 from ecbfx import validate_currency, ECBError
 
 # Normalises and validates a currency code — raises ECBError if invalid
-print(validate_currency("usd"))   # → "USD"
-print(validate_currency("  GBP ")) # → "GBP"
+print(validate_currency("usd"))    # → "USD"
+print(validate_currency("  GBP "))  # → "GBP"
 
 try:
     validate_currency("US$")
 except ECBError as e:
-    print(e)  # Invalid currency code 'US$'. Expected 2–4 ASCII letters.
+    print(e)
+    # Invalid currency code 'US$'. Expected a 3-letter ISO 4217 code, e.g. USD, GBP, CHF.
 ```
 
 Use `ECBError` in `try/except` blocks when calling any `ecbfx` function
@@ -181,11 +181,15 @@ to handle API failures, network errors, or invalid inputs cleanly.
 |---|---|---|
 | Input | currency list + date range | list of `(date, currency)` tuples |
 | Returns | every calendar day in range | exactly the requested dates |
+| Order | sorted by `(date, currency)` | matches input order, repeats included |
 | Best for | daily pipelines, backfill | transaction enrichment, broker CSVs |
-| HTTP calls | one per currency | one per currency (full span, regardless of gaps) |
 
-> **Note:** `fetch_rates_for_pairs` always fetches the full date span from the earliest to the latest date per currency in a single HTTP call. For very sparse data (e.g. two transactions 10 years apart), this fetches the entire intervening range. A warning is logged when the span exceeds one year.
+Both make one HTTP call per currency.
 
+> **Note:** `fetch_rates_for_pairs` fetches the full span from the earliest to
+> the latest date per currency in that single call. For very sparse data (e.g.
+> two transactions 10 years apart) this pulls the entire intervening range; a
+> warning is logged when the span exceeds one year.
 
 ---
 

{ecbfx-0.2.0 → ecbfx-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name            = "ecbfx"
-version         = "0.2.0"
+version         = "0.3.0"
 description     = "ECB foreign exchange rate lookup — CLI and Python API with gap-fill, strict mode, and scripting support"
 readme          = "README.md"
 license         = { text = "MIT" }
@@ -27,6 +27,7 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Office/Business :: Financial",
     "Topic :: Utilities",
 ]
@@ -40,6 +41,7 @@ dev = [
     "pytest>=7",
     "pytest-cov",
     "responses",       # HTTP mocking for tests
+    "ruff",            # linter — see [tool.ruff] below
 ]
 
 [project.scripts]
@@ -53,6 +55,22 @@ Issues     = "https://github.com/edvinassvedas-dev/ecbfx/issues"
 [tool.hatch.build.targets.wheel]
 packages = ["src/ecbfx"]
 
+
 [tool.pytest.ini_options]
 testpaths    = ["tests"]
 addopts      = "-v --tb=short"
+
+[tool.ruff]
+# 88 is Black's default; this code is written to roughly 95, so the default
+# would report ~9 pure-formatting hits that say nothing about correctness.
+line-length = 100
+
+[tool.ruff.lint]
+# Bug-shaped rules only. The `UP`/`I` families were deliberately left out —
+# they would flag ~37 "use `list` instead of `List`" style rewrites, and
+# requires-python is >=3.9 where the typing imports are still needed.
+select = ["E", "F", "B"]
+ignore = [
+    "E731",  # the DIM/BOLD/CYAN/... colour helpers read better as an aligned
+             # block of lambdas than as six separate defs
+]

{ecbfx-0.2.0 → ecbfx-0.3.0}/src/ecbfx/__init__.py

@@ -13,11 +13,9 @@ from .api import (
     resolve_rate,
 )
 
-try:
-    from importlib.metadata import version as _v
-    __version__ = _v("ecbfx")
-except Exception:
-    __version__ = "unknown"
+from .api import package_version
+
+__version__ = package_version()
 
 __all__ = [
     "ECBError",