.. include:: strings.rst
Friendships
===========

.. module:: friendships

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

  Subscribe to status updates from specified user.

  |post|

  Implements https://twitter-api.readthedocs.io/en/latest/friendships.html#post--api-friendships-create.json

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


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

  Unsubscribe to status updates from specified user.

  |post|

  Implements https://twitter-api.readthedocs.io/en/latest/friendships.html#post--api-friendships-destroy.json

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

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

  Shows if ``source_user`` follows ``target_user``.

  |get|

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

  :param str server_url: |server_url|
  :rtype: bool
  :return: ``True`` if ``source_user`` follows ``target_user``. ``False``
           otherwise.

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

  Returns detailed information about the relationship between two
  users.

  |get|

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

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