Function run 

pub fn run<I, T>(args: I) -> i32
where
    I: IntoIterator<Item = T>,
    T: Into<OsString> + Clone,

Runs the aviso command-line client to completion and returns the process exit code.

This is the single entry point shared by the aviso binary (src/main.rs) and the bundled aviso console command shipped in the pyaviso Python wheel through the aviso-py extension. It owns argument parsing, tracing setup, the async runtime, and the exit-code mapping, and it does not call std::process::exit on its normal paths, so an embedding process (the Python interpreter) keeps control of its own lifecycle. The one exception is the second-Ctrl+C hard exit during listen / replay, which terminates the process immediately by design.

args is the full argument vector including the program name at index 0, matching std::env::args_os and sys.argv.

Exit codes: 0 success, 1 runtime error, 2 usage error. A clap parse failure prints its message and returns clap’s own exit code (2), while --help and --version print and return 0.