Struct Args 

pub(crate) struct Args {
    pub(crate) transcript: Option<PathBuf>,
    pub(crate) org: String,
    pub(crate) project: String,
    pub(crate) dir: PathBuf,
    pub(crate) port: u16,
    pub(crate) breakdown: bool,
    pub(crate) measure: bool,
    pub(crate) pid: Option<u32>,
    pub(crate) arm: Arm,
    pub(crate) turns: u32,
    pub(crate) asks: u32,
    pub(crate) seconds: f64,
}

Fields

transcript: Option<PathBuf>

A session transcript to serve as the seat’s conversation, read whole.

org: String

The org the fixture declares.

project: String

The project the fixture declares. Its directory is under --dir.

dir: PathBuf

Where the fixture’s config dir goes. The workspace’s store lives under it and the transcript is written into it, so a fresh directory gives a fresh seat; nothing here clears one, so a rerun over the same directory reuses the store it left.

port: u16

The port. Fixed rather than ephemeral: a harness that samples ps needs to find the server by something, and the port is what survives a PID nobody wrote down.

breakdown: bool

Report where the time goes inside one request before serving.

measure: bool

Measure a running server rather than serve one.

pid: Option<u32>

The server’s PID, which is whose CPU time the measurement charges.

arm: Arm

The arm to run, and each one sends what its name says: idle does nothing and is the baseline; subscribe is one connect and one subscribe; more is an attach then --asks pages; and refresh is an attach then --asks subscribe-reloads, each an unsubscribe and a subscribe, which is what the client sends on every update.

A closed set, so a mistyped arm is refused rather than run as more. An arm that ran a different workload under the name a person typed is the defect this instrument exists to find, and it is the same mistake whether the code or the caller makes it.

turns: u32

How many turns each more asks for.

asks: u32

How many asks an arm makes.

seconds: f64

How long the idle arm runs, and the wall the charge is scaled against.

Trait Implementations

impl Args for Args

fn group_id() -> Option<Id>

Report the [ArgGroup::id][crate::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 CommandFactory for Args

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 FromArgMatches for Args

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 Args

fn parse() -> Self

Parse from std::env::args_os(), [exit][Error::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][Error::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][Error::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.