.. include:: strings.rst Statuses ======== .. module:: statuses .. function:: update(server_url, status, *, source=None, in_reply_to_status_id=None, lat=None, long=None, media=None, username='', password='', oauth={}) Updates the authenticating user's current status. :param str server_url: |server_url| :param str status: the text of your status update. :param str source: (optional) the name of application you update the status from. :param int in_reply_to_status_id: (optional) the ID of an existing status that the update is in reply to. :param int lat: (optional) the latitude of the location this status refers to. This parameter will be ignored unless it is inside the range -90.0 to +90.0 (North is positive) inclusive. It will also be ignored if there isn’t a corresponding long parameter :param int long: (optional) the longitude of the location this status refers to. The valid ranges for longitude is -180.0 to +180.0 (East is positive) inclusive. This parameter will be ignored if outside that range, if it is not a number or if there not a corresponding lat parameter :param media: (optional) a file like stream of bytes to upload as attachment :param str username: |username| :param str password: |password| :param dict oauth: |oauth| :rtype: dict :return: :ref:`status_dict` .. function:: show(server_url, status_id, *, username='', password='', oauth={}) Returns a specified status. :param str server_url: |server_url| :param int status_id: ID of the status to show :param str username: |username| :param str password: |password| :param dict oauth: |oauth| :rtype: dict :return: :ref:`status_dict` .. function:: destroy(server_url, status_id, *, username='', password='', oauth={}) Deletes the status specified by the required ID parameter. The authenticating user must be the author of the specified status. Returns the destroyed status if successful. :param str server_url: |server_url| :param int status_id: ID of the status to delete :param str username: |username| :param str password: |password| :param dict oauth: |oauth| :rtype: dict :return: :ref:`status_dict` .. function:: repeat(server_url, status_id, *, username='', password='', oauth={}) Repeats a status. Returns the original status with repeat details embedded. :param str server_url: |server_url| :param int status_id: ID of the status to repeat :param str username: |username| :param str password: |password| :param dict oauth: |oauth| :rtype: dict :return: :ref:`status_dict` .. function:: conversation(server_url, conversation_id, *, since_id=None, max_id=None, count=20, username='', password='', oauth={}) Returns statuses that have been posted in the conversation :param str server_url: |server_url| :param int conversation_id: ID of the conversation to show :param int since_id: |status_since_id| :param int max_id: |status_max_id| :param int count: |status_count| :param str username: |username| :param str password: |password| :param dict oauth: |oauth| :rtype: list :return: a list of :ref:`status dicts `