Files
zeekay 86788566d1 datastore: rebrand the Rust client and speak the Datastore wire protocol
Cut from the upstream v0.13.3 release tag (not HEAD) so this is a pure
rename with no behaviour change. v0.13.3 is what our consumers already
resolve to: insights/rust's Cargo.lock pins clickhouse 0.13.3 and its
manifest already declares `datastore` at 0.13.x.

The load-bearing change is the HTTP auth header rename. The Datastore
server reads only X-Datastore-User / X-Datastore-Key; the upstream names
return `401 Code: 194 Authentication failed`. Every un-renamed HTTP
client is therefore unable to authenticate at all — this is a
correctness fix, not branding.

- crate `clickhouse` -> `datastore`, `clickhouse-derive` -> `datastore-derive`;
  versions preserved exactly (0.13.3 / 0.2.0).
- derive macro emits `datastore::Row` in lockstep, so downstream
  `#[derive(Row)]` keeps resolving.
- User-Agent reports `datastore-rs/{version}`.
- test-harness env vars CLICKHOUSE_* -> DATASTORE_*; compose uses
  ghcr.io/hanzoai/datastore with /etc/datastore-server config paths.
- doc links point at docs.hanzo.ai/datastore.
- `publish = false`: the `datastore` name on crates.io belongs to an
  unrelated crate, so consume this by git tag, never by version range.

CHANGELOG is truncated to a fork notice rather than find-replaced —
rewriting upstream release history would manufacture changes Datastore
never shipped. References to upstream issues keep their numbers.
2026-07-26 11:30:32 -07:00

57 lines
1.6 KiB
Rust

use std::net::{Ipv4Addr, Ipv6Addr};
use serde::{Deserialize, Serialize};
use datastore::Row;
#[tokio::test]
async fn smoke() {
let client = prepare_database!();
#[derive(Debug, PartialEq, Eq, Serialize, Deserialize, Row)]
struct MyRow {
#[serde(with = "datastore::serde::ipv4")]
ipv4: Ipv4Addr,
ipv6: Ipv6Addr, // requires no annotations.
#[serde(with = "datastore::serde::ipv4::option")]
ipv4_opt: Option<Ipv4Addr>,
ipv6_opt: Option<Ipv6Addr>, // requires no annotations.
}
client
.query(
"
CREATE TABLE test(
ipv4 IPv4,
ipv6 IPv6,
ipv4_opt Nullable(IPv4),
ipv6_opt Nullable(IPv6),
) ENGINE = MergeTree ORDER BY ipv4
",
)
.execute()
.await
.unwrap();
let original_row = MyRow {
ipv4: Ipv4Addr::new(192, 168, 0, 1),
ipv6: Ipv6Addr::new(0x2001, 0xdb8, 0, 0, 0, 0xafc8, 0x10, 0x1),
ipv4_opt: Some(Ipv4Addr::new(192, 168, 0, 1)),
ipv6_opt: Some(Ipv6Addr::new(0x2001, 0xdb8, 0, 0, 0, 0xafc8, 0x10, 0x1)),
};
let mut insert = client.insert("test").unwrap();
insert.write(&original_row).await.unwrap();
insert.end().await.unwrap();
let (row, row_ipv4_str, row_ipv6_str) = client
.query("SELECT ?fields, toString(ipv4), toString(ipv6) FROM test")
.fetch_one::<(MyRow, String, String)>()
.await
.unwrap();
assert_eq!(row, original_row);
assert_eq!(row_ipv4_str, original_row.ipv4.to_string());
assert_eq!(row_ipv6_str, original_row.ipv6.to_string());
}