parsimony-destatis
Destatis (German Federal Statistical Office) connector — fetches and enumerates tables from the public GENESIS-Online REST API.
Part of the parsimony-connectors monorepo. Distributed standalone on PyPI as parsimony-destatis.
Connectors
| Name | Kind | Description |
|---|---|---|
destatis_fetch |
fetch | Fetch a GENESIS table by code (e.g. 61111-0001), with optional start_year / end_year. JSON-stat 2.0 is parsed into long-format rows; German month/quarter labels are normalized to ISO dates. |
enumerate_destatis |
enumerator | Enumerate GENESIS statistics and their tables (catalog indexing) by crawling /statistics, /statistics/{code}/information, and /statistics/{code}/tables. |
destatis_search |
tool | Semantic-search the published Destatis catalog and map a natural-language query to a table code (feed it to destatis_fetch(name=...)). |
Coverage
The keyless GENESIS-Online REST API exposes 3,009 predefined tables across 331 statistics
(prices, population, national accounts, labour, foreign trade, production, transport, health,
environment, earnings, …). enumerate_destatis walks the authoritative path — /statistics
then a per-statistic /tables fan-out — which is lossless (every statistic's table list comes
back in full, no pagination cap, no table shared across statistics), so the catalog contains
every fetchable table. Each table is itself multi-dimensional: destatis_fetch returns one row
per (classification combination × period), with the classification dimensions preserved as
columns. Time is parsed from the JSON-stat period keys (annual, monthly, quarterly, semester,
reference-date, school-year — all normalized to ISO dates).
The multidimensional cube / custom-table power-user surface of classic GENESIS is not part of this keyless API (it belonged to the retired registration-gated webservice) and is out of scope.
Install
pip install parsimony-destatis
Pulls in a compatible parsimony automatically. Verify discovery:
python -c "from parsimony import discover; print([p.name for p in discover.iter_providers()])"
Configuration
No credentials required. GENESIS-Online allows anonymous access — there is no API key, username, or password to set.
The only optional setting is the catalog-snapshot URL used by destatis_search:
export PARSIMONY_DESTATIS_CATALOG_URL="hf://your-org/destatis" # optional; overrides the default snapshot
Quick start
from parsimony_destatis import CONNECTORS
result = CONNECTORS["destatis_fetch"](name="61111-0001")
print(result.raw.head())
For multi-plugin composition:
from parsimony import discover
connectors = discover.load_all()
Provider
- Homepage: https://www.destatis.de
- GENESIS-Online API: https://genesis.destatis.de/genesis/api/rest
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_destatis-0.0.2.tar.gz.
File metadata
- Download URL: parsimony_destatis-0.0.2.tar.gz
- Upload date:
- Size: 21.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3c95368ef9b65c74c71b8092edcaeeef4c722774a0904c56df1a1c2aa030d33f
|
|
| MD5 |
2de591db437292fda3055098a64354b3
|
|
| BLAKE2b-256 |
b65ba0cd13c18f7556afd4348c82a82c16b13cf239fe29473bf0d0e8bf8354c2
|
Provenance
The following attestation bundles were made for parsimony_destatis-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_destatis-0.0.2.tar.gz -
Subject digest:
3c95368ef9b65c74c71b8092edcaeeef4c722774a0904c56df1a1c2aa030d33f - Sigstore transparency entry: 2408423965
- 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_destatis-0.0.2-py3-none-any.whl.
File metadata
- Download URL: parsimony_destatis-0.0.2-py3-none-any.whl
- Upload date:
- Size: 21.7 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 |
72cf9526ecacba4049eff4ad9e5f9096e932ededab7330758cf1d2ecd16541d7
|
|
| MD5 |
d78a4200c312f0318fd5a83617690639
|
|
| BLAKE2b-256 |
3312abb27ff5270a88996e47630bea1e654c0578241c439630afbd081eaec087
|
Provenance
The following attestation bundles were made for parsimony_destatis-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_destatis-0.0.2-py3-none-any.whl -
Subject digest:
72cf9526ecacba4049eff4ad9e5f9096e932ededab7330758cf1d2ecd16541d7 - Sigstore transparency entry: 2408424096
- 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:
