mytheclipse/README.md

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), and observability (metrics, panic tracking).	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.	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.