public inbox for pve-devel@lists.proxmox.com
 help / color / mirror / Atom feed
From: Christoph Heiss <c.heiss@proxmox.com>
To: pve-devel@lists.proxmox.com
Subject: Re: [PATCH installer] fix #7833: common: cli: ensure process exits with 1 if subcommand fails
Date: Thu, 12 Nov 2026 11:07:02 +0100	[thread overview]
Message-ID: <2026dd36-e147-4f13-90c1-f340a6160c2f@proxmox.com> (raw)
In-Reply-To: <20260818095947.464930-1-c.heiss@proxmox.com>

Obsoleted by commit 8d2483a67 [0].

[0] https://git.proxmox.com/?p=pve-installer.git;a=commitdiff;h=8d2483a67

On 8/18/26 11:59, Christoph Heiss wrote:
> Fixes #7833 [0].
> 
> Currently, errors from the `AppInfo::on_command` handler is propagated
> and printed, but does not cause cli::run() to return a failure exit
> code.
> 
> A small, custom error enum is introduced to differentiate between an
> unknown/missing subcommand - which should also trigger the global help
> menu - and errors from the command that was run.
> 
> Based on that, the appropriate `ExitCode` variant is set and propagated
> back to the caller.
> 
> [0] https://bugzilla.proxmox.com/show_bug.cgi?id=7833
> 
> Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
> ---
>  proxmox-auto-install-assistant/src/main.rs |  4 +-
>  proxmox-chroot/src/main.rs                 |  4 +-
>  proxmox-installer-common/src/cli.rs        | 91 ++++++++++++++++++----
>  3 files changed, 78 insertions(+), 21 deletions(-)
> 
> diff --git a/proxmox-auto-install-assistant/src/main.rs b/proxmox-auto-install-assistant/src/main.rs
> index 730d7d8..728d8ee 100644
> --- a/proxmox-auto-install-assistant/src/main.rs
> +++ b/proxmox-auto-install-assistant/src/main.rs
> @@ -560,8 +560,8 @@ GLOBAL OPTIONS:
>              Some("device-match") => cli::handle_command::<CommandDeviceMatchArgs>(args),
>              Some("device-info") => cli::handle_command::<CommandDeviceInfoArgs>(args),
>              Some("system-info") => cli::handle_command::<CommandSystemInfoArgs>(args),
> -            Some(s) => bail!("unknown subcommand '{s}'"),
> -            None => bail!("subcommand required"),
> +            Some(s) => Err(cli::Error::UnknownSubcommand(s.to_owned())),
> +            None => Err(cli::Error::SubcommandRequired),
>          },
>      })
>  }
> diff --git a/proxmox-chroot/src/main.rs b/proxmox-chroot/src/main.rs
> index 5f087bb..6544bf1 100644
> --- a/proxmox-chroot/src/main.rs
> +++ b/proxmox-chroot/src/main.rs
> @@ -125,8 +125,8 @@ GLOBAL OPTIONS:
>          on_command: |s, args| match s {
>              Some("prepare") => cli::handle_command::<CommandPrepareArgs>(args),
>              Some("cleanup") => cli::handle_command::<CommandCleanupArgs>(args),
> -            Some(s) => bail!("unknown subcommand '{s}'"),
> -            None => bail!("subcommand required"),
> +            Some(s) => Err(cli::Error::UnknownSubcommand(s.to_owned())),
> +            None => Err(cli::Error::SubcommandRequired),
>          },
>      })
>  }
> diff --git a/proxmox-installer-common/src/cli.rs b/proxmox-installer-common/src/cli.rs
> index e2b4d81..1c9ef29 100644
> --- a/proxmox-installer-common/src/cli.rs
> +++ b/proxmox-installer-common/src/cli.rs
> @@ -1,7 +1,7 @@
>  //! Provides a simple command line parsing interface, with special support for
>  //! (one-level deep) subcommands.
>  
> -use std::process;
> +use std::{fmt, process::ExitCode};
>  
>  use anyhow::Result;
>  
> @@ -22,41 +22,98 @@ pub trait Subcommand {
>      fn run(&self) -> Result<()>;
>  }
>  
> +/// Describes a CLI app.
> +///
> +/// ### Example usage
> +/// ```
> +/// fn main() -> process::ExitCode {
> +///     cli::run(cli::AppInfo {
> +///         global_help: "Some CLI app",
> +///         on_command: |s, args| match s {
> +///             Some("foo") => cli::handle_command::<FooCommand>(args),
> +///             Some(s) => Err(cli::Error::UnknownSubcommand(s.to_owned())),
> +///             None => Err(cli::Error::SubcommandRequired),
> +///         }
> +///     })
> +/// }
> +/// ```
>  pub struct AppInfo<'a> {
> +    /// Global help menu to display if `-h`/`--help` was given without any subcommand or an invalid
> +    /// subcommand was specified.
>      pub global_help: &'a str,
> -    pub on_command: fn(Option<&str>, &mut Arguments) -> Result<()>,
> +    /// Callback to invoke with the subcommand name (if given) and the argument list.
> +    ///
> +    /// Receives the subcommand name (if one was given on the command line) and the rest of the
> +    /// argument list.
> +    pub on_command: fn(Option<&str>, &mut Arguments) -> Result<(), Error>,
>  }
>  
> -pub fn run(info: AppInfo) -> process::ExitCode {
> -    if let Err(err) = parse_args(&info) {
> -        eprintln!("Error: {err:#}\n\n{}", info.global_help);
> -        process::ExitCode::FAILURE
> -    } else {
> -        process::ExitCode::SUCCESS
> +#[derive(Debug)]
> +pub enum Error {
> +    UnknownSubcommand(String),
> +    SubcommandRequired,
> +    Other(anyhow::Error),
> +}
> +
> +impl std::error::Error for Error {}
> +
> +impl fmt::Display for Error {
> +    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
> +        match self {
> +            Error::UnknownSubcommand(s) => write!(f, "unknown subcommand '{s}'"),
> +            Error::SubcommandRequired => write!(f, "subcommand required"),
> +            Error::Other(s) => write!(f, "{s}"),
> +        }
>      }
>  }
>  
> -fn parse_args(info: &AppInfo) -> Result<()> {
> +/// Retrieves the process command line, checks for a subcommand name and for the default global
> +/// flags `-h`/`--help` and `-V`/`--version`.
> +///
> +/// If no global flag was given, runs the command handler given in [`AppInfo::on_command`].
> +pub fn run(info: AppInfo) -> ExitCode {
>      let mut args = pico_args::Arguments::from_env();
> -    let subcommand = args.subcommand()?;
> +
> +    let subcommand = match args.subcommand() {
> +        Ok(s) => s,
> +        Err(err) => {
> +            eprintln!("Error: {err:#}\n\n{}", info.global_help);
> +            return ExitCode::FAILURE;
> +        }
> +    };
>  
>      if subcommand.is_none() && args.contains(["-h", "--help"]) {
>          eprintln!("{}", info.global_help);
> -        Ok(())
> +        ExitCode::SUCCESS
>      } else if args.contains(["-V", "--version"]) {
>          eprintln!("{} v{}", env!("CARGO_PKG_NAME"), env!("CARGO_PKG_VERSION"));
> -        Ok(())
> +        ExitCode::SUCCESS
>      } else {
> -        (info.on_command)(subcommand.as_deref(), &mut args)
> +        match (info.on_command)(subcommand.as_deref(), &mut args) {
> +            Ok(()) => ExitCode::SUCCESS,
> +            Err(Error::Other(err)) => {
> +                eprintln!("Error: {err:#}");
> +                ExitCode::FAILURE
> +            }
> +            // For non-command errors (i.e. invalid subcommand), also print the help text, in
> +            // addition to the error itself.
> +            Err(err) => {
> +                eprintln!("Error: {err:#}\n\n{}", info.global_help);
> +                ExitCode::FAILURE
> +            }
> +        }
>      }
>  }
>  
> -pub fn handle_command<T: Subcommand>(args: &mut pico_args::Arguments) -> Result<()> {
> +/// Runs a specific subcommand. If the arguments contain -h/--help, the help text of the subcommand
> +/// is printed and success is returned.
> +pub fn handle_command<T: Subcommand>(args: &mut pico_args::Arguments) -> Result<(), Error> {
>      if args.contains(["-h", "--help"]) {
>          T::print_usage();
> -    } else if let Err(err) = T::parse(args).and_then(|cmd| cmd.run()) {
> -        eprintln!("Error: {err:#}");
> +        return Ok(());
>      }
>  
> -    Ok(())
> +    T::parse(args)
> +        .and_then(|cmd| cmd.run())
> +        .map_err(Error::Other)
>  }





      reply	other threads:[~2026-11-12 10:07 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-08-18  9:59 [PATCH installer] fix #7833: common: cli: ensure process exits with 1 if subcommand fails Christoph Heiss
2026-11-12 10:07 ` Christoph Heiss [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=2026dd36-e147-4f13-90c1-f340a6160c2f@proxmox.com \
    --to=c.heiss@proxmox.com \
    --cc=pve-devel@lists.proxmox.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
Service provided by Proxmox Server Solutions GmbH | Privacy | Legal