random_variant_macro is a procedural macro. It will run at compile time and transform your program's source code.

Adding `random_variant_macro` macro(s) as a dependency

Run this command in a terminal, in your project's directory:

cargo add random_variant_macro

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

random_variant_macro = "0.2.0"

You may need to import the macro(s) with use random_variant_macro::*.

Read the random_variant_macro documentation.

Back to the crate overview.

Readme

RandomVariant

Trait that returns a random variant of the given type, if you are creating a new type to limit some values, instead of deriving the RandomVariant, implement it manually to ensure only correct values are created Unless you also want to try the Result type Useful for hunting down unwraps or other assumptions in your code, The benefit over the crate EveryVariant is that this can be limited to A much smaller set to test, where generting every variant quickly can grow to unmanageable testing sets

Example

    use serde::Serialize;
    use std::net::IpAddr;

    #[derive(RandomVariant, Serialize)]
    enum Message {
        Log(String),
        ErrorCode(u32),
        /// This tuple will fail to serialize if flattened in serde
        Rebooting,
    }

    #[derive(RandomVariant, Serialize)]
    struct LoggedMessage {
        /// Fail to serialize, since flatteing enums is not supported
        #[serde(flatten)]
        t: Message,
        add: IpAddr,
    }
    let mut rng = crate::rand::thread_rng();
    
    /// This allows us to limit the testing set to trying 100 randomized structs
    for _i in 0..100 {
        let v = LoggedMessage::random_variant(&mut rng);
        serde_json::to_string(&v).unwrap();
    }

Adding random_variant_macro macro(s) as a dependency

Adding `random_variant_macro` macro(s) as a dependency