RubyGems - spikard - Versions diffs - 0.4.0-x86_64-linux - Mend

spikard 0.4.0-x86_64-linux

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (138) hide show

checksums.yaml +7 -0
data/LICENSE +1 -0
data/README.md +659 -0
data/ext/spikard_rb/Cargo.toml +17 -0
data/ext/spikard_rb/extconf.rb +10 -0
data/ext/spikard_rb/src/lib.rs +6 -0
data/lib/spikard/app.rb +405 -0
data/lib/spikard/background.rb +27 -0
data/lib/spikard/config.rb +396 -0
data/lib/spikard/converters.rb +13 -0
data/lib/spikard/handler_wrapper.rb +113 -0
data/lib/spikard/provide.rb +214 -0
data/lib/spikard/response.rb +173 -0
data/lib/spikard/schema.rb +243 -0
data/lib/spikard/sse.rb +111 -0
data/lib/spikard/streaming_response.rb +44 -0
data/lib/spikard/testing.rb +221 -0
data/lib/spikard/upload_file.rb +131 -0
data/lib/spikard/version.rb +5 -0
data/lib/spikard/websocket.rb +59 -0
data/lib/spikard.rb +43 -0
data/sig/spikard.rbs +366 -0
data/vendor/bundle/ruby/3.4.0/gems/diff-lcs-1.6.2/mise.toml +5 -0
data/vendor/bundle/ruby/3.4.0/gems/rake-compiler-dock-1.10.0/build/buildkitd.toml +2 -0
data/vendor/crates/spikard-bindings-shared/Cargo.toml +63 -0
data/vendor/crates/spikard-bindings-shared/examples/config_extraction.rs +139 -0
data/vendor/crates/spikard-bindings-shared/src/config_extractor.rs +561 -0
data/vendor/crates/spikard-bindings-shared/src/conversion_traits.rs +194 -0
data/vendor/crates/spikard-bindings-shared/src/di_traits.rs +246 -0
data/vendor/crates/spikard-bindings-shared/src/error_response.rs +403 -0
data/vendor/crates/spikard-bindings-shared/src/handler_base.rs +274 -0
data/vendor/crates/spikard-bindings-shared/src/lib.rs +25 -0
data/vendor/crates/spikard-bindings-shared/src/lifecycle_base.rs +298 -0
data/vendor/crates/spikard-bindings-shared/src/lifecycle_executor.rs +637 -0
data/vendor/crates/spikard-bindings-shared/src/response_builder.rs +309 -0
data/vendor/crates/spikard-bindings-shared/src/test_client_base.rs +248 -0
data/vendor/crates/spikard-bindings-shared/src/validation_helpers.rs +355 -0
data/vendor/crates/spikard-bindings-shared/tests/comprehensive_coverage.rs +502 -0
data/vendor/crates/spikard-bindings-shared/tests/error_response_edge_cases.rs +389 -0
data/vendor/crates/spikard-bindings-shared/tests/handler_base_integration.rs +413 -0
data/vendor/crates/spikard-core/Cargo.toml +40 -0
data/vendor/crates/spikard-core/src/bindings/mod.rs +3 -0
data/vendor/crates/spikard-core/src/bindings/response.rs +133 -0
data/vendor/crates/spikard-core/src/debug.rs +63 -0
data/vendor/crates/spikard-core/src/di/container.rs +726 -0
data/vendor/crates/spikard-core/src/di/dependency.rs +273 -0
data/vendor/crates/spikard-core/src/di/error.rs +118 -0
data/vendor/crates/spikard-core/src/di/factory.rs +538 -0
data/vendor/crates/spikard-core/src/di/graph.rs +545 -0
data/vendor/crates/spikard-core/src/di/mod.rs +192 -0
data/vendor/crates/spikard-core/src/di/resolved.rs +411 -0
data/vendor/crates/spikard-core/src/di/value.rs +283 -0
data/vendor/crates/spikard-core/src/errors.rs +39 -0
data/vendor/crates/spikard-core/src/http.rs +153 -0
data/vendor/crates/spikard-core/src/lib.rs +29 -0
data/vendor/crates/spikard-core/src/lifecycle.rs +422 -0
data/vendor/crates/spikard-core/src/metadata.rs +397 -0
data/vendor/crates/spikard-core/src/parameters.rs +723 -0
data/vendor/crates/spikard-core/src/problem.rs +310 -0
data/vendor/crates/spikard-core/src/request_data.rs +189 -0
data/vendor/crates/spikard-core/src/router.rs +249 -0
data/vendor/crates/spikard-core/src/schema_registry.rs +183 -0
data/vendor/crates/spikard-core/src/type_hints.rs +304 -0
data/vendor/crates/spikard-core/src/validation/error_mapper.rs +689 -0
data/vendor/crates/spikard-core/src/validation/mod.rs +459 -0
data/vendor/crates/spikard-http/Cargo.toml +58 -0
data/vendor/crates/spikard-http/examples/sse-notifications.rs +147 -0
data/vendor/crates/spikard-http/examples/websocket-chat.rs +91 -0
data/vendor/crates/spikard-http/src/auth.rs +247 -0
data/vendor/crates/spikard-http/src/background.rs +1562 -0
data/vendor/crates/spikard-http/src/bindings/mod.rs +3 -0
data/vendor/crates/spikard-http/src/bindings/response.rs +1 -0
data/vendor/crates/spikard-http/src/body_metadata.rs +8 -0
data/vendor/crates/spikard-http/src/cors.rs +490 -0
data/vendor/crates/spikard-http/src/debug.rs +63 -0
data/vendor/crates/spikard-http/src/di_handler.rs +1878 -0
data/vendor/crates/spikard-http/src/handler_response.rs +532 -0
data/vendor/crates/spikard-http/src/handler_trait.rs +861 -0
data/vendor/crates/spikard-http/src/handler_trait_tests.rs +284 -0
data/vendor/crates/spikard-http/src/lib.rs +524 -0
data/vendor/crates/spikard-http/src/lifecycle/adapter.rs +149 -0
data/vendor/crates/spikard-http/src/lifecycle.rs +428 -0
data/vendor/crates/spikard-http/src/middleware/mod.rs +285 -0
data/vendor/crates/spikard-http/src/middleware/multipart.rs +930 -0
data/vendor/crates/spikard-http/src/middleware/urlencoded.rs +541 -0
data/vendor/crates/spikard-http/src/middleware/validation.rs +287 -0
data/vendor/crates/spikard-http/src/openapi/mod.rs +309 -0
data/vendor/crates/spikard-http/src/openapi/parameter_extraction.rs +535 -0
data/vendor/crates/spikard-http/src/openapi/schema_conversion.rs +867 -0
data/vendor/crates/spikard-http/src/openapi/spec_generation.rs +678 -0
data/vendor/crates/spikard-http/src/query_parser.rs +369 -0
data/vendor/crates/spikard-http/src/response.rs +399 -0
data/vendor/crates/spikard-http/src/server/handler.rs +1557 -0
data/vendor/crates/spikard-http/src/server/lifecycle_execution.rs +98 -0
data/vendor/crates/spikard-http/src/server/mod.rs +806 -0
data/vendor/crates/spikard-http/src/server/request_extraction.rs +630 -0
data/vendor/crates/spikard-http/src/server/routing_factory.rs +497 -0
data/vendor/crates/spikard-http/src/sse.rs +961 -0
data/vendor/crates/spikard-http/src/testing/form.rs +14 -0
data/vendor/crates/spikard-http/src/testing/multipart.rs +60 -0
data/vendor/crates/spikard-http/src/testing/test_client.rs +285 -0
data/vendor/crates/spikard-http/src/testing.rs +377 -0
data/vendor/crates/spikard-http/src/websocket.rs +831 -0
data/vendor/crates/spikard-http/tests/background_behavior.rs +918 -0
data/vendor/crates/spikard-http/tests/common/handlers.rs +308 -0
data/vendor/crates/spikard-http/tests/common/mod.rs +21 -0
data/vendor/crates/spikard-http/tests/di_integration.rs +202 -0
data/vendor/crates/spikard-http/tests/doc_snippets.rs +4 -0
data/vendor/crates/spikard-http/tests/lifecycle_execution.rs +1135 -0
data/vendor/crates/spikard-http/tests/multipart_behavior.rs +688 -0
data/vendor/crates/spikard-http/tests/server_config_builder.rs +324 -0
data/vendor/crates/spikard-http/tests/sse_behavior.rs +728 -0
data/vendor/crates/spikard-http/tests/websocket_behavior.rs +724 -0
data/vendor/crates/spikard-rb/Cargo.toml +43 -0
data/vendor/crates/spikard-rb/build.rs +199 -0
data/vendor/crates/spikard-rb/src/background.rs +63 -0
data/vendor/crates/spikard-rb/src/config/mod.rs +5 -0
data/vendor/crates/spikard-rb/src/config/server_config.rs +283 -0
data/vendor/crates/spikard-rb/src/conversion.rs +459 -0
data/vendor/crates/spikard-rb/src/di/builder.rs +105 -0
data/vendor/crates/spikard-rb/src/di/mod.rs +413 -0
data/vendor/crates/spikard-rb/src/handler.rs +612 -0
data/vendor/crates/spikard-rb/src/integration/mod.rs +3 -0
data/vendor/crates/spikard-rb/src/lib.rs +1857 -0
data/vendor/crates/spikard-rb/src/lifecycle.rs +275 -0
data/vendor/crates/spikard-rb/src/metadata/mod.rs +5 -0
data/vendor/crates/spikard-rb/src/metadata/route_extraction.rs +427 -0
data/vendor/crates/spikard-rb/src/runtime/mod.rs +5 -0
data/vendor/crates/spikard-rb/src/runtime/server_runner.rs +326 -0
data/vendor/crates/spikard-rb/src/server.rs +283 -0
data/vendor/crates/spikard-rb/src/sse.rs +231 -0
data/vendor/crates/spikard-rb/src/testing/client.rs +404 -0
data/vendor/crates/spikard-rb/src/testing/mod.rs +7 -0
data/vendor/crates/spikard-rb/src/testing/sse.rs +143 -0
data/vendor/crates/spikard-rb/src/testing/websocket.rs +221 -0
data/vendor/crates/spikard-rb/src/websocket.rs +233 -0
data/vendor/crates/spikard-rb/tests/magnus_ffi_tests.rs +14 -0
metadata +213 -0

