Crate caelix_core 

Core primitives for Caelix.

Macros

provider_dependencies

Declares provider dependencies for manual Injectable implementations and factories. Builds the explicit dependency list required by a handwritten Injectable implementation.

Structs

BadGatewayException

Re-exported public API. Public Caelix type BadGatewayException.

BadRequestException

Re-exported public API. Public Caelix type BadRequestException.

Bytes

Re-exported public API. A cheaply cloneable and sliceable chunk of contiguous memory.

Cache

Re-exported public API. Public Caelix type Cache.

CacheModule

Re-exported public API. Public Caelix type CacheModule.

ConflictException

Re-exported public API. Public Caelix type ConflictException.

Container

Re-exported public API. Public Caelix type Container.

ControllerDef

Re-exported public API. Public Caelix type ControllerDef.

Cookie

Framework-owned response cookie primitives. A response cookie with secure defaults.

DefaultThrottleConfig

Request throttling primitives. Default 60 requests per 60 seconds throttle configuration.

EventBus

Re-exported public API. Public Caelix type EventBus.

EventHandlerDef

Re-exported public API. Public Caelix type EventHandlerDef.

EventModule

Re-exported public API. Public Caelix type EventModule.

ExpectationFailedException

Re-exported public API. Public Caelix type ExpectationFailedException.

FailedDependencyException

Re-exported public API. Public Caelix type FailedDependencyException.

ForbiddenException

Re-exported public API. Public Caelix type ForbiddenException.

GatewayDef

Re-exported public API. Public Caelix type GatewayDef.

GatewayTimeoutException

Re-exported public API. Public Caelix type GatewayTimeoutException.

GoneException

Re-exported public API. Public Caelix type GoneException.

HttpException

Re-exported public API. Public Caelix type HttpException.

HttpResponse

Re-exported public API. Public Caelix type HttpResponse.

HttpVersionNotSupportedException

Re-exported public API. Public Caelix type HttpVersionNotSupportedException.

ImATeapotException

Re-exported public API. Public Caelix type ImATeapotException.

InsufficientStorageException

Re-exported public API. Public Caelix type InsufficientStorageException.

InternalServerErrorException

Re-exported public API. Public Caelix type InternalServerErrorException.

IpThrottleTracker

Request throttling primitives. Tracks clients by IP, with explicit trusted-proxy support.

LengthRequiredException

Re-exported public API. Public Caelix type LengthRequiredException.

LockedException

Re-exported public API. Public Caelix type LockedException.

Logger

Re-exported public API. Public Caelix type Logger.

LoopDetectedException

Re-exported public API. Public Caelix type LoopDetectedException.

MemoryCacheOptions

Re-exported public API. Public Caelix type MemoryCacheOptions.

MemoryCacheStore

Re-exported public API. Public Caelix type MemoryCacheStore.

MemoryThrottleStore

Request throttling primitives. A bounded, process-local atomic throttle store.

MessageContext

Re-exported public API. Context made available to a microservice handler.

MessageDelivery

Re-exported public API. Durable transport delivery details attached to an event handler invocation.

MessageHandlerDef

Re-exported public API. One transport-neutral message handler declared by a microservice.

MethodNotAllowedException

Re-exported public API. Public Caelix type MethodNotAllowedException.

MicroserviceDef

Re-exported public API. Metadata for one dependency-injected microservice class.

MisdirectedRequestException

Re-exported public API. Public Caelix type MisdirectedRequestException.

ModuleDef

Re-exported public API. Public Caelix type ModuleDef.

ModuleMetadata

Re-exported public API. Public Caelix type ModuleMetadata.

NetworkAuthenticationRequiredException

Re-exported public API. Public Caelix type NetworkAuthenticationRequiredException.

Next

Re-exported public API. Public Caelix type Next.

NotAcceptableException

Re-exported public API. Public Caelix type NotAcceptableException.

NotExtendedException

Re-exported public API. Public Caelix type NotExtendedException.

