Hephaistos

Test Environment

We use the Docker for testing.

To build a docker image you will need:

• Docker Desktop
• Clone this repository

Building Docker Image on Ubuntu

• Install the Docker Desktop. Feel free to choose any version you want.
• This repository is based on latest version of Docker Desktop.

  git clone https://github.com/ssu-csec/hephaistos.git
  cd ./hephaistos/scripts && ./build.sh

• build.sh: Builds the image automatically using the Dockerfile

Troubleshooting

Sometimes, building the docker image does not work properly.

If some scripts are not working, use the run.sh.

cd ./hephaistos/scripts/ && ./run.sh

• If the JavaScript Analyzer is not working in your container:

  cd /tmp/hephaistos
  # command: node Hephaistos.js <crawled data path>
  node Hephaistos.js ./CustomTRC/results/easylist_test
  # or
  node Hephaistos.js ./CustomTRC/results/tranco_test

• To evaluate the analysis results:

  cd /tmp/hephaistos/tools && node evaluate.js /tmp/hephaistos/CustomTRC/results/easylist_test
  # or
  cd /tmp/hephaistos/tools && node evaluate.js /tmp/hephaistos/CustomTRC/results/tranco_test

• To generate statistics from the evaluation results:

  cd /tmp/hephaistos/tools && node statistic.js /tmp/hephaistos/CustomTRC/results/easylist_test/results
  # or
  cd /tmp/hephaistos/tools && node statistic.js /tmp/hephaistos/CustomTRC/results/tranco_test/results