Metadata-Version: 1.0
Name: django-lastfmauth
Version: 0.1a1
Summary: Django app to let your website visitors register/login using LastFM authentication webservice.
Home-page: http://github.com/matagus/django-lastfm-auth
Author: Matias Agustin Mendez
Author-email: me@matagus.com.ar
License: BSD
Description: ## lastfmauth app for django projects
        
        Last.fm 2.0 API provides an authentication webservice. It works the same way Facebook Connect does,
        but with Last.fm user credentials. With django-lastfmauth it is easy to redirect a user to Last.Fm:
        Last.fm will do the login and ask them permission to your application to do it. Then, it will 
        redirect the user to your website (you can set the callback url, please see bellow).
        
        So far, this app does all this job, but it needs some more work.
        
        
        ### Requirements
        Tested with django 1.2 and python 2.6.
        
        ### Instalation
        Register your app and get a key in [LastFM API page](http://www.last.fm/api/)
        Set the callback url to http://your-domain/login_complete/
        
        Then download and install lastfmauth app: 
        
            pip install -E path/to/your/env/ django-lastfmauth
        
        or 
        
            easy_install django-lastfmauth
        
        Add to your settings.py:
        
            INSTALLED_APPS = (
                ...
                'lastfmauth',
                ...
            )
        
            AUTHENTICATION_BACKENDS = (
                "lastfmauth.backends.LastfmAuthBackend",
                ...
            )
        
            LASTFM_API_KEY = "YOUR API KEY"
            LASTFM_SECRET = "YOUR SECRET KEY"
            LASTFM_WS_BASE_URL = "http://ws.audioscrobbler.com/2.0/"
        
        Add to your urls.py:
            ...
            (r'^lastfmauth/', include('lastfmauth.urls')),
            ...
        
        Create app tables in your database:
        
            python manage.py syncdb
        
        ### Usage
        Put somewhere in your templates a link to let visitors login using LastFM:
        
            <a href="{% url lastfmauth_login %}">{% trans 'Login using your LastFm account' %}</a>
        
        ### License
        This work is under MIT License.
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Topic :: Internet :: WWW/HTTP
