IATI NonEmbedded Codelists

Introduction

These are codelists used by the IATI Standard, but not "Embedded" within it, so not subject to the same change control progress. For more information see https://github.com/IATI/IATI-Codelists#embedded-vs-nonembedded-codelists

Updates

Updates can come from a variety of sources, including OCED DAC and CRS Codes and ISO updates (e.g. new currency link)

Process

1. Create a branch from master and commit the codelist changes
2. Create a Pull Request from the branch to master
3. Have Pull Request reviewed/approved
4. Merge Pull Request to update master

Downstream Updates

IATI Standard Website

• The IATI/IATI-Reference-Generator repo should be used to rebuild the SSOT documentation and upload to the website following that process.
• This will ensure the updates to the codelists are reflected on the IATI Standard website.

IATI Validator

• The Validator utilises a transformed version of the Codelists stored in IATI/IATI-Validator-Codelists.
• When changes are pushed to this master branch, the update-validator-codelists job in .github/workflows/CI.yml triggers a GitHub action in IATI/IATI-Validator-Codelists.
• Follow the Update Process as documented in the IATI-Validator-Codelists repo

IATI Datastore

• The Datastore Search utilises a transformed version of the Codelists stored in IATI/dss-filters
• When changes are pushed to this master branch, the call-update-dss-filters job in .github/workflows/CI.yml triggers a GitHub action in IATI/dss-filters.
• See IATI/dss-filters for instructions on updating the Codelists used by Datastore Search.

Information for developers

This tool supports Python 3.x. To use this script, we recommend the use of a virtual environment::

python3 -m venv pyenv
source pyenv/bin/activate
pip install -r requirements.txt
python convert.py