django-graphql-persist 0.0.1.dev0

Dependencies

• Django ≥ 1.11

• Python ≥ 3.4

Installation

Install last stable version from Pypi.

pip install django-graphql-persist

Include the PersistMiddleware middleware in your MIDDLEWARE settings:

MIDDLEWARE = [
    ...
    'graphql_persist.middleware.PersistMiddleware',
    ...
]

Configure the list of directories searched for GraphQL SDL definitions.

GRAPHQL_PERSIST = {
    'DOCUMENTS_DIRS': [
        '/app/documents',
    ],
}

Schema definition

/app/documents/schema.graphql

query GetViewer {
  viewer {
    ...userFields
  }
}

query GetUsers {
  users {
    ...userFields
  }
}

fragment userFields on UserType {
  id
  email
}

Query by “id”

{
  "id": "schema",
  "operationName": "GetViewer",
  "variables": {}
}

Operations definition

The server needs to do less processing to parse the query and verify the parameters.

/app/documents/GetViewer.graphql

query GetViewer {
  viewer {
    ...userFields
  }
}

fragment userFields on UserType {
  id
  email
}

Query by “operationName”

{
  "operationName": "GetViewer",
  "variables": {}
}

Settings

Here’s a list of settings available in Django-graphql-persist and their default values.

DOCUMENTS_DIRS

List of directories searched for GraphQL SDL definitions
Default: None

CACHE_NAME

This selects the cache to use.
Default: 'default'

CACHE_TIMEOUT

The timeout, in seconds, to use for the cache (infinite by default).
Default: None

KEY_PREFIX

A string that will be automatically prepended to all cache keys used for persisted queries.
Default: 'persist'

CACHE_KEY_HANDLER

...
Default: lambda document_id, request: document_id

PERSISTED_RESPONSE_HANDLER

...
Default: None