Skip to content

README.rst

Latest commit

 

History

History
89 lines (65 loc) · 3.24 KB

README.rst

File metadata and controls

89 lines (65 loc) · 3.24 KB

python-iso3166 - Standalone ISO 3166-1 country definitions

Authors: Mike Spindel
Version: 2.1.1

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='United States', alpha2='US', alpha3='USA', numeric='840', phone_code="'1')
>>> countries.get('ala')
Country(name='Åland Islands', alpha2='AX', alpha3='ALA', numeric='248', phone_code='+358 (AX)')
>>> countries.get(8)
Country(name='Albania', alpha2='AL', alpha3='ALB', numeric='008', phone_code='+355')
>>> countries.get('+44')
Country(name='United Kingdom of Great Britain and Northern Ireland', alpha2='GB', alpha3='GBR', numeric='826', phone_code='+44')

Country lists and indexes

>>> from iso3166 import countries

>>> for c in countries:
       print(c)
>>> Country(name='Afghanistan', alpha2='AF', alpha3='AFG', numeric='004', phone_code='+93')
Country(name='Åland Islands', alpha2='AX', alpha3='ALA', numeric='248', phone_code='+358 (AX)')
Country(name='Albania', alpha2='AL', alpha3='ALB', numeric='008', phone_code='+355')
Country(name='Algeria', alpha2='DZ', alpha3='DZA', numeric='012', phone_code='+213')

>>> import iso3166

>>> iso3166.countries_by_name
>>> {'AFGHANISTAN': Country(name='Afghanistan', alpha2='AF', alpha3='AFG', numeric='004', phone_code='+93'),
'ALBANIA': Country(name='Albania', alpha2='AL', alpha3='ALB', numeric='008', phone_code='+355'),
'ALGERIA': Country(name='Algeria', alpha2='DZ', alpha3='DZA', numeric='012'), phone_code='+213',
...

>>> iso3166.countries_by_numeric
>>> {'004': Country(name='Afghanistan', alpha2='AF', alpha3='AFG', numeric='004', phone_code='+93'),
'008': Country(name='Albania', alpha2='AL', alpha3='ALB', numeric='008', phone_code='+355'),
'010': Country(name='Antarctica', alpha2='AQ', alpha3='ATA', numeric='010', phone_code='+672'),
...

>>> iso3166.countries_by_alpha2
>>> {'AD': Country(name='Andorra', alpha2='AD', alpha3='AND', numeric='020', phone_code='+376'),
'AE': Country(name='United Arab Emirates', alpha2='AE', alpha3='ARE', numeric='784', phone_code='+971'),
'AF': Country(name='Afghanistan', alpha2='AF', alpha3='AFG', numeric='004', phone_code='+93'),
...

>>> iso3166.countries_by_alpha3
>>> {'ABW': Country(name='Aruba', alpha2='AW', alpha3='ABW', numeric='533', phone_code='+297'),
'AFG': Country(name='Afghanistan', alpha2='AF', alpha3='AFG', numeric='004', phone_code='+93'),
'AGO': Country(name='Angola', alpha2='AO', alpha3='AGO', numeric='024', phone_code='+244'),
...

>>> iso3166.countries_by_phone_code
>>> {'+93': Country(name='Afghanistan', alpha2='AF', alpha3='AFG', numeric='004', phone_code='+93'),
'+355': Country(name='Albania', alpha2='AL', alpha3='ALB', numeric='008', phone_code='+355'),
'+213': Country(name='Algeria', alpha2='DZ', alpha3='DZA', numeric='012'), phone_code='+213',
...