worldfinder.get_capital
=======================

.. py:module:: worldfinder.get_capital


Functions
---------

.. autoapisummary::

   worldfinder.get_capital.get_capital


Module Contents
---------------

.. py:function:: get_capital(country)

   Retrieve the capital city of a given country.

   Parameters:
   -----------
   country : str
       The country in which the user wishes to find the capital city

   Returns:
   --------
   str
       The capital city corresponding to the country passed

   Raises:
   -------
   TypeError
       If country input is not a string.

   ValueError
       If country input contains an empty string OR
       If country input is not a valid country OR
       If no capital was found for given country

   Examples:
   ---------
   get_capital("Italy")
   'Rome'