allianceauth-graphql 0.2.0

GraphQL integration for AllianceAuth

allianceauth-graphql

GraphQL integration for AllianceAuth

Free software: GNU General Public License v3

Usage

This version is still in pre-alpha, as of v0.1.1 it does nothing.

Setup

The following is assuming you have a functioning AllianceAuth installation.

Install plugin

1. pip install allianceauth-graphql.

2. Add the following apps to the bottom of your INSTALLED_APPS in the local.py settings file:

   'allianceauth_graphql',
   'graphene_django',
   

3. Add the following settings to your local.py file:

   from datetime import timedelta
   
   # ...
   
   GRAPHENE = {
       'SCHEMA': 'allianceauth_graphql.schema.schema',
       "MIDDLEWARE": [
           "graphql_jwt.middleware.JSONWebTokenMiddleware",
       ],
   }
   
   AUTHENTICATION_BACKENDS += [
       "graphql_jwt.backends.JSONWebTokenBackend",
   ]
   
   GRAPHQL_JWT = {
       "JWT_VERIFY_EXPIRATION": True,
       "JWT_EXPIRATION_DELTA": timedelta(days=1),
   }
   

4. Edit your projects url.py file:

   It should looks something like this

   from django.conf.urls import include, url
   from allianceauth import urls
   
   urlpatterns = [
       url(r'', include(urls)),
   ]
   
   handler500 = 'allianceauth.views.Generic500Redirect'
   handler404 = 'allianceauth.views.Generic404Redirect'
   handler403 = 'allianceauth.views.Generic403Redirect'
   handler400 = 'allianceauth.views.Generic400Redirect'
   

   After the edit:

   from django.conf.urls import include, url
   from allianceauth import urls
   from allianceauth_graphql import urls as aa_gql_urls
   
   urlpatterns = [
       url(r'', include(urls)),
       url(r'graphql/', include(aa_gql_urls)),
   ]
   
   handler500 = 'allianceauth.views.Generic500Redirect'
   handler404 = 'allianceauth.views.Generic404Redirect'
   handler403 = 'allianceauth.views.Generic403Redirect'
   handler400 = 'allianceauth.views.Generic400Redirect'
   

5. Restart AllianceAuth.

Settings

Setting	Default	Description
SHOW_GRAPHIQL	True	Shows the graphiql UI in the browser
GRAPHQL_LOGIN_SCOPES	['publicData']	Tokens needed. Unlike AllianceAuth pages, you need to login with the scopes you'll use, otherwise you won't be able to perform some queries

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

History

v0.2.0

* Working login with django-graphql-jwt

v0.1.1 (2022-04-02)

* Working /graphql/ endpoint and updated requirements.

v0.1.0 (2022-03-18)

* First release on PyPI.