This repository contains transformations to the TAD System Card. Currently supported transformations:
- Algoritmeregister (v0.1.0, v0.4.0, v1.0.0) --> TAD System Card (v0.1a3).
- Toetsingskader algoritmes (v1) --> TAD Assessment Card (v0.1a3).
The following are required:
- yq. On MacOs install yq by executing the following command
in the terminal:
brew install yq
- Python and Poetry. To install Python, follow these instructions. To install Poetry follow, these instruction.
Before using the conversion scripts run:
poetry installThe directory transformations/ contains the transformation files. These transformation files
can be loaded by yq to transform a given input format to TAD System Cards. One can add transformations
for new input formats.
The directory scripts contains shells scripts for converting the algoritmeregister and the toetsingskader
algoritmes to TAD System Cards and Assessment Cards respectively.
The command
./scripts/convert_algoritmeregister.shwill load the whole algoritmeregister from this resource.
This will create a directory out/ in which TAD System Cards will be generated from the entries from the
algoritmeregsiter. The System Cards will have filenames {organization}_{name}.yml.
Furthermore, it is also possible to provide an explicit file to this script, which will convert a csv
file containing entries from the algoritmeregister to System Cards by executing:
./scripts/convert_algoritmeregister.sh <PATH_TO_ALGORITMEREGISTER_CSV>The command
./scripts/convert_toetsingskader_v1.shwill load the empty toetsingskader algoritmes v1 from this resource.
This will create an Assessment Card in out/toetsingskader_algoritmes_v1.yml.
Furthermore, it is also possible to provide an explicit file to this script, which will convert a xlsx
file of a toetsingskader algoritmes to a Assesment Card by executing:
./scripts/convert_toetsingskader_v1.sh <PATH_TO_TOETSINGSKADER_XLSX>To test the algoritmeregister transformations, run:
./scripts/tests/test_algoritmeregister_transform.shTo test the toetsingskader transformation, run:
./scripts/tests/test_toetsingskader_transform.sh