data/vendor/crates/spikard-http/src/testing.rs ADDED Viewed

@@ -0,0 +1,377 @@
+use axum::body::Body;
+use axum::http::Request as AxumRequest;
+use axum_test::{TestResponse as AxumTestResponse, TestServer, TestWebSocket, WsMessage};
+pub mod multipart;
+pub use multipart::{MultipartFilePart, build_multipart_body};
+pub mod form;
+pub mod test_client;
+pub use test_client::TestClient;
+use brotli::Decompressor;
+use flate2::read::GzDecoder;
+pub use form::encode_urlencoded_body;
+use http_body_util::BodyExt;
+use serde_json::Value;
+use std::collections::HashMap;
+use std::io::{Cursor, Read};
+/// Snapshot of an Axum response used by higher-level language bindings.
+#[derive(Debug, Clone)]
+pub struct ResponseSnapshot {
+    /// HTTP status code.
+    pub status: u16,
+    /// Response headers (lowercase keys for predictable lookups).
+    pub headers: HashMap<String, String>,
+    /// Response body bytes (decoded for supported encodings).
+    pub body: Vec<u8>,
+}
+impl ResponseSnapshot {
+    /// Return response body as UTF-8 string.
+    pub fn text(&self) -> Result<String, std::string::FromUtf8Error> {
+        String::from_utf8(self.body.clone())
+    }
+    /// Parse response body as JSON.
+    pub fn json(&self) -> Result<Value, serde_json::Error> {
+        serde_json::from_slice(&self.body)
+    }
+    /// Lookup header by case-insensitive name.
+    pub fn header(&self, name: &str) -> Option<&str> {
+        self.headers.get(&name.to_ascii_lowercase()).map(|s| s.as_str())
+    }
+}
+/// Possible errors while converting an Axum response into a snapshot.
+#[derive(Debug)]
+pub enum SnapshotError {
+    /// Response header could not be decoded to UTF-8.
+    InvalidHeader(String),
+    /// Body decompression failed.
+    Decompression(String),
+}
+impl std::fmt::Display for SnapshotError {
+    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
+        match self {
+            SnapshotError::InvalidHeader(msg) => write!(f, "Invalid header: {}", msg),
+            SnapshotError::Decompression(msg) => write!(f, "Failed to decode body: {}", msg),
+        }
+    }
+}
+impl std::error::Error for SnapshotError {}
+/// Execute an HTTP request against an Axum [`TestServer`] by rehydrating it
+/// into the server's own [`axum_test::TestRequest`] builder.
+pub async fn call_test_server(server: &TestServer, request: AxumRequest<Body>) -> AxumTestResponse {
+    let (parts, body) = request.into_parts();
+    let mut path = parts.uri.path().to_string();
+    if let Some(query) = parts.uri.query()
+        && !query.is_empty()
+    {
+        path.push('?');
+        path.push_str(query);
+    }
+    let mut test_request = server.method(parts.method.clone(), &path);
+    for (name, value) in parts.headers.iter() {
+        test_request = test_request.add_header(name.clone(), value.clone());
+    }
+    let collected = body
+        .collect()
+        .await
+        .expect("failed to read request body for test dispatch");
+    let bytes = collected.to_bytes();
+    if !bytes.is_empty() {
+        test_request = test_request.bytes(bytes);
+    }
+    test_request.await
+}
+/// Convert an `AxumTestResponse` into a reusable [`ResponseSnapshot`].
+pub async fn snapshot_response(response: AxumTestResponse) -> Result<ResponseSnapshot, SnapshotError> {
+    let status = response.status_code().as_u16();
+    let mut headers = HashMap::new();
+    for (name, value) in response.headers() {
+        let header_value = value
+            .to_str()
+            .map_err(|e| SnapshotError::InvalidHeader(e.to_string()))?;
+        headers.insert(name.to_string().to_ascii_lowercase(), header_value.to_string());
+    }
+    let body = response.into_bytes();
+    let decoded_body = decode_body(&headers, body.to_vec())?;
+    Ok(ResponseSnapshot {
+        status,
+        headers,
+        body: decoded_body,
+    })
+}
+fn decode_body(headers: &HashMap<String, String>, body: Vec<u8>) -> Result<Vec<u8>, SnapshotError> {
+    let encoding = headers
+        .get("content-encoding")
+        .map(|value| value.trim().to_ascii_lowercase());
+    match encoding.as_deref() {
+        Some("gzip") | Some("x-gzip") => decode_gzip(body),
+        Some("br") => decode_brotli(body),
+        _ => Ok(body),
+    }
+}
+fn decode_gzip(body: Vec<u8>) -> Result<Vec<u8>, SnapshotError> {
+    let mut decoder = GzDecoder::new(Cursor::new(body));
+    let mut decoded = Vec::new();
+    decoder
+        .read_to_end(&mut decoded)
+        .map_err(|e| SnapshotError::Decompression(e.to_string()))?;
+    Ok(decoded)
+}
+fn decode_brotli(body: Vec<u8>) -> Result<Vec<u8>, SnapshotError> {
+    let mut decoder = Decompressor::new(Cursor::new(body), 4096);
+    let mut decoded = Vec::new();
+    decoder
+        .read_to_end(&mut decoded)
+        .map_err(|e| SnapshotError::Decompression(e.to_string()))?;
+    Ok(decoded)
+}
+/// WebSocket connection wrapper for testing.
+///
+/// Provides a simple interface for sending and receiving WebSocket messages
+/// during tests without needing a real network connection.
+pub struct WebSocketConnection {
+    inner: TestWebSocket,
+}
+impl WebSocketConnection {
+    /// Create a new WebSocket connection from an axum-test TestWebSocket.
+    pub fn new(inner: TestWebSocket) -> Self {
+        Self { inner }
+    }
+    /// Send a text message over the WebSocket.
+    pub async fn send_text(&mut self, text: impl std::fmt::Display) {
+        self.inner.send_text(text).await;
+    }
+    /// Send a JSON message over the WebSocket.
+    pub async fn send_json<T: serde::Serialize>(&mut self, value: &T) {
+        self.inner.send_json(value).await;
+    }
+    /// Send a raw WebSocket message.
+    pub async fn send_message(&mut self, msg: WsMessage) {
+        self.inner.send_message(msg).await;
+    }
+    /// Receive the next text message from the WebSocket.
+    pub async fn receive_text(&mut self) -> String {
+        self.inner.receive_text().await
+    }
+    /// Receive and parse a JSON message from the WebSocket.
+    pub async fn receive_json<T: serde::de::DeserializeOwned>(&mut self) -> T {
+        self.inner.receive_json().await
+    }
+    /// Receive raw bytes from the WebSocket.
+    pub async fn receive_bytes(&mut self) -> bytes::Bytes {
+        self.inner.receive_bytes().await
+    }
+    /// Receive the next raw message from the WebSocket.
+    pub async fn receive_message(&mut self) -> WebSocketMessage {
+        let msg = self.inner.receive_message().await;
+        WebSocketMessage::from_ws_message(msg)
+    }
+    /// Close the WebSocket connection.
+    pub async fn close(self) {
+        self.inner.close().await;
+    }
+}
+/// A WebSocket message that can be text or binary.
+#[derive(Debug, Clone)]
+pub enum WebSocketMessage {
+    /// A text message.
+    Text(String),
+    /// A binary message.
+    Binary(Vec<u8>),
+    /// A close message.
+    Close(Option<String>),
+    /// A ping message.
+    Ping(Vec<u8>),
+    /// A pong message.
+    Pong(Vec<u8>),
+}
+impl WebSocketMessage {
+    fn from_ws_message(msg: WsMessage) -> Self {
+        match msg {
+            WsMessage::Text(text) => WebSocketMessage::Text(text.to_string()),
+            WsMessage::Binary(data) => WebSocketMessage::Binary(data.to_vec()),
+            WsMessage::Close(frame) => WebSocketMessage::Close(frame.map(|f| f.reason.to_string())),
+            WsMessage::Ping(data) => WebSocketMessage::Ping(data.to_vec()),
+            WsMessage::Pong(data) => WebSocketMessage::Pong(data.to_vec()),
+            WsMessage::Frame(_) => WebSocketMessage::Close(None),
+        }
+    }
+    /// Get the message as text, if it's a text message.
+    pub fn as_text(&self) -> Option<&str> {
+        match self {
+            WebSocketMessage::Text(text) => Some(text),
+            _ => None,
+        }
+    }
+    /// Get the message as JSON, if it's a text message containing JSON.
+    pub fn as_json(&self) -> Result<Value, String> {
+        match self {
+            WebSocketMessage::Text(text) => {
+                serde_json::from_str(text).map_err(|e| format!("Failed to parse JSON: {}", e))
+            }
+            _ => Err("Message is not text".to_string()),
+        }
+    }
+    /// Get the message as binary, if it's a binary message.
+    pub fn as_binary(&self) -> Option<&[u8]> {
+        match self {
+            WebSocketMessage::Binary(data) => Some(data),
+            _ => None,
+        }
+    }
+    /// Check if this is a close message.
+    pub fn is_close(&self) -> bool {
+        matches!(self, WebSocketMessage::Close(_))
+    }
+}
+/// Connect to a WebSocket endpoint on the test server.
+pub async fn connect_websocket(server: &TestServer, path: &str) -> WebSocketConnection {
+    let ws = server.get_websocket(path).await.into_websocket().await;
+    WebSocketConnection::new(ws)
+}
+/// Server-Sent Events (SSE) stream for testing.
+///
+/// Wraps a response body and provides methods to parse SSE events.
+#[derive(Debug)]
+pub struct SseStream {
+    body: String,
+    events: Vec<SseEvent>,
+}
+impl SseStream {
+    /// Create a new SSE stream from a response.
+    pub fn from_response(response: &ResponseSnapshot) -> Result<Self, String> {
+        let body = response
+            .text()
+            .map_err(|e| format!("Failed to read response body: {}", e))?;
+        let events = Self::parse_events(&body);
+        Ok(Self { body, events })
+    }
+    fn parse_events(body: &str) -> Vec<SseEvent> {
+        let mut events = Vec::new();
+        let lines: Vec<&str> = body.lines().collect();
+        let mut i = 0;
+        while i < lines.len() {
+            if lines[i].starts_with("data:") {
+                let data = lines[i].trim_start_matches("data:").trim().to_string();
+                events.push(SseEvent { data });
+            } else if lines[i].starts_with("data") {
+                let data = lines[i].trim_start_matches("data").trim().to_string();
+                if !data.is_empty() || lines[i].len() == 4 {
+                    events.push(SseEvent { data });
+                }
+            }
+            i += 1;
+        }
+        events
+    }
+    /// Get all events from the stream.
+    pub fn events(&self) -> &[SseEvent] {
+        &self.events
+    }
+    /// Get the raw body of the SSE response.
+    pub fn body(&self) -> &str {
+        &self.body
+    }
+    /// Get events as JSON values.
+    pub fn events_as_json(&self) -> Result<Vec<Value>, String> {
+        self.events
+            .iter()
+            .map(|event| event.as_json())
+            .collect::<Result<Vec<_>, _>>()
+    }
+}
+/// A single Server-Sent Event.
+#[derive(Debug, Clone)]
+pub struct SseEvent {
+    /// The data field of the event.
+    pub data: String,
+}
+impl SseEvent {
+    /// Parse the event data as JSON.
+    pub fn as_json(&self) -> Result<Value, String> {
+        serde_json::from_str(&self.data).map_err(|e| format!("Failed to parse JSON: {}", e))
+    }
+}
+#[cfg(test)]
+mod tests {
+    use super::*;
+    #[test]
+    fn sse_stream_parses_multiple_events() {
+        let mut headers = HashMap::new();
+        headers.insert("content-type".to_string(), "text/event-stream".to_string());
+        let snapshot = ResponseSnapshot {
+            status: 200,
+            headers,
+            body: b"data: {\"id\": 1}\n\ndata: \"hello\"\n\n".to_vec(),
+        };
+        let stream = SseStream::from_response(&snapshot).expect("stream");
+        assert_eq!(stream.events().len(), 2);
+        assert_eq!(stream.events()[0].as_json().unwrap()["id"], serde_json::json!(1));
+        assert_eq!(stream.events()[1].data, "\"hello\"");
+        assert_eq!(stream.events_as_json().unwrap().len(), 2);
+    }
+    #[test]
+    fn sse_event_reports_invalid_json() {
+        let event = SseEvent {
+            data: "not-json".to_string(),
+        };
+        assert!(event.as_json().is_err());
+    }
+}