<commit_before>Django OAuth Toolkit
====================

*OAuth2 goodies for the Djangonauts!*

.. image:: https://travis-ci.org/evonove/django-oauth-toolkit.png
   :alt: Build Status
   :target: https://travis-ci.org/evonove/django-oauth-toolkit
.. image:: https://coveralls.io/repos/evonove/django-oauth-toolkit/badge.png
   :alt: Coverage Status
   :target: https://coveralls.io/r/evonove/django-oauth-toolkit

If you are facing one or more of the following:
 * Your Django app needs to interact with an OAuth2 authorization server to access 3rd party resources,
 * Your Django app exposes a web API you want to protect with OAuth2 authentication,
 * You need to implement an OAuth2 authorization server to provide tokens management for your infrastructure,

Django OAuth Toolkit can help you providing out of the box all the endpoints, data and logic needed to add OAuth2
capabilities to your Django projects. Django OAuth Toolkit makes extensive use of the excellent
`OAuthLib <https://github.com/idan/oauthlib>`_, so that everything is
`rfc-compliant <http://tools.ietf.org/html/rfc6749>`_.

Documentation
--------------

The `full documentation <https://django-oauth-toolkit.readthedocs.org/en/latest/>`_ is on *Read the Docs*.

License
-------

django-oauth-toolkit is released under the terms of the **BSD license**. Full details in ``LICENSE`` file.

Roadmap
-------------------------------

Highest priority first

 * ``django-rest-framework`` integration
 * Test server deployment
 * OAuth2 client wrapper
 * OAuth1 support

Changelog
---------
0.2.1 [2013-06-06]

 * Core optimizations

0.2.0 [2013-06-05]
<commit_msg>Improved README with requirements and installation info<commit_after>Django OAuth Toolkit
====================

*OAuth2 goodies for the Djangonauts!*

.. image:: https://travis-ci.org/evonove/django-oauth-toolkit.png
   :alt: Build Status
   :target: https://travis-ci.org/evonove/django-oauth-toolkit
.. image:: https://coveralls.io/repos/evonove/django-oauth-toolkit/badge.png
   :alt: Coverage Status
   :target: https://coveralls.io/r/evonove/django-oauth-toolkit

If you are facing one or more of the following:
 * Your Django app needs to interact with an OAuth2 authorization server to access 3rd party resources,
 * Your Django app exposes a web API you want to protect with OAuth2 authentication,
 * You need to implement an OAuth2 authorization server to provide tokens management for your infrastructure,

Django OAuth Toolkit can help you providing out of the box all the endpoints, data and logic needed to add OAuth2
capabilities to your Django projects. Django OAuth Toolkit makes extensive use of the excellent
`OAuthLib <https://github.com/idan/oauthlib>`_, so that everything is
`rfc-compliant <http://tools.ietf.org/html/rfc6749>`_.

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

* Python 2.7, 3.3
* Django 1.4, 1.5, 1.6a1

Installation
------------

Install using pip...

```
pip install django-oauth-toolkit
```

Add 'django-oauth-toolkit' to your INSTALLED_APPS setting.

```
INSTALLED_APPS = (
    ...
    'django-oauth-toolkit',        
)
```

If you need an OAuth2 provider you'll want to add the following to your urls.py

```
urlpatterns = patterns(
    ...
    url(r'^o/', include('oauth2_provider.urls')),
)
```

Documentation
--------------

The `full documentation <https://django-oauth-toolkit.readthedocs.org/en/latest/>`_ is on *Read the Docs*.

License
-------

django-oauth-toolkit is released under the terms of the **BSD license**. Full details in ``LICENSE`` file.

Roadmap
-------------------------------

Highest priority first

 * ``django-rest-framework`` integration
 * Test server deployment
 * OAuth2 client wrapper
 * OAuth1 support

Changelog
---------
0.2.1 [2013-06-06]

 * Core optimizations

0.2.0 [2013-06-05]

{'fraction_non_alphanumeric': 0.1451271186440678, 'fraction_numerical': 0.021451271186440676, 'mean_word_length': 3.4175438596491228, 'pattern_counts': {'":': 0, '<': 9, '<?xml version=': 0, '>': 9, 'https://': 12, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '588729', 'n_tokens_mistral': 1225, 'n_tokens_neox': 1146, 'n_words': 382}