Struct App 

pub struct App { /* private fields */ }

Builder principal do framework.

Acumula rotas, services de DI, configuração de OpenAPI e middleware (interceptors). Use run_http para servir local, ou a trait AppRuntime (do crate serverust-lambda) para o método .run() que detecta automaticamente entre Lambda e HTTP local.

Exemplo

use std::sync::Arc;
use serverust_core::App;
use serverust_macros::{get, injectable};

#[injectable]
struct Greeter;

impl Greeter {
    fn hi(&self) -> String { "hello".into() }
}

#[get("/")]
async fn root(
    axum::extract::State(g): axum::extract::State<Arc<Greeter>>,
) -> String {
    g.hi()
}

#[tokio::main]
async fn main() -> std::io::Result<()> {
    App::new()
        .openapi_info("My API", "0.1.0")
        .provide::<Greeter>(Arc::new(Greeter))
        .route(root)
        .run_http("127.0.0.1:3000")
        .await
}

Rotas de documentação

into_router injeta automaticamente três rotas: /openapi.json (OpenAPI 3.1), /docs (Swagger UI) e /redoc (ReDoc). Customize os paths via docs e redoc.

Implementations

impl App

pub fn new() -> Self

Cria um App vazio com defaults: /openapi.json, /docs, /redoc.

pub fn openapi_info( self, title: impl Into<String>, version: impl Into<String>, ) -> Self

Customiza title e version do documento OpenAPI gerado.

pub fn register_schema<T: ToSchema + PartialSchema>(self) -> Self

Registra um schema T: ToSchema em components.schemas do OpenAPI.

pub fn docs(self, path: &'static str) -> Self

Customiza o path em que o Swagger UI é servido (default /docs).

pub fn redoc(self, path: &'static str) -> Self

Customiza o path em que o ReDoc é servido (default /redoc).

pub fn provide<T: ?Sized + Send + Sync + 'static>(self, value: Arc<T>) -> Self

Registra um service com lifetime Singleton no container.

T pode ser dyn Trait: app.provide::<dyn MyService>(Arc::new(impl)). Handlers extraem o serviço via State<Arc<dyn MyService>>.

pub fn override<T: ?Sized + Send + Sync + 'static>(self, value: Arc<T>) -> Self

API de teste: substitui o provider de T por uma instância mock. override é palavra reservada — chame como app.r#override::<...>(...).

pub fn interceptor<I: Interceptor>(self, interceptor: I) -> Self

Registra um interceptor (tower middleware) sobre as rotas do usuário.

Aplicado em Self::into_router apenas às rotas registradas via Self::route — as rotas de documentação (/openapi.json, /docs, /redoc) ficam de fora intencionalmente, para que não dependam da pipeline de negócio (ex.: autenticação, rate limiting).

pub fn config(self, cfg: ServerustConfig) -> Self

Injeta uma ServerustConfig tipada no container. Handlers podem extraí-la via State<Arc<ServerustConfig>>.

pub fn route<R: IntoRoute>(self, handler: R) -> Self

Registra um handler anotado por #[get], #[post], etc.

pub fn into_router(self) -> Router

Constrói o axum::Router final adicionando /openapi.json, /docs e /redoc.

pub async fn run_http<A: ToSocketAddrs>(self, addr: A) -> Result<()>

Sobe um servidor HTTP local ligado em addr (ex.: "127.0.0.1:3000").

Imprime no stderr o endereço efetivo + URLs de documentação assim que o listener fica pronto, para o desenvolvedor saber onde conectar:

  🦀 serverust on http://0.0.0.0:3000
     docs:    http://0.0.0.0:3000/docs
     openapi: http://0.0.0.0:3000/openapi.json

Trait Implementations

impl Default for App

fn default() -> Self

Returns the “default value” for a type.