Skip to main content

Extension of Python package pycountry providing conversion functions.

Project description

pycountry-convert

Extension of Python package pycountry providing conversion functions.

Badges

info License Status Hits Contributors
tests Travis-CI Build Status Code Coverage Status
package PyPI Package latest release Supported versions Requirements Status

Install

pip install pycountry-convert

Architecture

Using country data derived from wikipedia, this package provides conversion functions between ISO country names, country-codes, and continent names.

Functions

  • map_countries(cn_name_format="default", cn_extras={}): Return a dict of countries with key as country name (standard and official) with ISO 3166-1 values Alpha 2, Alpha 3, and Numeric. This mapping will include countries defined within pycountry, Wikipedia, and whatever extra countries provided by parameter cn_extras. Parameter cn_name_format will format the country name as request to either be using the default layout “default”, lowercase “lower”, or uppercase “upper”.
  • country_alpha2_to_continent_code(): Convert country code ISO 3166-1 alpha-2 to continent name.
  • country_alpha2_to_country_name(cn_name_format="default"): Convert country code ISO 3166-1 alpha-2 to country name.
  • country_name_to_country_alpha2(cn_name, cn_name_format="default"): Convert country name to country code ISO 3166-1 alpha-2 .
  • country_alpha3_to_country_name(cn_name_format="default"): Convert country code ISO 3166-1 alpha-3 to country name.
  • country_name_to_country_alpha3(cn_name, cn_name_format="default"): Convert country name to country code ISO 3166-1 alpha-3 .
  • country_alpha3_to_country_alpha2(): Convert country code ISO 3166-1 alpha-3 to country code ISO 3166-1 alpha-2 .

Parameter: cn_name_format

  • COUNTRY_NAME_FORMAT_DEFAULT "default": Country names as provide by pycountry.
  • COUNTRY_NAME_FORMAT_LOWER "lower": All lowercase country names.
  • COUNTRY_NAME_FORMAT_UPPER "upper": All uppercase country names.

Parameter: cn_extras

Dictionary of { cn_name: cn_alpha2_code, … }

Dependencies

pycountry-convert module is built upon Python 3 and has dependencies upon several Python modules available within Python Package Index PyPI.

Release History

0.5.4 (2017-12-07)

  • LICENSE: LGPL 3.0

0.5.0 (2017-11-30)

  • README.rst
  • Hits and Contributors

0.3.0 (2017-11-27)

  • README.rst
  • Travis CI

0.1.9 (2017-03-12)

  • Makefile and README.rst

0.1.8 (2016-11-19)

  • Makefile and README.rst

0.1.0 (2016-11-17)

  • Initial Code
  • Code pulled from TuneLab/tune-mv-integration-python
  • Country name to Country Alpha-2 Code cleanup

0.0.1 (2016-11-17)

  • Initial commit

Project details


Release history Release notifications

History Node

0.7.2

History Node

0.7.0

History Node

0.6.7

History Node

0.6.6

History Node

0.6.5

History Node

0.6.4

History Node

0.6.3

History Node

0.6.2

History Node

0.6.1

History Node

0.6.0

History Node

0.5.11

History Node

0.5.10

History Node

0.5.9

History Node

0.5.8

This version
History Node

0.5.7

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pycountry_convert-0.5.7-py3.6.egg (20.3 kB) Copy SHA256 hash SHA256 Egg 3.6 Dec 7, 2017
pycountry_convert-0.5.7-py3-none-any.whl (13.4 kB) Copy SHA256 hash SHA256 Wheel 3.6 Dec 7, 2017
pycountry-convert-0.5.7.tar.gz (13.8 kB) Copy SHA256 hash SHA256 Source None Dec 7, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page