Struct Context 

pub struct Context { /* private fields */ }

Protocol-agnostic request context.

Provides unified access to protocol-specific metadata like headers, user info, and trace IDs.

Automatic Injection

When using protocol macros (#[http], #[ws], etc.), methods can receive a Context parameter that is automatically populated with request metadata:

use server_less::{http, Context};

#[http]
impl UserService {
    async fn create_user(&self, ctx: Context, name: String) -> Result<User> {
        // Access request metadata
        let user_id = ctx.user_id()?;        // Authenticated user
        let request_id = ctx.request_id()?;  // Request trace ID
        let auth = ctx.authorization();      // Authorization header

        // Create user with context...
    }
}

Protocol-Specific Metadata

Different protocols populate Context with relevant data:

• HTTP: All headers via header(), request ID from x-request-id
• gRPC: Metadata fields (not yet implemented)
• CLI: Environment variables via env() (not yet implemented)
• MCP: Conversation context (not yet implemented)

Name Collision

If you have your own Context type, qualify the server-less version:

fn handler(&self, ctx: server_less::Context) { }

See the #[http] macro documentation for details on collision handling.

Implementations

impl Context

pub fn new() -> Context

Create a new empty context

pub fn with_metadata(metadata: HashMap<String, String>) -> Context

Create context with metadata

pub fn get(&self, key: &str) -> Option<&str>

Get a metadata value

pub fn set(&mut self, key: impl Into<String>, value: impl Into<String>)

Set a metadata value

pub fn user_id(&self) -> Option<&str>

Get the authenticated user ID

pub fn set_user_id(&mut self, user_id: impl Into<String>)

Set the authenticated user ID

pub fn request_id(&self) -> Option<&str>

Get the request ID

pub fn set_request_id(&mut self, request_id: impl Into<String>)

Set the request ID

pub fn metadata(&self) -> &HashMap<String, String>

Get all metadata

pub fn header(&self, name: &str) -> Option<&str>

Get an HTTP header value (case-insensitive lookup)

pub fn authorization(&self) -> Option<&str>

Get the Authorization header

pub fn content_type(&self) -> Option<&str>

Get the Content-Type header

pub fn env(&self, name: &str) -> Option<&str>

Get an environment variable

Trait Implementations

impl Clone for Context

fn clone(&self) -> Context

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Context

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for Context

fn default() -> Context

Returns the “default value” for a type.