asepharyana
8106f8943e
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.
64 lines
2.6 KiB
Markdown
64 lines
2.6 KiB
Markdown
# Implementation Spec: New Features for mytheclipse
|
|
|
|
## Status: COMPLETE
|
|
|
|
## Summary
|
|
|
|
Added 4 new crates and enhancements to existing crates to expand mytheclipse's
|
|
abstraction layer coverage. All code compiles with `cargo build --workspace --all-features`,
|
|
all tests pass, and clippy is clean.
|
|
|
|
## New Crates
|
|
|
|
1. **mytheclipse-queue** (`crates/mytheclipse-queue/`)
|
|
- `Queue` trait: enqueue, dequeue, ack, nack, dlq_move, len
|
|
- `Job` / `JobId` types with payload + metadata
|
|
- `WorkerPool` with configurable concurrency, retry/backoff, dead-letter queue
|
|
- `JobHandler` trait for processing jobs
|
|
- Backend: in-memory (default), Redis (feature `redis`), NATS (feature `nats`), PostgreSQL (feature `postgres`)
|
|
|
|
2. **mytheclipse-tracing** (`crates/mytheclipse-tracing/`)
|
|
- `TracingLayer` with env-filter support and subscriber builder
|
|
- `OtelLayer` for OTLP/Jaeger export (feature `otel`, `jaeger`, `full`)
|
|
- Features: `env` (default), `otel`, `jaeger`, `full`
|
|
|
|
3. **mytheclipse-http** (`crates/mytheclipse-http/`)
|
|
- `HttpClient` wrapping reqwest with timeout + tracing instrumentation
|
|
- `HttpServer` (axum) with health endpoint + graceful shutdown
|
|
- Features: `client` (default), `server-axum`, `server-hyper`
|
|
|
|
4. **mytheclipse-cli** (`crates/mytheclipse-cli/`)
|
|
- `CliApp` / `CliBuilder` with clap derive
|
|
- Subcommands: `serve`, `worker`, `migrate`, `health`, `version`
|
|
- Feature: `clap-derive` (default)
|
|
|
|
## Enhancements to Existing Crates
|
|
|
|
### mytheclipse (core)
|
|
- `pool.rs`: `SemaphorePool<T>` with `Pool` trait, `Pooled<T>` RAII permit
|
|
- `health.rs`: `HealthRegistry`, `HealthCheck` trait, `HealthStatus` enum
|
|
- `leader.rs`: `LeaderElection` trait, `InProcLeaderElection` impl
|
|
- Features: gated under `traffic` (pool) and `lifecycle` (health, leader)
|
|
|
|
### mytheclipse-cache
|
|
- `auto_refresh.rs`: `AutoRefreshCache` — background refresh on cache miss
|
|
- `metrics.rs`: `CacheMetrics` + `CacheSnapshot` with hit/miss/eviction tracking
|
|
- Added `tokio` optional dep (used by cache-aside + auto-refresh)
|
|
|
|
### mytheclipse-config
|
|
- `schema.rs`: `ConfigSchema` + `PropertySchema` for JSON Schema generation
|
|
- Feature `schema` gated
|
|
|
|
### mytheclipse-storage
|
|
- `multipart.rs`: `MultipartUploadDriver` trait + `MultipartUpload` handler
|
|
- Feature `multipart` (default) gated
|
|
|
|
### mytheclipse-crypto
|
|
- `paseto.rs`: `PasetoSigner` + `PasetoClaims` for PASETO v4.local tokens
|
|
- Features `paseto` and `rate-limit` added
|
|
|
|
## Verification
|
|
- `cargo build --workspace --all-features` ✓
|
|
- `cargo test --workspace --all-features` ✓ (all pass, 1 ignored doctest)
|
|
- `cargo clippy --workspace --all-features` ✓ (no warnings)
|