For two of my GraphQL mutations, I want to have my create and update functions use the same input parameters, but update with an additional "id" field. I strongly believe in "don't repeat yourself", so I would like to create one dict or class that they can both use/inherit, and be able to add the "id" to the update function. If I decide to add new parameters, I want both mutations to be affected with minimal code updates. I tried a few things, but none worked. After looking at the code, I saw that there was a simple fix that would allow me to use a dictionary and be able to do this: ```UserParameters = { "name": graphene.String(), "email": graphene.String(), ... } UserCreate(graphene.Mutation): Arguments = { **UserParameters, "password": graphene.String() } ... UserUpdate(graphene.Mutation): Arguments = { **UserParameters, "id": graphene.ID(required=True) } ... ``` I don't know if there was another way to achieve this result with the current method of creating the argument inputs. If anyone has a more Pythonic or elegant way to achieve this result, I'm open to ideas. |
||
---|---|---|
bin | ||
docs | ||
examples | ||
graphene | ||
.coveragerc | ||
.editorconfig | ||
.gitignore | ||
.travis.yml | ||
LICENSE | ||
MANIFEST.in | ||
mypy.ini | ||
README.md | ||
README.rst | ||
setup.cfg | ||
setup.py | ||
tox.ini | ||
UPGRADE-v1.0.md | ||
UPGRADE-v2.0.md |
Please read UPGRADE-v2.0.md to learn how to upgrade to Graphene 2.0
.
Graphene

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.
- Data agnostic: Graphene supports any kind of data source: SQL (Django, SQLAlchemy), NoSQL, custom Python objects, etc. We believe that by providing a complete API you could plug Graphene anywhere your data lives and make your data available through GraphQL.
Integrations
Graphene has multiple integrations with different frameworks:
integration | Package |
---|---|
Django | graphene-django |
SQLAlchemy | graphene-sqlalchemy |
Google App Engine | graphene-gae |
Peewee | In progress (Tracking Issue) |
Also, Graphene is fully compatible with the GraphQL spec, working seamlessly with all GraphQL clients, such as Relay, Apollo and gql.
Installation
For instaling graphene, just run this command in your shell
pip install "graphene>=2.0"
2.0 Upgrade Guide
Please read UPGRADE-v2.0.md to learn how to upgrade.
Examples
Here is one example for you to get started:
class Query(graphene.ObjectType):
hello = graphene.String(description='A typical hello world')
def resolve_hello(self, info):
return 'World'
schema = graphene.Schema(query=Query)
Then Querying graphene.Schema
is as simple as:
query = '''
query SayHello {
hello
}
'''
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
Contributing
After cloning this repo, ensure dependencies are installed by running:
pip install -e ".[test]"
After developing, the full test suite can be evaluated by running:
py.test graphene --cov=graphene --benchmark-skip # Use -v -s for verbose mode
You can also run the benchmarks with:
py.test graphene --benchmark-only
Documentation
The documentation is generated using the excellent Sphinx and a custom theme.
The documentation dependencies are installed by running:
cd docs
pip install -r requirements.txt
Then to produce a HTML version of the documentation:
make html