feat: add 4 new crates (queue, tracing, http, cli) + enhancements to existing crates

New crates: - mytheclipse-queue: unified job queue with WorkerPool, retry/backoff, DLQ Backends: in-memory (default), Redis, NATS, PostgreSQL - mytheclipse-tracing: tracing subscriber layers with env filter + OTLP/Jaeger export - mytheclipse-http: HTTP client/server with timeout + tracing, axum server - mytheclipse-cli: CLI framework with clap derive, built-in subcommands Enhancements to existing crates: - mytheclipse-core: SemaphorePool, LeaderElection, HealthRegistry/HealthCheck - mytheclipse-cache: AutoRefreshCache (bg refresh on miss), CacheMetrics - mytheclipse-config: ConfigSchema for JSON Schema generation - mytheclipse-storage: MultipartUploadDriver trait - mytheclipse-crypto: PASETO v4.local token support All features compile with --all-features; tests + clippy pass clean.
2026-08-29 16:05:02 +07:00
parent 2596b357ec
commit 8106f8943e
53 changed files with 3588 additions and 44 deletions
@@ -40,6 +40,9 @@ pub mod loader;
 #[cfg(feature = "hot-reload")]
 pub mod dynamic;

+#[cfg(feature = "schema")]
+pub mod schema;
+
 pub use error::ConfigError;
 pub use loader::ConfigLoader;

@@ -0,0 +1,107 @@
+//! JSON Schema generation for config types (feature `schema`).
+//!
+//! Generate JSON Schema from your config struct — useful for:
+//! - Runtime validation
+//! - Documentation / auto-generated config UIs
+//! - Editor autocomplete via schema-store.json
+//!
+//! ```ignore
+//! use serde::Deserialize;
+//! use mytheclipse_config::schema::ConfigSchema;
+//!
+//! #[derive(Debug, Deserialize, Default)]
+//! struct AppConfig {
+//!     port: u16,
+//! }
+//!
+//! let schema = ConfigSchema::generate::<AppConfig>();
+//! println!("schema type: {}", schema.r#type);
+//! ```
+
+use serde_json::Value;
+use std::collections::BTreeMap;
+
+/// A minimal JSON Schema for documentation and validation.
+#[derive(Debug, Clone)]
+pub struct ConfigSchema {
+    pub r#type: String,
+    pub properties: BTreeMap<String, PropertySchema>,
+    pub required: Vec<String>,
+}
+
+#[derive(Debug, Clone)]
+pub struct PropertySchema {
+    pub r#type: String,
+    pub description: Option<String>,
+    pub default: Option<Value>,
+    pub properties: Option<BTreeMap<String, PropertySchema>>,
+    pub required: Option<Vec<String>>,
+}
+
+impl ConfigSchema {
+    /// Generates a schema for the given type (requires serde derive support).
+    pub fn generate<T: serde::Serialize + Default>() -> ConfigSchema {
+        let value = serde_json::to_value(T::default()).unwrap_or(Value::Null);
+        let mut properties = BTreeMap::new();
+        let mut required = Vec::new();
+
+        if let Value::Object(map) = &value {
+            for (k, v) in map {
+                properties.insert(
+                    k.clone(),
+                    PropertySchema {
+                        r#type: value_type_name(v),
+                        description: None,
+                        default: Some(v.clone()),
+                        properties: None,
+                        required: None,
+                    },
+                );
+                required.push(k.clone());
+            }
+        }
+
+        ConfigSchema {
+            r#type: "object".to_string(),
+            properties,
+            required,
+        }
+    }
+}
+
+fn value_type_name(v: &Value) -> String {
+    match v {
+        Value::Null => "null".to_string(),
+        Value::Bool(_) => "boolean".to_string(),
+        Value::Number(n) => {
+            if n.is_i64() || n.is_u64() {
+                "integer".to_string()
+            } else if n.is_f64() {
+                "number".to_string()
+            } else {
+                "string".to_string()
+            }
+        }
+        Value::String(_) => "string".to_string(),
+        Value::Array(_) => "array".to_string(),
+        Value::Object(_) => "object".to_string(),
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use serde::Serialize;
+
+    #[derive(Serialize, Default)]
+    struct TestConfig {
+        port: u16,
+    }
+
+    #[test]
+    fn generates_schema() {
+        let schema = ConfigSchema::generate::<TestConfig>();
+        assert_eq!(schema.r#type, "object");
+        assert!(schema.properties.contains_key("port"));
+    }
+}