Running the scripts

Using Github CodeSpaces is a super easy way to run the scripts. It opens a version of the popular Microsoft VSCode in a browser and already has Python installed, and a terminal for running the script.

Here are the steps to run a script:

To run the generate_generation_transformations.sh script Get the required input files from the website as documented at https://github.com/eclipse/efbt/wiki/Downloading-Files-from-the-ECB-website .

To run the create_ldm_and_explode_subtypes.sh We need files from SQLDeveloper, follow the instructions at https://github.com/eclipse/efbt/wiki/Export-Files-form-SQLDeveloper. You will also need the arcs file which can be obtained following these instructions https://github.com/eclipse/efbt/wiki/Running-the-Get_arcs-script

Sign in to Github with an account (Github accounts are free)

Go to the eclipse EFBT Github page https://github.com/eclipse/efbt

Switch from master branch to its develop branch by clicking on “Master” and choosing “Develop”

Click on Code-> CodeSpaces -> “..” ,then choose create codespace with options, and choose 4-core machine type to create a new codespace on develop...see below:

To upload files needed for create_ldm_and_explode_subtypes.sh:

On codespaces file explorer navigate to bird->bird_utilities->ldm_tools->resources

Right click on resources and choose “upload”, and choose the csv files that you have locally.

To upload files needed for generate_generation_transformations.sh:

On codespaces file explorer navigate to bird->birdseed_creator->resources

Right click on resources and choose “upload”, and choose the csv files that you have locally.

The bottom line of the browser will provide an update on progress of this upload, it should not take too long (maybe 30 seconds with medium speed internet)

When the upload is completed, then In the terminal on the bottom right just type the name of the script but with ./ before it, so for example:

./generate_generation_transformations.sh

or

./create_ldm_and_explode_subtypes.sh

or

./create_reports.sh

you can look in the relevant results\ directory directory for results which will be in the same folder as the relevant resources directory...and look at the sub-directories of this results folder.

You can download any of these results files by right clicking and choosing download

Or Alternatively:

We should have a local copy of that Github repository, and a python interpreter installed.