
Installation
************


Dependencies
============

Dependencies that **must** be met to use the application:

* OpenId support depends on python-openid

* OAuth support depends on requests-oauthlib

* Several backends demands application registration on their
  corresponding sites and other dependencies like sqlalchemy on Flask
  and Webpy.


Get a copy
==========

From pypi:

   $ pip install python-social-auth

Or:

   $ easy_install python-social-auth

Or clone from github:

   $ git clone git://github.com/omab/python-social-auth.git

And add social to "PYTHONPATH":

   $ export PYTHONPATH=$PYTHONPATH:$(pwd)/python-social-auth/

Or:

   $ cd python-social-auth
   $ sudo python setup.py install


Upgrading
=========


Django with South
-----------------

Upgrading from 0.1 to 0.2 is likely to cause problems trying to apply
a migration when the tables already exist. In this case a fake
migration needs to be applied:

$ python manage.py migrate --fake default
