Welcome! Whether you are a GraphQL newbie or experienced veteran, Tartiflette will help you to build a powerful GraphQL API.
This tutorial will explain to you the main features of Tartiflette as well as some more advanced ones (dynamic introspection, SDL directives & more).
What are we doing?
Nothing is better than coding to understand a library. In this tutorial, we will develop our own Tartiflette recipes manager served by an awesome GraphQL API.
Here are the topics we will cover during this tutorial:
- install the Tartiflette library (and sub-dependencies)
- declare your schema using the SDL (Schema Definition Language)
- create a Tartiflette (Server) instance
- write Query, Mutation, and Subscription resolvers
- run Query, Mutation and Subscription requests
- declare and use custom directives (Advanced)
- secure nodes with directives (Advanced)
- expose different portions of the schema in the introspection based on context (dynamic introspection) (Advanced)
The tutorial's end result is available on GitHub at tartiflette-aiohttp-tutorial.
We assume that you are familiar with Python 3.6+,
asyncio and more generally with asynchronous development. We do not plan to link this tutorial with other technologies like RDBMS (MySQL, Postgres etc ...). We will keep this tutorial focused on
Moreover, we will intensively use the command line to manipulate files or launch commands.
Make sure that your setup contains:
- Python 3.6+ via Pipenv
- a package manager (e.g:
homebrewon macOS or
Do you need help?
If you are ever feeling lost or do not understand a concept, join the Tartiflette community on Slack (with luck, some of the Tartiflette maintainers will be there).