doku 0.21.1

A framework for documenting Rust data structures
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

use doku::{Document, Fields, TypeKind};

#[test]
fn serde_aliases_are_collected_by_document() {
    #[derive(serde::Deserialize, Document)]
    #[allow(dead_code)]
    struct Thing {
        #[serde(alias = "foos")]
        foo: String,

        #[serde(alias = "bat")]
        #[serde(alias = "baz")]
        bar: i32,
    }

    if let doku::Type {
        kind:
            TypeKind::Struct {
                fields: Fields::Named { fields },
                ..
            },
        ..
    } = Thing::ty()
    {
        let foo_aliases = fields
            .iter()
            .find(|(name, _)| *name == "foo")
            .unwrap()
            .1
            .aliases;
        let bar_aliases = fields
            .iter()
            .find(|(name, _)| *name == "bar")
            .unwrap()
            .1
            .aliases;
        assert_eq!(foo_aliases, ["foos"]);
        assert_eq!(bar_aliases, ["bat", "baz"]);
    } else {
        unreachable!();
    }
}