Struct rb_sys_build::RbConfig

pub struct RbConfig {
    pub search_paths: Vec<SearchPath>,
    pub libs: Vec<Library>,
    pub link_args: Vec<String>,
    pub cflags: Vec<String>,
    pub blocklist_lib: Vec<String>,
    /* private fields */
}

Extracts structured information from raw compiler/linker flags to make compiling Ruby gems easier.

Fields

search_paths: Vec<SearchPath>

libs: Vec<Library>

link_args: Vec<String>

cflags: Vec<String>

blocklist_lib: Vec<String>

Implementations

impl RbConfig

pub fn new() -> RbConfig

Creates a new, blank RbConfig. You likely want to use RbConfig::current() instead.

pub fn all_keys(&self) -> Keys<'_, String, String>

All keys in the RbConfig’s value map.

pub fn current() -> RbConfig

Instantiates a new RbConfig for the current Ruby.

pub fn link_ruby(&mut self, is_static: bool) -> &mut Self

Pushes the LIBRUBYARG flags so Ruby will be linked.

pub fn libruby_static_name(&self) -> String

Get the name for libruby-static (i.e. ruby.3.1-static).

pub fn libruby_so_name(&self) -> String

Get the name for libruby (i.e. ruby.3.1)

pub fn blocklist_lib(&mut self, name: &str) -> &mut RbConfig

Filter the libs, removing the ones that are not needed.

pub fn ruby_version(&self) -> String

Returns the current ruby version.

pub fn cppflags(&self) -> Vec<String>

Get the CPPFLAGS from the RbConfig, making sure to subsitute variables.

pub fn get(&self, key: &str) -> String

Returns the value of the given key from the either the matching RBCONFIG_{key} environment variable or RbConfig::CONFIG[{key}] hash.

pub fn get_optional(&self, key: &str) -> Option<String>

Returns the value of the given key from the either the matching RBCONFIG_{key} environment variable or RbConfig::CONFIG[{key}] hash.

pub fn use_rpath(&mut self) -> &mut RbConfig

Enables the use of rpath for linking.

pub fn push_cflags(&mut self, cflags: &str) -> &mut Self

Push cflags string

pub fn major_minor(&self) -> (u32, u32)

Get major/minor version tuple of Ruby

pub fn cargo_args(&self) -> Vec<String>

Get the rb_config output for cargo

pub fn print_cargo_args(&self)

Print to rb_config output for cargo

pub fn push_dldflags(&mut self, input: &str) -> &mut Self

Adds items to the rb_config based on a string from LDFLAGS/DLDFLAGS

pub fn set_value_for_key(&mut self, key: &str, value: String)

Sets a value for a key

pub fn has_ruby_dln_check_abi(&self) -> bool

Trait Implementations

impl Debug for RbConfig

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

Formats the value using the given formatter.

impl Default for RbConfig

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq<RbConfig> for RbConfig

fn eq(&self, other: &RbConfig) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for RbConfig

impl StructuralEq for RbConfig

impl StructuralPartialEq for RbConfig