From 991fb9439ef5aa5754e78988e90be4fdd3243851 Mon Sep 17 00:00:00 2001
From: Victor Pellan <victor.pellan@datadoghq.com>
Date: Fri, 8 Nov 2024 18:08:41 +0100
Subject: [PATCH] Changed the way to force tests from env var to JSON

---
 .github/forced-tests-list.json     |  0
 .github/workflows/system-tests.yml | 19 +++++++++++---
 docs/ForcingSystemTests.md         | 40 ++++++++++++++++++++++++++++++
 3 files changed, 55 insertions(+), 4 deletions(-)
 create mode 100644 .github/forced-tests-list.json
 create mode 100644 docs/ForcingSystemTests.md

diff --git a/.github/forced-tests-list.json b/.github/forced-tests-list.json
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/.github/workflows/system-tests.yml b/.github/workflows/system-tests.yml
index 5bbd2e60a3f..92f6bc38193 100644
--- a/.github/workflows/system-tests.yml
+++ b/.github/workflows/system-tests.yml
@@ -11,9 +11,7 @@ on:
 env:
   REGISTRY: ghcr.io
   REPO: ghcr.io/datadog/dd-trace-rb
-  ST_REF: main
-  FORCE_TESTS:
-  FORCE_TESTS_SCENARIO:
+  ST_REF: main # This must always be set to `main` on dd-trace-rb's master branch
 
 jobs:
   build-harness:
@@ -111,6 +109,8 @@ jobs:
     name: Build (${{ matrix.app }})
     permissions:
       packages: write
+    outputs:
+      FORCED_TESTS_LIST_JSON: ${{steps.read_forced_tests_list.outputs.FORCED_TESTS_LIST_JSON}}
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -125,6 +125,12 @@ jobs:
           path: 'binaries/${{ matrix.library.path }}'
           fetch-depth: 2
           persist-credentials: false
+      - name: Read forced-tests-list.json file
+        id: read_forced_tests_list
+        run: |
+          echo "FORCED_TESTS_LIST_JSON<<EOF" >> $GITHUB_OUTPUT
+          echo "$(cat binaries/dd-trace-rb/.github/forced-tests-list.json)" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
       - name: Pull released image
         run: |
           if docker pull ${{ env.REPO }}/system-tests/${{ matrix.library.name }}/${{ matrix.image }}-${{ matrix.app }}:latest; then
@@ -299,12 +305,17 @@ jobs:
         run: |
           docker image list
       - name: Run scenario
+        # The last escape sequence check if the JSON string exists,
+        # then check if the current scenario is contained in it, then create a string by chaining -F and forced tests.
+        # A potential error might come from an empty array in a scenario in the json file.
         run: |
-          ./run.sh ++docker ${{ matrix.scenario }} ${{matrix.scenario == env.FORCE_TESTS_SCENARIO && env.FORCE_TESTS || ''}}
+          ./run.sh ++docker ${{ matrix.scenario }} \
+            ${{ env.FORCED_TESTS_LIST && fromJSON(env.FORCED_TESTS_LIST)[matrix.scenario] && format('-F {0}', join(fromJSON(env.FORCED_TESTS_LIST)[matrix.scenario], ' -F ')) || ''}}'
         env:
           DD_API_KEY: ${{ secrets.DD_APPSEC_SYSTEM_TESTS_API_KEY }}
           SYSTEM_TESTS_AWS_ACCESS_KEY_ID: ${{ secrets.SYSTEM_TESTS_IDM_AWS_ACCESS_KEY_ID }}
           SYSTEM_TESTS_AWS_SECRET_ACCESS_KEY: ${{ secrets.SYSTEM_TESTS_IDM_AWS_SECRET_ACCESS_KEY }}
+          FORCED_TESTS_LIST: ${{ needs.build-apps.outputs.FORCED_TESTS_LIST_JSON }}
       - name: Archive logs
         uses: actions/upload-artifact@v4
         if: ${{ always() }}
diff --git a/docs/ForcingSystemTests.md b/docs/ForcingSystemTests.md
new file mode 100644
index 00000000000..1bd636d024b
--- /dev/null
+++ b/docs/ForcingSystemTests.md
@@ -0,0 +1,40 @@
+# Forcing System Tests
+
+During development, you may want to force-execute specific system-tests on dd-trace-rb CI while their declaration aren't merged yet on system-tests side.
+To do so, you can complete the `.github/forced-tests-list.json` file by following this template:
+
+```json
+{
+  "SYSTEM_TEST_SCENARIO_1":
+    [
+      "tests/test_forced_file.py",
+      "tests/test_forced_file.py::Test_ForcedClass",
+      "tests/test_forced_file.py::Test_ForcedClass::test_forced_method"
+    ],
+  "SYSTEM_TEST_SCENARIO_2":
+    [
+      ...
+    ],
+    ...
+}
+```
+
+## Example
+
+```json
+  {
+  "DEFAULT":
+    [
+      "tests/appsec/waf/test_miscs.py::Test_CorrectOptionProcessing",
+      "tests/test_semantic_conventions.py::Test_Meta::test_meta_span_kind"
+    ],
+  "APPSEC_STANDALONE":
+    [
+      "tests/appsec/test_asm_standalone.py"
+    ]
+}
+```
+
+## Cleanup
+
+You can leave other force-executed tests added by other developers and append yours to the .json file, there is a cleanup task in the release process.
\ No newline at end of file