worldfinder.get_countries
=========================

.. py:module:: worldfinder.get_countries


Functions
---------

.. autoapisummary::

   worldfinder.get_countries.get_countries


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

.. py:function:: get_countries(city)

   Return all unique countries that contain a given city.

   :param city: The name of the city to search for.
   :type city: str

   :returns: * *list of str* -- A list of unique countries (in their original case) that contain the
               specified city. The list will be deduplicated.
             * *Raises*
             * *-------*
             * *TypeError* -- If city input is not a string.
             * *ValueError* -- If city input contains an empty string OR
               If city input is not a valid city

   .. rubric:: Examples

   >>> get_countries("London")
   ["Canada", "United Kingdom", "United States"]