README.md

robocert-metamodel

This repository contains the Eclipse plugins that implement that metamodel of RoboCert. It also includes Java code that implements custom functionality on the model, as well as common helper functionality.

The main representation of the metamodel is robostar.robocert/model/RoboCert.emf. From this, one can generate robostar.robocert/model/RoboCert.ecore by right-clicking in Eclipse and selecting 'Generate Ecore Model'. The two files must be kept in sync, and the Emfatic version must remain the primary source of truth.

This is pre-release material. We greatly appreciate any suggestions, comments, and issues.

Dependencies

• Java 17. This should now be readily available for modern systems (I was able to install it on Ubuntu 20.04, for instance), but likely won't be your default install at time of writing.
• An Eclipse setup (2021-12+) with plugin development tools and the latest version of RoboChart's metamodel checked out (see, for instance, the RoboChart metamodel dependency notes);
• Emfatic (you will need 1.1.0.202207260534 or higher; at time of writing, this means you will need to use the interim branch. This is because of a known bug with string escaping in previous versions.)

• Eclipse Modelling Framework Ecore processing plugins (tested with 2.27.0)
• Maven Maven (tested with 3.8.5)
• Git

Other items may be required. If the list above is incomplete, please file an issue.

How to build and run

Please inform us of any build failures.

Maven

1. $ mvn clean install

Eclipse

1. Right click robostar.robocert/model/RoboCert.emf 1. Click Generate Ecore Model
2. Right click robostar.robocert/model/GenerateRoboCertModel.mwe2 1. Click Run As > MWE2 Workflow

Protocol for updating the metamodel

Whenever updating the metamodel, follow these steps:

1. Perform regression testing
2. Change the language reference manual

If changes to documentations are not possible immediately, create issues indicating exactly what needs to be done.