8 unstable releases (3 breaking)

0.4.1 Apr 20, 2023
0.4.0 Feb 22, 2023
0.3.0 Nov 19, 2022
0.2.2 Oct 14, 2022
0.1.0 Apr 11, 2022

#247 in Procedural macros

Download history 1034/week @ 2024-06-18 1101/week @ 2024-06-25 1153/week @ 2024-07-02 1068/week @ 2024-07-09 1040/week @ 2024-07-16 1139/week @ 2024-07-23 1321/week @ 2024-07-30 1360/week @ 2024-08-06 1203/week @ 2024-08-13 772/week @ 2024-08-20 1216/week @ 2024-08-27 1259/week @ 2024-09-03 998/week @ 2024-09-10 972/week @ 2024-09-17 1049/week @ 2024-09-24 745/week @ 2024-10-01

4,073 downloads per month
Used in 9 crates (6 directly)

MIT license

45KB
1K SLoC

StructStruck

Ever had a deeply nested JSON struct

{
    "outer": {
        "middle": {
            "inner": {
                "foo": "bar"
            }
        }
    }
}

and wanted to write the Rust structs to handle that data just in the same nested way?

struct Parent {
    outer: struct {
        middle: struct {
            inner: struct {
                foo: String,
            }
        }
    }
}

This proc macro crate allows exactly that. Check the docs on how exaclty.

For illustration, some more usecases:

  • an enum where every variant has its own struct, named exactly the same as the variant.
structstruck::strike! {
    enum Token {
        Identifier(struct {
            name: String,
        }),
        Punctuation(struct {
            character: char,
        }),
    }
}
  • my original use case: conveniently write kubernetes custom resources with kube.
structstruck::strike! {
    #[strikethrough[derive(Deserialize, Serialize, Clone, Debug, Validate, JsonSchema)]]
    #[strikethrough[serde(rename_all = "camelCase")]]
    #[derive(CustomResource)]
    #[kube(
        group = "kafka.strimzi.io",
        version = "v1beta2",
        kind = "Kafka",
        namespaced
    )]
    struct KafkaSpec {
        kafka: struct KafkaCluster {
            #[validate(length(min = 1))]
            version: String,
            #[validate(range(min = 1))]
            replicas: u32,
            listeners: Vec<struct KafkaListener {
                name: String,
                port: u16,
                r#type: String,
                tls: bool,
            }>,
            config: HashMap<String, JsonValue>,
            storage: struct {
                r#type: String,
                volumes: Vec<struct Volume {
                    id: Option<u64>,
                    r#type: String,
                    size: String,
                    delete_claim: bool,
                }>,
            },
        },
        zookeeper: struct {
            #[validate(range(min = 1))]
            replicas: u32,
            storage: Volume,
        },
        entity_operator: struct {
            topic_operator: Option<HashMap<String, JsonValue>>,
            user_operator: Option<HashMap<String, JsonValue>>,
        },
    }
}

Dependencies

~305KB