glitchup_derive

A group of procedural macros to assist in the use of glitchup. Check any updates on the changelog.

#[derive(MutConfig)]

This derivation macro is used to derive MutConfig for any compatible struct. For a struct to be compatible, the following must apply:

• The name of the struct must contain Config.
• The fields of the struct must be of the following types:
  • Primitives
    • isize
    • String
    • bool
  • Generics
    • Vec<{Supported Primitive}>
    • Option<{Supported Primitive}>

These specific primitives were selected due to the MutOptionVal using said values.

The MutConfig trait implements a to_hashmap function, where the fields of the struct are converted into a HashMap<String, MutOptionVal> to be used by a Mutation.

#[derive(Debug, Deserialize, MutConfig)]
struct MainConfig {
    mutation : MutationConfig,
    mutations : Vec<Vec<String>> // will fail!
}

#[derive(Debug, Deserialize, MutConfig)]
struct MutationConfig {
    min : Option<isize>,
    max : Option<isize>,
    chunksize : isize,
}

In MainConfig above, mutations would fail. However, as an example, we need it in order for our application to work. We know that no Mutation will use it, so what we can do is add the #[ignore] attribute:

#[derive(Debug, Deserialize, MutConfig)]
struct MainConfig {
    mutation : MutationConfig,
    #[ignore]
    mutations : Vec<Vec<String>> // all ok now!
}
...

Any field tagged with #[ignore] will not be included in to_hashmap(...).