aiohttp-graphql
Adds GraphQL support to your aiohttp application.
Based on flask-graphql by Syrus Akbary and sanic-graphql by Sergey Porivaev.
Usage
Just use the GraphQLView
view from aiohttp_graphql
from aiohttp_graphql import GraphQLView
GraphQLView.attach(app, schema=Schema, graphiql=True)
# Optional, for adding batch query support (used in Apollo-Client)
GraphQLView.attach(app, schema=Schema, batch=True)
This will add a /graphql
endpoint to your app (customizable by passing route_path='/mypath'
to GraphQLView.attach
).
Note: GraphQLView.attach
is just a convenience function, and the same functionality can be acheived with
gql_view = GraphQLView(schema=Schema, **kwargs)
app.router.add_route('*', gql_view, name='graphql')
It's worth noting that the the "view function" of GraphQLView
is contained in GraphQLView.__call__
. So, when you create an instance, that instance is callable with the request object as the sole positional argument. To illustrate:
gql_view = GraphQLView(schema=Schema, **kwargs)
gql_view(request) # <-- the instance is callable and expects a `aiohttp.web.Request` object.
Supported options
schema
: TheGraphQLSchema
object that you want the view to execute when it gets a valid request.executor
: TheExecutor
that you want to use to execute queries. If anAsyncioExecutor
instance is provided, performs queries asynchronously within executor’s loop.root_value
: Theroot_value
you want to provide toexecutor.execute
.context
: A value to pass as thecontext
to thegraphql()
function. By default is set todict
with request object at keyrequest
.pretty
: Whether or not you want the response to be pretty printed JSON.graphiql
: IfTrue
, may present GraphiQL when loaded directly from a browser (a useful tool for debugging and exploration).graphiql_version
: The version of the providedgraphiql
package.graphiql_template
: Inject a Jinja template string to customize GraphiQL.middleware
: Custom middleware for graphql-python.batch
: Set the GraphQL view as batch (for using in Apollo-Client or [ReactRelayNetworkLayer])jinja_env
: Sets jinja environment to be used to process GraphiQL template. If Jinja’s async mode is enabled (byenable_async=True
), usesTemplate.render_async
instead ofTemplate.render
. If environment is not set, fallbacks to simple regex-based renderer.max_age
: sets the response headerAccess-Control-Max-Age
for preflight requestsencoder
: the encoder to use for responses (sensibly defaults tographql_server.json_encode
)error_formatter
: the error formatter to use for responses (sensibly defaults tographql_server.default_format_error
)enable_async
: whetherasync
mode will be enabled.
Testing
Testing is done with pytest
.
git clone https://github.com/dfee/aiohttp-graphql
cd aiohttp-graphql
# Create a virtualenv
python3.6 -m venv env && source env/bin/activate # for example
pip install -e .[test]
pytest
The tests, while modeled after sanic-graphql's tests, have been entirely refactored to take advantage of pytest-asyncio
, conform with PEP-8, and increase readability with pytest fixtures. For usage tests, please check them out.
License
Copyright for portions of project aiohttp-graphql are held by Syrus Akbary as part of project flask-graphql and sanic-graphql as part of project Sergey Porivaev. All other claims to this project aiohttp-graphql are held by Devin Fee.
This project is licensed under the MIT License.