imibare

Programmatic access to Rwandan government statistical data.

imibare gives you clean, typed, versioned access to official statistics published by Rwandan government institutions (NISR, BNR, MINECOFIN, RSSB, RRA, and more) as pandas or polars DataFrames. No scraping, no PDF wrangling.

Install

pip install imibare

Optional extras:

pip install imibare[polars]    # return polars DataFrames
pip install imibare[iceberg]   # snapshot time travel via load(version=...)

Quick start

import imibare as imi

# Browse the catalog (works offline)
for d in imi.catalog(country="RW")[:5]:
    print(d.id, "-", d.name)

# Load a dataset as a pandas DataFrame
df = imi.load("rw.nisr.cpi.monthly")

# Filter by date range
recent = imi.load("rw.nisr.cpi.monthly", start="2023-01-01")

# Return a polars DataFrame (requires the [polars] extra)
fx = imi.load("rw.bnr.fx.daily", engine="polars")

Catalog

catalog() returns dataset metadata you can filter by country, topic, or frequency:

imi.catalog()                             # every dataset
imi.catalog(country="RW", topic="prices")
imi.catalog(frequency="daily")

Each entry carries its id, producing institution, coverage window, columns, source URL, and license.

Dataset IDs

Every dataset has a stable, country-prefixed id of four segments:

{country}.{institution}.{topic}.{frequency}
rw.nisr.cpi.monthly

Ids are permanent; a breaking schema change ships under a new suffix (for example rw.nisr.cpi.monthly.v2).

Versioned data (time travel)

With the [iceberg] extra you can load a dataset as it stood on a given date:

imi.load("rw.nisr.cpi.monthly", version="2025-06-01")

Data access

catalog() works offline from metadata bundled in the package. load() fetches Parquet data from imibare's object store; see the documentation for access configuration.

Links

License

Code is released under the MIT License. Data retrieved through this package remains under the license of each source institution; see each dataset's metadata for details.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.2.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for imibare from gravatar.com imibare

Credits

Author: imibare

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Provides Extra

dev iceberg polars

Tags

africa economics government-data open-data rwanda statistics

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

imibare-0.1.0.tar.gz (111.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

imibare-0.1.0-py3-none-any.whl (109.4 kB view details)

Uploaded Python 3

File details

Details for the file imibare-0.1.0.tar.gz.

File metadata

  • Download URL: imibare-0.1.0.tar.gz
  • Upload date:
  • Size: 111.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for imibare-0.1.0.tar.gz
Algorithm Hash digest
SHA256 a4818ac5d77fc87b7c7448cebaee3951da4c0aa57150677d9f88b91af5579d67
MD5 4477b19d47a866726d49e71f9bbb1b55
BLAKE2b-256 ef94c9b2e5b9ef0f82a24b30614bbb6ee90c5e9254fe671d21523fd3a0b504c1

See more details on using hashes here.

Provenance

The following attestation bundles were made for imibare-0.1.0.tar.gz:

Publisher: publish-pypi.yml on imibare/imibare

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file imibare-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: imibare-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 109.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for imibare-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6ff8c52db4e888e4823d0c1a48149dda28540f3cf36fd00401221948bd5327b8
MD5 fe1c985be8e5329866bb56d6988dd7bb
BLAKE2b-256 0cc67424ebd5e3632c2323fdc866b564bb1bbf83e995d0a2ce8bed886e6113c2

See more details on using hashes here.

Provenance

The following attestation bundles were made for imibare-0.1.0-py3-none-any.whl:

Publisher: publish-pypi.yml on imibare/imibare

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.2.0

2 files

This release

0.1.0 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page