Publish Xarray Datasets via a REST API.
Project description
Publish Xarray Datasets via a REST API.
Serverside: Publish a Xarray Dataset through a rest API
ds.rest.serve(host="0.0.0.0", port=9000)Client-side: Connect to a published dataset
The published dataset can be accessed from various kinds of client applications. Here is an example of directly accessing the data from within Python:
import xarray as xr
import zarr
from fsspec.implementations.http import HTTPFileSystem
fs = HTTPFileSystem()
http_map = fs.get_mapper('http://0.0.0.0:9000')
# open as a zarr group
zg = zarr.open_consolidated(http_map, mode='r')
# or open as another Xarray Dataset
ds = xr.open_zarr(http_map, consolidated=True)Why?
Xpublish lets you serve/share/publish Xarray Datasets via a web application.
The data and/or metadata in the Xarray Datasets can be exposed in various forms through pluggable REST API endpoints. Efficient, on-demand delivery of large datasets may be enabled with Dask on the server-side.
We are exploring applications of Xpublish that include:
publish on-demand or derived data products
turning xarray objects into streaming services (e.g. OPeNDAP)
How?
Under the hood, Xpublish is using a web app (FastAPI) that is exposing a REST-like API with builtin and/or user-defined endpoints.
For example, Xpublish provides by default a minimal Zarr compatible REST-like API with the following endpoints:
.zmetadata: returns Zarr-formatted metadata keys as json strings.
var/0.0.0: returns a variable data chunk as a binary string.
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 xpublish-0.2.0.tar.gz.
File metadata
- Download URL: xpublish-0.2.0.tar.gz
- Upload date:
- Size: 38.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.10.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | da221ef83c51d660c13f95883121f1b82d39b3d7e83c7d2c46cf9f6e4edd372b |
|
| MD5 | 22b96afccd9679b7f8baa3c06d0c94e4 |
|
| BLAKE2b-256 | 99d2227123697bf88110860f8b03c4b7ab507d83ab43b184e3ff9edb61866203 |
File details
Details for the file xpublish-0.2.0-py3-none-any.whl.
File metadata
- Download URL: xpublish-0.2.0-py3-none-any.whl
- Upload date:
- Size: 17.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.10.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 49ae38ef201706510396e82e676480c0bbfb102bccc00704655b891297f545ad |
|
| MD5 | 5e069ea81b2a873991eb5e59e8fd176b |
|
| BLAKE2b-256 | 6486ae60a5993af99ac575312925f87b40d6d1a8224f767d9551db52f6b1401f |
