v1.0 Upgrade Guide

Big changes from v0.10.x to 1.0. While on the surface a lot of this just looks like shuffling around API, the entire codebase has been rewritten to handle some really great use cases and improved performance.

Backwards Compatibility and Deprecation Warnings

This has been a community project from the start, we need your help making the upgrade as smooth as possible for everybody! We have done our best to provide backwards compatibility with deprecated APIs.

Interfaces

For implementing an Interface in a ObjectType, you have to it onto Meta.interfaces.

Like:

from graphene import Interface, ObjectType, String

class Character(Interface):
    name = String()

class Human(Character): # Old way, Human will still be an Interface
    pass

class Droid(ObjectType): # New way, you have to specify the ObjectType
    class Meta:
        interfaces = (Character, )

Mutations

Mutation fields have changed the way of usage, before if you have the mutation MyMutation you only have to reference with graphene.Field(MyMutation) now it's simply MyMutation.Field()

Example:

from graphene import ObjectType, Mutation, String

class ReverseString(Mutation):
    class Input:
        input = String(required=True)

    reversed = String()

    def mutate(self, args, context, info):
        reversed = args.get('input')[::-1]
        return ReverseString(reversed=reversed)

class Query(ObjectType):
    reverse_string = graphene.Field(ReverseString) # Old way, will not include the mutation arguments by default
    reverse_string = ReverseString.Field()

Nodes

Apart of implementing as showed in the previous section, for use the node field you have to specify the node Type.

Example:

from graphene import ObjectType, relay

class Query(ObjectType):
    node = relay.NodeField() # Old way, NodeField no longer exists. Use Node.Field
    node = relay.Node.Field() # New way

Also, if wanted to create an ObjectType that implements Node, you have to do it explicity.

Django

The Django integration with Graphene now have an independent package: graphene-django. For installing, you have to replace the old graphene[django] with graphene-django.

As the package is now independent, you have to import now from graphene_django.
DjangoNode no longer exists, please use relay.Node instead:

from graphene.relay import Node
from graphene_django import DjangoObjectType

class Droid(DjangoObjectType):
    class Meta:
        interfaces = (Node, )

SQLAlchemy

The SQLAlchemy integration with Graphene now have an independent package: graphene-sqlalchemy. For installing, you have to replace the old graphene[sqlalchemy] with graphene-sqlalchemy.

As the package is now independent, you have to import now from graphene_sqlalchemy.
SQLAlchemyNode no longer exists, please use relay.Node instead:

from graphene.relay import Node
from graphene_sqlalchemy import SQLAlchemyObjectType

class Droid(SQLAlchemyObjectType):
    class Meta:
        interfaces = (Node, )

3.0 KiB Raw Blame History