Enum hakari::UnifyTargetHost

#[non_exhaustive]
pub enum UnifyTargetHost {
    None,
    Auto,
    UnifyIfBoth,
    ReplicateTargetOnHost,
}

Whether to unify feature sets for a given dependency across target and host platforms.

Consider a dependency that is built as both normally (on the target platform) and in a build script or proc macro. The normal dependency is considered to be built on the target platform, and is represented in the [dependencies] section in the generated Cargo.toml. The build dependency is built on the host platform, represented in the [build-dependencies] section.

Now consider that the target and host platforms need two different sets of features:

# feature set on target platform
[dependencies]
my-dep = { version = "1.0", features = ["a", "b"] }

# feature set on host platform
[build-dependencies]
my-dep = { version = "1.0", features = ["b", "c"] }

Should hakari unify the feature sets across the [dependencies] and [build-dependencies] feature sets?

Call HakariBuilder::set_unify_target_host to configure this option.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

None

Perform no unification across the target and host feature sets.

This is the most conservative option, but it means that some dependencies may be built with two different sets of features. In this mode, Hakari will likely be significantly less efficient.

Auto

Automatically choose between the UnifyIfBoth and the ReplicateTargetOnHost options:

• If the workspace contains proc macros, or crates that are build dependencies of other crates, choose the ReplicateTargetAsHost strategy.
• Otherwise, choose the UnifyIfBoth strategy.

This is the default behavior.

UnifyIfBoth

Perform unification across target and host feature sets, but only if a dependency is built on both the target and the host.

This is useful if cross-compilations are uncommon and one wishes to avoid the same package being built two different ways: once for the target and once for the host.

ReplicateTargetOnHost

Perform unification across target and host feature sets, and also replicate all target-only lines to the host.

This is most useful if some workspace packages are proc macros or build dependencies used by other packages.

Trait Implementations

impl Arbitrary for UnifyTargetHost

type Parameters = ()

The type of parameters that arbitrary_with accepts for configuration of the generated Strategy. Parameters must implement Default.

type Strategy = TupleUnion<((u32, Arc<fn() -> Self>), (u32, Arc<fn() -> Self>), (u32, Arc<fn() -> Self>), (u32, Arc<fn() -> Self>))>

The type of Strategy used to generate values of type Self.

fn arbitrary_with(_top: Self::Parameters) -> Self::Strategy

Generates a Strategy for producing arbitrary values of type the implementing type (Self). The strategy is passed the arguments given in args.

fn arbitrary() -> Self::Strategy

Generates a Strategy for producing arbitrary values of type the implementing type (Self).

impl Clone for UnifyTargetHost

fn clone(&self) -> UnifyTargetHost

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for UnifyTargetHost

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

Formats the value using the given formatter.

impl Default for UnifyTargetHost

The default for UnifyTargetHost: automatically choose unification strategy based on the workspace.

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for UnifyTargetHost

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Hash for UnifyTargetHost

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl Ord for UnifyTargetHost

fn cmp(&self, other: &UnifyTargetHost) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl PartialEq<UnifyTargetHost> for UnifyTargetHost

fn eq(&self, other: &UnifyTargetHost) -> 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 !=.

impl PartialOrd<UnifyTargetHost> for UnifyTargetHost

fn partial_cmp(&self, other: &UnifyTargetHost) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for UnifyTargetHost

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl Copy for UnifyTargetHost

impl Eq for UnifyTargetHost

impl StructuralEq for UnifyTargetHost

impl StructuralPartialEq for UnifyTargetHost