datapress-core 0.3.3

Backend-agnostic core types, config, routing, and HTTP handlers for the datapress dataset server.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

# datapress-core

Backend-agnostic core for [datapress](https://github.com/jeroenflvr/fast-api) —
a Rust workspace that exposes Parquet / Delta datasets over a JSON HTTP API.

This crate holds the pieces shared by every backend:

- Configuration model (`datasets.toml` parsing, server/auth/docs/swagger/metrics
  blocks).
- The `Backend` trait and request/response models (`QueryRequest`, predicates,
  aggregation plans).
- Centralized `AppError` with HTTP status mapping.
- actix-web routing and v1 handlers, plus optional Swagger UI, Prometheus
  metrics, and OIDC auth (all feature-gated).

It is consumed by the backend crates
[`datapress-duckdb`](https://crates.io/crates/datapress-duckdb) and
[`datapress-datafusion`](https://crates.io/crates/datapress-datafusion); you
typically depend on one of those rather than on this crate directly.

## Features

| Feature      | Effect                                                        |
|--------------|---------------------------------------------------------------|
| `duckdb`     | Enables the DuckDB `From` error conversions.                  |
| `datafusion` | Enables the Arrow/Parquet/DataFusion `From` error conversions.|
| `docs`       | Embed and serve the MkDocs site.                              |
| `swagger`    | Embed Swagger UI + OpenAPI spec.                              |
| `metrics`    | Expose a Prometheus `/metrics` endpoint.                      |
| `auth`       | OIDC bearer-token authentication + scope enforcement.         |

## License

MIT — see [LICENSE](../../LICENSE).