asepharyana
1dfc6d6865
Root cause of the failing CI run was that examples/tests referencing feature-gated items were auto-detected (no required-features), so `--all-targets` compiled them under feature combinations where those modules didn't exist. Fixes: - mytheclipse Cargo.toml: declare the `high_level` example and `race_stress` integration test with required-features = ["full"]; `cargo build --all-targets` now skips them when full is off. This clears the whole test-matrix (workspace default, all-features, and every single-feature config) which all failed on E0432/E0433. - lib.rs: auto_metrics_service depends on service_builder, so regate it behind all(observability, resiliency) instead of observability alone (observability-only build compiled the module without resiliency). - mytheclipse-tracing: gate `pub mod fmt` behind any tracing-subscriber-providing feature so --no-default-features compiles. - mytheclipse-queue: gate `pub mod worker` behind in-memory (worker.rs requires tokio, only provided by in-memory). - clippy -D warnings fixes: deprecated base64 0.22 free fns -> Engine (paseto), unused key field, needless mut (service_builder), unused import/dead var/missing is_empty (bg_join), dead is_expired (dlock), while-let-iterator->for (parallel_map), type_complexity (shutdown_guard), MutexGuard held across await (middleware, now clones Arc'd layers), if-let-Err->is_err (queue), unused CliBuilder fields now wired into clap. - rustdoc -D warnings: resolve retry/MetricsBridge/CircuitBreaker/KeyRing intra-doc links and fix the unparseable lifecycle.rs code fence. - cargo fmt --all to satisfy the Rustfmt gate.
mytheclipse
A personal collection of Rust abstractions for building resource-aware, resilient, and well-instrumented applications without hand-rolling the same plumbing every time — organized as a Cargo workspace, one focused crate per concern.
Crates
| Crate | Description | Docs |
|---|---|---|
mytheclipse |
Resource-aware execution primitives (async I/O, compute, background queues), resiliency (retry, circuit breaker, timeout), traffic control (rate limiter, backpressure, concurrency limiter), lifecycle (graceful shutdown, cron, async lifecycle manager, distributed lock), and observability (metrics, panic tracking, metrics-to-health bridge). | README |
mytheclipse-cache |
Unified multi-layer (L1/L2) cache abstraction: in-memory or Moka L1, Redis/Valkey L2, cache-aside read-through. | README |
mytheclipse-storage |
Unified storage & file system abstraction: one driver interface over local disk, S3/MinIO, and Google Cloud Storage, stream-based. | README |
mytheclipse-event |
Unified events & message bus abstraction: in-memory pub/sub dispatcher plus RabbitMQ and NATS broker adapters behind one trait. | README |
mytheclipse-config |
Type-safe, dynamic configuration engine: load .env/YAML/JSON/TOML into typed structs, with hot-reload and typed validation. |
README |
mytheclipse-crypto |
Safe hashing (Argon2id), encryption (AES-256-GCM), JWT and PASETO tokens, with key rotation support. | README |
mytheclipse-queue |
Unified job queue abstraction with WorkerPool executor, retry/backoff, and dead-letter support. Backends: in-memory, Redis, NATS, PostgreSQL. | README |
mytheclipse-tracing |
Pre-built tracing subscriber layers with env filtering and optional OTLP/Jaeger/Zipkin export. | README |
mytheclipse-http |
HTTP client and server abstraction with built-in retry, circuit breaker, timeout, and rate limiting. | README |
mytheclipse-cli |
CLI framework for mytheclipse applications with built-in subcommands (serve, worker, migrate, health, version). | README |
Every crate follows the same philosophy: one small interface, pluggable
backends behind feature flags, and a working default that needs no external
service to build or test. Distributed backends (Redis, S3, GCS, RabbitMQ,
NATS) are feature-gated and their integration tests are #[ignore]d unless
the corresponding environment variables point at a live service.
Getting started
Each crate is published independently; add the ones you need:
[dependencies]
mytheclipse = { version = "1", features = ["full"] }
mytheclipse-cache = "0.1"
mytheclipse-storage = { version = "0.1", features = ["s3"] }
mytheclipse-event = { version = "0.1", features = ["nats"] }
mytheclipse-config = "0.1"
mytheclipse-crypto = "0.1"
See each crate's own README (linked above) for usage examples and the full feature-flag list.
Development
This is a Cargo workspace; run commands from the repository root:
cargo build --workspace --all-features
cargo test --workspace --all-features
cargo clippy --workspace --all-features -- -D warnings
cargo fmt --all --check
Or target a single crate with -p <name>, e.g. cargo test -p mytheclipse-cache.
License
Licensed under either of:
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.