bblocks
Building Blocks for development data work
bblocks is a growing collection of Python packages designed to simplify the everyday work of analysts and
researchers in the international development sector. Built with usability and modularity in mind, bblocks
provides reliable, reusable components that help standardize and streamline data workflows—from data cleaning
and transformation to country concordance, dataset importation, and integration with ETL pipelines such as Data Commons.
Whether you're wrangling data for a quick analysis or developing a robust, production-ready
pipeline, bblocks offers practical, tested tools that are easy to plug into your workflow and scale with your needs.
Read the documentation for more details on how to use bblocks packages
and the motivation for their creation.
Packages
bblocks is an umbrella package that includes several specialized sub-packages,
each designed to address specific data tasks.
bblocks-places: Resolve and standardize place names, including countries, regions, and other geographic entities.bblocks-data-importers: Tools to import data from different international development sources such as IMF, World Bank and many others.
Installation
It’s easy to get started with bblocks. Whether you want the full distribution or only specific tools, installation is flexible and straightforward.
Install the entire bblocks toolkit
This is recommended for most users who want access to all the tools in the bblocks ecosystem.
pip install bblocks[all]
Install specific bblocks packages
Install only the packages you need without unnecessary dependencies. For example, to install the places package:
pip install bblocks[places]
You can also install individual packages directly:
pip install bblocks-places
Basic Usage
Once installed, you can start using bblocks packages in your analysis pipelines. Here's a
quick example of fetching some data using th bblocks-data-importers and resolving entity
names with bblocks-places:
from bblocks.data_importers import WorldBank
from bblocks import places
# Fetch World Bank data for series "SI.POV.DDAY" (poverty headcount ratio at $3.00 a day)
wb = WorldBank()
df = wb.get_data(series="SI.POV.DDAY")
# Resolve entities to short names
df["country"] = places.resolve_places(df["entity_name"], to="name_short", not_found="ignore")
# filter for African countries
gdp_africa = places.filter_african_countries(df["country"])
# Keep only relevant columns
gdp_africa = gdp_africa.loc[:, ["year", "country", "value",]]
# preview the results
print(gdp_africa.head())
# Output:
# year country value
# 0 1988 Algeria 12.3
# 1 1995 Algeria 11.8
# 2 2011 Algeria 0
# 3 2000 Angola 27
# ...
Contributing
We welcome contributions to bblocks! If you have ideas for new packages, improvements, or bug fixes,
please check out our contributing guidelines
for details on how to get involved.
Release files for bblocks 2.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| bblocks-2.2.0.tar.gz | 3.3 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| bblocks-2.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 7.1 kB
Release files / bblocks-2.2.0.tar.gz
| Download URL | bblocks-2.2.0.tar.gz |
|---|---|
| Size | 3.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
524227ec0c4a0ae0640501c0a1bf961d444a8c32118bcedff1c030894f4c0e22
|
|
BLAKE2b-256 checksum How to use checksums |
73c4907568861a65fd3a40191f59c35e9cf3c40e6cdb1375716dc555220b5f2c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / bblocks-2.2.0-py3-none-any.whl
| Download URL | bblocks-2.2.0-py3-none-any.whl |
|---|---|
| Size | 3.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
443ea7165224f9fcbf8a4245855a5b81246d612a9533d34c85edd86387b50f49
|
|
BLAKE2b-256 checksum How to use checksums |
4c8ad4ec99403a15d46acd317051b9f46106f8766a3ef1a5431f9af24b7fca9a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Security for bblocks 2.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
