Metadata-Version: 2.0
Name: django-graph-auth
Version: 0.2.0
Summary: django-graph-auth is a Django application which provides simple mutations and queries for managing users with GraphQL.
Home-page: https://github.com/morgante/django-graph-auth
Author: Morgante Pell
Author-email: morgante.pell@morgante.net
License: MIT License
Keywords: django graphql api authentication jwt
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.8
Classifier: Framework :: Django :: 1.9
Classifier: Framework :: Django :: 1.10
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules

django-graph-auth
=======================

django-graph-auth is a Django application which provides simple mutations and queries for managing users with GraphQL. It can register users, log in, reset users, and expose `JSON web tokens`_.

Documentation can be found on `GitHub`_.

.. _Django Rest Framework: http://www.django-rest-framework.org/

.. _JSON web tokens: http://getblimp.github.io/django-rest-framework-jwt/

.. _GitHub: https://github.com/morgante/django-graph-auth/blob/master/docs/api.md

Requirements
------------

This has only been tested with:

* Python: 3.5
* Django: 1.10

Setup
-----

Install from **pip**:

.. code-block:: sh

    pip install django-graph-auth

and then add it to your installed apps:

.. code-block:: python

    INSTALLED_APPS = (
        ...
        'graph_auth',
        ...
    )

You will also need to edit your base schema to import the mutations and queries, like this:

.. code-block:: python

	import graphene
	from graphene import relay, ObjectType

	import graph_auth.schema

	class Query(graph_auth.schema.Query, ObjectType):
	    node = relay.Node.Field()

	class Mutation(graph_auth.schema.Mutation, ObjectType):
	    pass

	schema = graphene.Schema(query=Query, mutation=Mutation)


Credits
-------

``django-graph-auth`` was created by Morgante Pell (`@morgante
<https://github.com/morgante>`_). It is based on `django-rest-auth`_.

.. _django-rest-auth: https://github.com/Tivix/django-rest-auth


History
=======

Pending
-------

* New release notes go here.

0.2.0 (2016-10-10)
-----------------

* Add `USER_FIELDS` setting to enable customization of which fields are exposed on users.

0.1.0 (2016-10-10)
-----------------

* Initial release


