============================================================

python-iso3166 - Standalone ISO 3166-1 country definitions

:Authors: Mike Spindel :Version: 0.9

ISO 3166-1 defines two-letter, three-letter, and three-digit country codes. python-iso3166 is a self-contained module that converts between these codes and the corresponding country name.

Installation

::

$ pip install iso3166

Usage

Country details

::

from iso3166 import countries

countries.get('us') Country(name=u'United States', alpha2='US', alpha3='USA', numeric='840') countries.get('ala') Country(name=u'\xc5land Islands', alpha2='AX', alpha3='ALA', numeric='248') countries.get(8) Country(name=u'Albania', alpha2='AL', alpha3='ALB', numeric='008')

Country lists and indexes

::

from iso3166 import countries

for c in countries: print c Country(name=u'Afghanistan', alpha2='AF', alpha3='AFG', numeric='004') Country(name=u'\xc5land Islands', alpha2='AX', alpha3='ALA', numeric='248') Country(name=u'Albania', alpha2='AL', alpha3='ALB', numeric='008') Country(name=u'Algeria', alpha2='DZ', alpha3='DZA', numeric='012')

::

import iso3166

iso3166.countriesbyname {u'AFGHANISTAN': Country(name=u'Afghanistan', alpha2='AF', alpha3='AFG', numeric='004'), u'ALBANIA': Country(name=u'Albania', alpha2='AL', alpha3='ALB', numeric='008'), u'ALGERIA': Country(name=u'Algeria', alpha2='DZ', alpha3='DZA', numeric='012'), ...

iso3166.countriesbynumeric {'004': Country(name=u'Afghanistan', alpha2='AF', alpha3='AFG', numeric='004'), '008': Country(name=u'Albania', alpha2='AL', alpha3='ALB', numeric='008'), '010': Country(name=u'Antarctica', alpha2='AQ', alpha3='ATA', numeric='010'), ...

iso3166.countriesbyalpha2 {'AD': Country(name=u'Andorra', alpha2='AD', alpha3='AND', numeric='020'), 'AE': Country(name=u'United Arab Emirates', alpha2='AE', alpha3='ARE', numeric='784'), 'AF': Country(name=u'Afghanistan', alpha2='AF', alpha3='AFG', numeric='004'), ...

iso3166.countriesbyalpha3 {'ABW': Country(name=u'Aruba', alpha2='AW', alpha3='ABW', numeric='533'), 'AFG': Country(name=u'Afghanistan', alpha2='AF', alpha3='AFG', numeric='004'), 'AGO': Country(name=u'Angola', alpha2='AO', alpha3='AGO', numeric='024'), ...