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-rb/src/lifecycle.rs ADDED Viewed

@@ -0,0 +1,275 @@
+//! Ruby lifecycle hooks implementation
+//!
+//! This module provides the bridge between Ruby blocks/procs and Rust's lifecycle hook system.
+//! Uses magnus to safely call Ruby code from Rust async tasks.
+use axum::{
+    body::Body,
+    http::{Request, Response, StatusCode},
+};
+use magnus::{RHash, Value, gc::Marker, prelude::*, value::InnerValue, value::Opaque};
+use serde_json::Value as JsonValue;
+use spikard_http::lifecycle::{HookResult, LifecycleHook};
+use std::future::Future;
+use std::pin::Pin;
+/// Ruby lifecycle hook wrapper
+///
+/// Wraps a Ruby proc/block and makes it callable from Rust's lifecycle system.
+/// Handles conversion between Rust HTTP types and Ruby request/response objects.
+pub struct RubyLifecycleHook {
+    name: String,
+    /// Ruby proc/callable object (Opaque for Send safety)
+    func: Opaque<Value>,
+}
+impl RubyLifecycleHook {
+    /// Create a new Ruby lifecycle hook
+    pub fn new(name: String, func: Value) -> Self {
+        Self {
+            name,
+            func: func.into(),
+        }
+    }
+    /// Mark Ruby values for GC
+    #[allow(dead_code)]
+    pub fn mark(&self, marker: &Marker) {
+        if let Ok(ruby) = magnus::Ruby::get() {
+            marker.mark(self.func.get_inner_with(&ruby));
+        }
+    }
+}
+impl LifecycleHook<Request<Body>, Response<Body>> for RubyLifecycleHook {
+    fn name(&self) -> &str {
+        &self.name
+    }
+    fn execute_request<'a>(
+        &'a self,
+        req: Request<Body>,
+    ) -> Pin<Box<dyn Future<Output = Result<HookResult<Request<Body>, Response<Body>>, String>> + Send + 'a>> {
+        let func = self.func;
+        let name = self.name.clone();
+        let name_for_error = name.clone();
+        Box::pin(async move {
+            let (parts, body) = req.into_parts();
+            let body_bytes = axum::body::to_bytes(body, usize::MAX)
+                .await
+                .map_err(|e| format!("Failed to read request body: {}", e))?;
+            let body_value: JsonValue = if body_bytes.is_empty() {
+                JsonValue::Null
+            } else {
+                serde_json::from_slice(&body_bytes)
+                    .unwrap_or_else(|_| JsonValue::String(String::from_utf8_lossy(&body_bytes).to_string()))
+            };
+            let result = magnus::Ruby::get()
+                .map_err(|e| format!("Failed to get Ruby: {}", e))
+                .and_then(|ruby| {
+                    let request_hash = RHash::new();
+                    request_hash
+                        .aset(ruby.to_symbol("method"), ruby.str_new(parts.method.as_str()))
+                        .map_err(|e| format!("Failed to set method: {}", e))?;
+                    request_hash
+                        .aset(ruby.to_symbol("path"), ruby.str_new(parts.uri.path()))
+                        .map_err(|e| format!("Failed to set path: {}", e))?;
+                    let headers_hash = RHash::new();
+                    for (key, value) in parts.headers.iter() {
+                        headers_hash
+                            .aset(ruby.str_new(key.as_str()), ruby.str_new(value.to_str().unwrap_or("")))
+                            .map_err(|e| format!("Failed to set header: {}", e))?;
+                    }
+                    request_hash
+                        .aset(ruby.to_symbol("headers"), headers_hash)
+                        .map_err(|e| format!("Failed to set headers: {}", e))?;
+                    let body_str =
+                        serde_json::to_string(&body_value).map_err(|e| format!("Failed to serialize body: {}", e))?;
+                    request_hash
+                        .aset(ruby.to_symbol("body"), ruby.str_new(&body_str))
+                        .map_err(|e| format!("Failed to set body: {}", e))?;
+                    let func_value = ruby.get_inner(func);
+                    let result: Value = func_value
+                        .funcall("call", (request_hash,))
+                        .map_err(|e| format!("Hook '{}' call failed: {}", name, e))?;
+                    if let Some(result_hash) = RHash::from_value(result) {
+                        if let Some(status_value) = result_hash.get(ruby.to_symbol("status_code")) {
+                            let status = i64::try_convert(status_value)
+                                .map_err(|e| format!("Failed to convert status code: {}", e))?;
+                            let content = result_hash
+                                .get(ruby.to_symbol("content"))
+                                .or_else(|| result_hash.get(ruby.to_symbol("body")))
+                                .unwrap_or_else(|| ruby.qnil().as_value());
+                            let body_str = if content.is_nil() {
+                                "{}".to_string()
+                            } else {
+                                String::try_convert(content).unwrap_or_else(|_| {
+                                    content
+                                        .to_r_string()
+                                        .map(|s| s.to_string().unwrap_or_else(|_| "{}".to_string()))
+                                        .unwrap_or_else(|_| "{}".to_string())
+                                })
+                            };
+                            let response = Response::builder()
+                                .status(StatusCode::from_u16(status as u16).unwrap_or(StatusCode::OK))
+                                .header("content-type", "application/json")
+                                .body(Body::from(body_str))
+                                .map_err(|e| format!("Failed to build response: {}", e))?;
+                            return Ok(HookResult::ShortCircuit(response));
+                        }
+                        let method = result_hash
+                            .get(ruby.to_symbol("method"))
+                            .and_then(|v| String::try_convert(v).ok())
+                            .unwrap_or_else(|| "GET".to_string());
+                        let path = result_hash
+                            .get(ruby.to_symbol("path"))
+                            .and_then(|v| String::try_convert(v).ok())
+                            .unwrap_or_else(|| "/".to_string());
+                        let req_builder = Request::builder().method(method.as_str()).uri(path);
+                        let body = if let Some(body_val) = result_hash.get(ruby.to_symbol("body")) {
+                            if body_val.is_nil() {
+                                Body::empty()
+                            } else {
+                                let body_str = String::try_convert(body_val).unwrap_or_else(|_| {
+                                    body_val
+                                        .to_r_string()
+                                        .map(|s| s.to_string().unwrap_or_default())
+                                        .unwrap_or_default()
+                                });
+                                Body::from(body_str)
+                            }
+                        } else {
+                            Body::empty()
+                        };
+                        let request = req_builder
+                            .body(body)
+                            .map_err(|e| format!("Failed to build request: {}", e))?;
+                        Ok(HookResult::Continue(request))
+                    } else {
+                        Err(format!("Hook must return a Hash, got {}", unsafe {
+                            result.classname()
+                        }))
+                    }
+                });
+            result.map_err(|e| format!("Hook '{}' task error: {}", name_for_error, e))
+        })
+    }
+    fn execute_response<'a>(
+        &'a self,
+        resp: Response<Body>,
+    ) -> Pin<Box<dyn Future<Output = Result<HookResult<Response<Body>, Response<Body>>, String>> + Send + 'a>> {
+        let func = self.func;
+        let name = self.name.clone();
+        let name_for_error = name.clone();
+        Box::pin(async move {
+            let (parts, body) = resp.into_parts();
+            let body_bytes = axum::body::to_bytes(body, usize::MAX)
+                .await
+                .map_err(|e| format!("Failed to read response body: {}", e))?;
+            let body_value: JsonValue = if body_bytes.is_empty() {
+                JsonValue::Null
+            } else {
+                serde_json::from_slice(&body_bytes)
+                    .unwrap_or_else(|_| JsonValue::String(String::from_utf8_lossy(&body_bytes).to_string()))
+            };
+            let result = magnus::Ruby::get()
+                .map_err(|e| format!("Failed to get Ruby: {}", e))
+                .and_then(|ruby| {
+                    let response_hash = RHash::new();
+                    response_hash
+                        .aset(
+                            ruby.to_symbol("status_code"),
+                            ruby.integer_from_i64(parts.status.as_u16() as i64),
+                        )
+                        .map_err(|e| format!("Failed to set status_code: {}", e))?;
+                    let headers_hash = RHash::new();
+                    for (key, value) in parts.headers.iter() {
+                        headers_hash
+                            .aset(ruby.str_new(key.as_str()), ruby.str_new(value.to_str().unwrap_or("")))
+                            .map_err(|e| format!("Failed to set header: {}", e))?;
+                    }
+                    response_hash
+                        .aset(ruby.to_symbol("headers"), headers_hash)
+                        .map_err(|e| format!("Failed to set headers: {}", e))?;
+                    let body_str =
+                        serde_json::to_string(&body_value).map_err(|e| format!("Failed to serialize body: {}", e))?;
+                    response_hash
+                        .aset(ruby.to_symbol("content"), ruby.str_new(&body_str))
+                        .map_err(|e| format!("Failed to set content: {}", e))?;
+                    let func_value = ruby.get_inner(func);
+                    let result: Value = func_value
+                        .funcall("call", (response_hash,))
+                        .map_err(|e| format!("Hook '{}' call failed: {}", name, e))?;
+                    if let Some(result_hash) = RHash::from_value(result) {
+                        let status = result_hash
+                            .get(ruby.to_symbol("status_code"))
+                            .and_then(|v| i64::try_convert(v).ok())
+                            .unwrap_or(200);
+                        let content = result_hash
+                            .get(ruby.to_symbol("content"))
+                            .or_else(|| result_hash.get(ruby.to_symbol("body")))
+                            .unwrap_or_else(|| ruby.qnil().as_value());
+                        let body_str = if content.is_nil() {
+                            "{}".to_string()
+                        } else {
+                            String::try_convert(content).unwrap_or_else(|_| {
+                                content
+                                    .to_r_string()
+                                    .map(|s| s.to_string().unwrap_or_else(|_| "{}".to_string()))
+                                    .unwrap_or_else(|_| "{}".to_string())
+                            })
+                        };
+                        let mut response_builder =
+                            Response::builder().status(StatusCode::from_u16(status as u16).unwrap_or(StatusCode::OK));
+                        response_builder = response_builder.header("content-type", "application/json");
+                        let response = response_builder
+                            .body(Body::from(body_str))
+                            .map_err(|e| format!("Failed to build response: {}", e))?;
+                        Ok(HookResult::Continue(response))
+                    } else {
+                        Err(format!("Hook must return a Hash, got {}", unsafe {
+                            result.classname()
+                        }))
+                    }
+                });
+            result.map_err(|e| format!("Hook '{}' task error: {}", name_for_error, e))
+        })
+    }
+}
+unsafe impl Send for RubyLifecycleHook {}
+unsafe impl Sync for RubyLifecycleHook {}

data/vendor/crates/spikard-rb/src/metadata/mod.rs ADDED Viewed

@@ -0,0 +1,5 @@
+//! Route metadata extraction and building from Ruby definitions.
+pub mod route_extraction;
+pub use route_extraction::{build_route_metadata, json_to_ruby, ruby_value_to_json};