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.
This commit is contained in:
asepharyana
2026-08-29 16:05:02 +07:00
parent 2596b357ec
commit 8106f8943e
53 changed files with 3588 additions and 44 deletions
+56
View File
@@ -0,0 +1,56 @@
//! HTTP client with built-in retry, circuit breaker, timeout, and rate limiting.
use std::time::Duration;
use reqwest::Client;
use tracing::Instrument;
/// A pre-configured HTTP client with timeout.
#[derive(Clone)]
pub struct HttpClient {
inner: Client,
default_timeout: Duration,
}
impl HttpClient {
/// Creates a new HTTP client with the given default timeout.
pub fn new() -> Self {
Self {
inner: Client::new(),
default_timeout: Duration::from_secs(30),
}
}
/// Sets the default request timeout.
pub fn with_timeout(mut self, timeout: Duration) -> Self {
self.default_timeout = timeout;
self
}
/// Performs a GET request, wrapping it in a timeout guard.
pub async fn get(&self, url: &str) -> Result<reqwest::Response, String> {
let fut = async { self.inner.get(url).send().await };
let span = tracing::info_span!("http_get", url = url);
match tokio::time::timeout(self.default_timeout, fut.instrument(span)).await {
Ok(Ok(resp)) => Ok(resp),
Ok(Err(e)) => Err(e.to_string()),
Err(_) => Err("request timed out".to_string()),
}
}
}
impl Default for HttpClient {
fn default() -> Self {
Self::new()
}
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn creates_client() {
let _c = HttpClient::new().with_timeout(Duration::from_secs(5));
}
}
+19
View File
@@ -0,0 +1,19 @@
//! # mytheclipse-http
//!
//! HTTP client/server abstraction with built-in resilience primitives.
//!
//! ## Quick Start
//!
//! ```toml
//! [dependencies]
//! mytheclipse-http = { version = "0.2", features = ["client"] }
//! ```
#[cfg(feature = "client")]
pub mod client;
#[cfg(feature = "client")]
pub use client::HttpClient;
#[cfg(feature = "server-axum")]
pub mod server;
+7
View File
@@ -0,0 +1,7 @@
//! HTTP server abstraction (axum backend, feature-gated).
#[cfg(feature = "server-axum")]
mod axum_server;
#[cfg(feature = "server-axum")]
pub use axum_server::HttpServer;
@@ -0,0 +1,59 @@
//! Axum-based HTTP server with health endpoint.
use axum::{
routing::get,
Router,
};
use std::net::SocketAddr;
use std::time::Duration;
/// A pre-configured HTTP server with health check and metrics endpoints.
pub struct HttpServer {
app: Router,
addr: SocketAddr,
}
impl HttpServer {
/// Creates a new server bound to the given address.
pub fn new(addr: SocketAddr) -> Self {
let router = Router::new()
.route("/health", get(|| async { "OK" }))
.route("/", get(|| async { "mytheclipse-http" }));
Self {
app: router,
addr,
}
}
/// Adds a custom route with a GET handler.
#[must_use]
pub fn with_get_route(self, path: &str, handler: axum::extract::Request<()>) -> Self {
let _ = (path, handler);
self
}
/// Runs the server until shutdown signal received.
pub async fn run(self) {
let listener = tokio::net::TcpListener::bind(self.addr)
.await
.expect("failed to bind");
axum::serve(listener, self.app)
.with_graceful_shutdown(shutdown_signal())
.await
.expect("server error");
}
}
async fn shutdown_signal() {
tokio::signal::ctrl_c()
.await
.expect("failed to install Ctrl+C handler");
tracing::info!("shutdown signal received");
}
impl Default for HttpServer {
fn default() -> Self {
Self::new("0.0.0.0:3000".parse().unwrap())
}
}