TRex

TRex Feature Highlights

  • Editing TTCN-3 v3.1.1 (2005-06)
    • Syntax highlighting
    • Content Assist
    • Outline view
    • Code Formatter
    • Text Hover
    • Open Declaration
    • Find References
  • Compiler Integration
    • Telelogic Tau G2/Tester
  • Refactoring
  • Metrics
    • Calculation of some TTCN-3 metrics
    • Metrics-based refactoring suggestions

Requirements for Running TRex

  • The TRex installer provides a TRex standalone product which includes the Eclipse 3.2 platform and SUN's Java 5 Virtual Machine. I.e. there are no requirements.
  • If you already have Eclipse installed, you probably want to install TRex as plug-in to the existing installation. In this case, take care that you meet the following requirements:
    • Eclipse >=3.2
    • Java Virtual Machine >=5
      • We use Java 5 language constructs. Hence, you need JRE >= 5.0 for running the TRex plugins. Download SUN's JRE 5.0 from http://java.sun.com/j2se/1.5.0/download.jsp . (If you intend to do also development in Java, you better download SUN's JDK 5.0 which includes JRE 5.0.)

Requirements for Building TRex

In addition to the above requirements for running TRex as a plug-in, you need the following:

  • a Subversion (SVN) client
    To access the sources, an SVN client is required.
    • For manual build, you might want to use one of the SVN client plugins for Eclipse, i.e. either Subclipse or Subversive. Both clients have strengths and weaknesses:
      • Subversive does not have all the functionality of Subclipse, but the existing functionality provides a better user experience. In particular, Subversive works better out of the box.
      • Subclipse is better in terms of functionality, in particular quick diff blame annotations and the Eclipse 3.2 history view supporting linked mode with on the fly loading of history. Furthermore, it has an integration with our JIRA bug tracking system based on the commit logs.
    • For the headless automated build, any SVN client may be used to initially checkout de.ugoe.cs.swe.trex.build .
  • Java compiler >=5
    • Eclipse includes it's own Java 5 compiler. However, documentation and source of the standard Java libraries are not part of Eclipse's Java compiler. Hence, it is recommended to install a standalone JDK >= 5.0 which provides source and documentation. Download SUN's JDK 5.0 from http://java.sun.com/j2se/1.5.0/download.jsp .
  • ANTLR plugin for Eclipse (for manual build from inside Eclipse)
    • To edit and compile the ANTLR 2.7.x files with the TTCN-3 grammar, the ANTLR plugin for Eclipse is quite convenient: http://antlreclipse.sourceforge.net/ . However, it does not compile the ANTLR files in the right order. (It is only usable if you impose the right order by compiling the ANTLR files manually.) Therefore, we recommed to use our branched version below:
    • We have branched the ANTLR plugin for Eclipse to adjust it to our needs. Our branched version is available here for download and the source is available at www.trex.informatik.uni-goettingen.de/svn/antlreclipse. It introduces two major changes: it contains an integration with the ANTLR pretty printer from Loring Craymer and it introduces an intelligent ANTLR grammar builder respecting grammar dependencies. That way, it is not necessary to compile the grammars by hand any more.
      Note: since Eclipse 3.3, this plug-in seems to trigger an error dialogue each time an ANTLR grammer file is modified, i.e. the plug-in still works, but you have to acknowledge the error each time.
      Install this branch as follows:
      • First install the ANTLR plugin from sourceforge http://antlreclipse.sourceforge.net/ ,
      • Then copy the two jar files from http://www.trex.informatik.uni-goettingen.de/antlreclipse into the plugin folder where the old ANTLR plugin files reside (you do not even need to delete the old ANTLR plugin jar files).
      • That's all! After your next start of Eclipse, you may verify that the correct version of the ANTLR plugin is installed: Help->About Eclipse SDK->Plug-In Details. Scroll down to where the ANTLR plug-ins are listed and verify that in the Version column a version starting with '5' ist shown. (While the latest official release from sourceforge is version 4.x.y, our branch uses version number 5.x.y.)
  • Apache Ant (for headless automated build)
    • In fact our automated build uses further software in addition to Apache Ant itself, but all of this additional software is bundled in our automated build system. Download Apache Ant from http://ant.apache.org/bindownload.cgi .
YourKit Java Profiler