Core GraphQL Library for Python
This library is a port of graphql-js to Python.
This library includes core features only that other packages within the graphql-python organization shall build upon.
We are currently targeting feature parity with v0.4.13 of the reference implementation, and are currently on v0.4.12.
Please see issues for the progress.
An overview of the GraphQL language is available in the README for the Specification for GraphQL. The overview describes a simple set of GraphQL examples that exist as tests in this repository. A good way to get started is to walk through that README and the corresponding tests in parallel.
Install from pip:
pip install graphql-coregraphql-core supports the following Python versions:
2.7.x3.3.x3.4.x3.5.0pypy-2.6.1
Support for 3.5.0's asyncio module for concurrent execution is available via an executor middleware at
graphql.core.execution.middlewares.asyncio.AsyncioExecutionMiddleware.
Additionally, support for gevent is available via
graphql.core.execution.middlewares.gevent.GeventExecutionMiddleware.
Otherwise, by default, the executor will use execute with no concurrency.
Documentation is in the works but not available yet. See #14 for additional information.
For a more refined and Pythonic interface to build graphql APIs, check out
graphene- Easy to use: Graphene helps you use GraphQL in Python without effort.
- Relay: Graphene has builtin support for Relay
- Django: Automatic Django model mapping to Graphene Types. Check a fully working Django implementation
graphql-epoxy- Minimal Boilerplate: You can create a GraphQL schema and execute it in less than 5 lines of code.
- Definition Ordering: It doesn't matter. Define your objects in any order you want. Epoxy will take care of the rest.
- Quick: Once you create your schema, epoxy doesn't get in the way. Your resolvers will be called directly by
graphql-corewith no additional indirection.
For an up to date list of contributors, check the contributor list here.
This project is a community fork of graphqllib by @dittos.