Struct RustFlags 

pub struct RustFlags { /* private fields */ }

Available on crate feature os_cmd only.

Represents various flags used for configuring Rust compilation.

• crt_static

  • Some(true) => ["-C", "target-feature=+crt-static"]
  • Some(false) => ["-C", "target-feature=-crt-static"]
  • None => []

• prefer_dynamic

  • Some(true) => ["-C", "prefer-dynamic=true"]
  • Some(false) => ["-C", "prefer-dynamic=false"]
  • None => []

• linker: The linker to be used.

  • “” => []
  • lld => ["-C", "linker=lld"]

• relocation_model: static, pic, pie, etc.

• code_model: “tiny”, “small”, “kernel”, “medium”, “large”

• codegen_units:

  • Some(u) => ["-C", "codegen-units={u}"]
  • None => []

• native_target_cpu:

  • Some(true) => ["-C", "target-cpu=native"]
  • Some(false) => ["-C", "target-cpu=generic"]
  • None => []

• other_flags: Additional flags for the Rust compiler.

See also: The rustc book

Implementations

impl RustFlags

pub fn with_crt_static(self, val: Option<bool>) -> Self

pub fn with_prefer_dynamic(self, val: Option<bool>) -> Self

pub fn with_linker(self, val: MiniStr) -> Self

pub fn with_linker_flavor(self, val: LinkerFlavor) -> Self

pub fn with_link_self_contained(self, val: Option<bool>) -> Self

pub fn with_relocation_model(self, val: RelocationModel) -> Self

pub fn with_code_model(self, val: CodeModel) -> Self

pub fn with_codegen_units(self, val: Option<usize>) -> Self

pub fn with_native_target_cpu(self, val: Option<bool>) -> Self

pub fn with_other_flags(self, val: Box<[MiniStr]>) -> Self

impl RustFlags

pub fn get_crt_static(&self) -> &Option<bool>

pub fn get_prefer_dynamic(&self) -> &Option<bool>

pub fn get_linker(&self) -> &MiniStr

pub fn get_linker_flavor(&self) -> &LinkerFlavor

pub fn get_link_self_contained(&self) -> &Option<bool>

pub fn get_relocation_model(&self) -> &RelocationModel

pub fn get_code_model(&self) -> &CodeModel

pub fn get_codegen_units(&self) -> &Option<usize>

pub fn get_native_target_cpu(&self) -> &Option<bool>

pub fn get_other_flags(&self) -> &Box<[MiniStr]>

impl RustFlags

pub fn into_vec(self) -> Vec<MiniStr>

Collects flags into a Vec

Example

use tap::Pipe;
use testutils::os_cmd::{
  collect_boxed_ministr_slice,
  presets::cargo_build::flags::{LinkerFlavor, RustFlags},
};

let flags = RustFlags::default()
  .with_crt_static(false.into())
  .with_prefer_dynamic(true.into())
  .with_linker_flavor(LinkerFlavor::GNUbinutilsLLVMLLD)
  .with_other_flags(
    [
      "-C",
      "link-arg=-ffunction-sections",
      "-C",
      "link-arg=-fdata-sections",
    ]
    .pipe(collect_boxed_ministr_slice),
  )
  .into_vec();

assert_eq!(
  flags,
  [
    "-C",
    "target-feature=-crt-static",
    "-C",
    "prefer-dynamic=true",
    "-C",
    "linker-flavor=ld.lld",
    "-C",
    "link-arg=-ffunction-sections",
    "-C",
    "link-arg=-fdata-sections",
  ]
);

Trait Implementations

impl Clone for RustFlags

fn clone(&self) -> RustFlags

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RustFlags

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

Formats the value using the given formatter.

impl Default for RustFlags

fn default() -> Self

Default

RustFlags {
    crt_static: None,
    prefer_dynamic: None,
    linker: "",
    linker_flavor: Ignore,
    link_self_contained: None,
    relocation_model: Ignore,
    code_model: Ignore,
    codegen_units: None,
    native_target_cpu: None,
    other_flags: [],
}