Struct ServeConfig 

pub struct ServeConfig {

    pub s3_uri: Option<String>,
    pub host: String,
    pub port: u16,
    pub s3_bucket: Option<String>,
    pub s3_endpoint: Option<String>,
    pub s3_region: String,
    pub auth_secret: Option<String>,
    pub auth_enabled: bool,
    pub cache_slides: usize,
    pub cache_blocks: usize,
    pub cache_tiles: usize,
    pub block_size: usize,
    pub jpeg_quality: u8,
    pub cache_max_age: u32,
    pub cors_origins: Option<Vec<String>>,
    pub verbose: bool,
    pub no_tracing: bool,
}

Configuration for the serve command (tile server).

Fields

s3_uri: Option<String>

S3 bucket URI (e.g., s3://my-bucket) or just the bucket name. Alternative to –s3-bucket flag.

host: String

Host address to bind the server to.

port: u16

Port to listen on.

s3_bucket: Option<String>

S3 bucket name containing the slide files. Can also be provided as a positional argument (s3://bucket).

s3_endpoint: Option<String>

Custom S3 endpoint URL for S3-compatible services (MinIO, etc.).

If not specified, uses the default AWS S3 endpoint.

s3_region: String

AWS region for S3.

auth_secret: Option<String>

Secret key for HMAC-SHA256 signed URL authentication.

Required when authentication is enabled.

auth_enabled: bool

Enable signed URL authentication.

When disabled (default), all tile requests are allowed without authentication. Enable for production deployments.

cache_slides: usize

Maximum number of slides to keep in cache.

cache_blocks: usize

Maximum number of blocks to cache per slide (256KB each).

cache_tiles: usize

Maximum tile cache size in bytes (default: 100MB).

block_size: usize

Block size in bytes for the block cache.

jpeg_quality: u8

Default JPEG quality for tile encoding (1-100).

cache_max_age: u32

HTTP Cache-Control max-age in seconds.

cors_origins: Option<Vec<String>>

Allowed CORS origins (comma-separated).

If not specified, allows any origin.

verbose: bool

Enable verbose logging (debug level).

no_tracing: bool

Disable request tracing.

Implementations

impl ServeConfig

pub fn resolve_bucket(&self) -> Result<String, String>

Resolve the S3 bucket name from either the positional URI or –s3-bucket flag.

pub fn validate(&self) -> Result<(), String>

Validate the configuration and return an error message if invalid.

pub fn bind_address(&self) -> String

Get the server bind address as “host:port”.

pub fn auth_secret_or_empty(&self) -> &str

Get the auth secret, returning empty string if not set.

pub fn bucket(&self) -> String

Get the resolved bucket name, panicking if not set (call validate() first).

Trait Implementations

impl Args for ServeConfig

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl Clone for ServeConfig

fn clone(&self) -> ServeConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServeConfig

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

Formats the value using the given formatter.

impl FromArgMatches for ServeConfig

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.