/django-lastfm-auth

An extension to Django-Social-Auth which adds a backend for Last.fm

Primary LanguagePythonBSD 2-Clause "Simplified" LicenseBSD-2-Clause

Django-Lastfm-Auth

Django-Lastfm-Auth is an extension to Django-Social-Auth which adds a backend for Last.fm.

If you are looking for a stand alone Last.fm authentication backend then please check out django-lastfmauth.

Development Status

The development of this backend has stopped and it is not expected to be maintained in the future. If you are interested in picking up the development of this project please let me know.

Requirements

  • Django-Social-Auth >= 0.3.3
    • Django >= 1.2.5
    • Python-OAuth2 >= 1.5.167
    • Python-Openid >= 2.2

API Keys

In order to use this application you must sign up for API keys on Last.fm. These should be put into your settings file using the settings:

LASTFM_API_KEY = '' # Your api key
LASTFM_SECRET = '' # Your api secret

Extra data

Similar to the other OAuth backends you can define

LASTFM_EXTRA_DATA = [('realname', 'realname'), ]

as a list of tuples (response name, alias) to store on the UserSocialAuth model.

Installation

To install django-lastfm-auth via pip:

pip install django-lastfm-auth

Or you can from the latest version from Github manually:

git clone git://github.com/mlavin/django-lastfm-auth.git
cd django-lastfm-auth
python setup.py install

or via pip:

pip install -e git+https://github.com/mlavin/django-lastfm-auth.git

Once you have the app installed you must include in your settings:

INSTALLED_APPS = (
    ...
    'social_auth',
    'lastfm_auth',
    ...
)

AUTHENTICATION_BACKENDS = (
    ...
    'lastfm_auth.backend.LastfmBackend',
    ...
)

SOCIAL_AUTH_IMPORT_BACKENDS = (
    ...
    'lastfm_auth',
    ...
)

Please refer to the Django-Social-Auth documentation for additional information.

Questions or Issues?

If you have questions, issues or requests for improvements please let me know on Github.