Struct CreateProxyConfig 

pub struct CreateProxyConfig {
    pub proxy_url: String,
    pub include_paths: Vec<String>,
    pub exclude_paths: Vec<String>,
    pub cache_key_fn: Arc<dyn Fn(&RequestInfo<'_>) -> String + Send + Sync>,
}

Configuration for creating a proxy

Fields

proxy_url: String

The backend URL to proxy requests to

include_paths: Vec<String>

Paths to include in caching (empty means include all) Supports wildcards and method prefixes: “/api/”, “POST /api/”, “GET /*/users”, etc.

exclude_paths: Vec<String>

Paths to exclude from caching (empty means exclude none) Supports wildcards and method prefixes: “/admin/*”, “POST ”, “PUT /api/”, etc. Exclude overrides include

cache_key_fn: Arc<dyn Fn(&RequestInfo<'_>) -> String + Send + Sync>

Custom cache key generator Takes request info and returns a cache key Default: method + path + query string

Implementations

impl CreateProxyConfig

pub fn new(proxy_url: String) -> Self

Create a new config with default settings

Examples found in repository

examples/library_usage.rs (line 11)

async fn main() {
    // Initialize tracing (optional but recommended)
    // tracing_subscriber::fmt::init();

    // Create proxy configuration
    // You can specify method prefixes to filter by HTTP method
    let proxy_config = CreateProxyConfig::new("http://localhost:8080".to_string())
        .with_include_paths(vec![
            "/api/*".to_string(),
            "/public/*".to_string(),
            "GET /admin/stats".to_string(), // Only cache GET requests to this endpoint
        ])
        .with_exclude_paths(vec![
            "/api/admin/*".to_string(),
            "POST *".to_string(),  // Don't cache any POST requests
            "PUT *".to_string(),   // Don't cache any PUT requests
            "DELETE *".to_string(), // Don't cache any DELETE requests
        ]);

    // Create proxy - proxy_url is the backend server to proxy requests to
    let (proxy_app, refresh_trigger): (Router, RefreshTrigger) = create_proxy(proxy_config);

    // You can clone and use the refresh_trigger in your code
    let trigger_clone = refresh_trigger.clone();

    // Example: Trigger cache refresh from another part of your application
    tokio::spawn(async move {
        tokio::time::sleep(tokio::time::Duration::from_secs(60)).await;
        
        // Clear all cache entries
        trigger_clone.trigger();
        println!("All cache cleared!");
        
        tokio::time::sleep(tokio::time::Duration::from_secs(30)).await;
        
        // Clear only cache entries matching a pattern (supports wildcards)
        trigger_clone.trigger_by_key_match("GET:/api/*");
        println!("Cache cleared for GET:/api/* pattern!");
    });

    // Start the proxy server
    let listener = tokio::net::TcpListener::bind("0.0.0.0:3000").await.unwrap();

    println!("Proxy server listening on http://0.0.0.0:3000");
    println!("Caching paths: /api/*, /public/*, GET /admin/stats");
    println!("Excluding: /api/admin/*, POST *, PUT *, DELETE *");
    println!("Note: Only GET requests will be cached (POST/PUT/DELETE are excluded)");

    axum::serve(listener, proxy_app).await.unwrap();
}

pub fn with_include_paths(self, paths: Vec<String>) -> Self

Set include paths

Examples found in repository

examples/library_usage.rs (lines 12-16)

async fn main() {
    // Initialize tracing (optional but recommended)
    // tracing_subscriber::fmt::init();

    // Create proxy configuration
    // You can specify method prefixes to filter by HTTP method
    let proxy_config = CreateProxyConfig::new("http://localhost:8080".to_string())
        .with_include_paths(vec![
            "/api/*".to_string(),
            "/public/*".to_string(),
            "GET /admin/stats".to_string(), // Only cache GET requests to this endpoint
        ])
        .with_exclude_paths(vec![
            "/api/admin/*".to_string(),
            "POST *".to_string(),  // Don't cache any POST requests
            "PUT *".to_string(),   // Don't cache any PUT requests
            "DELETE *".to_string(), // Don't cache any DELETE requests
        ]);

    // Create proxy - proxy_url is the backend server to proxy requests to
    let (proxy_app, refresh_trigger): (Router, RefreshTrigger) = create_proxy(proxy_config);

    // You can clone and use the refresh_trigger in your code
    let trigger_clone = refresh_trigger.clone();

    // Example: Trigger cache refresh from another part of your application
    tokio::spawn(async move {
        tokio::time::sleep(tokio::time::Duration::from_secs(60)).await;
        
        // Clear all cache entries
        trigger_clone.trigger();
        println!("All cache cleared!");
        
        tokio::time::sleep(tokio::time::Duration::from_secs(30)).await;
        
        // Clear only cache entries matching a pattern (supports wildcards)
        trigger_clone.trigger_by_key_match("GET:/api/*");
        println!("Cache cleared for GET:/api/* pattern!");
    });

    // Start the proxy server
    let listener = tokio::net::TcpListener::bind("0.0.0.0:3000").await.unwrap();

    println!("Proxy server listening on http://0.0.0.0:3000");
    println!("Caching paths: /api/*, /public/*, GET /admin/stats");
    println!("Excluding: /api/admin/*, POST *, PUT *, DELETE *");
    println!("Note: Only GET requests will be cached (POST/PUT/DELETE are excluded)");

    axum::serve(listener, proxy_app).await.unwrap();
}

pub fn with_exclude_paths(self, paths: Vec<String>) -> Self

Set exclude paths

Examples found in repository

examples/library_usage.rs (lines 17-22)

async fn main() {
    // Initialize tracing (optional but recommended)
    // tracing_subscriber::fmt::init();

    // Create proxy configuration
    // You can specify method prefixes to filter by HTTP method
    let proxy_config = CreateProxyConfig::new("http://localhost:8080".to_string())
        .with_include_paths(vec![
            "/api/*".to_string(),
            "/public/*".to_string(),
            "GET /admin/stats".to_string(), // Only cache GET requests to this endpoint
        ])
        .with_exclude_paths(vec![
            "/api/admin/*".to_string(),
            "POST *".to_string(),  // Don't cache any POST requests
            "PUT *".to_string(),   // Don't cache any PUT requests
            "DELETE *".to_string(), // Don't cache any DELETE requests
        ]);

    // Create proxy - proxy_url is the backend server to proxy requests to
    let (proxy_app, refresh_trigger): (Router, RefreshTrigger) = create_proxy(proxy_config);

    // You can clone and use the refresh_trigger in your code
    let trigger_clone = refresh_trigger.clone();

    // Example: Trigger cache refresh from another part of your application
    tokio::spawn(async move {
        tokio::time::sleep(tokio::time::Duration::from_secs(60)).await;
        
        // Clear all cache entries
        trigger_clone.trigger();
        println!("All cache cleared!");
        
        tokio::time::sleep(tokio::time::Duration::from_secs(30)).await;
        
        // Clear only cache entries matching a pattern (supports wildcards)
        trigger_clone.trigger_by_key_match("GET:/api/*");
        println!("Cache cleared for GET:/api/* pattern!");
    });

    // Start the proxy server
    let listener = tokio::net::TcpListener::bind("0.0.0.0:3000").await.unwrap();

    println!("Proxy server listening on http://0.0.0.0:3000");
    println!("Caching paths: /api/*, /public/*, GET /admin/stats");
    println!("Excluding: /api/admin/*, POST *, PUT *, DELETE *");
    println!("Note: Only GET requests will be cached (POST/PUT/DELETE are excluded)");

    axum::serve(listener, proxy_app).await.unwrap();
}

pub fn with_cache_key_fn<F>(self, f: F) -> Self

where F: Fn(&RequestInfo<'_>) -> String + Send + Sync + 'static,

Set custom cache key function

Trait Implementations

impl Clone for CreateProxyConfig

fn clone(&self) -> CreateProxyConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.