Struct ServerCli 

pub struct ServerCli {

    pub config: Option<PathBuf>,
    pub environment: Option<String>,
    pub profile: Option<String>,
    pub env_prefix: Option<String>,
    pub mode: Option<RuntimeMode>,
    pub web_platform: bool,
    pub no_web_platform: bool,
    pub observability: bool,
    pub no_observability: bool,
    pub max_body_bytes: Option<usize>,
    pub request_timeout_ms: Option<u64>,
    pub rate_limit_capacity: Option<usize>,
    pub rate_limit_refill_tokens: Option<usize>,
    pub rate_limit_refill_seconds: Option<u64>,
    pub id_generator: Option<IdGeneratorKind>,
    pub print_startup_plan: bool,
    pub dry_run: bool,
}

First-party CLI bootstrap for Vantus applications.

This layer is intentionally runtime-focused. It controls configuration selection, module toggles, runtime limits, and startup behavior. Cargo build profiles remain a build-time concern:

• use cargo run for debug/dev builds
• use cargo run --release for optimized release builds

Fields

config: Option<PathBuf>

Base configuration file to load instead of auto-discovery.

environment: Option<String>

Overrides the runtime environment name.

profile: Option<String>

Overrides the active profile used for profile-specific config files.

env_prefix: Option<String>

Overrides the environment variable prefix used for config loading.

mode: Option<RuntimeMode>

Applies runtime defaults for development or production behavior.

web_platform: bool

Enables the built-in web platform module.

no_web_platform: bool

Disables the built-in web platform module.

observability: bool

Enables the first-party observability module.

no_observability: bool

Disables the first-party observability module.

max_body_bytes: Option<usize>

Overrides the maximum accepted request body size in bytes.

request_timeout_ms: Option<u64>

Overrides the outer request timeout in milliseconds.

rate_limit_capacity: Option<usize>

Token bucket capacity for the global rate limiter.

rate_limit_refill_tokens: Option<usize>

Number of tokens restored per refill interval.

rate_limit_refill_seconds: Option<u64>

Rate-limiter refill interval in seconds.

id_generator: Option<IdGeneratorKind>

Chooses the shared request-ID generator implementation.

print_startup_plan: bool

Prints the resolved startup plan before booting.

dry_run: bool

Prints the startup plan and exits without starting the server.

Implementations

impl ServerCli

pub fn apply_to_builder( &self, builder: &mut HostBuilder, defaults: CliFeatureDefaults, ) -> Result<(), CliError>

Applies CLI-selected defaults, module toggles, and runtime limits.

pub fn effective_mode(&self) -> RuntimeMode

Returns the resolved runtime mode, defaulting to development.

pub fn id_generator_kind(&self) -> IdGeneratorKind

Returns the resolved ID generator choice, defaulting to UUIDs.

pub fn web_platform_enabled(&self, default: bool) -> bool

Returns whether the built-in web platform module should be installed.

pub fn observability_enabled(&self, default: bool) -> bool

Returns whether the first-party observability module should be installed.

pub fn startup_plan( &self, defaults: CliFeatureDefaults, ) -> Result<String, CliError>

Renders a human-readable startup plan suitable for --dry-run.

Trait Implementations

impl Args for ServerCli

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 ServerCli

fn clone(&self) -> ServerCli

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl CommandFactory for ServerCli

fn command<'b>() -> Command

Build a Command that can instantiate Self.

fn command_for_update<'b>() -> Command

Build a Command that can update self.

impl Debug for ServerCli

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

Formats the value using the given formatter.

impl FromArgMatches for ServerCli

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.

impl Parser for ServerCli

fn parse() -> Self

Parse from std::env::args_os(), exit on error.

fn try_parse() -> Result<Self, Error>

Parse from std::env::args_os(), return Err on error.

fn parse_from<I, T>(itr: I) -> Self

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, exit on error.

fn try_parse_from<I, T>(itr: I) -> Result<Self, Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, return Err on error.

fn update_from<I, T>(&mut self, itr: I)

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, exit on error.

fn try_update_from<I, T>(&mut self, itr: I) -> Result<(), Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.