NotFoundException

Re-exported public API. Public Caelix type NotFoundException.

NotImplementedException

Re-exported public API. Public Caelix type NotImplementedException.

PayloadTooLargeException

Re-exported public API. Public Caelix type PayloadTooLargeException.

PaymentRequiredException

Re-exported public API. Public Caelix type PaymentRequiredException.

PreconditionFailedException

Re-exported public API. Public Caelix type PreconditionFailedException.

PreconditionRequiredException

Re-exported public API. Public Caelix type PreconditionRequiredException.

ProviderDef

Re-exported public API. Public Caelix type ProviderDef.

ProviderDependency

Re-exported public API. Metadata for one resolved provider dependency. Public Caelix type ProviderDependency.

ProviderOverrides

Re-exported public API. Public Caelix type ProviderOverrides.

ProxyAuthenticationRequiredException

Re-exported public API. Public Caelix type ProxyAuthenticationRequiredException.

RangeNotSatisfiableException

Re-exported public API. Public Caelix type RangeNotSatisfiableException.

RequestContext

Re-exported public API. Public Caelix type RequestContext.

RequestHeaderFieldsTooLargeException

Re-exported public API. Public Caelix type RequestHeaderFieldsTooLargeException.

RequestTimeoutException

Re-exported public API. Public Caelix type RequestTimeoutException.

RouteDef

Re-exported public API. Public Caelix type RouteDef.

ServiceUnavailableException

Re-exported public API. Public Caelix type ServiceUnavailableException.

StatusCode

Re-exported public API. An HTTP status code (status-code in RFC 9110 et al.).

Throttle

Request throttling primitives. The global request-throttling service.

ThrottleModule

Request throttling primitives. Global module enabling throttling for macro-generated controller routes.

ThrottleOptions

Request throttling primitives. Runtime throttling configuration.

ThrottlePolicy

Request throttling primitives. A fixed-window request policy.

ThrottleStoreRecord

Request throttling primitives. The result of an atomic store increment.

TooEarlyException

Re-exported public API. Public Caelix type TooEarlyException.

TooManyRequestsException

Re-exported public API. Public Caelix type TooManyRequestsException.

UnauthorizedException

Re-exported public API. Public Caelix type UnauthorizedException.

UnavailableForLegalReasonsException

Re-exported public API. Public Caelix type UnavailableForLegalReasonsException.

UnprocessableEntityException

Re-exported public API. Public Caelix type UnprocessableEntityException.

UnsupportedMediaTypeException

Re-exported public API. Public Caelix type UnsupportedMediaTypeException.

UpgradeRequiredException

Re-exported public API. Public Caelix type UpgradeRequiredException.

UriTooLongException

Re-exported public API. Public Caelix type UriTooLongException.

VariantAlsoNegotiatesException

Re-exported public API. Public Caelix type VariantAlsoNegotiatesException.

WebSocketCloseFrame

Re-exported public API. Public Caelix type WebSocketCloseFrame.

WebSocketError

Re-exported public API. Public Caelix type WebSocketError.

WebSocketRequest

Re-exported public API. Public Caelix type WebSocketRequest.

WebSocketSession

Re-exported public API. Public Caelix type WebSocketSession.

Enums

Body

Re-exported public API. A body whose shape isn’t known at the Response<T> type level — used by Response::Raw so a handler can return e.g. Response<()> while still sending an arbitrary JSON/text/bytes payload.

LogLevel

Re-exported public API. Public Caelix enumeration LogLevel.

MessageHandlerKind

Re-exported public API. The kind of a message handler.

Response

Re-exported public API. Public Caelix enumeration Response.

ResponseBody

Re-exported public API. Response body: fully buffered, or a live stream of chunks.

SameSite

Framework-owned response cookie primitives. The SameSite attribute applied to a response cookie.

WebSocketCloseCode

Re-exported public API. Public Caelix enumeration WebSocketCloseCode.

Traits

CacheStore

