Skip to content

Check that your data complies with the Risk Data Library Standard (RDLS) using our open source data review tool

License

Notifications You must be signed in to change notification settings

GFDRR/rdls-cove

Repository files navigation

RDLS Conversion and Validation Tool

This repository is for maintaining the RDLS Conversion and Validation Tool, which can be used by data publishers to create metadata in the Risk data Library Standard, by converting the spreadsheet template to the JSON metadata format.

Linked repo: rdls-lib-cove

The standard is documented at rdl-standard.readthedocs.io. The documentation is maintained at github.com/GFDRR/rdl-standard.

Dev installation

git clone https://github.com/GFDRR/rdls-cove gfdrr-rdls-cove
cd gfdrr-rdls-cove
virtualenv .ve --python=/usr/bin/python3
source .ve/bin/activate
pip install -r requirements_dev.txt
python manage.py migrate
python manage.py compilemessages
python manage.py runserver

You may need to pass 0.0.0.0:8000 to runserver in the last step, depending on your development environment.

Note: requires gettext to be installed. This should come by default with Ubuntu, but just in case:

apt-get update && apt-get install gettext

Dev with Docker

Docker is used in production, so sometimes you may want to run locally with Docker to debug issues:

docker compose -f docker-compose.dev.yml down # (if running)
docker compose -f docker-compose.dev.yml build --no-cache
docker compose -f docker-compose.dev.yml up # (to restart)

To run commands, make sure environment is running (see up command above) then:

docker compose -f docker-compose.dev.yml run rdls-cove-app-dev python manage.py migrate

Translations

We use Django's translation framework to provide this application in different languages. We have used Google Translate to perform initial translations from English, but expect those translations to be worked on by humans over time.

Translations for Translators

Translators can provide translations for this application by becomming a collaborator on Transifex https://www.transifex.com/OpenDataServices/cove

Translations for Developers

For more information about Django's translation framework, see https://docs.djangoproject.com/en/1.8/topics/i18n/translation/

If you add new text to the interface, ensure to wrap it in the relevant gettext blocks/functions.

In order to generate messages and post them on Transifex:

First check the Transifex lock <https://opendataservices.plan.io/projects/co-op/wiki/CoVE_Transifex_lock>, because only one branch can be translated on Transifex at a time.

Then:

python manage.py makemessages -l en
tx push -s

In order to fetch messages from transifex:

tx pull -a

In order to compile them:

python manage.py compilemessages

Keep the makemessages and pull messages steps in thier own commits seperate from the text changes.

To check that all new text is written so that it is able to be translated you could install and run django-template-i18n-lint

pip install django-template-i18n-lint
django-template-i18n-lint cove

Adding and updating requirements

Add a new requirements to requirements.in or requirements_dev.in depending on whether it is just a development requirement or not.

Then, run pip-compile requirements.in && pip-compile requirements_dev.in this will populate requirements.txt and requirements_dev.txt with pinned versions of the new requirement and its dependencies.

pip-compile --upgrade requirements.in && pip-compile --upgrade requirements_dev.in will update all pinned requirements to the latest version. Generally we don't want to do this at the same time as adding a new dependency, to make testing any problems easier.

About

Check that your data complies with the Risk Data Library Standard (RDLS) using our open source data review tool

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published