parsimony-bdf
Banque de France connector — French macroeconomic, monetary, and financial time series via the Webstat (Opendatasoft) API.
Part of the parsimony-connectors monorepo. Distributed standalone on PyPI as parsimony-bdf.
Connectors
| Name | Kind | Description |
|---|---|---|
bdf_fetch |
connector | Fetch a Banque de France time series by SDMX key (e.g. EXR.M.USD.EUR.SP00.E), optionally bounded by start_period/end_period. |
enumerate_bdf |
enumerator | Stream the full BdF series universe (~41.6k series across 45 dataflows) for catalog discovery. |
bdf_search |
connector | Semantic-search the published BdF catalog snapshot; returns ranked series codes. |
Install
pip install parsimony-bdf
Pulls in a compatible parsimony automatically. Verify discovery:
python -c "from parsimony import discover; print([p.name for p in discover.iter_providers()])"
Configuration
The Webstat API requires a free API key. Register at https://developer.webstat.banque-france.fr/, then set:
export BDF_API_KEY="<your-key>"
The key is sent in the Authorization: Apikey <KEY> header (the literal word
Apikey, not Bearer). It is declared as a secret (stripped from
provenance) and never appears in request logs. Supply it via the env var above,
or bind it explicitly:
from parsimony_bdf import load
connectors = load(api_key="<your-key>") # binds the key across the bundle
A missing key fails fast with UnauthorizedError naming BDF_API_KEY.
bdf_search reads a published catalog snapshot (default hf://parsimony-dev/bdf).
Override the snapshot location with the PARSIMONY_BDF_CATALOG_URL environment
variable, or pass catalog_url= at call time.
Quick start
from parsimony_bdf import load
connectors = load(api_key="<your-key>")
result = connectors["bdf_fetch"](key="EXR.M.USD.EUR.SP00.E")
print(result.raw.head())
For multi-plugin composition (autoloads everything installed):
from parsimony import discover
connectors = discover.load_all()
Catalogs
The Webstat series dataset is a single flat queryable table, so enumerate_bdf
discovers the entire universe in two requests: one series/exports/json
export (~41.6k series) plus one webstat-datasets call for the 45 dataflow stub
rows. Each series row carries English + French titles and a topic breadcrumb,
folded into the catalog description for cross-language recall. Maintainers
build a Catalog snapshot from it (scripts/build_catalog.py) and push it to
the snapshot URL bdf_search reads — the build runs offline as a publish job,
never at query time. Quota: 10,000 requests/day.
Provider
- Homepage: https://www.banque-france.fr
- Webstat portal: https://webstat.banque-france.fr
- Developer portal: https://developer.webstat.banque-france.fr/
License
See LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file parsimony_bdf-0.0.2.tar.gz.
File metadata
- Download URL: parsimony_bdf-0.0.2.tar.gz
- Upload date:
- Size: 16.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1d5fb59d84f1c07e09f1ad1a61c4aace2403e52b39fb6ea7764fd8ffbd2742c9
|
|
| MD5 |
1c42b6fcd14accc51de94c96833cf795
|
|
| BLAKE2b-256 |
9348c176c6065064c36479a53b2ed51123b84a40991523565b98d10262806e36
|
Provenance
The following attestation bundles were made for parsimony_bdf-0.0.2.tar.gz:
Publisher:
release.yml on ockham-sh/parsimony-connectors
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
parsimony_bdf-0.0.2.tar.gz -
Subject digest:
1d5fb59d84f1c07e09f1ad1a61c4aace2403e52b39fb6ea7764fd8ffbd2742c9 - Sigstore transparency entry: 2408409126
- Sigstore integration time:
-
Permalink:
ockham-sh/parsimony-connectors@45adac08dad2b5faf031867e7e3ca1b87689f5b9 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/ockham-sh
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@45adac08dad2b5faf031867e7e3ca1b87689f5b9 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file parsimony_bdf-0.0.2-py3-none-any.whl.
File metadata
- Download URL: parsimony_bdf-0.0.2-py3-none-any.whl
- Upload date:
- Size: 19.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3a328b06e34fdfea2a98ca65b02538efe8fcd392686afd72d39f160214cef119
|
|
| MD5 |
520607cfeea4f34a6aee050992287042
|
|
| BLAKE2b-256 |
03291e3c29ffa1a10814d1552d2d0de5f0990336a21f73e46354cde34e522538
|
Provenance
The following attestation bundles were made for parsimony_bdf-0.0.2-py3-none-any.whl:
Publisher:
release.yml on ockham-sh/parsimony-connectors
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
parsimony_bdf-0.0.2-py3-none-any.whl -
Subject digest:
3a328b06e34fdfea2a98ca65b02538efe8fcd392686afd72d39f160214cef119 - Sigstore transparency entry: 2408409396
- Sigstore integration time:
-
Permalink:
ockham-sh/parsimony-connectors@45adac08dad2b5faf031867e7e3ca1b87689f5b9 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/ockham-sh
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@45adac08dad2b5faf031867e7e3ca1b87689f5b9 -
Trigger Event:
workflow_dispatch
-
Statement type:
