Graph service - Java backend
============================

Server side Java RPC API.

Build
-----

```bash
$ mvn compile assembly:single
```

Start RPC API
-------------

```bash
$ java -cp target/swh-graph-*.jar \
    org.softwareheritage.graph.server.App \
    <compressed_graph_path>
```

Default port is 5009 (use the `--port` option to change port number). If you
need timings metadata send back to the client in addition to the result, use the
`--timings` flag.

Tests
-----

Unit tests rely on test data that are already available in the Git repository
(under `src/swh/graph/tests/dataset/`). You generally only need to run them
using Maven:

```bash
$ mvn test
```

In case you want to regenerate the test data:

```bash
# Graph compression
$ cd src/swh/graph/tests/dataset
$ ./generate_graph.sh
$ cd ../../../..

$ mvn compile assembly:single
# Dump mapping files
$ java -cp target/swh-graph-*.jar \
    org.softwareheritage.graph.maps.NodeMapBuilder \
    src/swh/graph/tests/dataset/example.nodes.csv.gz \
    src/swh/graph/tests/dataset/output/example
```