Graphene is a Python library for building GraphQL schemas/types fast and easily.
Easy to use: Graphene helps you use GraphQL in Python without effort.
Relay: Graphene has builtin support for Relay
Django: Automatic Django model mapping to Graphene Types. Check a fully working Django implementation
But, what is supported in this Python version? Everything: Interfaces, ObjectTypes, Mutations and Relay (Nodes, Connections and Mutations).
Installation
For instaling graphene, just run this command in your shell
pip install graphene
# Or in case of need Django model support
pip install graphene[django]
Examples
Here is one example for get you started:
class Query(graphene.ObjectType):
hello = graphene.StringField(description='A typical hello world')
ping = graphene.StringField(description='Ping someone',
to=graphene.Argument(graphene.String))
def resolve_hello(self, args, info):
return 'World'
def resolve_ping(self, args, info):
return 'Pinging {}'.format(args.get('to'))
schema = graphene.Schema(query=Query)
Then Querying graphene.Schema is as simple as:
query = '''
query SayHello {
hello
ping(to:"peter")
}
'''
result = schema.execute(query)
If you want to learn even more, you can also check the following examples:
Basic Schema: Starwars example
Relay Schema: Starwars Relay example
Django model mapping: Starwars Django example
Contributing
After cloning this repo, ensure dependencies are installed by running:
python setup.py install
After developing, the full test suite can be evaluated by running:
python setup.py test # Use --pytest-args="-v -s" for verbose mode
Release files for graphene 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| graphene-0.3.0.tar.gz | 22.7 kB | Details |
Release files / graphene-0.3.0.tar.gz
| Download URL | graphene-0.3.0.tar.gz |
|---|---|
| Size | 22.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cd9f3baf32c5154e5ba79fff91c22d26d16e8f65ca4ed53f77610ea571c47f7a
|
|
BLAKE2b-256 checksum How to use checksums |
9c5506b5016358090e8daf86035aaaa8f436bea7ccdf8fbed526146bd110bc57
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |