'''Base class for Twitter errors'''

@property

def message(self):

'''Returns the first argument used to construct this error.'''

'''A class representing the Status structure used by the twitter API.

def __init__(self,

created_at=None,

favorited=None,

id=None,

text=None,

location=None,

user=None,

in_reply_to_screen_name=None,

in_reply_to_user_id=None,

in_reply_to_status_id=None,

truncated=None,

source=None,

now=None,

urls=None,

user_mentions=None,

hashtags=None,

geo=None,

place=None,

coordinates=None,

contributors=None,

retweeted=None,

retweeted_status=None,

retweet_count=None):

'''An object to hold a Twitter status message.

self.created_at = created_at

self.favorited = favorited

self.id = id

self.text = text

self.location = location

self.user = user

self.now = now

self.in_reply_to_screen_name = in_reply_to_screen_name

self.in_reply_to_user_id = in_reply_to_user_id

self.in_reply_to_status_id = in_reply_to_status_id

self.truncated = truncated

self.retweeted = retweeted

self.source = source

self.urls = urls

self.user_mentions = user_mentions

self.hashtags = hashtags

self.geo = geo

self.place = place

self.coordinates = coordinates

self.contributors = contributors

self.retweeted_status = retweeted_status

self.retweet_count = retweet_count

def GetCreatedAt(self):

'''Get the time this status message was posted.

return self._created_at

def SetCreatedAt(self, created_at):

'''Set the time this status message was posted.

self._created_at = created_at

created_at = property(GetCreatedAt, SetCreatedAt,

doc='The time this status message was posted.')

def GetCreatedAtInSeconds(self):

'''Get the time this status message was posted, in seconds since the epoch.

return calendar.timegm(rfc822.parsedate(self.created_at))

created_at_in_seconds = property(GetCreatedAtInSeconds,

doc="The time this status message was "

"posted, in seconds since the epoch")

def GetFavorited(self):

'''Get the favorited setting of this status message.

return self._favorited

def SetFavorited(self, favorited):

'''Set the favorited state of this status message.

self._favorited = favorited

favorited = property(GetFavorited, SetFavorited,

doc='The favorited state of this status message.')

def GetId(self):

'''Get the unique id of this status message.

return self._id

def SetId(self, id):

'''Set the unique id of this status message.

self._id = id

id = property(GetId, SetId,

doc='The unique id of this status message.')

def GetInReplyToScreenName(self):

return self._in_reply_to_screen_name

def SetInReplyToScreenName(self, in_reply_to_screen_name):

self._in_reply_to_screen_name = in_reply_to_screen_name

in_reply_to_screen_name = property(GetInReplyToScreenName, SetInReplyToScreenName,

doc='')

def GetInReplyToUserId(self):

return self._in_reply_to_user_id

def SetInReplyToUserId(self, in_reply_to_user_id):

self._in_reply_to_user_id = in_reply_to_user_id

in_reply_to_user_id = property(GetInReplyToUserId, SetInReplyToUserId,

doc='')

def GetInReplyToStatusId(self):

return self._in_reply_to_status_id

def SetInReplyToStatusId(self, in_reply_to_status_id):

self._in_reply_to_status_id = in_reply_to_status_id

in_reply_to_status_id = property(GetInReplyToStatusId, SetInReplyToStatusId,

doc='')

def GetTruncated(self):

return self._truncated

def SetTruncated(self, truncated):

self._truncated = truncated

truncated = property(GetTruncated, SetTruncated,

doc='')

def GetRetweeted(self):

return self._retweeted

def SetRetweeted(self, retweeted):

self._retweeted = retweeted

retweeted = property(GetRetweeted, SetRetweeted,

doc='')

def GetSource(self):

return self._source

def SetSource(self, source):

self._source = source

source = property(GetSource, SetSource,

doc='')

def GetText(self):

'''Get the text of this status message.

return self._text

def SetText(self, text):

'''Set the text of this status message.

self._text = text

text = property(GetText, SetText,

doc='The text of this status message')

def GetLocation(self):

'''Get the geolocation associated with this status message

return self._location

def SetLocation(self, location):

'''Set the geolocation associated with this status message

self._location = location

location = property(GetLocation, SetLocation,

doc='The geolocation string of this status message')

def GetRelativeCreatedAt(self):

'''Get a human redable string representing the posting time

