class TwitterError(Exception):

  '''Base class for Twitter errors'''

  @property

  def message(self):

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

  Args:

    status: A status instance

      to the wall clock time.

  Returns:

    A human readable string representing the posting time

  def GetFriendsTimeline(self,

                         user=None,

                         count=None,

                         since_id=None):

    '''Fetch the sequence of Status messages for a user's friends

        Specifies the ID or screen name of the user for whom to return

        the friends_timeline.  If unspecified, the username and password

        must be set in the twitter.Api instance.  [Optional]

        Specifies the number of statuses to retrieve. May not be

        greater than 200. [Optional]

      since:

    results.append(self.PostUpdate(lines[-1], **kwargs))

    return results

    '''Get a sequence of status messages representing the 20 most recent

    replies (status updates prefixed with @username) to the authenticating

    user.

    Args:

      since:

        Narrows the returned results to just those statuses created

        after the specified HTTP-formatted date. [optional]

    if not self._username:

      raise TwitterError("twitter.Api instance must be authenticated")

    if user:

    else:

      url = 'http://twitter.com/statuses/friends.json'

    parameters = {}

    if since_id:

      parameters['since_id'] = since_id

    if page:

    json = self._FetchUrl(url, parameters=parameters)

    data = simplejson.loads(json)

    self._CheckForTwitterError(data)

    self._CheckForTwitterError(data)

    return NewUserFromJsonDict(data)

             show_user=None):

    '''Returns tweets that match a specified query.

    Args:

      query: The search query string, must be less than 140 characters

        code. [Optional]

      rpp:

        The number of tweets to return per page, up to a max of 100. [Optional]

        The page number (starting at 1) to return, up to a max of

        roughly 1500 results (based on rpp * page. Note: there are

        pagination limits. [Optional]

        Returns tweets with status ids greater than the given id. [Optional]

        Returns tweets by users located within a given radius of the

        given latitude/longitude, where the user's location is taken

        from their Twitter profile. The parameter value is specified

      A Results instance representing the search results

    '''

    url = 'http://search.twitter.com/search.json'

    parameters = {'q': query}

    if len(query) > 140:

      raise TwitterError('query must be <= 140 characters')

    Args:

      url: The URL to retrieve

        A dict of (str, unicode) key/value pairs.  If set, POST will be used.

      parameters:

        to the query string. [OPTIONAL]

      no_cache: If true, overrides the cache on the current request

        hashed_key = md5(key).hexdigest()

    except TypeError:

        hashed_key = md5.new(key).hexdigest()

    return os.path.join(self._root_directory,

                        self._GetPrefix(hashed_key),

                        hashed_key)

    status.created_at = 'Fri Jan 26 23:17:14 +0000 2007'

    self.assertEqual('Fri Jan 26 23:17:14 +0000 2007', status.created_at)

    now = created_at + 10

                     twitter.ComputeRelativeCreatedAt(status, now))

    status.user.CopyFrom(self._GetSampleUser())

    self.assertEqual(718443, status.user.id)

    results = twitter.NewResultsFromJsonDict(data)

    self.assertEqual(0.016569, results.completed_in)

    self.assertEqual(1818791702, results.max_id)

                     results.next_page)

    self.assertEqual(1, results.page)

    self.assertEqual('twitter', results.query)