GraphQL implementation in Haskell

Go to file

Eugen Wissner 09135c581a Constrain base monad to MonadCatch Let's try MonadThrow/MonadCatch. It looks nice at a first glance. The monad transformer stack contains only the ReaderT, less lifts are required. Exception subtyping is easier, the user can (and should) define custom error types and throw them. And it is still possible to use pure error handling, if someone doesn't like runtime exceptions or need to run a query in a pure environment. Fixes #42.		2020-07-17 07:05:03 +02:00
.github/workflows	Check in .cabal	2020-07-03 07:00:37 +02:00
docs/tutorial	Respect subscriptions in the executor	2020-07-15 19:15:31 +02:00
src/Language	Constrain base monad to MonadCatch	2020-07-17 07:05:03 +02:00
tests	Constrain base monad to MonadCatch	2020-07-17 07:05:03 +02:00
.gitignore	Check in .cabal	2020-07-03 07:00:37 +02:00
CHANGELOG.md	Constrain base monad to MonadCatch	2020-07-17 07:05:03 +02:00
CONTRIBUTING.md	Write contrinbuting guidelines	2020-04-12 08:32:39 +02:00
graphql.cabal	Constrain base monad to MonadCatch	2020-07-17 07:05:03 +02:00
LICENSE	Update copyright	2020-01-21 23:27:21 +01:00
package.yaml	Constrain base monad to MonadCatch	2020-07-17 07:05:03 +02:00
README.md	Merge Trans and Type.Out modules	2020-07-02 07:33:03 +02:00
Setup.hs	Initial commit	2015-09-12 12:54:05 +02:00
stack.yaml	Support subscriptions	2020-07-14 19:37:56 +02:00

README.md

Haskell GraphQL

GraphQL implementation in Haskell.

This implementation is relatively low-level by design, it doesn't provide any mappings between the GraphQL types and Haskell's type system and avoids compile-time magic. It focuses on flexibility instead, so other solutions can be built on top of it.

State of the work

For now this only provides a parser and a printer for the GraphQL query language and allows to execute queries and mutations using the given schema, but without the validation step. But the idea is to be a Haskell port of graphql-js.

For the list of currently missing features see issues marked as "not implemented".

Documentation

API documentation is available through Hackage.

You'll also find a small tutorial with some examples under docs/tutorial.

Further information

Contributing guidelines.
Changelog – this one contains the most recent changes; individual changelogs for specific versions can be found on Hackage.

Contact

Suggestions, contributions and bug reports are welcome.

Should you have questions on usage, please open an issue and ask – this helps to write useful documentation.