convert README.md to rst (#10)

Author: ewhauser

README.rst

@@ -0,0 +1,61 @@
+|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