814390feec
Crate nuevo en crates/core/brahman-handshake que implementa el handshake real del shared_wit/protocol.wit como wire format Rust↔Rust sobre Unix socket con frames length-prefixed + cuerpo postcard. Componentes: - src/messages.rs: Hello, HelloAck, Ping, Pong, Farewell, HandshakeError y Frame (enum-suma). HandshakeError ya implementa thiserror::Error y cruza el wire. - src/codec.rs: write_frame / read_frame asíncronos con MAX_FRAME_BYTES de 4 MiB. Test interno de roundtrip. - src/server.rs: Server::bind crea el listener en Unix socket; emite ResolvedCard tras validar la Card y devuelve ULID como SessionId. ServerConfig.init_attached se reporta en HelloAck. - src/client.rs: Client::connect hace pre-validación local de la Card (fail fast), envía Hello, parsea HelloAck. ping() y farewell() expuestos. - tests/handshake.rs: 4 tests de integración: * full_handshake_roundtrip — happy path con 3 pings + farewell * rejects_invalid_card_client_side — label vacío rechazado pre-envío * server_rejects_protocol_mismatch — protocol_version 999.0.0 → Error * ping_before_hello_rejected — Ping sin Hello previo → Rejected Limitación conocida: postcard no serializa serde_json::Value (variantes Array/Object con length dinámico). Se removieron por eso los campos `extensions` (Card) y `extra` (Permissions). Forward-compat queda cubierta por schema_version + protocol_version negotiation; si más adelante necesitamos preservar campos JSON desconocidos, irá en un WireCard separado o un envelope. 13/13 tests verdes (brahman-card 8 + brahman-handshake codec 1 + integ 4). cargo check --workspace: 0 errores. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
168 lines
5.0 KiB
Rust
168 lines
5.0 KiB
Rust
//! Tests de integración: levanta server + client en el mismo proceso,
|
|
//! ejercita el round-trip completo del protocolo.
|
|
|
|
use std::collections::BTreeSet;
|
|
use std::time::Duration;
|
|
|
|
use brahman_card::{
|
|
Card, CgroupSpec, NamespaceSet, Payload, ResourceLimits, SomaSpec, Supervision,
|
|
CARD_SCHEMA_VERSION,
|
|
};
|
|
use brahman_handshake::{
|
|
client::{Client, ClientError},
|
|
codec::{read_frame, write_frame},
|
|
messages::{Frame, HandshakeError, Hello, Ping},
|
|
server::{Server, ServerConfig},
|
|
};
|
|
use tokio::net::UnixStream;
|
|
use ulid::Ulid;
|
|
|
|
fn sample_card(label: &str) -> Card {
|
|
Card {
|
|
schema_version: CARD_SCHEMA_VERSION,
|
|
id: Ulid::new(),
|
|
lineage: None,
|
|
label: label.into(),
|
|
provides: BTreeSet::new(),
|
|
requires: BTreeSet::new(),
|
|
soma: SomaSpec {
|
|
cgroup: CgroupSpec {
|
|
path: "ente.slice/test".into(),
|
|
cpu_weight: None,
|
|
io_weight: None,
|
|
},
|
|
namespaces: NamespaceSet::default(),
|
|
rlimits: ResourceLimits::default(),
|
|
cpu_affinity: None,
|
|
},
|
|
payload: Payload::Virtual,
|
|
supervision: Supervision::OneShot,
|
|
..Default::default()
|
|
}
|
|
}
|
|
|
|
/// Genera una ruta de socket única bajo TMPDIR. No la creamos —
|
|
/// el server la creará al hacer bind.
|
|
fn sock_path(name: &str) -> std::path::PathBuf {
|
|
std::env::temp_dir().join(format!(
|
|
"brahman-test-{}-{}-{}.sock",
|
|
name,
|
|
std::process::id(),
|
|
Ulid::new()
|
|
))
|
|
}
|
|
|
|
#[tokio::test]
|
|
async fn full_handshake_roundtrip() {
|
|
let path = sock_path("happy");
|
|
let server = Server::bind(&path, ServerConfig { init_attached: true }).unwrap();
|
|
|
|
let session_handle = tokio::spawn({
|
|
async move {
|
|
let session = server.accept_one().await.unwrap();
|
|
session.handle().await.unwrap();
|
|
}
|
|
});
|
|
|
|
let mut client = Client::connect(&path, sample_card("alpha")).await.unwrap();
|
|
assert!(client.server_info().init_attached);
|
|
assert_eq!(
|
|
client.server_info().protocol_version,
|
|
brahman_card::PROTOCOL_VERSION
|
|
);
|
|
|
|
let mut last = 0u64;
|
|
for _ in 0..3 {
|
|
let ts = client.ping().await.unwrap();
|
|
assert!(ts >= last);
|
|
last = ts;
|
|
tokio::time::sleep(Duration::from_millis(2)).await;
|
|
}
|
|
client.farewell().await.unwrap();
|
|
|
|
tokio::time::timeout(Duration::from_secs(2), session_handle)
|
|
.await
|
|
.expect("server hung after farewell")
|
|
.unwrap();
|
|
}
|
|
|
|
#[tokio::test]
|
|
async fn rejects_invalid_card_client_side() {
|
|
let path = sock_path("invalid");
|
|
let server = Server::bind(&path, ServerConfig::default()).unwrap();
|
|
let session_handle = tokio::spawn(async move {
|
|
// No esperamos que el server complete: el cliente corta antes.
|
|
let _ = tokio::time::timeout(Duration::from_secs(1), async move {
|
|
let session = server.accept_one().await.unwrap();
|
|
session.handle().await.unwrap();
|
|
})
|
|
.await;
|
|
});
|
|
|
|
let mut bad = sample_card("placeholder");
|
|
bad.label = String::new();
|
|
let err = Client::connect(&path, bad).await.unwrap_err();
|
|
assert!(matches!(err, ClientError::InvalidCard(_)));
|
|
|
|
session_handle.abort();
|
|
}
|
|
|
|
#[tokio::test]
|
|
async fn server_rejects_protocol_mismatch() {
|
|
let path = sock_path("mismatch");
|
|
let server = Server::bind(&path, ServerConfig::default()).unwrap();
|
|
let session_handle = tokio::spawn(async move {
|
|
let session = server.accept_one().await.unwrap();
|
|
session.handle().await.unwrap();
|
|
});
|
|
|
|
let mut stream = UnixStream::connect(&path).await.unwrap();
|
|
let hello = Hello {
|
|
schema_version: CARD_SCHEMA_VERSION,
|
|
protocol_version: "999.0.0".into(),
|
|
card: sample_card("future-module"),
|
|
};
|
|
write_frame(&mut stream, &Frame::Hello(hello)).await.unwrap();
|
|
|
|
match read_frame(&mut stream).await.unwrap() {
|
|
Frame::Error(HandshakeError::ProtocolMismatch(_)) => {}
|
|
other => panic!("esperado ProtocolMismatch, got {other:?}"),
|
|
}
|
|
|
|
tokio::time::timeout(Duration::from_secs(2), session_handle)
|
|
.await
|
|
.expect("server hung after rejecting")
|
|
.unwrap();
|
|
}
|
|
|
|
#[tokio::test]
|
|
async fn ping_before_hello_rejected() {
|
|
let path = sock_path("ping-no-hello");
|
|
let server = Server::bind(&path, ServerConfig::default()).unwrap();
|
|
let session_handle = tokio::spawn(async move {
|
|
let session = server.accept_one().await.unwrap();
|
|
session.handle().await.unwrap();
|
|
});
|
|
|
|
// Conectamos y mandamos un Ping sin haber saludado.
|
|
let mut stream = UnixStream::connect(&path).await.unwrap();
|
|
write_frame(
|
|
&mut stream,
|
|
&Frame::Ping(Ping {
|
|
session: Ulid::new(),
|
|
}),
|
|
)
|
|
.await
|
|
.unwrap();
|
|
|
|
match read_frame(&mut stream).await.unwrap() {
|
|
Frame::Error(HandshakeError::Rejected(_)) => {}
|
|
other => panic!("esperado Rejected, got {other:?}"),
|
|
}
|
|
|
|
tokio::time::timeout(Duration::from_secs(2), session_handle)
|
|
.await
|
|
.expect("server hung after rejecting")
|
|
.unwrap();
|
|
}
|