Automated scripts for receiving updates to ISO3166 country codes

Automated scripts that check for any updates/changes to the ISO3166-1 and ISO3166-2 country codes and naming conventions, as per the ISO3166 newsletter (https://www.iso.org/iso-3166-country-codes.html).

Table of Contents

• Introduction
• Usage
• Requirements
• Installation
• Issues
• Contact
• License
• References

Introduction

iso3166-updates is a repo that consists of a series of scripts that check for any updates/changes to the ISO3166-1 and ISO3166-2 country codes and naming conventions, as per the ISO3166 newsletter (https://www.iso.org/iso-3166-country-codes.html). The ISO3166 standard by the ISO defines codes for the names of countries, dependent territories, special areas of geographical interest, and their principal subdivisions [1].

The ISO 3166-1 icons are those of the names of countries and their subdivisions that can be broken into three sets of country codes:

• ISO 3166-1 alpha-2 – two-letter country codes which are the most widely used of the three, and used most prominently for the Internet's country code top-level domains (with a few exceptions).
• ISO 3166-1 alpha-3 – three-letter country codes which allow a better visual association between the codes and the country names than the alpha-2 codes.
• ISO 3166-1 numeric – three-digit country codes which are identical to those developed and maintained by the United Nations Statistics Division, with the advantage of script (writing system) independence, and hence useful for people or systems using non-Latin scripts.

The ISO 3166-2 icons are those of the names of countries and their subdivisions – Part 2: Country subdivision code, defines codes for the names of the principal subdivisions (e.g., provinces, states, departments, regions) of all countries coded in ISO 3166-1 [2].

Problem Statement

Requirements

• python >= 3.6
• pandas >= 1.4.3
• requests >= 2.28.1
• beautifulsoup4 >= 4.11.1

Installation

Install the latest version of iso3166-updates using pip:

pip3 install iso3166-updates

Installation from source:

git clone -b master https://github.com/amckenna41/iso3166-updates.git
python3 setup.py install
cd iso3166_updates

Usage

Issues

Any issues, errors or bugs can be raised via the Issues tab in the repository.

Contact

If you have any questions or comments, please contact amckenna41@qub.ac.uk or raise an issue on the [Issues][Issues] tab.

References

[1]: https://en.wikipedia.org/wiki/ISO_3166
[2]: https://en.wikipedia.org/wiki/ISO_3166-2
[3]: https://github.com/lipis/flag-icons

Back to top