graphene-tornado

|Build Status| |Coverage Status|

graphene-tornado

A project for running Graphene <http://graphene-python.org/>__ on top of Tornado <http://www.tornadoweb.org/>__ in Python 2 and 3. The codebase is a port of graphene-django <https://github.com/graphql-python/graphene-django>__.

Getting started

Create a Tornado application and add the GraphQL handlers:

.. code:: python

import tornado.web from tornado.ioloop import IOLoop

from graphene_tornado.schema import schema from graphene_tornado.tornado_graphql_handler import TornadoGraphQLHandler

class ExampleApplication(tornado.web.Application):

   def __init__(self):
       handlers = [
           (r'/graphql', TornadoGraphQLHandler, dict(graphiql=True, schema=schema)),
           (r'/graphql/batch', TornadoGraphQLHandler, dict(graphiql=True, schema=schema, batch=True)),
           (r'/graphql/graphiql', TornadoGraphQLHandler, dict(graphiql=True, schema=schema))
       ]
       tornado.web.Application.__init__(self, handlers)

if name == 'main': app = ExampleApplication() app.listen(5000) IOLoop.instance().start()

When writing your resolvers, decorate them with either Tornado’s @coroutine decorator for Python 2.7:

.. code:: python

@gen.coroutine def resolve_foo(self, info): foo = yield db.get_foo() raise Return(foo)

Or use the async / await pattern in Python 3:

.. code:: python

async def resolve_foo(self, info): foo = await db.get_foo() return foo

.. |Build Status| image:: https://travis-ci.org/graphql-python/graphene-tornado.svg?branch=master :target: https://travis-ci.org/graphql-python/graphene-tornado .. |Coverage Status| image:: https://coveralls.io/repos/github/graphql-python/graphene-tornado/badge.svg?branch=master :target: https://coveralls.io/github/graphql-python/graphene-tornado?branch=master