RUEST

Rust + NestJS — NestJS DX, performance Rust, simplicité Axum.

Framework backend Rust inspiré de NestJS et Spring Boot — voir BRD&PRD.md.

Capacités HTTP (Axum)

Toutes les features Axum 0.7 sont activées : HTTP/1, HTTP/2, WebSocket, multipart, form, query, MatchedPath, OriginalUri, tracing des extracteurs, etc.

use ruest::prelude::*;
// Json, Form, Query, Path, AppResult, Multipart, WebSocketUpgrade, …

Piliers du framework

cargo test -p ruest --test principles   # smoke des piliers

Phase 1 (MVP) ✅

Modules, DI, controllers, routing compile-time, validation, config, logger, CLI ruest, AppResult, exemples basic-api et shop-api.

Installation (crates.io)

Après publication sur crates.io :

cargo add ruest-framework    # framework (import : use ruest::prelude::*;)
cargo add ruest-db           # base de données (schema.ruest, migrations, SQLx)
cargo install ruest-cli      # commande `ruest` (new, g, start, db, …)

Le nom ruest sur crates.io est déjà utilisé par un autre projet ; le framework est publié sous ruest-framework (même API ruest:: dans le code).

Guide de publication pour les mainteneurs : docs/PUBLISHING.md.

Démarrage (monorepo)

cargo build
cargo run -p basic-api    # port 3000 — users + products
cargo run -p shop-api     # port 3001 — customers + orders (structure README)

Exemple (aligné sur basic-api)

use ruest::prelude::*;

#[service]
pub struct UserService { /* … */ }

impl Default for UserService { /* … */ }

#[controller("/users")]
pub struct UserController {
    service: Inject<UserService>,
}

#[routes]
impl UserController {
    #[get("/")]
    async fn get_users(&self) -> AppResult<Json<Vec<User>>> {
        Ok(Json(self.service.find_all().await))
    }

    #[post("/")]
    async fn create_user(&self) -> AppResult<Json<User>> {
        // …
        Ok(Json(user))
    }
}

#[module(controllers = [UserController], providers = [UserService])]
pub struct UsersModule;

// Module racine (shop-api, basic-api) — pas besoin de relister controllers/services :
#[module(imports = [UsersModule, ProductsModule])]
pub struct AppModule;

#[tokio::main]
async fn main() -> Result<(), CoreError> {
    ruest::logger::init();
    ruest::bootstrap_app(AppModule)?
        .port(3000)
        .listen()
        .await
}

Erreurs métier dans les handlers :

return Err(ruest_err!(Conflict, "Email already exists"));

Sécurité JWT

bootstrap_app(AppModule)?
    .with_jwt_auth(SecurityConfig::dev())?  // ou SecurityConfig::from_env()?
    .port(3000)
    .listen()
    .await?;

Voir docs/SECURITY.md — guards #[guard(roles = ["admin"])], extracteur AuthUser, routes publiques /auth/login, etc.

Structure du framework

ruest/               # crate unique `ruest` (modules internes : core, di, http, …)
├── src/core, di, http, security, …
├── macros/          # ruest-macros (proc-macros, dépendance du crate ruest)
└── cli/             # ruest-cli → binaire `ruest`

ruest-db/            # RuestDB — `cargo add ruest-db`

Sur crates.io : ruest + ruest-macros (transitif) + ruest-db (optionnel) + ruest-cli (install).

## Structure d’une app (générée par `ruest new`)

```text
src/
├── main.rs
├── config/
├── common/
└── modules/
    └── users/
        ├── dto/
        ├── entities/
        ├── users.controller.rs
        ├── users.service.rs
        ├── users.repository.rs
        └── users.module.rs

CLI ruest

cargo install --path ruest/cli   # binaire `ruest`
ruest new my-api
ruest g resource users
ruest start --watch
ruest doctor

Roadmap

Licence

MIT