Building¶

Getting project source code¶

1. Clone the project Git repository
   

   $ git clone --recursive https://forge.ispras.ru/git/veritrans.git
   

2. The command above creates 'veritrans' directory with project's code inside it. Enter the 'veritrans' directory and do the following:
   

   $ git submodule init
   $ git submodule update
   

These commands get code of project's submodules to the current location.

Building and running Verilog Translator from command line¶

To build Verilog Translator and run JUnit tests we use Gradle. Please install it first (Gradle 4.10.3 is recommended) or use Gradle wrapper script ('gradlew.bat' for Windows, 'gradlew' for Unix).

To compile main classes run:

gradle classes

To compile test classes run:

gradle testClasses

To run all unit tests run:

gradle test

To list all Gradle commands run:

gradle tasks

Building and running Verilog Translator from Eclipse IDE¶

1. Install Buildship Gradle integration plugin for Eclipse IDE.
2. Create init.gradle file in the $HOME/.gradle directory and write the following to it:
   

   allprojects
   {
     apply plugin: 'eclipse'
   
     it.eclipse
     {
       classpath.downloadJavadoc = true
     }
   }
   

3. Import Verilog Translator's sources into Eclipse workspace:
• Use the menu item "File/Import...".
• Choose "Gradle/Gradle Project".
• Select the "veritrans" directory as the root directory, press "Next".
• Select the "Gradle wrapper (recommended)" import option.
• Press the "Finish" button: the project will be opened in the Eclipse IDE.