Derive Macro async_graphql::Enum[][src]

#[derive(Enum)]
{
    // Attributes available to this derive:
    #[graphql]
}
Expand description

Define a GraphQL enum

See also the Book.

Macro parameters

AttributedescriptionTypeOptional
nameEnum namestringY
rename_itemsRename all the fields according to the given case convention. The possible values are “lowercase”, “UPPERCASE”, “PascalCase”, “camelCase”, “snake_case”, “SCREAMING_SNAKE_CASE”.stringY
remoteDerive a remote enumstringY
visibleIf false, it will not be displayed in introspection. See also the Book.boolY
visibleCall the specified function. If the return value is false, it will not be displayed in introspection.stringY

Item parameters

AttributedescriptionTypeOptional
nameItem namestringY
deprecationItem deprecatedboolY
deprecationItem deprecation reasonstringY
visibleIf false, it will not be displayed in introspection. See also the Book.boolY
visibleCall the specified function. If the return value is false, it will not be displayed in introspection.stringY

Examples

use async_graphql::*;

#[derive(Enum, Copy, Clone, Eq, PartialEq)]
enum MyEnum {
    A,
    #[graphql(name = "b")] B,
}

struct QueryRoot {
    value1: MyEnum,
    value2: MyEnum,
}

#[Object]
impl QueryRoot {
    /// value1
    async fn value1(&self) -> MyEnum {
        self.value1
    }

    /// value2
    async fn value2(&self) -> MyEnum {
        self.value2
    }
}

tokio::runtime::Runtime::new().unwrap().block_on(async move {
    let schema = Schema::new(QueryRoot{ value1: MyEnum::A, value2: MyEnum::B }, EmptyMutation, EmptySubscription);
    let res = schema.execute("{ value1 value2 }").await.into_result().unwrap().data;
    assert_eq!(res, value!({ "value1": "A", "value2": "b" }));
});