datapress-client 0.4.20

Async + blocking Rust client for a running DataPress dataset server (JSON and Arrow IPC).
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
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

# datapress-client

Async + blocking Rust client for a running [DataPress](https://github.com/jeroenflvr/datapress)
dataset server. Wraps the JSON and Arrow IPC HTTP endpoints.

## Features

- `arrow` *(default)* — decode Arrow IPC stream responses into `arrow::record_batch::RecordBatch`.
- `blocking` *(default)* — synchronous `blocking::Client` backed by a private current-thread Tokio runtime.

Disable defaults for an async-only, reqwest + serde build:

```toml
datapress-client = { version = "0.4", default-features = false }
```

## Async

```rust,no_run
use datapress_client::{Client, QueryRequest, Predicate};

# async fn run() -> datapress_client::Result<()> {
let client = Client::new("http://127.0.0.1:8000")?;
let names = client.datasets().await?;

let req = QueryRequest::builder()
    .columns(["State", "Severity"])
    .predicate(Predicate::new("Severity", "gte", 3))
    .page_size(10_000)
    .build();
let resp = client.query_json("accidents", &req).await?;
println!("{} rows", resp.data.len());
# Ok(())
# }
```

## Blocking

```rust,no_run
use datapress_client::blocking::Client;

# fn run() -> datapress_client::Result<()> {
let client = Client::new("http://127.0.0.1:8000")?;
let count = client.count("accidents", &[])?;
println!("{count} rows");
# Ok(())
# }
```

## Arrow

```rust,no_run
# use datapress_client::{Client, QueryRequest};
# async fn run(client: Client, req: QueryRequest) -> datapress_client::Result<()> {
let batches = client.query_arrow("accidents", &req).await?;
for batch in &batches {
    println!("{} rows x {} cols", batch.num_rows(), batch.num_columns());
}
# Ok(())
# }
```

## Endpoints covered

| Method                 | Endpoint                                |
| ---------------------- | --------------------------------------- |
| `healthz` / `readyz`   | `GET /healthz`, `GET /readyz` (root)    |
| `datasets`             | `GET {api}/datasets`                    |
| `schema`               | `GET {api}/datasets/{name}/schema`      |
| `count`                | `POST {api}/datasets/{name}/count`      |
| `query_json`           | `POST {api}/datasets/{name}/query`      |
| `query_arrow`          | `POST {api}/datasets/{name}/query/stream` (Arrow IPC) |
| `sql`                  | `POST {api}/sql`                        |
| `reload`               | `POST {api}/datasets/{name}/reload`     |

`{api}` defaults to `/api/v1` (configurable via `ClientBuilder::api_base`).

## License

MIT