Crate wundergraph

Wundergraph provides a platform to easily expose your database through a GraphQL interface.

Short example

use wundergraph::prelude::*;

table! {
    heros {
        id -> Integer,
        name -> Text,
        hair_color -> Nullable<Text>,
        species -> Integer,
    }
}

table! {
    species {
        id -> Integer,
        name -> Text,
    }
}

#[derive(Clone, Debug, Identifiable, WundergraphEntity)]
#[table_name = "heros"]
pub struct Hero {
    id: i32,
    name: String,
    hair_color: Option<String>,
    species: HasOne<i32, Species>,
}

#[derive(Clone, Debug, Identifiable, WundergraphEntity)]
#[table_name = "species"]
pub struct Species {
    id: i32,
    name: String,
    heros: HasMany<Hero, heros::species>,
}

wundergraph::query_object!{
    Query {
       Hero,
       Species,
    }
}

Where to find things

Everything required for basic usage of wundergraph is exposed through wundergraph::prelude. wundergraph::query_builder::selection contains functionality to manual extend or implement a query entity, wundergraph::query_builder::mutations contains similar functionality for mutations. wundergraph::scalar provides the implementation of the internal used juniper scalar value type. wundergraph::error contains the definition of the internal error type. wundergraph::diesel_ext and wundergraph::juniper_ext provide extension traits and types for the corresponding crates. wundergraph::helper contains wundergraph specific helper types.

Modules

diesel_ext

A module containing extension traits for various diesel types

error

This module contains all error handling related functionality in wundergraph

helper

A module containing various helper traits and types mostly useful to work with tuples at compile time

juniper_ext

A module containing juniper specific extension traits

prelude

Re-exports important traits and types. Meant to be glob imported when using wundergraph.

query_builder

This module contains functionality used by wundergraph to convert a GraphQL request as sql query.

scalar

A module containing a wundergraph specific juniper scalar value implementation

Macros

mutation_object

Macro to register the main mutation object

query_object

Macro to register the main query object

Derive Macros

WundergraphEntity

A custom derive to implement all wundergraph related traits for a entity Using this trait implies internally #[derive(WundergraphBelongsTo)] and #[derive(BuildFilterHelper)]