Core utilities to serve HDF5 file contents
Project description
h5grove, core utilities to serve HDF5 file contents
h5grove is a Python package that provides utilities to design backends serving HDF5 file content: attributes, metadata and data. HDF5 files are accessed with h5py.
Rationale
There are several packages out there that can serve HDF5 files. However, they are dedicated to their usecases and settle on one implementation, hampering reusability.
In addition, some problems arise constantly when designing HDF5 backends. To name a few:
- Resolving external links
- Dealing with compression and slicing of datasets
- Encoding data efficiently and consistently (looking at you,
NaN,Infinityin JSON)
h5grove aims at providing building blocks that solve these common problems and can be reused in existing or new backends.
Installation
pip install h5grove
You can use h5grove low-level utilities whatever the backend implementation you choose. We simply provide additional utilities for Tornado and Flask that can be installed with:
pip install h5grove[flask] # For Flask
pip install h5grove[tornado] # For Tornado
Contents
Example implementations using Flask and Tornado are given in the example folder. These are functional backends that make use of the utilities provided by the h5grove package.
For more tailored use, you can make use of the low-level utilities in your own project. The package contains the following modules:
content: A hierarchy ofContentclasses that extract the relevant information (be it attributes, metadata or data) from the file (resolving links if possible) and expose them through methods.
Ideally, getting the information from a path in the file should be as simple as:
with h5py.File(filepath, "r") as h5file:
content = create_content(h5file, path)
# Get metadata (valid for all entities)
content.metadata()
# Get data (only valid for datasets)
content.data()
encoders: Functions that encode data and provide the appropriate headers to build request responses. The module provides a JSON and a binary encoder.flaskutils: Utilities dedicated to Flask backends. Notably provides a Blueprint.tornadoutils: Utilities dedicated to Tornado backends.
Release history Release notifications | RSS feed
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
File details
Details for the file h5grove-0.0.5.tar.gz.
File metadata
- Download URL: h5grove-0.0.5.tar.gz
- Upload date:
- Size: 11.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.6.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.6.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d6d712507b7e370031038767f47411d9778513c0bbbe4541c86e2bcba88d8472 |
|
| MD5 | f8317d0550fcdb27875a7cb5e08f82fd |
|
| BLAKE2b-256 | 0efe04d6756753fd612e365918bec96a78154224acb9bea952b7140722a65bcb |
File details
Details for the file h5grove-0.0.5-py3-none-any.whl.
File metadata
- Download URL: h5grove-0.0.5-py3-none-any.whl
- Upload date:
- Size: 10.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.6.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.6.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 9aa730203abb486b6a2f3a7b9b137efaae408c068981dd99c409bfc1db0bb325 |
|
| MD5 | c185f463aec2f4d57357c542f13458ab |
|
| BLAKE2b-256 | a340f9dda48041c8c33f02f0f60c314adbe7b6432fbb5f342f28de3e5cd9d427 |
