Document an example of async usage?

[ajhyndman]

I'm not an expert in the python ecosystem, and am not sure what's required from me to support asynchronous resolvers in an Ariadne schema. If it's possible, I'd love a brief example illustrating a working async resolver!

---

What I've tried so far (using python 3.7):

from aiodataloader import DataLoader
from ariadne import ResolverMap, gql, start_simple_server

# DATA LOADERS
heroesLoader = HeroesLoader()

class HeroesLoader(DataLoader):
    async def batch_load_fn(self, keys):
        # return await batch_get_heroes()

# SCHEMA DEFINITION
type_defs = gql("""
type Query {
    heroes: [Hero!]!
}

type Hero {
    name: String!
    shortName: String
    title: String
}
""")

# RESOLVERS
query = ResolverMap("Query")
hero = ResolverMap("Hero")

@query.field("heroes")
async def resolve_heroes(*_):
    return await heroesLoader.load('_')

start_simple_server(type_defs, [query, hero])

[rafalp]

Hello,

start_simple_server is purely synchronous at this time, so you can't use async with it, but we have changes in the pipeline introducing proper support for async simple server we want to ship in next release:

• Split WSGI app into two, namespace it #100
• https://github.com/patrys/starlette-ariadne

[ajhyndman]

Cool! So I would need to implement my own WSGI layer which supports async execution, until that lands?

Also, I would love to get involved and help out with this project. Do you think there are any good starting points. in which I might be at all helpful?

[rafalp]

If you don't need subscriptions in your GraphQL server, you can create custom WSGI middleware inheriting from GraphQLMiddleware's but using graphql instead of graphql_sync for query execution: https://github.com/mirumee/ariadne/blob/master/ariadne/wsgi_middleware.py#L154

[rafalp]

If you want to help, please take a look on issues marked with Help wanted.

[ajhyndman]

I'll close this issue, since it looks like it's already on the team's radar!