Struct S3Config 

pub struct S3Config {
    pub gateway_listen: String,
    pub s3_virtual_hosting: bool,
    pub s3_domain: String,
    pub s3_skip_signature_validation: bool,
    pub s3_max_memory_object_size: usize,
    pub default_region: String,
    pub log_level: String,
    pub persistence: bool,
    pub data_dir: String,
}

S3 service configuration.

All fields have sensible defaults matching LocalStack behavior. Configuration can be loaded from environment variables via S3Config::from_env.

Examples

use rustack_s3_core::config::S3Config;

let config = S3Config::default();
assert_eq!(config.gateway_listen, "0.0.0.0:4566");
assert!(config.s3_virtual_hosting);

Fields

gateway_listen: String

Bind address for the gateway (e.g. "0.0.0.0:4566").

s3_virtual_hosting: bool

Whether S3 virtual-hosted-style addressing is enabled.

s3_domain: String

Domain for S3 virtual hosting resolution.

s3_skip_signature_validation: bool

Whether to skip signature validation on incoming requests.

s3_max_memory_object_size: usize

Maximum object size (in bytes) kept entirely in memory before spilling to disk.

default_region: String

Default AWS region for this S3 service instance.

log_level: String

Log level filter string (e.g. "info", "debug").

persistence: bool

Whether persistence (durable storage) is enabled.

data_dir: String

Data directory used when persistence is enabled.

Implementations

impl S3Config

pub fn builder() -> S3ConfigBuilder<((), (), (), (), (), (), (), (), ())>

Create a builder for building S3Config. On the builder, call .gateway_listen(...)(optional), .s3_virtual_hosting(...)(optional), .s3_domain(...)(optional), .s3_skip_signature_validation(...)(optional), .s3_max_memory_object_size(...)(optional), .default_region(...)(optional), .log_level(...)(optional), .persistence(...)(optional), .data_dir(...)(optional) to set the values of the fields. Finally, call .build() to create the instance of S3Config.

impl S3Config

pub fn from_env() -> Self

Load configuration from environment variables.

Reads the following environment variables (falling back to defaults):

Variable	Default
GATEWAY_LISTEN	0.0.0.0:4566
S3_VIRTUAL_HOSTING	true
S3_DOMAIN	s3.localhost.localstack.cloud
S3_SKIP_SIGNATURE_VALIDATION	true
S3_MAX_MEMORY_OBJECT_SIZE	524288
DEFAULT_REGION	us-east-1
LOG_LEVEL	info
PERSISTENCE	false
DATA_DIR	/var/lib/localstack

Examples

use rustack_s3_core::config::S3Config;

let config = S3Config::from_env();
assert!(!config.gateway_listen.is_empty());

Trait Implementations

impl Clone for S3Config

fn clone(&self) -> S3Config

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for S3Config

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

Formats the value using the given formatter.

impl Default for S3Config

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for S3Config

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for S3Config

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

where __S: Serializer,

Serialize this value into the given Serde serializer.