Installing the Bird/Nescio IDE

The Bird/Nescio IDE is based on Eclipse and the Rascal Language. These are the steps to install it and create a new Bird/Nescio project:

1. Download Eclipse IDE for RCP and RAP Developers, available at www.eclipse.org/downloads/packages/
2. Once in the Eclipse IDE, go to the menu Help -> Install New Software...
3. On the "Install" dialog, next to the "Work with" textbox, type https://nescio.swat.engineering/update-site/ and stroke the Enter key.
4. You can see that there is a new item called "Bird/Nescio DSLs" next to a checkbox. Check it and press "Next>".
5. The Install Details of the selected component are displayed. Press "Next>".
6. The license details for the selected component are displayed. Accept the terms and press "Finish". The plugin will start its installation. At some point, a security warning dialog will be presented. Click on the "Install anyway" button.
7. A dialog soliciting the restart of Eclipse is presented. Click on "Restart Now". After the restart, the Eclipse Bird/Nescio IDE is succesfully installed.

Creating a blank project on the Bird/Nescio IDE

Once the Bird/Nescio IDE is installed, these are the steps to create a new project and the associated files:

1. Go to the menu File -> New -> Project...
2. On the "New Project" dialog, select "Bird/Nescio - Bird/Nescio Project" and press "Next>"
3. Name the project and press "Finish".
4. The new project direct structure is ready and displayed on the IDE. Notice there is an "src" folder. Both the Bird descriptions (format .bird) and the Nescio specifications (format .nescio) must be put there, if not physically, via a symlink. there is also a "generated" folder. There inside will be both the Java parsers generated by the Bird descriptions, and the Java anonymizers generated by the Nescio specifications.
5. Configure the details about the docker image on file META-INF/RASCAL.MF, in particular, the base Java package for all the generated code (BasePackage).
6. To start the development of an Bird/Nescio module, right click on the project root folder and select the menu New -> Other...
7. a) To develop a Bird specification: On the "New" dialog, select "Bird/Nescio - Bird Module" and press "Next>". (b) To develop a Nescio specification: On the "New" dialog, select "Bird/Nescio - Nescio Module" and press "Next>".
8. Name the module and press "Finish".
9. The new module file (extension .bird or .nescio) is created in folder "generated" and its content is displayed. Notice that it already contains a simple specification as a template.
10. Each time a Bird module is saved, a new Java file containing a parser for such specification is generated on the "generated" folder.
11. Each time a Nescio module is saved, a new Java file containing the anonymizer based on such specification is generated on the "generated" folder. The parsers for the bird files that this Nescio files import must be generated for this anonymizer to succesfully compile.