Struct BuildStd 

pub struct BuildStd { /* private fields */ }

Available on crate feature os_cmd only.

Represents the build options for the standard library components.

By default (BuildStd::default()), all options are set to false.

Note: BuildStd.build_default is NOT equivalent to BuildStd::default()

• Special Option: build_default: When set to true => ["-Z", "build-std"], which compiles core, std, alloc, and proc_macro.

  • Note: Other options will override build_default
    • When build_default is true and core is also true, => ["-Z", "build-std=core"]
    • Only when build_default is true and all other options are false, => ["-Z", "build-std"]

• core: true => ["-Z", "build-std=core"]

• alloc: true => ["-Z", "build-std=alloc"]

• When both core and alloc are true => ["-Z", "build-std=core,alloc"]

You can control the components to be compiled using the with_ methods.

Example

use testutils::os_cmd::presets::cargo_build::{ArgConverter, BuildStd};

let build_std_with_core_and_alloc = BuildStd::default()
  .with_std(false)
  .with_core(true)
  .with_alloc(true)
  .with_build_default(true);

assert_eq!(
  build_std_with_core_and_alloc
    .to_args()
    .next(),
  Some("-Z".into())
);

assert_eq!(
  build_std_with_core_and_alloc
    .to_args()
    .last(),
  Some("build-std=core,alloc".into())
);

let build_std_with_default_only = BuildStd::default().with_build_default(true);
assert_eq!(
  build_std_with_default_only
    .to_args()
    .last(),
  Some("build-std".into())
);

let build_std_none_enabled = BuildStd::default();
assert_eq!(
  build_std_none_enabled
    .to_args()
    .next(),
  None
);

Implementations

impl BuildStd

pub fn with_build_default(self, val: bool) -> Self

pub fn with_std(self, val: bool) -> Self

pub fn with_core(self, val: bool) -> Self

pub fn with_alloc(self, val: bool) -> Self

pub fn with_panic_abort(self, val: bool) -> Self

pub fn with_panic_unwind(self, val: bool) -> Self

pub fn with_test(self, val: bool) -> Self

pub fn with_proc_macro(self, val: bool) -> Self

impl BuildStd

pub fn get_build_default(&self) -> bool

pub fn get_std(&self) -> bool

pub fn get_core(&self) -> bool

pub fn get_alloc(&self) -> bool

pub fn get_panic_abort(&self) -> bool

pub fn get_panic_unwind(&self) -> bool

pub fn get_test(&self) -> bool

pub fn get_proc_macro(&self) -> bool

Trait Implementations

impl ArgConverter for BuildStd

fn to_args(&self) -> Self::ArgsIter

Converts the BuildStd struct to an array of arguments.

This method generates a list of arguments based on the enabled fields in the BuildStd struct. If no fields are enabled, it returns None. If build_default is enabled, it returns the default build arguments.

type ArgsIter = Flatten<IntoIter<[CompactString; 2]>>

impl Clone for BuildStd

fn clone(&self) -> BuildStd

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BuildStd

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

Formats the value using the given formatter.

impl Default for BuildStd

fn default() -> Self

Default:

BuildStd {
  build_default: false,
  std: false,
  core: false,
  alloc: false,
  panic_abort: false,
  panic_unwind: false,
  test: false,
  proc_macro: false,
}