Metadata-Version: 2.1
Name: Rest_Framework_Auth_Toolkit
Version: 0.10
Summary: Simple + flexible signup and login for Django APIs
Home-page: https://github.com/caravancoop/rest-framework-auth-toolkit
License: UNKNOWN
Author: Caravan Coop
Author-email: hi@caravan.coop
Description-Content-Type: text/markdown
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Framework :: Django :: 1.11
Classifier: Framework :: Django :: 2.0
Classifier: Framework :: Django :: 2.1
Requires-Dist: django >= 1.11
Requires-Dist: facepy; extra == "facebook"
Provides-Extra: .none
Provides-Extra: facebook

```
                     __                   __  __         __              ____   _ __
     ________  _____/ /_     ____ ___  __/ /_/ /_       / /_____  ____  / / /__(_) /_
    / ___/ _ \/ ___/ __/ ___/ __ `/ / / / __/ __ \  ___/ __/ __ \/ __ \/ / //_/ / __/
   / /  /  __(__  ) /_  /__/ /_/ / /_/ / /_/ / / / /__/ /_/ /_/ / /_/ / / ,< / / /_
  /_/   \___/____/\__/     \__,_/\__,_/\__/_/ /_/     \__/\____/\____/_/_/|_/_/\__/

```

This libary provides mixins and views to handle signup, login and
logout in an API built with django-rest-framework.  After login,
client applications get a token for the API requests.

Email-based signups are supported out of the box.
Other methods require you to specify an extra in your requirements;
for example, to use Facebook login you need to depend on
`rest-framework-auth-toolkit[facebook]`.

Contrary to other similar modules, rest-auth-toolkit doess not provide
a set of Django apps to include and configure in your settings, but a
collection of mixins, base classes, base views and simple templates
that you can integrate and customize in your own apps.

See the [demo](demo/) app for example usage.

⚠️ This library is not stable yet, make sure to pin your dependencies.
Recommended form: `rest-framework-auth-toolkit == 0.9.*`

See the [changelog](CHANGELOG.md) for breaking changes.


## Contributing

To run tests:

```
export DATABASE_URL=postgres://ratk@localhost:5432/ratk
tox
```

You will have to create the `ratk` role first, as well as
the `ratk` and `test_ratk` databases.

