Struct cargo::core::CliUnstable

pub struct CliUnstable {
    pub print_im_a_teapot: bool,
    pub unstable_options: bool,
    pub offline: bool,
    pub no_index_update: bool,
    pub avoid_dev_deps: bool,
    pub minimal_versions: bool,
    pub package_features: bool,
    pub advanced_env: bool,
    pub config_profile: bool,
}

A parsed representation of all unstable flags that Cargo accepts.

Cargo, like rustc, accepts a suite of -Z flags which are intended for gating unstable functionality to Cargo. These flags are only available on the nightly channel of Cargo.

This struct doesn’t have quite the same convenience macro that the features have above, but the procedure should still be relatively stable for adding a new unstable flag:

1. First, add a field to this CliUnstable structure. All flags are allowed to have a value as the -Z flags are either of the form -Z foo or -Z foo=bar, and it’s up to you how to parse bar.

2. Add an arm to the match statement in CliUnstable::add below to match on your new flag. The key (k) is what you’re matching on and the value is in v.

3. (optional) Add a new parsing function to parse your datatype. As of now there’s an example for bool, but more can be added!

4. In Cargo use config.cli_unstable() to get a reference to this structure and then test for your flag or your value and act accordingly.

If you have any trouble with this, please let us know!

Fields

print_im_a_teapot: bool

unstable_options: bool

offline: bool

no_index_update: bool

avoid_dev_deps: bool

minimal_versions: bool

package_features: bool

advanced_env: bool

config_profile: bool

Implementations

impl CliUnstable

pub fn parse(&mut self, flags: &[String]) -> CargoResult<()>

Trait Implementations

impl Debug for CliUnstable

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

Formats the value using the given formatter.

impl Default for CliUnstable

fn default() -> CliUnstable

Returns the “default value” for a type.