fudge = 1.25

delta = long(self.now) - long(self.created_at_in_seconds)

if delta < (1 * fudge):

return 'about a second ago'

elif delta < (60 * (1/fudge)):

return 'about %d seconds ago' % (delta)

elif delta < (60 * fudge):

return 'about a minute ago'

elif delta < (60 * 60 * (1/fudge)):

return 'about %d minutes ago' % (delta / 60)

elif delta < (60 * 60 * fudge) or delta / (60 * 60) == 1:

return 'about an hour ago'

elif delta < (60 * 60 * 24 * (1/fudge)):

return 'about %d hours ago' % (delta / (60 * 60))

elif delta < (60 * 60 * 24 * fudge) or delta / (60 * 60 * 24) == 1:

return 'about a day ago'

else:

return 'about %d days ago' % (delta / (60 * 60 * 24))

relative_created_at = property(GetRelativeCreatedAt,

doc='Get a human readable string representing '

'the posting time')

def GetUser(self):

'''Get a twitter.User reprenting the entity posting this status message.

return self._user

def SetUser(self, user):

'''Set a twitter.User reprenting the entity posting this status message.

self._user = user

user = property(GetUser, SetUser,

doc='A twitter.User reprenting the entity posting this '

'status message')

def GetNow(self):

'''Get the wallclock time for this status message.

if self._now is None:

self._now = time.time()

return self._now

def SetNow(self, now):

'''Set the wallclock time for this status message.

self._now = now

now = property(GetNow, SetNow,

doc='The wallclock time for this status instance.')

def GetGeo(self):

return self._geo

def SetGeo(self, geo):

self._geo = geo

geo = property(GetGeo, SetGeo,

doc='')

def GetPlace(self):

return self._place

def SetPlace(self, place):

self._place = place

place = property(GetPlace, SetPlace,

doc='')

def GetCoordinates(self):

return self._coordinates

def SetCoordinates(self, coordinates):

self._coordinates = coordinates

coordinates = property(GetCoordinates, SetCoordinates,

doc='')

def GetContributors(self):

return self._contributors

def SetContributors(self, contributors):

self._contributors = contributors

contributors = property(GetContributors, SetContributors,

doc='')

def GetRetweeted_status(self):

return self._retweeted_status

def SetRetweeted_status(self, retweeted_status):

self._retweeted_status = retweeted_status

retweeted_status = property(GetRetweeted_status, SetRetweeted_status,

doc='')

def GetRetweetCount(self):

return self._retweet_count

def SetRetweetCount(self, retweet_count):

self._retweet_count = retweet_count

retweet_count = property(GetRetweetCount, SetRetweetCount,

doc='')

def __ne__(self, other):

return not self.__eq__(other)

def __eq__(self, other):

try:

return other and \

self.created_at == other.created_at and \

self.id == other.id and \

self.text == other.text and \

self.location == other.location and \

self.user == other.user and \

self.in_reply_to_screen_name == other.in_reply_to_screen_name and \

self.in_reply_to_user_id == other.in_reply_to_user_id and \

self.in_reply_to_status_id == other.in_reply_to_status_id and \

self.truncated == other.truncated and \

self.retweeted == other.retweeted and \

self.favorited == other.favorited and \

self.source == other.source and \

self.geo == other.geo and \

self.place == other.place and \

self.coordinates == other.coordinates and \

self.contributors == other.contributors and \

self.retweeted_status == other.retweeted_status and \

self.retweet_count == other.retweet_count

except AttributeError:

return False

def __str__(self):

'''A string representation of this twitter.Status instance.

return self.AsJsonString()

def AsJsonString(self):

'''A JSON string representation of this twitter.Status instance.

return simplejson.dumps(self.AsDict(), sort_keys=True)

def AsDict(self):

