mirror of
https://github.com/graphql-python/graphene.git
synced 2024-11-30 05:23:57 +03:00
69 lines
1.8 KiB
Markdown
69 lines
1.8 KiB
Markdown
# 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 add also `ObjectType`.
|
|
|
|
Like:
|
|
|
|
```python
|
|
from graphene import Interface, ObjectType, String
|
|
|
|
class Character(Interface):
|
|
name = String()
|
|
|
|
class Human(Character): # Old way, not working anymore
|
|
pass
|
|
|
|
class Droid(Character, ObjectType): # New way, you have to specify the ObjectType
|
|
pass
|
|
```
|
|
|
|
## 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:
|
|
|
|
```python
|
|
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, not working anymore
|
|
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:
|
|
|
|
```python
|
|
from graphene import ObjectType, relay
|
|
|
|
class Query(ObjectType):
|
|
node = relay.NodeField() # Old way, NodeField no longer exists
|
|
node = relay.Node.Field() # New way
|
|
``` |