Metadata-Version: 2.0
Name: django-le-social
Version: 0.8
Summary: External registration / authentication for Django
Home-page: https://github.com/brutasse/django-le-social
Author: Bruno Renié
Author-email: bruno@renie.fr
License: BSD licence, see LICENCE file
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Requires-Dist: Django

Django-le-social
================

.. image:: https://travis-ci.org/brutasse/django-le-social.png?branch=master
   :alt: Build Status
   :target: https://travis-ci.org/brutasse/django-le-social

Django-le-social is an external registration helper for Django. It currently
lets you use Twitter (OAuth) and OpenID authentication, as well as traditional
registration.

It's more a framework than a drop-in app in the sense that it won't create
any user data for you: when a user comes from an external authentication
source, django-le-social executes a method that **you** decide. There is no
user creation, no new model instance, no user login. You need to decide what
to do, mainly store the OAuth token or the OpenID data, create a user and log
him in.


* Authors: Bruno Renié and `contributors`_
* Licence: BSD
* Compatibility: Django 1.4+
* Optional requirements: twitter, python-openid
* Documentation: http://django-le-social.readthedocs.org/en/latest/

.. _contributors: https://github.com/brutasse/django-le-social/contributors

Hacking
-------

Setup your environment::

    git clone https://brutasse@github.com/brutasse/django-le-social.git
    cd django-le-social
    mkvirtualenv --python python2 le-social
    add2virtualenv .
    pip install -r requirements.txt

Hack, and run the tests::

    python setup.py test

Or do it with `Tox`_ to test on python2.6, 2.7 and 3.3, as well as all the
supported Django versions::

    tox

.. _Tox: http://codespeak.net/~hpk/tox


