#78 Added RESTler fuzzer scripts (#81)

README.md

@@ -25,7 +25,6 @@ gradle :botalka:bootJar
 ### Start infrastructure
 
 ```bash
-docker compose down
 docker compose up --build --force-recreate
 ```
 
@@ -35,3 +34,9 @@ docker compose up --build --force-recreate
 docker exec -it lms-database bash
 psql -h localhost -p 5432 -d $POSTGRES_DB -U $POSTGRES_USER
 ```
+
+### Connect to fuzzer
+
+```bash
+docker exec -it lms-fuzzer sh
+```

docker-compose.yml

@@ -24,6 +24,18 @@ services:
       POSTGRES_PASSWORD: postgres
     networks:
       - lms-network
+  fuzzer:
+    container_name: lms-fuzzer
+    image: restler
+    stdin_open: true
+    tty: true
+    restart: always
+    volumes:
+      - .:/lms
+    networks:
+      - lms-network
+    profiles:
+      - fuzzing
 networks:
   lms-network:
     driver: bridge

fuzzing/analyze.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+
+RESTler/resultsAnalyzer/Restler.ResultsAnalyzer analyze /Fuzz/RestlerResults
+
+less runSummary.json
+less errorBuckets.json

fuzzing/compile.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env sh
+
+API_SPEC=lms/botalka/src/main/resources/static/openapi/api.yml
+RESTler/restler/Restler compile \
+  --api_spec $API_SPEC

fuzzing/fuzz.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+
+RESTler/restler/Restler fuzz \
+  --settings lms/fuzzing/settings.json \
+  --grammar_file Compile/grammar.py \
+  --dictionary_file Compile/dict.json

fuzzing/settings.json

@@ -0,0 +1,8 @@
+{
+  "host": "lms-botalka",
+  "target_port": 8080,
+  "no_ssl": true,
+  "custom_non_bug_codes": ["400"],
+  "fuzzing_mode": "random-walk",
+  "time_budget": 1
+}