Struct CancellationTest 

pub struct CancellationTest<H> { /* private fields */ }

Helper for testing handler cancellation behavior.

Example

use fastapi_core::testing::CancellationTest;

let test = CancellationTest::new(my_handler);

// Test that handler respects cancellation
let result = test.cancel_after_polls(3);
assert!(result.gracefully_cancelled());

Implementations

impl<H: Handler + 'static> CancellationTest<H>

pub fn new(handler: H) -> Self

Creates a new cancellation test for the given handler.

pub fn with_seed(self, seed: u64) -> Self

Sets the seed for deterministic testing.

pub fn test_respects_cancellation(&self) -> CancellationTestResult

Tests that the handler respects cancellation via checkpoint.

This sets the cancellation flag before calling the handler, then verifies that the handler detects it at a checkpoint and returns an appropriate error response.

pub fn complete_normally(&self) -> CancellationTestResult

Tests that the handler completes normally without cancellation.

pub fn test_with_cancel_callback<F>( &self, path: &str, cancel_fn: F, ) -> CancellationTestResult

where F: FnMut(&RequestContext) -> bool,

Tests handler behavior with a custom cancellation callback.

The callback is called with the context and can decide when to trigger cancellation based on custom logic.