Project voor *Vertalerbouw*
Go to file
User ec8617354e refactor packages, add package-info 2019-02-07 02:15:07 +01:00
doc included array offsets, added tests, updated report and highlighting 2018-04-25 19:43:30 +02:00
lib revert Core language, remove Ant lib, remove maven, update build.xml 2019-02-07 02:09:36 +01:00
src/pp refactor packages, add package-info 2019-02-07 02:15:07 +01:00
util included array offsets, added tests, updated report and highlighting 2018-04-25 19:43:30 +02:00
.gitignore added Ant build file, readme, CLI and JAR build 2018-03-27 17:56:36 +02:00
README.md added Ant build file, readme, CLI and JAR build 2018-03-27 17:56:36 +02:00
build.xml revert Core language, remove Ant lib, remove maven, update build.xml 2019-02-07 02:09:36 +01:00

README.md

Prerequisites

Boppi requires JDK 1.8 or higher and Ant. Both must be available in the environment.

Installation

Run ant build to perform a basic build of the project: it initialises output directories, generates ANTLR files and compiles all java files. To skip ANTLR file generation, run ant do-init and ant do-build separately.

Run ant build-all to do the above and generate javadoc documentation, run JUnit tests and produce a runnable JAR file.

To see all possible targets, run ant -verbose -projecthelp.

Command line use

After building a JAR file, a command boppi becomes available in the dist/ folder. This command can be used to compile and run files or perform an interactive session. See boppi --help and boppi interactive --help for more information.

Directory structure

  • bin contains compiled java code and required text files (after ant do-build)
  • dist contains a runnable JAR, script files and a copy of the libraries required to run the JAR (after ant do-build-jar)
  • doc contains a report of the project and attached example files
    • doc/javadoc contains javadoc documentation of the project (after ant do-javadoc)
    • doc/junit contains a report of JUnit tests (after ant do-junit and ant do-junit-report)
  • lib contains Java libraries required for the project, excluding those in the JDK 1.8
  • src
    • src/pp/iloc contains java code for a slightly modified ILOC virtual machine
    • src/pp/s1184725/boppi contains java code for the Boppi language
  • util contains Pygments lexers for both ILOC and Boppi and scripts to run the Boppi command line interface (used for the JAR build).