Struct DebugInfo 

pub struct DebugInfo {
    pub source_file: Option<String>,
    pub source_line: Option<u32>,
    pub function_name: Option<String>,
    pub route_pattern: Option<String>,
    pub handler_name: Option<String>,
    pub extra: HashMap<String, String>,
}

Debug information to include in error responses when debug mode is enabled.

This struct holds diagnostic information that helps developers understand where and why an error occurred. This information should NEVER be included in production responses as it can leak sensitive implementation details.

Fields

• source_file: The file where the error originated
• source_line: The line number in the source file
• function_name: The function or handler that generated the error
• route_pattern: The matched route pattern (e.g., “/users/{id}”)
• handler_name: The name of the handler function
• extra: Additional key-value debug information

Example

use fastapi_core::error::DebugInfo;

let debug = DebugInfo::new()
    .with_source_location("src/handlers/user.rs", 42, "get_user")
    .with_route_pattern("/users/{id}")
    .with_extra("user_id_received", "abc123");

Fields

source_file: Option<String>

Source file path.

source_line: Option<u32>

Source line number.

function_name: Option<String>

Function or handler name.

route_pattern: Option<String>

Matched route pattern.

handler_name: Option<String>

Handler name (may differ from function_name for wrapped handlers).

extra: HashMap<String, String>

Additional debug context.

Implementations

impl DebugInfo

pub fn new() -> Self

Create empty debug info.

pub fn with_source_location( self, file: impl Into<String>, line: u32, function: impl Into<String>, ) -> Self

Set the source location.

pub fn with_route_pattern(self, pattern: impl Into<String>) -> Self

Set the route pattern.

pub fn with_handler_name(self, name: impl Into<String>) -> Self

Set the handler name.

pub fn with_extra( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

Add extra debug information.

pub fn is_empty(&self) -> bool

Check if this debug info is empty (has no data).

Trait Implementations

impl Clone for DebugInfo

fn clone(&self) -> DebugInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DebugInfo

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

Formats the value using the given formatter.

impl Default for DebugInfo

fn default() -> DebugInfo

Returns the “default value” for a type.

impl Serialize for DebugInfo

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.