---
id: hdx-python-utilities
version: "4.1.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# hdx-python-utilities — HDX Python Utilities for streaming tabular data, date and time handling and other helpful functions

License: permissive · Maintenance: active · Downloads: 561.0K/mo

## What it is and what it does

HDX Python Utilities is a general-purpose library that bundles common utility functions for data handling, file operations, and text processing. It wraps or provides helpers around tasks like downloading files with authentication and hashing, loading and saving JSON and YAML while preserving order, date/time manipulation, dictionary and list operations, HTML parsing, logging setup, and URL handling.

The library is designed for developers who need these utilities without building them from scratch. It brings together 15 runtime dependencies including frictionless, openpyxl, requests-file, ruamel-yaml, and others to provide a cohesive interface for common operations. It's part of the Humanitarian Data Exchange project but explicitly notes these utilities are not HDX-specific.

Use it for:

- Download files from URLs with built-in support for authentication, streaming, and hash verification
- Load and save JSON or YAML data while maintaining key order across Python versions
- Parse and manipulate tabular data using frictionless and Excel libraries
- Set up structured logging and error handling quickly without boilerplate
- Process and validate text, URLs, UUIDs, and other common data formats

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a collection of utilities for Python developers covering file downloading, data retrieval, JSON/YAML handling, date operations, text processing, hashing, logging, and URL manipulation.

Yes, if you need a grab-bag of utility functions for data handling and file operations. The library is actively maintained, has no known vulnerabilities, and installs with low friction. The MIT license is permissive. However, its 15 runtime dependencies mean you're pulling in a substantial dependency tree; evaluate whether you need the full suite or could use smaller, focused libraries instead.

## Install

pip install hdx-python-utilities
uv add hdx-python-utilities
poetry add hdx-python-utilities

## Installing hdx-python-utilities

Before you install: Low friction installation with a pure-Python wheel. Actively maintained as of 2026-06-16 with recent activity. Supports Python 3.10 through 3.14.

License in practice: MIT license (permissive) allows use in commercial and open-source projects with minimal restrictions.

Quickstart:

pip install hdx-python-utilities

from hdx_python_utilities.utilities.dictionary import merge_dictionaries

result = merge_dictionaries({"a": 1}, {"b": 2})

Requires Python 3.10 or later.

Verify before relying:

- Whether all 15 runtime dependencies are required for core functionality or if some are optional/conditional imports
- Performance characteristics when handling large files or streaming data
- Specific authentication methods supported beyond the general 'authentication' claim in description

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 561.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

file download utilities, json yaml handling, date time utilities, data retrieval streaming, text processing helpers, logging setup, url utilities, data-utilities, file-handling

[View on SkillFed](https://skillfed.io/packages/hdx-python-utilities) · [View on PyPI](https://pypi.org/project/hdx-python-utilities/)