.. include:: strings.rst
Users
=====

.. module:: users

.. function:: friends(server_url, *args, **kwargs)

  Returns a collection of user objects for users followed by
  the specified user.

  |get|

  Implements https://twitter-api.readthedocs.io/en/latest/users.html#get--api-statuses-friends.json

  :param str server_url: |server_url|
  :rtype: list
  :return: a list of :ref:`user dicts <user_dict>`


.. function:: followers(server_url, *args, **kwargs)

  Unsubscribe to status updates from specified user.

  |get|

  Implements https://twitter-api.readthedocs.io/en/latest/users.html#get--api-statuses-followers.json

  :param str server_url: |server_url|
  :rtype: list
  :return: a list of :ref:`user dicts <user_dict>`


.. function:: show(server_url, *args, **kwargs)

  Returns detailed information about the specified user.

  |get|

  Implements https://twitter-api.readthedocs.io/en/latest/users.html#get--api-users-show.json

  :param str server_url: |server_url|
  :rtype: dict
  :return: :ref:`user_dict`


.. function:: friends_ids(server_url, *args, **kwargs)

  Returns IDs of users the auntenticated or specified user is following
  (otherwise known as their "friends").

  |get|

  Implements https://twitter-api.readthedocs.io/en/latest/users.html#get--api-friends-ids.json

  :param str server_url: |server_url|
  :rtype: list
  :return: a list of user IDs


.. function:: followers_ids(server_url, *args, **kwargs)

  Returns IDs of users the auntenticated or specified user is followed by.

  |get|

  Implements https://twitter-api.readthedocs.io/en/latest/users.html#get--api-followers-ids.json

  :param str server_url: |server_url|
  :rtype: list
  :return: a list of user IDs