'''A dict representation of this twitter.Status instance.

data = {}

if self.created_at:

data['created_at'] = self.created_at

if self.favorited:

data['favorited'] = self.favorited

if self.id:

data['id'] = self.id

if self.text:

data['text'] = self.text

if self.location:

data['location'] = self.location

if self.user:

data['user'] = self.user.AsDict()

if self.in_reply_to_screen_name:

data['in_reply_to_screen_name'] = self.in_reply_to_screen_name

if self.in_reply_to_user_id:

data['in_reply_to_user_id'] = self.in_reply_to_user_id

if self.in_reply_to_status_id:

data['in_reply_to_status_id'] = self.in_reply_to_status_id

if self.truncated is not None:

data['truncated'] = self.truncated

if self.retweeted is not None:

data['retweeted'] = self.retweeted

if self.favorited is not None:

data['favorited'] = self.favorited

if self.source:

data['source'] = self.source

if self.geo:

data['geo'] = self.geo

if self.place:

data['place'] = self.place

if self.coordinates:

data['coordinates'] = self.coordinates

if self.contributors:

data['contributors'] = self.contributors

if self.hashtags:

data['hashtags'] = [h.text for h in self.hashtags]

if self.retweeted_status:

data['retweeted_status'] = self.retweeted_status.AsDict()

if self.retweet_count:

data['retweet_count'] = self.retweet_count

return data

@staticmethod

def NewFromJsonDict(data):

'''Create a new instance based on a JSON dict.

if 'user' in data:

user = User.NewFromJsonDict(data['user'])

else:

user = None

if 'retweeted_status' in data:

retweeted_status = Status.NewFromJsonDict(data['retweeted_status'])

else:

retweeted_status = None

urls = None

user_mentions = None

hashtags = None

if 'entities' in data:

if 'urls' in data['entities']:

urls = [Url.NewFromJsonDict(u) for u in data['entities']['urls']]

if 'user_mentions' in data['entities']:

user_mentions = [User.NewFromJsonDict(u) for u in data['entities']['user_mentions']]

if 'hashtags' in data['entities']:

hashtags = [Hashtag.NewFromJsonDict(h) for h in data['entities']['hashtags']]

