django-syncr / syncr / app /

Full commit
import time
from datetime import datetime
import twitter
from django.utils.encoding import smart_unicode
from syncr.twitter.models import TwitterUser, Tweet

class TwitterSyncr:
    """TwitterSyncr objects sync Twitter information to the Django
    backend. This includes meta data for Twitter users in addition to
    Twitter status updates (Tweets).

    NOTE: Limitations of the Twitter API currently restricts API
    access to only the most recent data in the Twitter system. This
    is for performance reasons (per API docs).

    This app depends on python-twitter:
    def __init__(self, username, password):
        """Construct a new TwitterSyncr object.

        Required arguments
          username: the Twitter user to use for authentication
          password: the Twitter user's password to use for auth
        self.username = username
        self.api = twitter.Api(username=username, password=password)

        self.user_cache = dict()

    def _getUser(self, user):
        """Retrieve Twitter user information, caching for performance
        Required arguments
          user: a Twitter username as a string.
        if self.user_cache.has_key(user):
            return self.user_cache[user]
            tw_user = self.api.GetUser(user)
            self.user_cache[user] = tw_user
            return self.user_cache[user]

    def _syncTwitterUser(self, user):
        """Synchronize a twitter.User object with the Django backend

        Required arguments
          user: a twitter.User object.
        default_dict = {'screen_name': user.screen_name,
                        'description': user.description,
                        'location': user.location,
                        'thumbnail_url': user.profile_image_url,
                        'url': user.url,
        obj, created = TwitterUser.objects.get_or_create(screen_name = user.screen_name,
                                                  defaults = default_dict)
        return obj

    def syncUser(self, user):
        """Synchronize a Twitter user with the Django backend

        Required arguments
          user: a Twitter username as a string
        user_obj = self._syncTwitterUser(self._getUser(user))
        return user_obj

    def _syncTwitterStatus(self, status):
        Take a twitter.Status object and synchronize it to Django.

          status: a twitter.Status object.

          A syncr.twitter.models.Tweet Django object.
        user = self._syncTwitterUser(status.user)
        pub_time = time.strptime(status.created_at, "%a %b %d %H:%M:%S +0000 %Y")
        pub_time = datetime.fromtimestamp(time.mktime(pub_time))
        default_dict = {'pub_time': pub_time,
                        'text': smart_unicode(status.text),
                        'user': user,
        obj, created = Tweet.objects.get_or_create(twitter_id =,
                                                   defaults = default_dict)
        return obj

    def syncTweet(self, status_id):
        """Synchronize a Twitter status update by id

        Required arguments
          status_id: a Twitter status update id
        status_obj = self.api.GetStatus(status_id)
        return self._syncTwitterStatus(status_obj)

    def syncTwitterUserTweets(self, user):
        """Synchronize a Twitter user's tweets with Django (currently
        only the last 20 updates)

        Required arguments
          user: the Twitter user as string
        statuses = self.api.GetUserTimeline(user)
        for status in statuses:

    def syncFriends(self, user):
        """Synchronize a Twitter user's friends with Django.

        Required arguments
          user: the Twitter username as a string
        user_obj = self._syncTwitterUser(self._getUser(user))
        friends = self.api.GetFriends(user)

        # sync our list of twitter.User objs as into ORM
        for friend in friends:
            obj = self._syncTwitterUser(friend)

    def syncFollowers(self):
        """Synchronize the Twitter user's followers with Django. This
        only works for the username who is authenticated in the API
        user_obj = self._syncTwitterUser(self._getUser(self.username))
        followers = self.api.GetFollowers()

        # sync our list of twitter.User objs into ORM
        for follower in followers:
            obj = self._syncTwitterUser(follower)

    def syncFriendsTweets(self, user):
        """Synchronize the tweets of a Twitter user's friends (currently
        only the last 20 updates). Also automatically add these users
        as friends in the Django database, if they aren't already.

        Required arguments
          user: the Twitter username whose friend's tweets will sync
        friend_updates = self.api.GetFriendsTimeline(user)
        user_obj = self._syncTwitterUser(self._getUser(user))
        # loop through twitter.Status objects and sync them
        for update in friend_updates:
            friend = self._syncTwitterUser(update.user)