Graphene-Django
Graphene-Django is an open-source library that provides seamless integration between Django, a high-level Python web framework, and Graphene, a library for building GraphQL APIs. The library allows developers to create GraphQL APIs in Django quickly and efficiently while maintaining a high level of performance.
Features
- Seamless integration with Django models
- Automatic generation of GraphQL schema
- Integration with Django's authentication and permission system
- Easy querying and filtering of data
- Support for Django's pagination system
- Compatible with Django's form and validation system
- Extensive documentation and community support
Installation
To install Graphene-Django, run the following command:
pip install graphene-django
Configuration
After installation, add 'graphene_django' to your Django project's INSTALLED_APPS list and define the GraphQL schema in your project's settings:
INSTALLED_APPS = [
# ...
'graphene_django',
]
GRAPHENE = {
'SCHEMA': 'myapp.schema.schema'
}
Usage
To use Graphene-Django, create a schema.py file in your Django app directory and define your GraphQL types and queries:
import graphene
from graphene_django import DjangoObjectType
from .models import MyModel
class MyModelType(DjangoObjectType):
class Meta:
model = MyModel
class Query(graphene.ObjectType):
mymodels = graphene.List(MyModelType)
def resolve_mymodels(self, info, **kwargs):
return MyModel.objects.all()
schema = graphene.Schema(query=Query)
Then, expose the GraphQL API in your Django project's urls.py file:
from django.urls import path
from graphene_django.views import GraphQLView
from . import schema
urlpatterns = [
# ...
path('graphql/', GraphQLView.as_view(graphiql=True)), # Given that schema path is defined in GRAPHENE['SCHEMA'] in your settings.py
]
Testing
Graphene-Django provides support for testing GraphQL APIs using Django's test client. To create tests, create a tests.py file in your Django app directory and write your test cases:
from django.test import TestCase
from graphene_django.utils.testing import GraphQLTestCase
from . import schema
class MyModelAPITestCase(GraphQLTestCase):
GRAPHENE_SCHEMA = schema.schema
def test_query_all_mymodels(self):
response = self.query(
'''
query {
mymodels {
id
name
}
}
'''
)
self.assertResponseNoErrors(response)
self.assertEqual(len(response.data['mymodels']), MyModel.objects.count())
Contributing
Contributions to Graphene-Django are always welcome! To get started, check the repository's issue tracker and contribution guidelines.
License
Graphene-Django is released under the MIT License.
Resources
- Official GitHub Repository
- Graphene Documentation
- Django Documentation
- GraphQL Specification
- GraphiQL - An in-browser IDE for exploring GraphQL APIs
- Graphene-Django Community - Join the community to discuss questions and share ideas related to Graphene-Django
Tutorials and Examples
- Official Graphene-Django Tutorial
- Building a GraphQL API with Django and Graphene-Django
- Real-world example: Django, Graphene, and Relay
Related Projects
- Graphene - A library for building GraphQL APIs in Python
- Graphene-SQLAlchemy - Integration between Graphene and SQLAlchemy, an Object Relational Mapper (ORM) for Python
- Graphene-File-Upload - A package providing an Upload scalar for handling file uploads in Graphene
- Graphene-Subscriptions - A package for adding real-time subscriptions to Graphene-based GraphQL APIs
Support
If you encounter any issues or have questions regarding Graphene-Django, feel free to submit an issue on the official GitHub repository. You can also ask for help and share your experiences with the Graphene-Django community on 💬 Discord
Release Notes
3 maintainers
Metadata
3 maintainers
Release files for graphene-django 3.2.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| graphene-django-3.2.3.tar.gz | 88.4 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| graphene_django-3.2.3-py2.py3-none-any.whl | Python 3, Python 2 | none | any | Details |
Total release size: 203.4 kB
Release files / graphene-django-3.2.3.tar.gz
| Download URL | graphene-django-3.2.3.tar.gz |
|---|---|
| Size | 88.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d831bfe8e9a6e77e477b7854faef4addb318f386119a69ee4c57b74560f3e07d
|
|
BLAKE2b-256 checksum How to use checksums |
6f7a8aef131349329dcd167578720f6364412f1728bfda14bba22c1e7b5d8365
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Release files / graphene_django-3.2.3-py2.py3-none-any.whl
| Download URL | graphene_django-3.2.3-py2.py3-none-any.whl |
|---|---|
| Size | 115.0 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
0c673a4dad315b26b4d18eb379ad0c7027fd6a36d23a1848b7c7c09a14a9271e
|
|
BLAKE2b-256 checksum How to use checksums |
1835ab9c668222f6271a0b71efb147c46816229dbb9fa5d15ee6b025eb08d4b2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Security for graphene-django 3.2.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
