Core GraphQL Library for Python

This in Beta status. Use in production at your own caution.

We are currently focusing on porting 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.7 of the reference implementation.

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-core

graphql-core supports the following Python versions:

• 2.7.x
• 3.3.x
• 3.4.x
• 3.5.0
• pypy-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.

graphql-core provides a more low-level API for building a GraphQL API and schema. For a more refined and Pythonic interface to build graphql APIs, check out graphene.

• @jhgg

For an up to date list of contributors, check the contributor list here.

MIT License

This project is a community fork of graphqllib by @dittos.