Django GraphQL Extensions
|Pypi| |Build Status| |Codecov| |Codacy|
A collection of custom extensions for Django GraphQL
_
.. _Django GraphQL: https://github.com/graphql-python/graphene-django
Dependencies
- Python ≥ 3.6
- Django ≥ 2.0
- Graphene-django ≥ 3.0.0b1
Installation
Install last stable version from Pypi.
.. code:: sh
pip install django-graphql-extensions
Authentication
@login_required
@staff_member_required
@superuser_required
@permission_required
@user_passes_test
See the documentation
_ to know the full list of decorators.
.. _documentation: https://github.com/flavors/django-graphql-extensions/wiki/Decorators
.. code:: python
from django.contrib.auth import get_user_model
import graphene
from graphql_extensions.decorators import (
login_required, staff_member_required,
)
class Query(graphene.ObjectType):
viewer = graphene.Field(UserType)
users = graphene.List(UserType)
@login_required
def resolve_viewer(self, info, **kwargs):
return info.context.user
@staff_member_required
def resolve_users(self, info, **kwargs):
return get_user_model().objects.all()
Errors
Returning appropriate error responses and masking error messages sent to the client.
Configure your GraphQLView
.
.. code:: python
from django.urls import include, path
from graphql_extensions.views import GraphQLView
urlpatterns = [
path('', GraphQLView.as_view(), name='index'),
]
Exceptions
.. code:: python
from graphql_extensions import exceptions
exceptions.GraphQLError
exceptions.PermissionDenied
exceptions.ValidationError
exceptions.NotFound
Payload
.. code:: js
{
"errors": [
{
"message": "You do not have permission to perform this action",
"locations": [
{
"line": 3,
"column": 13
}
],
"path": [
"viewer"
],
"extensions": {
"type": "PermissionDenied",
"code": "permissionDenied",
"timestamp": 1622783872,
"data": {},
"operation": "QUERY",
"trace": [
" File \"site-packages/graphql/execution/execute.py\", line 617, in resolve_field\n result = resolve_fn(source, info, **args)\n",
" File \"graphql_extensions/decorators.py\", line 23, in wrapper\n return func(info.context, *args, **kwargs)\n",
" File \"graphql_extensions/decorators.py\", line 35, in wrapper\n raise exc\n"
]
}
}
],
"data": {
"viewer": null
}
}
Writing tests
This package includes a subclass of unittest.TestCase <https://docs.python.org/3/library/unittest.html#unittest.TestCase>
__ SchemaTestCase
and improve support for making GraphQL queries.
.. code:: python
from django.contrib.auth import get_user_model
from graphql_extensions.test import SchemaTestCase
class UsersTests(SchemaTestCase):
def test_create_user(self):
query = '''
mutation CreateUser($username: String!, $password: String!) {
createUser(username: $username, password: $password) {
user {
id
}
}
}'''
response = self.client.execute(query, {
'username': 'test',
'password': 'dolphins',
})
self.assertFalse(response.errors)
self.assertTrue(response.data['user'])
def test_viewer(self):
user = get_user_model().objects.create_user(
username='test',
password='dolphins',
)
self.client.authenticate(self.user)
query = '''
{
viewer {
username
}
}'''
response = self.client.execute(query)
data = response.data['viewer']
self.assertEqual(data['username'], user.username)
Types
Custom Graphene types.
.. |Pypi| image:: https://img.shields.io/pypi/v/django-graphql-extensions.svg
:target: https://pypi.python.org/pypi/django-graphql-extensions
:alt: Pypi
.. |Build Status| image:: https://travis-ci.com/flavors/django-graphql-extensions.svg?branch=master
:target: https://travis-ci.com/flavors/django-graphql-extensions
:alt: Build Status
.. |Codecov| image:: https://codecov.io/gh/flavors/django-graphql-extensions/branch/master/graph/badge.svg
:target: https://codecov.io/gh/flavors/django-graphql-extensions
:alt: Codecov
.. |Codacy| image:: https://app.codacy.com/project/badge/Grade/95cb35fad84c4560973181a22352ac4b
:target: https://www.codacy.com/gh/flavors/django-graphql-extensions/dashboard?utm_source=github.com&utm_medium=referral&utm_content=flavors/django-graphql-extensions&utm_campaign=Badge_Grade
:alt: Codacy