Re-exported public API. Public Caelix extension trait CacheStore.

Controller

Re-exported public API. Public Caelix extension trait Controller.

EventHandler

Re-exported public API. Public Caelix extension trait EventHandler.

Gateway

Re-exported public API. Public Caelix extension trait Gateway.

Guard

Re-exported public API. Public Caelix extension trait Guard.

Injectable

Re-exported public API. Public Caelix extension trait Injectable.

Interceptor

Re-exported public API. Public Caelix extension trait Interceptor.

IntoCaelixResponse

Re-exported public API. Public Caelix extension trait IntoCaelixResponse.

Microservice

Re-exported public API. Implemented by #[microservice] classes.

Module

Re-exported public API. Public Caelix extension trait Module.

RegisterableEventHandler

Re-exported public API. Public Caelix extension trait RegisterableEventHandler.

RegisteredWebSocketGateway

Re-exported public API. Marker implemented by #[gateway] for RFC 6455 gateways. It separates path metadata from the transport callbacks so the same ModuleMetadata::gateway registration API can also support optional transports such as Socket.IO.

StreamExt

Re-exported public API. An extension trait for Streams that provides a variety of convenient combinator functions.

ThrottleConfig

Request throttling primitives. Supplies options for ThrottleModule.

ThrottleStore

Request throttling primitives. Atomic storage used by the throttler.

ThrottleTracker

Request throttling primitives. Derives the client identity used in throttle keys.

WebSocketGateway

Re-exported public API. Public Caelix extension trait WebSocketGateway.

Functions

bootstrap_module

Re-exported public API. Runs the bootstrap_module public API operation.

build_container

Re-exported public API. Runs the build_container public API operation.

build_container_with_overrides

Re-exported public API. Runs the build_container_with_overrides public API operation.

collect_module_message_handlers

Re-exported public API. Collects the transport-neutral handlers declared by a module graph.

collect_module_message_handlers_with_container

Re-exported public API. Collects message handlers while validating dependencies against an existing application container. Transport adapters use this when they register transport-owned values before module construction.

dropped_http_request_logs

Re-exported public API. Returns the number of enabled HTTP access-log entries dropped because the asynchronous writer queue was full.

http_request_logging_enabled

Re-exported public API. Runs the http_request_logging_enabled public API operation.

log

Re-exported public API. Runs the log public API operation.

log_application_starting

Re-exported public API. Runs the log_application_starting public API operation.

log_controller_routes

Re-exported public API. Runs the log_controller_routes public API operation.

log_http_exception

Re-exported public API. Runs the log_http_exception public API operation.

log_http_exception_with_context

Re-exported public API. Logs a server-side HTTP exception with request correlation metadata.

log_http_request

Re-exported public API. Runs the log_http_request public API operation.

log_module_initialized

Re-exported public API. Runs the log_module_initialized public API operation.

log_module_routes

Re-exported public API. Runs the log_module_routes public API operation.

log_provider_initialized

Re-exported public API. Runs the log_provider_initialized public API operation.

log_ready

Re-exported public API. Logs that the server has successfully bound and is ready to accept traffic.

log_route_mapped

Re-exported public API. Runs the log_route_mapped public API operation.

register_module

Re-exported public API. Runs the register_module public API operation.

register_module_controllers

Re-exported public API. Runs the register_module_controllers public API operation.

shutdown_module

Re-exported public API. Runs the shutdown_module public API operation.

validate_module

Re-exported public API. Validates a module’s metadata without constructing providers or starting an application.

validate_module_providers

Re-exported public API. Runs the validate_module_providers public API operation.

visit_module_gateways

Re-exported public API. Runs the visit_module_gateways public API operation.

Type Aliases

BoxBodyStream

Re-exported public API. Async sequence of body chunks. Errors use framework HttpException.

BoxFuture

Re-exported public API. Public Caelix type alias BoxFuture.

Result

Re-exported public API. Public Caelix type alias Result.