Initial commit; example Django application for using Twython OAuth with Twitter. Twython = Python Twitter API library/wrapper. Enjoy; a subproject of the mainline Twython effort.

twython_django_oauth/models.py

@@ -0,0 +1,12 @@
+from django.db import models
+from django.contrib.auth.models import User 
+
+class Profile(models.Model):
+	"""
+		An example Profile model that handles storing the oauth_token and
+		oauth_secret in relation to a user. Adapt this if you have a current
+		setup, there's really nothing special going on here.
+	"""
+	user = models.ForeignKey(User)
+	oauth_token = models.CharField(max_length = 200)
+	oauth_secret = models.CharField(max_length = 200)

twython_django_oauth/urls.py

@@ -0,0 +1,19 @@
+from django.conf.urls.defaults import *
+
+# your_app = name of your root djang app.
+urlpatterns = patterns('your_app.django_twitter_oauth.views',
+	
+	# First leg of the authentication journey...
+	(r'^login/?$', begin_auth),
+
+	# Logout, if need be
+	(r'^/logout?$', logout), # Calling logout and what not
+	
+	# This is where they're redirected to after authorizing - we'll
+	# further (silently) redirect them again here after storing tokens and such.
+	(r'^thanks/?$', thanks),
+
+	# An example view using a Twython method with proper OAuth credentials. Clone
+	# this view and url definition to get the rest of your desired pages/functionality.
+	(r'^user_timeline/?$', user_timeline),
+)

twython_django_oauth/views.py

@@ -0,0 +1,97 @@
+from django.contrib.auth import authenticate, login, logout
+from django.contrib.auth.models import User
+from django.http import HttpResponse, HttpResponseRedirect
+from django.shortcuts import render_to_response
+from django.contrib.auth.decorators import login_required
+
+from twython import Twython
+
+# If you've got your own Profile setup, see the note in the models file
+# about adapting this to your own setup.
+from your_app.twitter.models import Profile
+
+# Move these into your settings.py if you're feeling adventurous.
+CONSUMER_KEY = "YOUR CONSUMER KEY HERE"
+CONSUMER_SECRET = "YOUR CONSUMER SECRET HERE"
+
+def logout(request):
+	"""
+		Nothing hilariously hidden here, logs a user out. Strip this out if your 
+		application already has hooks to handle this.
+	"""
+	logout(request)
+	return HttpResponseRedirect('/')
+
+def begin_auth(request):
+	"""
+		The view function that initiates the entire handshake.
+		For the most part, this is 100% drag and drop.
+	"""
+	# Instantiate Twython with the first leg of our trip.
+	twitter = Twython(
+		twitter_token = CONSUMER_KEY,
+		twitter_secret = CONSUMER_SECRET
+	)
+	
+	# Request an authorization url to send the user to...
+	auth_props = twitter.get_authentication_tokens()
+	
+	# Then send them over there, durh.
+	request.session['request_token'] = auth_props
+	return HttpResponseRedirect(auth_props['auth_url'])
+
+def thanks(request):
+	"""
+		A user gets redirected here after hitting Twitter and authorizing your
+		app to use their data. 
+		
+		***
+			This is the view that stores the tokens you want
+			for querying data. Pay attention to this.
+		***
+	"""
+	# Now that we've got the magic tokens back from Twitter, we need to exchange
+	# for permanent ones and store them...
+	twitter = Twython(
+		twitter_token = CONSUMER_KEY,
+		twitter_secret = CONSUMER_SECRET,
+		oauth_token = request.session['request_token']['oauth_token'],
+		oauth_token_secret = request.session['request_token']['oauth_token_secret']
+	)
+	
+	# Retrieve the tokens we want...
+	authorized_tokens = twitter.get_authorized_tokens()
+	
+	# If they already exist, grab them, login and redirect to a page displaying stuff.
+	try:
+		user = User.objects.get(username = authorized_tokens['screen_name'])
+	except User.DoesNotExist:
+		# We mock a creation here; no email, password is just the token, etc.
+		user = User.objects.create_user(authorized_tokens['screen_name'], "fjdsfn@jfndjfn.com", authorized_tokens['oauth_token_secret'])
+		profile = Profile()
+		profile.user = user
+		profile.oauth_token = authorized_tokens['oauth_token']
+		profile.oauth_secret = authorized_tokens['oauth_token_secret']
+		profile.save()
+	
+	user = authenticate(
+		username = authorized_tokens['screen_name'],
+		password = authorized_tokens['oauth_token_secret']
+	)
+	login(request, user)
+	return HttpResponseRedirect('/timeline')
+
+def user_timeline(request):
+	"""
+		An example view with Twython/OAuth hooks/calls to fetch data about the user
+		in question. Pretty self explanatory if you read through it...
+	"""
+	user = request.user.get_profile()
+	twitter = Twython(
+		twitter_token = CONSUMER_KEY,
+		twitter_secret = CONSUMER_SECRET,
+		oauth_token = user.oauth_token,
+		oauth_token_secret = user.oauth_secret
+	)
+	user_tweets = twitter.getHomeTimeline()
+	return render_to_response('tweets.html', {'tweets': user_tweets})