[](https://pypi.org/project/countrygroups/)
[](https://www.npmjs.com/package/countrygroups)
Data Package, Python and JavaScript module with country groups.
## Data Package
The Data Package contains the lists as CSV or JSON file used to build the
language modules and can be loaded with the respective
[language tools](http://frictionlessdata.io/software/).
Some lists contain additional information like date of joining etc.
## Python Module
The Python module can be installed from
[PyPI](https://pypi.org/project/countrygroups/):
```
pip install countrygroups
```
It contains lists with three-letter codes:
```py
from countrygroups import EUROPEAN_UNION
print(EUROPEAN_UNION)
# =>
# ['AUT', 'BEL', 'BGR', 'CYP', 'CZE', 'DEU', 'DNK', 'ESP', 'EST', 'FIN', 'FRA',
# 'GRC', 'HRV', 'HUN', 'IRL', 'ITA', 'LTU', 'LUX', 'LVA', 'MLT', 'NLD', 'POL',
# 'PRT', 'ROU', 'SVK', 'SVN', 'SWE']
print(EUROPEAN_UNION.names)
# =>
# ['Austria', 'Belgium', 'Bulgaria', 'Croatia', 'Cyprus', 'Czechia', 'Denmark',
# 'Estonia', 'Finland', 'France', 'Germany', 'Greece', 'Hungary', 'Ireland',
# 'Italy', 'Latvia', 'Lithuania', 'Luxembourg', 'Malta', 'Netherlands',
# 'Poland', 'Portugal', 'Romania', 'Slovakia', 'Slovenia', 'Spain', 'Sweden']
```
## JavaScript Module
The JavaScript module can be installed with npm:
```
npm install countrygroups
```
It contains arrays with three-letter codes:
```js
var g7 = require("countrygroups").G7
console.log(g7) // => [ 'CAN', 'DEU', 'EUU', 'FRA', 'GBR', 'ITA', 'JPN', 'USA' ]
```
## Data
### UNFCCC Annex I parties (ANNEX_ONE)
[data/annex-one.csv](data/annex-one.csv)
Sources:
[List of Annex I Parties to the Convention](http://unfccc.int/parties_and_observers/parties/annex_i/items/2774.php)
### UNFCCC Annex I parties incl. Kazakhstan (ANNEX_ONE_KAZ)
[data/annex-one-kaz.csv](data/annex-one-kaz.csv)
Sources:
[Greenhouse gas inventory submissions from non-Annex I Parties](https://unfccc.int/process/transparency-and-reporting/greenhouse-gas-data/greenhouse-gas-data-unfccc/greenhouse-gas-inventory-submissions-from-non-annex-i-parties)
### Alliance of Small Island States (AOSIS) (AOSIS)
[data/aosis.csv](data/aosis.csv)
Sources:
[AOSIS - Members](http://aosis.org/about/members/)
### Regional groups for the IPCC AR5 report (AR5)
[data/ar5.csv](data/ar5.csv)
Sources:
[AR5 Region Definitions](https://tntcat.iiasa.ac.at/AR5DB/dsd?Action=htmlpage&page=about)
### Arab Group in the UNFCCC (ARAB_GROUP)
[data/arab-group.csv](data/arab-group.csv)
Sources:
[UNFCCC - Party Groupings](https://unfccc.int/party-groupings)
### BRICS (Brazil, Russia, India, China and South Africa) (BRICS)
[data/brics.csv](data/brics.csv)
Sources:
-
### Environmental Integrity Group (EIG)
[data/eig.csv](data/eig.csv)
Sources:
[UNFCCC - Party Groupings](https://unfccc.int/party-groupings)
### European Union (EU) (EUROPEAN_UNION)
[data/european-union.csv](data/european-union.csv)
Sources:
[EU member countries in brief](https://europa.eu/european-union/about-eu/countries/member-countries_en)
### G20 members (G20)
[data/g20.csv](data/g20.csv)
Sources:
-
### G7 members (G7)
[data/g7.csv](data/g7.csv)
Sources:
-
### G77 members (G77)
[data/g77.csv](data/g77.csv)
Sources:
[The Member States of the Group of 77](http://www.g77.org/doc/members.html)
### Countries graduated from Least Developed Countries (LDCs) (GRADUATED_LDCS)
[data/graduated-ldcs.csv](data/graduated-ldcs.csv)
Sources:
[LDCs at a Glance](https://www.un.org/development/desa/dpad/least-developed-country-category/ldcs-at-a-glance.html)
### International Maritime Organization (IMO)
[data/imo.csv](data/imo.csv)
Sources:
[UN Treaty Collection - Convention on the International Maritime Organization](https://treaties.un.org/pages/ViewDetails.aspx?src=TREATY&mtdsg_no=XII-1&chapter=12&clang=_en)
### Least Developed Countries (LDCs) (LDC)
[data/ldc.csv](data/ldc.csv)
Sources:
[LDCs at a Glance: List of all LDCs in PDF format, (updated 24 Nov 2021)](https://www.un.org/development/desa/dpad/wp-content/uploads/sites/45/publication/ldc_list.pdf)
### Landlocked Developing Countries (LLDCs) (LLDC)
[data/lldc.csv](data/lldc.csv)
Sources:
[UN-OHRLLS: Landlocked Developing Countries](http://unohrlls.org/about-lldcs/country-profiles/)
### UNFCCC Non-Annex I parties (NON_ANNEX_ONE)
[data/non-annex-one.csv](data/non-annex-one.csv)
Sources:
[List of Non-Annex I Parties to the Convention](http://unfccc.int/parties_and_observers/parties/non_annex_i/items/2833.php)
### Organisation for Economic Co-operation and Development (OECD) (OECD)
[data/oecd.csv](data/oecd.csv)
Sources:
[List of OECD Member countries - Ratification of the Convention on the OECD](http://www.oecd.org/about/membersandpartners/list-oecd-member-countries.htm)
### OPEC members (OPEC)
[data/opec.csv](data/opec.csv)
Sources:
[OPEC - Member Countries](http://www.opec.org/opec_web/en/about_us/25.htm)
### Small Island Developing States (SIDS) (SIDS)
[data/sids.csv](data/sids.csv)
Sources:
[Small Island Developing States, List of SIDS](https://sustainabledevelopment.un.org/topics/sids/list)
### Montreal Protocol
[data/montreal_protocol_countries.json](data/montreal_protocol_countries.json)
[data/montreal_protocol_high_ambient_temp.csv](data/montreal_protocol_high_ambient_temp.csv)
Sources:
[Article 5 / Non-Article 5 status](https://ozone.unep.org/classification-parties)
[Group 1 and 2 and high-ambient-temperature classification](https://ozone.unep.org/treaties/montreal-protocol/meetings/twenty-eighth-meeting-parties/decisions/decision-xxviii2-decision-related-amendment-phasing-down-hydrofluorocarbons)
### Non-UN Members/Associate Members of Regional Commissions of SIDS (SIDS_NON_UN_OR_REGIONAL_COMMISSIONS_ASSOCIATES)
[data/sids-non-un-or-regional-commissions-associates.csv](data/sids-non-un-or-regional-commissions-associates.csv)
Sources:
[Small Island Developing States, List of SIDS](https://sustainabledevelopment.un.org/topics/sids/list)
### Regional groups for the Shared Socioeconomic Pathways (SSPs) (SSP)
[data/ssp.csv](data/ssp.csv)
Sources:
-
### Umbrella group (UMBRELLA)
[data/umbrella.csv](data/umbrella.csv)
Sources:
[UN Climate Change Party Groupings](http://unfccc.int/parties_and_observers/parties/negotiating_groups/items/2714.php)
### UN Regional Groups of Member States (UN_REGIONAL_GROUPS)
[data/un-regional-groups.csv](data/un-regional-groups.csv)
Sources:
[United Nations Regional Groups of Member States](http://www.un.org/depts/DGACM/RegionalGroups.shtml)
### Members of the UNFCCC (UNFCCC)
[data/unfccc.csv](data/unfccc.csv)
Sources:
[Status of Ratification of the Convention](http://unfccc.int/essential_background/convention/status_of_ratification/items/2631.php)
### UN Statistical Division Geographical Regions (UNSTATS_GEOGRAPHICAL_REGIONS)
[data/unstats-geographical-regions.json](data/unstats-geographical-regions.json)
Sources:
[UN Statistics Division - Standard country or area codes for statistical use (M49)](https://unstats.un.org/unsd/methodology/m49/)
## Preparation
The `Makefile` used to generate the CSV files requires Python3 and will
automatically install its dependencies into a Virtualenv when run with
```shell
make
```