cmmartti/fractal-style-schema

An example of a Graphene-Python GraphQL schema where each entity is in its own module.

Fractal-Style GraphQL Schema

This is an example of a fractal style GraphQL schema for Graphene-Python, where each entity is in its own module. Within each module are mutation, type, query, subscription, resolvers etc. files that contain all of the types, queries, mutations, etc. for that entity. This organisation method avoids the issue of overly-long schema files that contain dozens or hundreds of types and resolvers.

This specific example is a simple read-only query API for video games and characters.

The graphql_api.auto.schema_operations_builder function assembles each part into a whole Query/Mutation, which can then be passed to graphene.Schema to create a schema.

Circular dependencies are met using Graphene's lazy_import utility function.

Setup

This GraphQL API is built on Django. Follow the steps below to run it on your machine:

1. Create a Python virtual environment:

   Python2: virtualenv venv

   Python3: python venv venv

2. Activate the virtual environment:

   Windows: venv\Scripts\activate

   *nix: source venv/bin/activate

3. Install dependencies:

   pip install -r requirements.txt

4. Start the dev server:

   python manage.py runserver

5. Open your browser to localhost:8000/graphql to view the GraphiQL IDE.

---

Based on code examples by ahopkins (Adam Hopkins) and ProjectCheshire (Jessamyn Hodge).

fractal-style-schema's Issues

Mutation example

please, could you give an example of mutation?

`auto` module catches all ImportErrors

The auto module silently catches all ImportErrors that occur past that point, even ones that happen in other modules. For example, if the auto module is trying to import module A in the try block, but module A tries to import a non-existent module X, module A is silently skipped.