Struct CommonArgs 

pub struct CommonArgs {
    pub port: Option<Port>,
    pub host: Option<String>,
    pub routing_mode: RoutingMode,
    pub config: ConfigPath,
    pub threads: Option<ThreadCount>,
}

Common command-line arguments for NNTP proxy binaries

Use #[command(flatten)] in binary-specific Args to include these fields.

Fields

port: Option<Port>

Port to listen on (overrides config file)

host: Option<String>

Host to bind to (overrides config file)

routing_mode: RoutingMode

Routing mode: stateful, per-command, or hybrid

• stateful: 1:1 mode, each client gets a dedicated backend connection
• per-command: Each command can use a different backend (stateless only)
• hybrid: Starts in per-command mode, auto-switches to stateful on first stateful command

config: ConfigPath

Configuration file path

threads: Option<ThreadCount>

Number of worker threads (default: 1, use 0 for CPU cores)

Implementations

impl CommonArgs

pub fn listen_addr(&self, config_port: Option<Port>) -> String

Get formatted listen address

Arguments

• config_port - Port from config file (if any)

Returns

Formatted listen address (e.g., “0.0.0.0:8119”)

pub fn effective_port(&self, config_port: Option<Port>) -> Option<Port>

Get effective port (from args or config)

pub fn effective_host(&self) -> &str

Get effective host

Trait Implementations

impl Args for CommonArgs

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 CommonArgs

fn clone(&self) -> CommonArgs

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl CommandFactory for CommonArgs

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 CommonArgs

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

Formats the value using the given formatter.

impl FromArgMatches for CommonArgs

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 CommonArgs

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.