Instant Graphql API for MongoDb with Mongoke

When creating a new project (usually a web service of some sort) i try to create a MVP (minimum viable product) as fast as possible.
To do that i try to use tools that generate code for me or speed up development.
One task that always takes a lot of time is the creation of the graphql query layer: creating the graphql service, connect it to the database and add authorization.

This task is so boring that i decided to create a service that does it automatically for me.
So i created Mongoke, it is a docker image that generates a totally functional graphql api for you.
Mongoke generates a service written in python that supports among the many features:

• powerful optimized queries
• relay style pagination
• authorization via your jwt
• apollo federation to be able to integrate other graphql services

Mongoke works thanks to a yaml configuration like the following:

# ./mongoke.yml skema: | User: _id: ObjectId username: Str email: Str BlogPost: _id: ObjectId author_id: ObjectId title: Str content: Str tags: [ code: Str ] types: User: collection: users BlogPost: collection: posts relations: - field: posts from: User to: BlogPost relation_type: to_many where: author_id: ${{ parent['_id'] }} 

Here we are configuring a graphql service to create tha api of a blog site.
The configuration is divided in 3 main steps:

• skema: This is where you describe the mongodb schema, it is written in the skema language, a DSL that compiles to grpahql and json-schema. The syntax is quite simple, object types are defined just like in yaml and you can also write inline list types. The skema built in types are Str, Int, Float, Bool, Any and Mongoke adds support for the mongodb ObjectId type.
• types: here we connect the database types to their collection names, you can add authorization guards here.
• relations: here are declared the relations to add to other types, to connect the different types you write the where query and you can evaluate the python code inside ${{ }} to access the connected type.

Then to start the graphql api you use docker-compose with the docker mongoke image, here i am also using the mongoke/populate-mongo image that populates the mongodb database with mock data generated from the above configuration.

 version: '3' services: mongoke: ports: - 8090:80 image: mongoke/mongoke:latest environment: - DB_URL=mongodb://mongo/db volumes: - ./mongoke.yml:/conf.yml populate-db: image: mongoke/populate-mongo volumes: - ./mongoke.yml/:/conf.yml environment: - DB_URL=mongodb://mongo/db mongo: image: mongo logging: driver: none 

Then execute docker-compose up and you have a working graphql api at http://localhost:8090/graphiql

This is an example query that you can execute:

{ user(where: {username: {neq: "hidden"}}) { username email posts(first: 10, cursorField: title) { nodes { title tags { code } } } } } 

You can extend the configration above to add authorization, more relations, more complex simply changing the yaml config and relaunching docker-compose.

See more examples and documentation on github