- Clone URL: git://caraus.tech/pub/graphql.git
GraphQL implementation in Haskell
This is the core library that provides:
- Parser for the query and schema languages, as well as a printer for the query language (minimizer and pretty-printer).
- Data structures to define a type system.
- Executor (queries, mutations and subscriptions are supported).
- Validation.
- Introspection is work in progress.
For a more precise list of currently missing features and known limitations see issues.
GHC 9 and Aeson 2
Since JSON serialization support is not mandatory for GraphQL itself, current version optionally supports only Aeson 1. Aeson 2 support is provided by a companion library, graphql-spice. Aeson 1 build supports GHC 8, Aeson 2 build - GHC 9. The default build currently uses GHC 8 and Aeson 1, this will change soon, so GHC9 and Aeson 2 (with graphql-spice) build will be the default.
The version built can be changed with json flag passed to cabal. Run cabal build --flag=+json to build the old verison, or --flag=-json for the new one. --flag also works with other cabal commands like test. To choose the appropriate build in a project, cabal.project with the following contents can be used:
packages: .
constraints: graphql -jso
Documentation
API documentation is available through Hackage.
Further documentation will be made available in the Wiki.