Neocrates

A comprehensive Rust utility library providing modular access to web development, AWS integrations, database operations, Redis caching, cryptography, authentication, and more. Neocrates acts as a facade crate that re-exports functionality from well-maintained ecosystem crates — gated behind feature flags so you only pay for what you use.

中文文档: README.zh-CN.md

✨ Features

MSRV: Rust 1.84+ (edition 2024)

📦 Installation

[dependencies]
# All features — great for getting started
neocrates = { version = "0.1", features = ["full"] }

# Selective — recommended for production (smaller binaries)
neocrates = { version = "0.1", default-features = false, features = ["web", "redis", "logger"] }

🚀 Quick Start

Logger

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    #[cfg(feature = "logger")]
    neocrates::logger::run().await;

    neocrates::tracing::info!("neocrates ready");
    Ok(())
}

S3 Client

#[cfg(feature = "awss3")]
{
    use neocrates::awss3::aws::AwsClient;

    let s3 = AwsClient::new(
        "my-bucket", "us-east-1",
        "https://s3.amazonaws.com",
        &std::env::var("AWS_ACCESS_KEY_ID")?,
        &std::env::var("AWS_SECRET_ACCESS_KEY")?,
    ).await?;

    s3.put_object("uploads/hello.txt", b"Hello, World!".to_vec()).await?;
}

Aliyun / Tencent STS

#[cfg(feature = "awssts")]
{
    use neocrates::awssts::aliyun::StsClient;

    let sts = StsClient::new(
        &std::env::var("ALI_AK")?,
        &std::env::var("ALI_SK")?,
        "acs:ram::123456789012:role/OSSRole",
        "session-name",
    );
    let creds = sts.assume_role(3600).await?;
    println!("Temporary AK: {}", creds.credentials.access_key_id);
}

Redis Cache

#[cfg(feature = "redis")]
{
    use neocrates::rediscache::RedisPool;

    let pool = RedisPool::from_env().await?;         // reads REDIS_URL
    let mut conn = pool.get_connection().await?;

    neocrates::redis::cmd("SET").arg("key").arg("val").query_async(&mut *conn).await?;
    let v: String = neocrates::redis::cmd("GET").arg("key").query_async(&mut *conn).await?;
    println!("{v}");
}

Diesel (PostgreSQL)

#[cfg(feature = "diesel")]
{
    use neocrates::dieselhelper;

    let pool = dieselhelper::create_pool(&std::env::var("DATABASE_URL")?).await?;
    dieselhelper::with_connection(&pool, |conn| {
        // diesel operations …
        Ok::<(), neocrates::diesel::result::Error>(())
    }).await?;
}

Axum Web App

#[cfg(feature = "web")]
{
    use neocrates::axum::{routing::get, Router};

    let app = Router::new()
        .route("/health", get(|| async { "OK" }));

    let listener = tokio::net::TcpListener::bind("0.0.0.0:3000").await?;
    neocrates::axum::serve(listener, app).await?;
}

⚙️ Environment Variables

🛠️ Development

make build          # cargo build
make build-full     # cargo build --features full
make test           # cargo test
make test-full      # cargo test --features full
make lint           # cargo clippy -D warnings
make fmt            # cargo fmt
make doc            # cargo doc --open
make audit          # cargo audit (requires cargo-audit)
make dry-run        # test publish
make publish m="release: v0.1.x"

Run make help to see all available targets.

🤝 Contributing

1. New functionality should be behind a feature flag.
2. Add tests for new features (#[tokio::test] for async).
3. Run make lint and make fmt before opening a PR.
4. Update this README and AGENTS.md when adding modules.

git clone https://github.com/ooiai/neocrates.git
cd neocrates
make build-full && make test-full

🛡️ Security

• Never hardcode credentials — use environment variables or a secrets manager.
• Always validate and sanitize user input before processing.
• Use Argon2 (via the crypto feature) for password hashing; never MD5 or SHA-1.
• Report security vulnerabilities directly to the maintainers.

📚 Resources

• API Docs: docs.rs/neocrates
• crates.io: crates.io/crates/neocrates
• Source: github.com/ooiai/neocrates
• Usage Examples: USAGE_EXAMPLES.md

📄 License

MIT License — Copyright © 2026 ooiai

See LICENSE for the full text.