return Status(created_at=data.get('created_at', None),

favorited=data.get('favorited', None),

id=data.get('id', None),

text=data.get('text', None),

location=data.get('location', None),

in_reply_to_screen_name=data.get('in_reply_to_screen_name', None),

in_reply_to_user_id=data.get('in_reply_to_user_id', None),

in_reply_to_status_id=data.get('in_reply_to_status_id', None),

truncated=data.get('truncated', None),

retweeted=data.get('retweeted', None),

source=data.get('source', None),

user=user,

urls=urls,

user_mentions=user_mentions,

hashtags=hashtags,

geo=data.get('geo', None),

place=data.get('place', None),

coordinates=data.get('coordinates', None),

contributors=data.get('contributors', None),

retweeted_status=retweeted_status,

'''A class representing the User structure used by the twitter API.

def __init__(self,

id=None,

name=None,

screen_name=None,

location=None,

description=None,

profile_image_url=None,

profile_background_tile=None,

profile_background_image_url=None,

profile_sidebar_fill_color=None,

profile_background_color=None,

profile_link_color=None,

profile_text_color=None,

protected=None,

utc_offset=None,

time_zone=None,

followers_count=None,

friends_count=None,

statuses_count=None,

favourites_count=None,

url=None,

status=None,

geo_enabled=None,

verified=None,

lang=None,

notifications=None,

contributors_enabled=None,

created_at=None,

listed_count=None):

self.id = id

self.name = name

self.screen_name = screen_name

self.location = location

self.description = description

self.profile_image_url = profile_image_url

self.profile_background_tile = profile_background_tile

self.profile_background_image_url = profile_background_image_url

self.profile_sidebar_fill_color = profile_sidebar_fill_color

self.profile_background_color = profile_background_color

self.profile_link_color = profile_link_color

self.profile_text_color = profile_text_color

self.protected = protected

self.utc_offset = utc_offset

self.time_zone = time_zone

self.followers_count = followers_count

self.friends_count = friends_count

self.statuses_count = statuses_count

self.favourites_count = favourites_count

self.url = url

self.status = status

self.geo_enabled = geo_enabled

self.verified = verified

self.lang = lang

self.notifications = notifications

self.contributors_enabled = contributors_enabled

self.created_at = created_at

self.listed_count = listed_count

def GetId(self):

'''Get the unique id of this user.

return self._id

def SetId(self, id):

'''Set the unique id of this user.

self._id = id

id = property(GetId, SetId,

doc='The unique id of this user.')

def GetName(self):

'''Get the real name of this user.

return self._name

def SetName(self, name):

'''Set the real name of this user.

self._name = name

name = property(GetName, SetName,

doc='The real name of this user.')

def GetScreenName(self):

'''Get the short twitter name of this user.

return self._screen_name

def SetScreenName(self, screen_name):

'''Set the short twitter name of this user.

self._screen_name = screen_name

screen_name = property(GetScreenName, SetScreenName,

doc='The short twitter name of this user.')

def GetLocation(self):

'''Get the geographic location of this user.

return self._location

def SetLocation(self, location):

'''Set the geographic location of this user.

self._location = location

location = property(GetLocation, SetLocation,

doc='The geographic location of this user.')

def GetDescription(self):

'''Get the short text description of this user.

return self._description

def SetDescription(self, description):

'''Set the short text description of this user.

self._description = description

description = property(GetDescription, SetDescription,

doc='The short text description of this user.')

def GetUrl(self):

'''Get the homepage url of this user.

return self._url

def SetUrl(self, url):

'''Set the homepage url of this user.

self._url = url

url = property(GetUrl, SetUrl,

doc='The homepage url of this user.')

def GetProfileImageUrl(self):

'''Get the url of the thumbnail of this user.

return self._profile_image_url

def SetProfileImageUrl(self, profile_image_url):

'''Set the url of the thumbnail of this user.

self._profile_image_url = profile_image_url

profile_image_url= property(GetProfileImageUrl, SetProfileImageUrl,

doc='The url of the thumbnail of this user.')

def GetProfileBackgroundTile(self):

'''Boolean for whether to tile the profile background image.

return self._profile_background_tile

def SetProfileBackgroundTile(self, profile_background_tile):

'''Set the boolean flag for whether to tile the profile background image.

self._profile_background_tile = profile_background_tile

profile_background_tile = property(GetProfileBackgroundTile, SetProfileBackgroundTile,

doc='Boolean for whether to tile the background image.')

def GetProfileBackgroundImageUrl(self):

return self._profile_background_image_url

def SetProfileBackgroundImageUrl(self, profile_background_image_url):

self._profile_background_image_url = profile_background_image_url

profile_background_image_url = property(GetProfileBackgroundImageUrl, SetProfileBackgroundImageUrl,

doc='The url of the profile background of this user.')

def GetProfileSidebarFillColor(self):

return self._profile_sidebar_fill_color

def SetProfileSidebarFillColor(self, profile_sidebar_fill_color):

self._profile_sidebar_fill_color = profile_sidebar_fill_color

profile_sidebar_fill_color = property(GetProfileSidebarFillColor, SetProfileSidebarFillColor)

def GetProfileBackgroundColor(self):

return self._profile_background_color

def SetProfileBackgroundColor(self, profile_background_color):

self._profile_background_color = profile_background_color

profile_background_color = property(GetProfileBackgroundColor, SetProfileBackgroundColor)

def GetProfileLinkColor(self):

return self._profile_link_color

def SetProfileLinkColor(self, profile_link_color):

self._profile_link_color = profile_link_color

profile_link_color = property(GetProfileLinkColor, SetProfileLinkColor)

def GetProfileTextColor(self):

return self._profile_text_color

def SetProfileTextColor(self, profile_text_color):

self._profile_text_color = profile_text_color

profile_text_color = property(GetProfileTextColor, SetProfileTextColor)

def GetProtected(self):

return self._protected

def SetProtected(self, protected):

self._protected = protected

protected = property(GetProtected, SetProtected)

def GetUtcOffset(self):

return self._utc_offset

def SetUtcOffset(self, utc_offset):

self._utc_offset = utc_offset

utc_offset = property(GetUtcOffset, SetUtcOffset)

def GetTimeZone(self):

'''Returns the current time zone string for the user.

return self._time_zone

def SetTimeZone(self, time_zone):

'''Sets the user's time zone string.

self._time_zone = time_zone

time_zone = property(GetTimeZone, SetTimeZone)

def GetStatus(self):

'''Get the latest twitter.Status of this user.

return self._status

def SetStatus(self, status):

'''Set the latest twitter.Status of this user.

self._status = status

status = property(GetStatus, SetStatus,

doc='The latest twitter.Status of this user.')

def GetFriendsCount(self):

'''Get the friend count for this user.

return self._friends_count

def SetFriendsCount(self, count):

'''Set the friend count for this user.