JBR Hook - CLI

A jbr hook type for a CLI-based hook.

Requirements

• Node.js (1.12 or higher)
• An existing jbr experiment that requires a hook.

Configure an experiment hook

If an experiment requires a hook, then you can install this CLI-based hook as follows.

$ jbr set-hook someHook cli

Output

output/logs/cli-stdout.txt: Logs of stdout. output/logs/cli-stderr.txt: Logs of stderr.

Configuration

When installing this hook, your configuration file (jbr-experiment.json) will contain the following:

...
  "someHook": {
    "@id": "urn:jrb:bb:hookSome",
    "@type": "HookCli",
    "entrypoint": [
      "comunica-sparql-http",
      "file@generated/dataset.nt",
      "-p",
      "3001"
    ],
    "statsFilePath": "stats.csv"
  }
...

Configuration fields

• entrypoint: Array of command parts to execute when starting the experiment. Except on Windows, the command runs in its own process group, so that stopping the experiment also stops processes it spawned (for example when started via npx).
• statsFilePath: Optional path to a CSV file in which the stats of the process will be written. CPU and memory usage are summed over the process and all its descendants.

License

jbr.js is written by Ruben Taelman.

This code is copyrighted by Ghent University – imec and released under the MIT license.