unison/development.markdown at edd0e84e70e5a52c275eb9db7e8808a0d1318235

mirror of https://github.com/unisonweb/unison.git synced 2024-11-13 22:29:35 +03:00

Arya Irani dc4b8054ad bump sbt version to 1.1.2, restoring incremental compilation

removed sbt-onejar plugin as it isn't yet compatible
https://github.com/sbt/sbt-onejar/issues/35

and updated development.markdown

2018-06-25 19:13:05 -04:00

These are commands that will likely be useful during development.

Scala

Launch sbt in runtime-jvm directory, then here are various useful commands:

main/test:run - runs all the tests
main/test:run compilation - runs tests prefixed by "compilation"
main/test:run 102932 compilation.let3 - runs tests prefixed by "compilation.let3" with the random seed 102932
benchmark/run - presents menu of benchmarks to run
;clean;coverage;main/test:run;coverageReport followed optionally by ;coverageOff - generates test coverage report
main/compile - builds the interpreter
main/run - builds and runs the interpreter

The runtime doesn't build with JDK 10 at the moment, but this will work:

JAVA_HOME=`/usr/libexec/java_home -v 9` sbt <commands ...>

To run the built interpreter without booting sbt:

scala -cp main/target/scala-2.12/classes org.unisonweb.Bootstrap test.ub

or from the project root directory:

scala -cp runtime-jvm/main/target/scala-2.12/classes org.unisonweb.Bootstrap test.ub

For doing compilation you can do:

stack repl unison-parser-typechecker

From here, do Main.main to run the tests and :r for rapid recompile.

You can also do:

stack build unison-parser-typechecker

If you want to run the tests outside the REPL.

What if you want a profiled build? Do:

stack build --executable-profiling --library-profiling --ghc-options="-fprof-auto -rtsopts" unison-parser-typechecker

Again you can leave off the flag. To run an executable with profiling enabled, do:

stack exec -- <executable-name> +RTS -p

That will generate a <executable-name>.prof plain text file with profiling data. More info on profiling.