Metadata-Version: 2.1
Name: locode
Version: 0.1.1.1
Summary: Country and city codes from around the world.
Home-page: https://github.com/scrapinghub/locode
License: BSD
Description: # Locode
        
        ## Overview
        
        This module contains a series of json files with ISO_3166-1, ISO_3166-2 and 
        city codes from http://www.unece.org/cefact/locode/service/location.html
        
        ## bdist_egg
        
        `python setup.py bdist_egg` supports `--country=<country_code>` for creation 
        of light weight eggs.
        
        ## Usage
        
        ```python
        >>> import locode
        >>> locode.get_country_code('United States')
        u'US'
        >>> locode.get_country_code('Angola')
        u'AO'
        >>> locode.get_country_code('Uruguay')
        u'UY'
        >>> locode.get_state_code('Montevideo', 'Uruguay')
        u'MO'
        >>> locode.get_state_code('Arizona', 'US')
        u'AZ'
        >>> locode.get_state_code('Saint John', 'AG')
        u'04'
        >>> locode.get_city_code('New York', 'NY', 'US')
        u'NYC'
        >>> locode.get_city_code('Punta Carretas', 'Montevideo', 'Uruguay')
        u'PCA'
        >>> locode.get_city_code('Ondjiva', 'Cunene', 'AO')
        u'NGV'
        ```
        
        ```python
        >>> locode.get_city_code('-', '-', '-')
        u'XX'
        >>> locode.get_state_code('-', '-')
        u'XX'
        >>> locode.get_country_code('-')
        u'XX'
        ```
        
        ## Other methods
        
        
        - `locode.get_countries()` - returns a map with all countries and its codes.
        - `locode.get_states(country)` - returns a map with all states and its codes for the provided country.
        - `locode.get_cities(country, state)` - returns a map witll all cities and its codes for the provided country and state (only for few countries atm)
        
Platform: UNKNOWN
Description-Content-Type: text/markdown
