Struct ServerArgs 

pub struct ServerArgs {

    pub config: Option<String>,
    pub database_url: Option<String>,
    pub bind_addr: Option<SocketAddr>,
    pub schema_path: Option<String>,
    pub metrics_enabled: Option<bool>,
    pub metrics_token: Option<String>,
    pub admin_api_enabled: Option<bool>,
    pub admin_token: Option<String>,
    pub introspection_enabled: Option<bool>,
    pub introspection_require_auth: Option<bool>,
    pub rate_limiting_enabled: Option<bool>,
    pub rate_limit_rps_per_ip: Option<u32>,
    pub rate_limit_rps_per_user: Option<u32>,
    pub rate_limit_burst_size: Option<u32>,
    pub log_format: Option<String>,
}

Server configuration flags shared between fraiseql-server and fraiseql run.

Every flag has a corresponding environment variable (clap’s env attribute). The resolution order is: CLI flag > env var > config file > built-in default.

Fields

config: Option<String>

Path to TOML configuration file.

database_url: Option<String>

Database connection URL.

bind_addr: Option<SocketAddr>

Server bind address (host:port).

schema_path: Option<String>

Path to compiled schema JSON file.

metrics_enabled: Option<bool>

Enable Prometheus metrics endpoint.

metrics_token: Option<String>

Bearer token for metrics endpoint authentication.

admin_api_enabled: Option<bool>

Enable admin API endpoints.

admin_token: Option<String>

Bearer token for admin API authentication.

introspection_enabled: Option<bool>

Enable GraphQL introspection endpoint.

introspection_require_auth: Option<bool>

Require authentication for introspection endpoint.

rate_limiting_enabled: Option<bool>

Enable per-IP and per-user rate limiting.

rate_limit_rps_per_ip: Option<u32>

Rate limit: maximum requests per second per IP.

rate_limit_rps_per_user: Option<u32>

Rate limit: maximum requests per second per authenticated user.

rate_limit_burst_size: Option<u32>

Rate limit: token bucket burst capacity.

log_format: Option<String>

Log output format: json for structured JSON, text for human-readable (default).

Implementations

impl ServerArgs

pub fn from_env() -> Self

Construct a ServerArgs from environment variables only (no CLI parsing).

This is useful for consumers that handle their own CLI args (e.g. fraiseql run) but still want to pick up server-production env vars like FRAISEQL_METRICS_ENABLED without duplicating the parsing logic.

Unset env vars produce None fields — only explicitly set env vars generate overrides.

pub fn apply_to_config(&self, config: &mut ServerConfig)

Apply CLI/env overrides to a ServerConfig loaded from file or defaults.

Fields that were not provided on the command line and not set via environment variables are left untouched in config.

pub fn is_json_log_format(&self) -> bool

Whether the log format is JSON.

Trait Implementations

impl Args for ServerArgs

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 ServerArgs

fn clone(&self) -> ServerArgs

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServerArgs

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

Formats the value using the given formatter.

impl Default for ServerArgs

fn default() -> ServerArgs

Returns the “default value” for a type.

impl FromArgMatches for ServerArgs

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.