aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorFederico Igne <federico.igne@cs.ox.ac.uk>2021-01-08 17:50:57 +0000
committerFederico Igne <federico.igne@cs.ox.ac.uk>2021-01-08 17:50:57 +0000
commit35f41c0529f65c4b3ee941e087d497a931d17d9e (patch)
treeab950ccc9a3457a4c60b0d4941dd080301cca13f /README.md
parentb0e195336a950095a733f32bf07754254ed08a37 (diff)
downloadRSAComb-35f41c0529f65c4b3ee941e087d497a931d17d9e.tar.gz
RSAComb-35f41c0529f65c4b3ee941e087d497a931d17d9e.zip
Add sbt plugin to create jar with dependences
Also update README.md with info on how to compile and run the program.
Diffstat (limited to 'README.md')
-rw-r--r--README.md33
1 files changed, 28 insertions, 5 deletions
diff --git a/README.md b/README.md
index dbf0ead..55a4b01 100644
--- a/README.md
+++ b/README.md
@@ -11,19 +11,42 @@ In order to use this program you need to have [RDFox](https://www.oxfordsemantic
11RDFox is proprietary software and as such we are not able to distribute it along with our code. 11RDFox is proprietary software and as such we are not able to distribute it along with our code.
12Please refer to [this link](https://www.oxfordsemantic.tech/tryrdfoxforfree) to request a free trial. 12Please refer to [this link](https://www.oxfordsemantic.tech/tryrdfoxforfree) to request a free trial.
13 13
14This software has been developed and tested with RDFox v.4.0 14This software has been developed and tested with RDFox v.4.1
15 15
16## Using the software 16## Using the software
17 17
18TODO 18We assume you followed [these steps](https://docs.oxfordsemantic.tech/getting-started.html#getting-started) in order to setup RDFox on your personal machine and in particular you know the path to the `JRDFox.jar` library that comes with the distribution.
19 19
20### Provide RDFox license 20### Provide RDFox license
21 21
22TODO 22The [documentation](https://docs.oxfordsemantic.tech/features-and-requirements.html#license-key), describes several ways to provide the license to RDFox.
23 23
24### Compiling the project 24One easy way is to put your license key in a file `RDFox.lic` in `$HOME/.RDFox/`, with adeguate read permissions for the user executing the program.
25 25
26TODO 26### Compiling and running the project
27
28The project uses [sbt](https://www.scala-sbt.org/) to manage dependences.
29
30To compile the project run the following from the base directory:
31```
32sbt compile
33```
34
35The project uses the sbt plugin [sbt-assembly](https://github.com/sbt/sbt-assembly) to produce a fat jar with all the required dependences.
36Run the following from the base directory of the project to produce a standalone `jar` file.
37```
38sbt assembly
39```
40
41The output of the command will print the location of the produced jar. Execute it with
42```
43java -jar <path/to/fat.jar> [<option> ...]
44```
45
46Note that the fat jar file distributed with this repository excludes the RDFox as a dependency. Provided that you have the RDFox setup on your machine, you can run the program as follows
47```
48java -cp <path/to/JRDFox.jar>:<path/to/fat.jar> uk.ac.ox.cs.rsacomb.RSAComb [<option> ...]
49```
27 50
28### Running tests and examples 51### Running tests and examples
29 52