From e6a8cea17b2f23d0ba1fc706008c57315ade7c61 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Mon, 2 Dec 2024 17:47:40 +0530
Subject: [PATCH 01/52] First draft

---
 .github/workflows/integration_test_run.yaml | 28 +++++++++++++++++++--
 1 file changed, 26 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 267ef33ba..0183e071c 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -294,16 +294,20 @@ jobs:
             module="-k ${{ matrix.modules }}"
           fi
           echo "MODULE=$module" >> $GITHUB_ENV
+      - name: Install Allure Dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install allure-pytest>=2.8.18
       - name: Run k8s integration tests
         working-directory: ${{ inputs.working-directory }}
         if: ${{ inputs.provider == 'microk8s' }}
         run: |
-          tox -e ${{ inputs.test-tox-env }} -- --model testing --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
+          tox -e ${{ inputs.test-tox-env }} -- --model testing --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}  --alluredir=allure-results
       - name: Run lxd integration tests
         working-directory: ${{ inputs.working-directory }}
         if: ${{ inputs.provider == 'lxd' }}
         run: |
-          tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
+          tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}  --alluredir=allure-results
       - name: Tmate debugging session (self-hosted)
         if: ${{ failure() && (inputs.tmate-debug || runner.debug) && inputs.self-hosted-runner }}
         uses: canonical/action-tmate@main
@@ -354,3 +358,23 @@ jobs:
           target: ${{ inputs.zap-target-protocol }}://${{ env.ZAP_TARGET }}:${{ inputs.zap-target-port }}/
           cmd_options: ${{ inputs.zap-cmd-options }}
           rules_file_name: ${{ inputs.zap-rules-file-name }}
+      - name: Get Allure history
+        uses: actions/checkout@v3
+        if: always()
+        continue-on-error: true
+        with:
+          ref: gh-pages
+          path: gh-pages
+      - name: Allure Report action from marketplace
+        uses: simple-elf/allure-report-action@v1.7
+        if: always()
+        with:
+          allure_results: allure-results
+          allure_history: allure-history
+      - name: Deploy report to Github Pages
+        if: always()
+        uses: peaceiris/actions-gh-pages@v2
+        env:
+          PERSONAL_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          PUBLISH_BRANCH: gh-pages
+          PUBLISH_DIR: allure-history

From c39ab8b9004c832dd745a4042d819fb3268296a8 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Mon, 2 Dec 2024 20:40:03 +0530
Subject: [PATCH 02/52] Edits

---
 .github/workflows/integration_test_run.yaml | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 66b69513f..1ff8abeb7 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -152,6 +152,9 @@ on:
         description: Rules file to ignore any alerts from the ZAP scan
         type: string
 
+permissions:
+  contents: write 
+
 jobs:
   integration-test:
     name: Integration tests
@@ -294,20 +297,24 @@ jobs:
             module="-k ${{ matrix.modules }}"
           fi
           echo "MODULE=$module" >> $GITHUB_ENV
-      - name: Install Allure Dependencies
+      - name: (beta) Get Allure option
+        id: allure-option
+        shell: python
         run: |
-          python -m pip install --upgrade pip
-          pip install allure-pytest>=2.8.18
+          import os
+          output = "option=--alluredir=allure-results"
+          with open(os.environ["GITHUB_OUTPUT"], "a") as file:
+              file.write(output)
       - name: Run k8s integration tests
         working-directory: ${{ inputs.working-directory }}
         if: ${{ inputs.provider == 'microk8s' }}
         run: |
-          tox -e ${{ inputs.test-tox-env }} -- --model testing --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}  --alluredir=allure-results
+          tox -e ${{ inputs.test-tox-env }} -- --model testing --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }} ${{ steps.allure-option.outputs.option }}
       - name: Run lxd integration tests
         working-directory: ${{ inputs.working-directory }}
         if: ${{ inputs.provider == 'lxd' }}
         run: |
-          tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}  --alluredir=allure-results
+          tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }} ${{ steps.allure-option.outputs.option }}
       - name: Tmate debugging session (self-hosted)
         if: ${{ failure() && (inputs.tmate-debug || runner.debug) && inputs.self-hosted-runner }}
         uses: canonical/action-tmate@main

From b2208a0cb079053b3b6187ff5c44b5127d4cc832 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 4 Dec 2024 10:50:44 +0530
Subject: [PATCH 03/52] upload allure results

---
 .github/workflows/integration_test_run.yaml | 29 ++++++---------------
 1 file changed, 8 insertions(+), 21 deletions(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 1ff8abeb7..d28295a28 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -309,12 +309,12 @@ jobs:
         working-directory: ${{ inputs.working-directory }}
         if: ${{ inputs.provider == 'microk8s' }}
         run: |
-          tox -e ${{ inputs.test-tox-env }} -- --model testing --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }} ${{ steps.allure-option.outputs.option }}
+          tox -e ${{ inputs.test-tox-env }} -- --model testing --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ steps.allure-option.outputs.option }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }} 
       - name: Run lxd integration tests
         working-directory: ${{ inputs.working-directory }}
         if: ${{ inputs.provider == 'lxd' }}
         run: |
-          tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }} ${{ steps.allure-option.outputs.option }}
+          tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ steps.allure-option.outputs.option }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
       - name: Tmate debugging session (self-hosted)
         if: ${{ failure() && (inputs.tmate-debug || runner.debug) && inputs.self-hosted-runner }}
         uses: canonical/action-tmate@main
@@ -367,23 +367,10 @@ jobs:
           target: ${{ inputs.zap-target-protocol }}://${{ env.ZAP_TARGET }}:${{ inputs.zap-target-port }}/
           cmd_options: ${{ inputs.zap-cmd-options }}
           rules_file_name: ${{ inputs.zap-rules-file-name }}
-      - name: Get Allure history
-        uses: actions/checkout@v3
-        if: always()
-        continue-on-error: true
+      - name: Upload Allure results
+        timeout-minutes: 3
+        uses: actions/upload-artifact@v4
         with:
-          ref: gh-pages
-          path: gh-pages
-      - name: Allure Report action from marketplace
-        uses: simple-elf/allure-report-action@v1.7
-        if: always()
-        with:
-          allure_results: allure-results
-          allure_history: allure-history
-      - name: Deploy report to Github Pages
-        if: always()
-        uses: peaceiris/actions-gh-pages@v2
-        env:
-          PERSONAL_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          PUBLISH_BRANCH: gh-pages
-          PUBLISH_DIR: allure-history
+          name: allure-results-${{ env.MODULE }}
+          path: allure-results/
+          if-no-files-found: error

From b9ad38ab044aeed838939fed8c3502aa0c89ae06 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 4 Dec 2024 14:11:08 +0530
Subject: [PATCH 04/52] added allure-pytest

---
 .github/workflows/integration_test_run.yaml        | 14 +++++++-------
 .../integration/test-rock/requirements.txt         |  1 +
 .../integration/test-upload-charm/requirements.txt |  1 +
 3 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index d28295a28..5e2c1676e 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -315,6 +315,13 @@ jobs:
         if: ${{ inputs.provider == 'lxd' }}
         run: |
           tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ steps.allure-option.outputs.option }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
+      - name: Upload Allure results
+        timeout-minutes: 3
+        uses: actions/upload-artifact@v4
+        with:
+          name: allure-results-${{ matrix.modules }}
+          path: allure-results/
+          if-no-files-found: error
       - name: Tmate debugging session (self-hosted)
         if: ${{ failure() && (inputs.tmate-debug || runner.debug) && inputs.self-hosted-runner }}
         uses: canonical/action-tmate@main
@@ -367,10 +374,3 @@ jobs:
           target: ${{ inputs.zap-target-protocol }}://${{ env.ZAP_TARGET }}:${{ inputs.zap-target-port }}/
           cmd_options: ${{ inputs.zap-cmd-options }}
           rules_file_name: ${{ inputs.zap-rules-file-name }}
-      - name: Upload Allure results
-        timeout-minutes: 3
-        uses: actions/upload-artifact@v4
-        with:
-          name: allure-results-${{ env.MODULE }}
-          path: allure-results/
-          if-no-files-found: error
diff --git a/tests/workflows/integration/test-rock/requirements.txt b/tests/workflows/integration/test-rock/requirements.txt
index 2d81d3bb6..0d05e6c9d 100644
--- a/tests/workflows/integration/test-rock/requirements.txt
+++ b/tests/workflows/integration/test-rock/requirements.txt
@@ -1 +1,2 @@
 ops
+allure-pytest>=2.8.18
diff --git a/tests/workflows/integration/test-upload-charm/requirements.txt b/tests/workflows/integration/test-upload-charm/requirements.txt
index 56f5f6428..f9239509b 100644
--- a/tests/workflows/integration/test-upload-charm/requirements.txt
+++ b/tests/workflows/integration/test-upload-charm/requirements.txt
@@ -1 +1,2 @@
 ops >= 1.5.0
+allure-pytest>=2.8.18
\ No newline at end of file

From 9d26d45cfbd54bb9533e0942dfb24fba6bb1382d Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 4 Dec 2024 14:38:50 +0530
Subject: [PATCH 05/52] debug lines

---
 .github/workflows/integration_test_run.yaml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 5e2c1676e..401ce1d1b 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -315,8 +315,14 @@ jobs:
         if: ${{ inputs.provider == 'lxd' }}
         run: |
           tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ steps.allure-option.outputs.option }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
+      - name: Check Allure directory
+        working-directory: ${{ inputs.working-directory }}
+        run: |
+          ls -la
+          ls -la allure-results/
       - name: Upload Allure results
         timeout-minutes: 3
+        if: always() && !cancelled()
         uses: actions/upload-artifact@v4
         with:
           name: allure-results-${{ matrix.modules }}

From 4f456bccd78ffaccc13b11028a47ab897f943f36 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 4 Dec 2024 14:53:16 +0530
Subject: [PATCH 06/52] debug lines

---
 .github/workflows/integration_test_run.yaml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 401ce1d1b..3f518f377 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -309,19 +309,22 @@ jobs:
         working-directory: ${{ inputs.working-directory }}
         if: ${{ inputs.provider == 'microk8s' }}
         run: |
+          pwd
           tox -e ${{ inputs.test-tox-env }} -- --model testing --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ steps.allure-option.outputs.option }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }} 
       - name: Run lxd integration tests
         working-directory: ${{ inputs.working-directory }}
         if: ${{ inputs.provider == 'lxd' }}
         run: |
+          pwd
           tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ steps.allure-option.outputs.option }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
       - name: Check Allure directory
-        working-directory: ${{ inputs.working-directory }}
         run: |
+          pwd
           ls -la
           ls -la allure-results/
       - name: Upload Allure results
         timeout-minutes: 3
+        working-directory: ${{ inputs.working-directory }}
         if: always() && !cancelled()
         uses: actions/upload-artifact@v4
         with:

From 399c7dcf5ca0f8b2a4cb06ea74d4831795f08143 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 4 Dec 2024 15:00:01 +0530
Subject: [PATCH 07/52] debug lines

---
 .github/workflows/integration_test_run.yaml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 3f518f377..511180631 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -324,12 +324,11 @@ jobs:
           ls -la allure-results/
       - name: Upload Allure results
         timeout-minutes: 3
-        working-directory: ${{ inputs.working-directory }}
         if: always() && !cancelled()
         uses: actions/upload-artifact@v4
         with:
           name: allure-results-${{ matrix.modules }}
-          path: allure-results/
+          path: ${{ inputs.working-directory }}/allure-results/
           if-no-files-found: error
       - name: Tmate debugging session (self-hosted)
         if: ${{ failure() && (inputs.tmate-debug || runner.debug) && inputs.self-hosted-runner }}

From 59044071c837201e595e6d0acbb61bad32a047f6 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 4 Dec 2024 15:18:22 +0530
Subject: [PATCH 08/52] debug lines

---
 .github/workflows/integration_test_run.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 511180631..307173b46 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -328,7 +328,7 @@ jobs:
         uses: actions/upload-artifact@v4
         with:
           name: allure-results-${{ matrix.modules }}
-          path: ${{ inputs.working-directory }}/allure-results/
+          path: ${{ inputs.working-directory }}allure-results/
           if-no-files-found: error
       - name: Tmate debugging session (self-hosted)
         if: ${{ failure() && (inputs.tmate-debug || runner.debug) && inputs.self-hosted-runner }}

From 7434888446449cac3558f0d629add6e693b6eb72 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 4 Dec 2024 15:29:26 +0530
Subject: [PATCH 09/52] debug lines

---
 .github/workflows/integration_test_run.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 307173b46..2a145b859 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -328,7 +328,7 @@ jobs:
         uses: actions/upload-artifact@v4
         with:
           name: allure-results-${{ matrix.modules }}
-          path: ${{ inputs.working-directory }}allure-results/
+          path: allure-results/
           if-no-files-found: error
       - name: Tmate debugging session (self-hosted)
         if: ${{ failure() && (inputs.tmate-debug || runner.debug) && inputs.self-hosted-runner }}

From facf0c1ebe4071ea0293d4fccd5fff885ccba10d Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 4 Dec 2024 22:22:05 +0530
Subject: [PATCH 10/52] getting integ to run

---
 .github/workflows/integration_test_run.yaml | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 2a145b859..b8e78ea4b 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -302,7 +302,7 @@ jobs:
         shell: python
         run: |
           import os
-          output = "option=--alluredir=allure-results"
+          output = "option=--alluredir=${{ inputs.working-directory }}allure-results"
           with open(os.environ["GITHUB_OUTPUT"], "a") as file:
               file.write(output)
       - name: Run k8s integration tests
@@ -318,6 +318,7 @@ jobs:
           pwd
           tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ steps.allure-option.outputs.option }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
       - name: Check Allure directory
+        working-directory: ${{ inputs.working-directory }}
         run: |
           pwd
           ls -la
@@ -328,7 +329,7 @@ jobs:
         uses: actions/upload-artifact@v4
         with:
           name: allure-results-${{ matrix.modules }}
-          path: allure-results/
+          path: ${{ inputs.working-directory }}allure-results/
           if-no-files-found: error
       - name: Tmate debugging session (self-hosted)
         if: ${{ failure() && (inputs.tmate-debug || runner.debug) && inputs.self-hosted-runner }}

From 76b8b13648d7351c476dc63b83361cd4fd9707f1 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 4 Dec 2024 22:38:26 +0530
Subject: [PATCH 11/52] getting integ to run

---
 .github/workflows/integration_test_run.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index b8e78ea4b..1defb4b70 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -302,7 +302,7 @@ jobs:
         shell: python
         run: |
           import os
-          output = "option=--alluredir=${{ inputs.working-directory }}allure-results"
+          output = "option=--alluredir=allure-results"
           with open(os.environ["GITHUB_OUTPUT"], "a") as file:
               file.write(output)
       - name: Run k8s integration tests

From fe89621026fc1c0ed557a11473e38441049151c7 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Thu, 5 Dec 2024 10:16:34 +0530
Subject: [PATCH 12/52] getting integ to run

---
 .github/workflows/allure_report.yaml        | 89 +++++++++++++++++++++
 .github/workflows/integration_test.yaml     |  5 ++
 .github/workflows/integration_test_run.yaml |  6 +-
 .github/workflows/workflow_test.yaml        | 26 ++++++
 4 files changed, 125 insertions(+), 1 deletion(-)
 create mode 100644 .github/workflows/allure_report.yaml

diff --git a/.github/workflows/allure_report.yaml b/.github/workflows/allure_report.yaml
new file mode 100644
index 000000000..ab9e7a89c
--- /dev/null
+++ b/.github/workflows/allure_report.yaml
@@ -0,0 +1,89 @@
+name: Allure Report Generation
+
+on: [workflow_call]
+
+jobs:
+  allure-report:
+    name: (beta) Publish Allure report
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    if: always() && !cancelled()
+    steps:
+      - name: Download Allure from allure-framwork
+        # Following instructions from https://allurereport.org/docs/gettingstarted-installation/#install-via-the-system-package-manager-for-linux
+        run: gh release download --repo allure-framework/allure2 --pattern 'allure_*.deb'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - name: Install Allure
+        run: |
+          sudo apt-get update
+          sudo apt-get install ./allure_*.deb -y
+      # For first run, manually create branch with no history
+      # (e.g.
+      # git checkout --orphan gh-pages-beta
+      # git rm -rf .
+      # touch .nojekyll
+      # git add .nojekyll
+      # git commit -m "Initial commit"
+      # git push origin gh-pages-beta
+      # )
+      - name: Checkout GitHub pages branch
+        uses: actions/checkout@v4
+        with:
+          ref: gh-pages
+          path: repo/
+      - name: Download first test results
+        uses: actions/download-artifact@v4
+        with:
+          path: allure-results/
+          pattern: allure-results*
+          merge-multiple: true
+      - name: Load test report history
+        run: |
+          if [[ -d repo/_latest/history/ ]]
+          then
+            echo 'Loading history'
+            cp -r repo/_latest/history/ allure-results/
+          fi
+      - name: Create executor.json
+        shell: python
+        run: |
+          # Reverse engineered from https://github.com/simple-elf/allure-report-action/blob/eca283b643d577c69b8e4f048dd6cd8eb8457cfd/entrypoint.sh
+          import json
+
+          DATA = {
+              "name": "GitHub Actions",
+              "type": "github",
+              "buildOrder": ${{ github.run_number }},  # TODO future improvement: use run ID
+              "buildName": "Run ${{ github.run_id }}",
+              "buildUrl": "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}",
+              "reportUrl": "../${{ github.run_number }}/",
+          }
+          with open("allure-results/executor.json", "w") as file:
+              json.dump(DATA, file)
+      - name: Generate Allure report
+        run: allure generate
+      - name: Create index.html
+        shell: python
+        run: |
+          DATA = f"""<!DOCTYPE html>
+          <meta charset="utf-8">
+          <meta http-equiv="cache-control" content="no-cache">
+          <meta http-equiv="refresh" content="0; url=${{ github.run_number }}">
+          """
+          with open("repo/index.html", "w") as file:
+              file.write(DATA)
+      - name: Update GitHub pages branch
+        working-directory: repo/
+        # TODO future improvement: commit message
+        run: |
+          mkdir '${{ github.run_number }}'
+          rm -f _latest
+          ln -s '${{ github.run_number }}' _latest
+          cp -r ../allure-report/. _latest/
+          git add .
+          git config user.name "GitHub Actions"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git commit -m "Allure report ${{ github.run_number }}"
+          # Uses token set in checkout step
+          git push origin gh-pages
\ No newline at end of file
diff --git a/.github/workflows/integration_test.yaml b/.github/workflows/integration_test.yaml
index 18fa972cf..7edff53c0 100644
--- a/.github/workflows/integration_test.yaml
+++ b/.github/workflows/integration_test.yaml
@@ -10,6 +10,10 @@ on:
         description: Label for building the charm
         type: string
         default: ubuntu-latest
+      calling-job-name:
+        description: Name of the job that is calling this reusable workflow
+        type: string
+        required: true
       charmcraft-channel:
         description: Charmcraft channel to use for the integration test
         type: string
@@ -316,6 +320,7 @@ jobs:
     if: always() && needs.plan.result == 'success' && (needs.build.result == 'success' || toJSON(fromJSON(needs.plan.outputs.plan).build) == '[]')
     secrets: inherit
     with:
+      calling-job-name: ${{ inputs.calling-job-name}}
       channel: ${{ inputs.channel }}
       charmcraft-ref: ${{ inputs.charmcraft-ref }}
       charmcraft-repository: ${{ inputs.charmcraft-repository }}
diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 1defb4b70..ecc2095a7 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -6,6 +6,10 @@ name: Run integration tests
 on:
   workflow_call:
     inputs:
+      calling-job-name:
+        description: Name of the job that is calling this reusable workflow
+        type: string
+        required: true
       charmcraft-ref:
         description: Used in conjunction with charmcraft-repository to pull and build charmcraft from source instead of using snapstore version.
         type: string
@@ -328,7 +332,7 @@ jobs:
         if: always() && !cancelled()
         uses: actions/upload-artifact@v4
         with:
-          name: allure-results-${{ matrix.modules }}
+          name: allure-results-${{ inputs.calling-job-name }}-${{ matrix.modules }}
           path: ${{ inputs.working-directory }}allure-results/
           if-no-files-found: error
       - name: Tmate debugging session (self-hosted)
diff --git a/.github/workflows/workflow_test.yaml b/.github/workflows/workflow_test.yaml
index 631b45114..c6cb6697d 100644
--- a/.github/workflows/workflow_test.yaml
+++ b/.github/workflows/workflow_test.yaml
@@ -13,6 +13,7 @@ jobs:
     with:
       working-directory: "tests/workflows/integration/test-upload-charm/"
       self-hosted-runner: false
+      calling-job-name: simple
   simple-self-hosted:
     uses: ./.github/workflows/test.yaml
     secrets: inherit
@@ -20,6 +21,7 @@ jobs:
       working-directory: "tests/workflows/integration/test-upload-charm/"
       self-hosted-runner: true
       self-hosted-runner-label: "edge"
+      calling-job-name: simple-self-hosted
   integration:
     uses: ./.github/workflows/integration_test.yaml
     secrets: inherit
@@ -27,6 +29,7 @@ jobs:
       working-directory: "tests/workflows/integration/test-upload-charm/"
       trivy-image-config: "tests/workflows/integration/test-upload-charm/trivy.yaml"
       trivy-severity-config: "CRITICAL,HIGH"
+      calling-job-name: integration
   integration-juju3:
     uses: ./.github/workflows/integration_test.yaml
     secrets: inherit
@@ -38,6 +41,7 @@ jobs:
       channel: 1.30-strict/stable
       provider: microk8s
       test-tox-env: "integration-juju3.1"
+      calling-job-name: integration-juju3
   integration-artifact:
     uses: ./.github/workflows/integration_test.yaml
     secrets: inherit
@@ -51,6 +55,7 @@ jobs:
       test-tox-env: "integration-juju3.1"
       upload-image: artifact
       microk8s-addons: "dns ingress rbac storage registry"
+      calling-job-name: integration-artifact
   integration-self-hosted:
     uses: ./.github/workflows/integration_test.yaml
     secrets: inherit
@@ -59,12 +64,14 @@ jobs:
       trivy-image-config: "tests/workflows/integration/test-upload-charm/trivy.yaml"
       self-hosted-runner: true
       self-hosted-runner-label: "edge"
+      calling-job-name: integration-self-hosted
   integration-rock:
     uses: ./.github/workflows/integration_test.yaml
     secrets: inherit
     with:
       working-directory: "tests/workflows/integration/test-rock/"
       trivy-image-config: "tests/workflows/integration/test-rock/trivy.yaml"
+      calling-job-name: integration-rock
   integration-rock-artifact:
     uses: ./.github/workflows/integration_test.yaml
     secrets: inherit
@@ -73,6 +80,7 @@ jobs:
       upload-image: artifact
       microk8s-addons: "dns ingress rbac storage registry"
       trivy-image-config: "tests/workflows/integration/test-rock/trivy.yaml"
+      calling-job-name: integration-rock-artifact
   integration-craft:
     uses: ./.github/workflows/integration_test.yaml
     secrets: inherit
@@ -83,6 +91,7 @@ jobs:
       charmcraft-ref: main
       rockcraft-repository: canonical/rockcraft
       rockcraft-ref: main
+      calling-job-name: integration-craft
   publish:
     uses: ./.github/workflows/publish_charm.yaml
     secrets: inherit
@@ -93,6 +102,7 @@ jobs:
       integration-test-workflow-file: workflow_test.yaml
       working-directory: tests/workflows/integration/test-upload-charm/
       workflow-run-id: ${{ github.run_id }}
+      calling-job-name: publish
   publish-artifact:
     uses: ./.github/workflows/publish_charm.yaml
     secrets: inherit
@@ -103,6 +113,7 @@ jobs:
       integration-test-workflow-file: workflow_test.yaml
       working-directory: tests/workflows/integration/test-upload-charm/
       workflow-run-id: ${{ github.run_id }}
+      calling-job-name: publish-artifact
   check:
     runs-on: ubuntu-latest
     if: always() && !cancelled()
@@ -132,3 +143,18 @@ jobs:
           [ '${{ needs.integration-craft.result }}' = 'success' ] || (echo integration-craft failed && false)
           [ '${{ needs.publish.result }}' != 'failure' ] || (echo publish failed && false)
           [ '${{ needs.publish-artifact.result }}' != 'failure' ] || (echo publish failed && false)
+  allure-report:
+    if: always() && !cancelled()
+    needs:
+      - simple
+      - simple-self-hosted
+      - integration
+      - integration-juju3
+      - integration-artifact
+      - integration-self-hosted
+      - integration-rock
+      - integration-rock-artifact
+      - integration-craft
+      - publish
+      - publish-artifact
+    uses: ./.github/workflows/allure_report.yaml

From f7c81be81fd8c156f6f7a73167a7adf8117caaac Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Thu, 5 Dec 2024 10:17:35 +0530
Subject: [PATCH 13/52] getting integ to run

---
 .github/workflows/integration_test.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/integration_test.yaml b/.github/workflows/integration_test.yaml
index 7edff53c0..763f64ac3 100644
--- a/.github/workflows/integration_test.yaml
+++ b/.github/workflows/integration_test.yaml
@@ -320,7 +320,7 @@ jobs:
     if: always() && needs.plan.result == 'success' && (needs.build.result == 'success' || toJSON(fromJSON(needs.plan.outputs.plan).build) == '[]')
     secrets: inherit
     with:
-      calling-job-name: ${{ inputs.calling-job-name}}
+      calling-job-name: ${{ inputs.calling-job-name }}
       channel: ${{ inputs.channel }}
       charmcraft-ref: ${{ inputs.charmcraft-ref }}
       charmcraft-repository: ${{ inputs.charmcraft-repository }}

From 06ae0c627ce2e0bc6a98cb6710258e563f14c8de Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Thu, 5 Dec 2024 10:20:30 +0530
Subject: [PATCH 14/52] getting integ to run

---
 .github/workflows/workflow_test.yaml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.github/workflows/workflow_test.yaml b/.github/workflows/workflow_test.yaml
index c6cb6697d..b0a8a62e1 100644
--- a/.github/workflows/workflow_test.yaml
+++ b/.github/workflows/workflow_test.yaml
@@ -13,7 +13,6 @@ jobs:
     with:
       working-directory: "tests/workflows/integration/test-upload-charm/"
       self-hosted-runner: false
-      calling-job-name: simple
   simple-self-hosted:
     uses: ./.github/workflows/test.yaml
     secrets: inherit
@@ -21,7 +20,6 @@ jobs:
       working-directory: "tests/workflows/integration/test-upload-charm/"
       self-hosted-runner: true
       self-hosted-runner-label: "edge"
-      calling-job-name: simple-self-hosted
   integration:
     uses: ./.github/workflows/integration_test.yaml
     secrets: inherit

From b46d2bef5530509a2a079f07f1143bd3f62d54d7 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Thu, 5 Dec 2024 10:21:22 +0530
Subject: [PATCH 15/52] getting integ to run

---
 .github/workflows/workflow_test.yaml | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/.github/workflows/workflow_test.yaml b/.github/workflows/workflow_test.yaml
index b0a8a62e1..ed45ce1cd 100644
--- a/.github/workflows/workflow_test.yaml
+++ b/.github/workflows/workflow_test.yaml
@@ -100,7 +100,6 @@ jobs:
       integration-test-workflow-file: workflow_test.yaml
       working-directory: tests/workflows/integration/test-upload-charm/
       workflow-run-id: ${{ github.run_id }}
-      calling-job-name: publish
   publish-artifact:
     uses: ./.github/workflows/publish_charm.yaml
     secrets: inherit
@@ -111,7 +110,6 @@ jobs:
       integration-test-workflow-file: workflow_test.yaml
       working-directory: tests/workflows/integration/test-upload-charm/
       workflow-run-id: ${{ github.run_id }}
-      calling-job-name: publish-artifact
   check:
     runs-on: ubuntu-latest
     if: always() && !cancelled()
@@ -144,8 +142,6 @@ jobs:
   allure-report:
     if: always() && !cancelled()
     needs:
-      - simple
-      - simple-self-hosted
       - integration
       - integration-juju3
       - integration-artifact
@@ -153,6 +149,4 @@ jobs:
       - integration-rock
       - integration-rock-artifact
       - integration-craft
-      - publish
-      - publish-artifact
     uses: ./.github/workflows/allure_report.yaml

From 0c6c4c97630fce0be6a98320ea43e19941ada60e Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Thu, 5 Dec 2024 10:23:19 +0530
Subject: [PATCH 16/52] getting integ to run

---
 .github/workflows/workflow_test.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/workflow_test.yaml b/.github/workflows/workflow_test.yaml
index ed45ce1cd..dea46379c 100644
--- a/.github/workflows/workflow_test.yaml
+++ b/.github/workflows/workflow_test.yaml
@@ -89,7 +89,7 @@ jobs:
       charmcraft-ref: main
       rockcraft-repository: canonical/rockcraft
       rockcraft-ref: main
-      calling-job-name: integration-craft
+      calling-job-name: integration-craft 
   publish:
     uses: ./.github/workflows/publish_charm.yaml
     secrets: inherit

From cba281994e53937ae48bd6b95613b2b8a2b1e4e8 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Thu, 5 Dec 2024 14:57:47 +0530
Subject: [PATCH 17/52] getting integ to run

---
 .github/workflows/allure_report.yaml        |  9 ++++---
 .github/workflows/integration_test_run.yaml | 28 ++++++---------------
 2 files changed, 14 insertions(+), 23 deletions(-)

diff --git a/.github/workflows/allure_report.yaml b/.github/workflows/allure_report.yaml
index ab9e7a89c..f8b33384b 100644
--- a/.github/workflows/allure_report.yaml
+++ b/.github/workflows/allure_report.yaml
@@ -1,10 +1,13 @@
+# Copyright 2024 Canonical Ltd.
+# See LICENSE file for licensing details.
+
 name: Allure Report Generation
 
 on: [workflow_call]
 
 jobs:
   allure-report:
-    name: (beta) Publish Allure report
+    name: Publish Allure report
     runs-on: ubuntu-latest
     timeout-minutes: 5
     if: always() && !cancelled()
@@ -20,12 +23,12 @@ jobs:
           sudo apt-get install ./allure_*.deb -y
       # For first run, manually create branch with no history
       # (e.g.
-      # git checkout --orphan gh-pages-beta
+      # git checkout --orphan gh-pages
       # git rm -rf .
       # touch .nojekyll
       # git add .nojekyll
       # git commit -m "Initial commit"
-      # git push origin gh-pages-beta
+      # git push origin gh-pages
       # )
       - name: Checkout GitHub pages branch
         uses: actions/checkout@v4
diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index ecc2095a7..0e074a5cc 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -291,50 +291,38 @@ jobs:
 
           args="${{ steps.plan-integration.outputs.args }}"
           echo "ARGS=$args" >> $GITHUB_ENV
+
+          allure_artifact_suffix=$(uuidgen)
           series=""
           if [ ! -z ${{ matrix.series }} ]; then
             series="--series ${{ matrix.series }}"
+            allure_artifact_suffix=$(allure_artifact_suffix)-${{ matrix.series }}
           fi
           echo "SERIES=$series" >> $GITHUB_ENV
           module=""
           if [ ! -z ${{ matrix.modules }} ]; then
             module="-k ${{ matrix.modules }}"
+            allure_artifact_suffix=$(allure_artifact_suffix)-${{ matrix.modules }}
           fi
           echo "MODULE=$module" >> $GITHUB_ENV
-      - name: (beta) Get Allure option
-        id: allure-option
-        shell: python
-        run: |
-          import os
-          output = "option=--alluredir=allure-results"
-          with open(os.environ["GITHUB_OUTPUT"], "a") as file:
-              file.write(output)
+          echo "ALLURE_ARTIFACT_SUFFIX=$allure_artifact_suffix" >> $GITHUB_ENV
       - name: Run k8s integration tests
         working-directory: ${{ inputs.working-directory }}
         if: ${{ inputs.provider == 'microk8s' }}
         run: |
-          pwd
-          tox -e ${{ inputs.test-tox-env }} -- --model testing --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ steps.allure-option.outputs.option }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }} 
+          tox -e ${{ inputs.test-tox-env }} -- --model testing --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} --alluredir=allure-results ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }} 
       - name: Run lxd integration tests
         working-directory: ${{ inputs.working-directory }}
         if: ${{ inputs.provider == 'lxd' }}
         run: |
-          pwd
-          tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ steps.allure-option.outputs.option }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
-      - name: Check Allure directory
-        working-directory: ${{ inputs.working-directory }}
-        run: |
-          pwd
-          ls -la
-          ls -la allure-results/
+          tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} --alluredir=allure-results ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
       - name: Upload Allure results
         timeout-minutes: 3
         if: always() && !cancelled()
         uses: actions/upload-artifact@v4
         with:
-          name: allure-results-${{ inputs.calling-job-name }}-${{ matrix.modules }}
+          name: allure-results-${{ env.ALLURE_ARTIFACT_SUFFIX }}
           path: ${{ inputs.working-directory }}allure-results/
-          if-no-files-found: error
       - name: Tmate debugging session (self-hosted)
         if: ${{ failure() && (inputs.tmate-debug || runner.debug) && inputs.self-hosted-runner }}
         uses: canonical/action-tmate@main

From fec66c7a1d381609daa8ad9924ada34986eb6118 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Fri, 6 Dec 2024 19:18:32 +0530
Subject: [PATCH 18/52] adding default result

---
 .github/workflows/allure_report.yaml          |  17 ++-
 .github/workflows/integration_test.yaml       |   5 -
 .github/workflows/integration_test_run.yaml   |  88 +++++++------
 .github/workflows/workflow_test.yaml          |   7 -
 python/cli/README.md                          |   3 +
 .../__init__.py                               |   0
 .../allure_add_default_for_missing_results.py |  49 +++++++
 python/cli/pyproject.toml                     |  21 +++
 .../allure_pytest_collection_report/README.md |   1 +
 .../__init__.py                               |   0
 .../_plugin.py                                | 120 ++++++++++++++++++
 .../pyproject.toml                            |  23 ++++
 12 files changed, 281 insertions(+), 53 deletions(-)
 create mode 100644 python/cli/README.md
 create mode 100644 python/cli/allure_add_default_for_missing_results/__init__.py
 create mode 100644 python/cli/allure_add_default_for_missing_results/allure_add_default_for_missing_results.py
 create mode 100644 python/cli/pyproject.toml
 create mode 100644 python/pytest_plugins/allure_pytest_collection_report/README.md
 create mode 100644 python/pytest_plugins/allure_pytest_collection_report/__init__.py
 create mode 100644 python/pytest_plugins/allure_pytest_collection_report/_plugin.py
 create mode 100644 python/pytest_plugins/allure_pytest_collection_report/pyproject.toml

diff --git a/.github/workflows/allure_report.yaml b/.github/workflows/allure_report.yaml
index f8b33384b..7afb2bba1 100644
--- a/.github/workflows/allure_report.yaml
+++ b/.github/workflows/allure_report.yaml
@@ -12,7 +12,7 @@ jobs:
     timeout-minutes: 5
     if: always() && !cancelled()
     steps:
-      - name: Download Allure from allure-framwork
+      - name: Download Allure
         # Following instructions from https://allurereport.org/docs/gettingstarted-installation/#install-via-the-system-package-manager-for-linux
         run: gh release download --repo allure-framework/allure2 --pattern 'allure_*.deb'
         env:
@@ -35,12 +35,25 @@ jobs:
         with:
           ref: gh-pages
           path: repo/
-      - name: Download first test results
+      - name: Download default test results
+        uses: actions/download-artifact@v4
+        with:
+          path: allure-collection-default-results/
+          pattern: allure-default-results*
+          merge-multiple: true
+      - name: Download actual test results
         uses: actions/download-artifact@v4
         with:
           path: allure-results/
           pattern: allure-results*
           merge-multiple: true
+      - name: Install CLI
+        run: pipx install git+https://github.com/canonical/operator-workflows@ISD-2620-allure#subdirectory=python/cli
+      - name: Combine Allure default results & actual results
+        # For every test: if actual result available, use that. Otherwise, use default result
+        # So that, if actual result not available, Allure report will show "unknown"/"failed" test result
+        # instead of omitting the test
+        run: allure-add-default-for-missing-results --allure-results-dir=allure-results --allure-collection-default-results-dir=allure-collection-default-results
       - name: Load test report history
         run: |
           if [[ -d repo/_latest/history/ ]]
diff --git a/.github/workflows/integration_test.yaml b/.github/workflows/integration_test.yaml
index 763f64ac3..18fa972cf 100644
--- a/.github/workflows/integration_test.yaml
+++ b/.github/workflows/integration_test.yaml
@@ -10,10 +10,6 @@ on:
         description: Label for building the charm
         type: string
         default: ubuntu-latest
-      calling-job-name:
-        description: Name of the job that is calling this reusable workflow
-        type: string
-        required: true
       charmcraft-channel:
         description: Charmcraft channel to use for the integration test
         type: string
@@ -320,7 +316,6 @@ jobs:
     if: always() && needs.plan.result == 'success' && (needs.build.result == 'success' || toJSON(fromJSON(needs.plan.outputs.plan).build) == '[]')
     secrets: inherit
     with:
-      calling-job-name: ${{ inputs.calling-job-name }}
       channel: ${{ inputs.channel }}
       charmcraft-ref: ${{ inputs.charmcraft-ref }}
       charmcraft-repository: ${{ inputs.charmcraft-repository }}
diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 0e074a5cc..bd4bf9696 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -6,10 +6,6 @@ name: Run integration tests
 on:
   workflow_call:
     inputs:
-      calling-job-name:
-        description: Name of the job that is calling this reusable workflow
-        type: string
-        required: true
       charmcraft-ref:
         description: Used in conjunction with charmcraft-repository to pull and build charmcraft from source instead of using snapstore version.
         type: string
@@ -156,9 +152,6 @@ on:
         description: Rules file to ignore any alerts from the ZAP scan
         type: string
 
-permissions:
-  contents: write 
-
 jobs:
   integration-test:
     name: Integration tests
@@ -178,6 +171,55 @@ jobs:
         )) || inputs.runs-on
       }}
     steps:
+      - name: Plan Integration
+        uses: canonical/operator-workflows/internal/plan-integration@main
+        id: plan-integration
+        with:
+          plan: ${{ inputs.plan }}
+      - name: Integration tests variable setting
+        working-directory: ${{ inputs.working-directory }}/${{ inputs.charm-directory }}
+        run: |
+          CHARM_NAME="$([ -f metadata.yaml ] && yq '.name' metadata.yaml || echo UNKNOWN)"
+          if [ "$CHARM_NAME" == "UNKNOWN" ]; then
+            CHARM_NAME="$([ -f charmcraft.yaml ] && yq '.name' charmcraft.yaml || echo UNKNOWN)"
+          fi
+          echo "CHARM_NAME=$CHARM_NAME" >> $GITHUB_ENV
+
+          args="${{ steps.plan-integration.outputs.args }}"
+          echo "ARGS=$args" >> $GITHUB_ENV
+
+          allure_artifact_suffix=$(uuidgen)
+          series=""
+          if [ ! -z ${{ matrix.series }} ]; then
+            series="--series ${{ matrix.series }}"
+            allure_artifact_suffix=$(allure_artifact_suffix)-${{ matrix.series }}
+          fi
+          echo "SERIES=$series" >> $GITHUB_ENV
+          module=""
+          if [ ! -z ${{ matrix.modules }} ]; then
+            module="-k ${{ matrix.modules }}"
+            allure_artifact_suffix=$(allure_artifact_suffix)-${{ matrix.modules }}
+          fi
+          echo "MODULE=$module" >> $GITHUB_ENV
+          echo "ALLURE_ARTIFACT_SUFFIX=$allure_artifact_suffix" >> $GITHUB_ENV
+      - name: Install pytest plugin for Allure
+        run: pip install git+https://github.com/canonical/operator-workflows@ISD-2620-allure#subdirectory=python/pytest_plugins/allure_pytest_collection_report
+      - name: Collect tests for Allure (k8s)
+        working-directory: ${{ inputs.working-directory }}
+        if: ${{ inputs.provider == 'microk8s' }}
+        run: |
+          tox -e ${{ inputs.test-tox-env }} -- --model testing --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} --allure-collection-dir=allure-default ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }} 
+      - name: Collect tests for Allure (lxd)
+        working-directory: ${{ inputs.working-directory }}
+        if: ${{ inputs.provider == 'lxd' }}
+        run: |
+          tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} --allure-collection-dir=allure-default ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
+      - name: Upload Default Allure results
+        timeout-minutes: 3
+        uses: actions/upload-artifact@v4
+        with:
+          name: allure-default-results-${{ env.ALLURE_ARTIFACT_SUFFIX }}
+          path: allure-default/
       - name: Setup operator environment
         uses: charmed-kubernetes/actions-operator@main
         with:
@@ -274,38 +316,6 @@ jobs:
 
       - run: sudo apt install skopeo -y
 
-      - name: Plan Integration
-        uses: canonical/operator-workflows/internal/plan-integration@main
-        id: plan-integration
-        with:
-          plan: ${{ inputs.plan }}
-
-      - name: Integration tests variable setting
-        working-directory: ${{ inputs.working-directory }}/${{ inputs.charm-directory }}
-        run: |
-          CHARM_NAME="$([ -f metadata.yaml ] && yq '.name' metadata.yaml || echo UNKNOWN)"
-          if [ "$CHARM_NAME" == "UNKNOWN" ]; then
-            CHARM_NAME="$([ -f charmcraft.yaml ] && yq '.name' charmcraft.yaml || echo UNKNOWN)"
-          fi
-          echo "CHARM_NAME=$CHARM_NAME" >> $GITHUB_ENV
-
-          args="${{ steps.plan-integration.outputs.args }}"
-          echo "ARGS=$args" >> $GITHUB_ENV
-
-          allure_artifact_suffix=$(uuidgen)
-          series=""
-          if [ ! -z ${{ matrix.series }} ]; then
-            series="--series ${{ matrix.series }}"
-            allure_artifact_suffix=$(allure_artifact_suffix)-${{ matrix.series }}
-          fi
-          echo "SERIES=$series" >> $GITHUB_ENV
-          module=""
-          if [ ! -z ${{ matrix.modules }} ]; then
-            module="-k ${{ matrix.modules }}"
-            allure_artifact_suffix=$(allure_artifact_suffix)-${{ matrix.modules }}
-          fi
-          echo "MODULE=$module" >> $GITHUB_ENV
-          echo "ALLURE_ARTIFACT_SUFFIX=$allure_artifact_suffix" >> $GITHUB_ENV
       - name: Run k8s integration tests
         working-directory: ${{ inputs.working-directory }}
         if: ${{ inputs.provider == 'microk8s' }}
diff --git a/.github/workflows/workflow_test.yaml b/.github/workflows/workflow_test.yaml
index dea46379c..f9b9b7c56 100644
--- a/.github/workflows/workflow_test.yaml
+++ b/.github/workflows/workflow_test.yaml
@@ -27,7 +27,6 @@ jobs:
       working-directory: "tests/workflows/integration/test-upload-charm/"
       trivy-image-config: "tests/workflows/integration/test-upload-charm/trivy.yaml"
       trivy-severity-config: "CRITICAL,HIGH"
-      calling-job-name: integration
   integration-juju3:
     uses: ./.github/workflows/integration_test.yaml
     secrets: inherit
@@ -39,7 +38,6 @@ jobs:
       channel: 1.30-strict/stable
       provider: microk8s
       test-tox-env: "integration-juju3.1"
-      calling-job-name: integration-juju3
   integration-artifact:
     uses: ./.github/workflows/integration_test.yaml
     secrets: inherit
@@ -53,7 +51,6 @@ jobs:
       test-tox-env: "integration-juju3.1"
       upload-image: artifact
       microk8s-addons: "dns ingress rbac storage registry"
-      calling-job-name: integration-artifact
   integration-self-hosted:
     uses: ./.github/workflows/integration_test.yaml
     secrets: inherit
@@ -62,14 +59,12 @@ jobs:
       trivy-image-config: "tests/workflows/integration/test-upload-charm/trivy.yaml"
       self-hosted-runner: true
       self-hosted-runner-label: "edge"
-      calling-job-name: integration-self-hosted
   integration-rock:
     uses: ./.github/workflows/integration_test.yaml
     secrets: inherit
     with:
       working-directory: "tests/workflows/integration/test-rock/"
       trivy-image-config: "tests/workflows/integration/test-rock/trivy.yaml"
-      calling-job-name: integration-rock
   integration-rock-artifact:
     uses: ./.github/workflows/integration_test.yaml
     secrets: inherit
@@ -78,7 +73,6 @@ jobs:
       upload-image: artifact
       microk8s-addons: "dns ingress rbac storage registry"
       trivy-image-config: "tests/workflows/integration/test-rock/trivy.yaml"
-      calling-job-name: integration-rock-artifact
   integration-craft:
     uses: ./.github/workflows/integration_test.yaml
     secrets: inherit
@@ -89,7 +83,6 @@ jobs:
       charmcraft-ref: main
       rockcraft-repository: canonical/rockcraft
       rockcraft-ref: main
-      calling-job-name: integration-craft 
   publish:
     uses: ./.github/workflows/publish_charm.yaml
     secrets: inherit
diff --git a/python/cli/README.md b/python/cli/README.md
new file mode 100644
index 000000000..5b6554569
--- /dev/null
+++ b/python/cli/README.md
@@ -0,0 +1,3 @@
+The `allure_add_default_for_missing_results` cli combines the Allure default results & actual results before generating the report. 
+
+Currently, if the result of a test is not available (for reasons such as setup failure), allure omits the test. This CLI ensures that for every test, if actual result is available, it will use that. Otherwise, it uses the default result `unknown`.
\ No newline at end of file
diff --git a/python/cli/allure_add_default_for_missing_results/__init__.py b/python/cli/allure_add_default_for_missing_results/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/python/cli/allure_add_default_for_missing_results/allure_add_default_for_missing_results.py b/python/cli/allure_add_default_for_missing_results/allure_add_default_for_missing_results.py
new file mode 100644
index 000000000..9d9de9255
--- /dev/null
+++ b/python/cli/allure_add_default_for_missing_results/allure_add_default_for_missing_results.py
@@ -0,0 +1,49 @@
+import argparse
+import dataclasses
+import json
+import pathlib
+
+
+@dataclasses.dataclass(frozen=True)
+class Result:
+    test_case_id: str
+    path: pathlib.Path
+
+    def __eq__(self, other):
+        if not isinstance(other, type(self)):
+            return False
+        return self.test_case_id == other.test_case_id
+
+
+def main():
+    """Combine Allure default results & actual results
+
+    For every test: if actual result available, use that. Otherwise, use default result
+
+    So that, if actual result not available, Allure report will show "unknown"/"failed" test result
+    instead of omitting the test
+    """
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--allure-results-dir", required=True)
+    parser.add_argument("--allure-collection-default-results-dir", required=True)
+    args = parser.parse_args()
+
+    actual_results = pathlib.Path(args.allure_results_dir)
+    default_results = pathlib.Path(args.allure_collection_default_results_dir)
+
+    results: dict[pathlib.Path, set[Result]] = {
+        actual_results: set(),
+        default_results: set(),
+    }
+    for directory, results_ in results.items():
+        for path in directory.glob("*-result.json"):
+            with path.open("r") as file:
+                id_ = json.load(file)["testCaseId"]
+            results_.add(Result(id_, path))
+
+    actual_results.mkdir(exist_ok=True)
+
+    missing_results = results[default_results] - results[actual_results]
+    for default_result in missing_results:
+        # Move to `actual_results` directory
+        default_result.path.rename(actual_results / default_result.path.name)
diff --git a/python/cli/pyproject.toml b/python/cli/pyproject.toml
new file mode 100644
index 000000000..257a49600
--- /dev/null
+++ b/python/cli/pyproject.toml
@@ -0,0 +1,21 @@
+[tool.poetry]
+name = "workflows-cli"
+# Version unused; repository has its own versioning system. (See .github/workflows/__release.yaml)
+version = "0.1.0"
+description = ""
+license = "Apache-2.0"
+authors = ["Carl Csaposs <carl.csaposs@canonical.com>"]
+readme = "README.md"
+
+[tool.poetry.scripts]
+allure-add-default-for-missing-results = "workflows_cli.allure_add_default_for_missing_results:main"
+
+[tool.poetry.dependencies]
+python = "^3.10"
+pyyaml = "^6.0.1"
+requests = "^2.31.0"
+
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
\ No newline at end of file
diff --git a/python/pytest_plugins/allure_pytest_collection_report/README.md b/python/pytest_plugins/allure_pytest_collection_report/README.md
new file mode 100644
index 000000000..e3a5e1b8b
--- /dev/null
+++ b/python/pytest_plugins/allure_pytest_collection_report/README.md
@@ -0,0 +1 @@
+The `allure-pytest` plugin marks all the test statuses as unknown during collection time.
\ No newline at end of file
diff --git a/python/pytest_plugins/allure_pytest_collection_report/__init__.py b/python/pytest_plugins/allure_pytest_collection_report/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/python/pytest_plugins/allure_pytest_collection_report/_plugin.py b/python/pytest_plugins/allure_pytest_collection_report/_plugin.py
new file mode 100644
index 000000000..b96f762b7
--- /dev/null
+++ b/python/pytest_plugins/allure_pytest_collection_report/_plugin.py
@@ -0,0 +1,120 @@
+# Upstream feature request to replace this plugin:
+# https://github.com/allure-framework/allure-python/issues/821
+
+import allure_commons.logger
+import allure_commons.model2
+import allure_commons.types
+import allure_commons.utils
+import allure_pytest.listener
+import allure_pytest.utils
+
+
+def pytest_addoption(parser):
+    parser.addoption(
+        "--allure-collection-dir",
+        help="Generate default Allure results (used by GitHub Actions) in \
+            this directory for tests that are missing Allure results",
+    )
+
+
+def pytest_configure(config):
+    if config.option.allure_collection_dir:
+        config.option.collectonly = True
+
+
+def pytest_collection_finish(session):
+    report_dir = session.config.option.allure_collection_dir
+    if not report_dir:
+        return
+
+    # Copied from `allure_pytest.listener.AllureListener._cache`
+    _cache = allure_pytest.listener.ItemCache()
+    # Modified from `allure_pytest.plugin.pytest_configure`
+    file_logger = allure_commons.logger.AllureFileLogger(report_dir)
+
+    for item in session.items:
+        # Modified from
+        # `allure_pytest.listener.AllureListener.pytest_runtest_protocol`
+        uuid = _cache.push(item.nodeid)
+        test_result = allure_commons.model2.TestResult(name=item.name, uuid=uuid)
+
+        # Copied from `allure_pytest.listener.AllureListener.pytest_runtest_setup`
+        params = (
+            allure_pytest.listener.AllureListener._AllureListener__get_pytest_params(
+                item
+            )
+        )
+        test_result.name = allure_pytest.utils.allure_name(item, params)
+        full_name = allure_pytest.utils.allure_full_name(item)
+        test_result.fullName = full_name
+        test_result.testCaseId = allure_commons.utils.md5(full_name)
+        test_result.description = allure_pytest.utils.allure_description(item)
+        test_result.descriptionHtml = allure_pytest.utils.allure_description_html(item)
+        current_param_names = [param.name for param in test_result.parameters]
+        test_result.parameters.extend(
+            [
+                allure_commons.model2.Parameter(
+                    name=name, value=allure_commons.utils.represent(value)
+                )
+                for name, value in params.items()
+                if name not in current_param_names
+            ]
+        )
+
+        # Copied from `allure_pytest.listener.AllureListener.pytest_runtest_teardown`
+        listener = allure_pytest.listener.AllureListener
+        test_result.historyId = allure_pytest.utils.get_history_id(
+            test_result.fullName,
+            test_result.parameters,
+            original_values=listener._AllureListener__get_pytest_params(item),
+        )
+        test_result.labels.extend(
+            [
+                allure_commons.model2.Label(name=name, value=value)
+                for name, value in allure_pytest.utils.allure_labels(item)
+            ]
+        )
+        test_result.labels.extend(
+            [
+                allure_commons.model2.Label(
+                    name=allure_commons.types.LabelType.TAG, value=value
+                )
+                for value in allure_pytest.utils.pytest_markers(item)
+            ]
+        )
+        allure_pytest.listener.AllureListener._AllureListener__apply_default_suites(
+            None, item, test_result
+        )
+        test_result.labels.append(
+            allure_commons.model2.Label(
+                name=allure_commons.types.LabelType.HOST,
+                value=allure_commons.utils.host_tag(),
+            )
+        )
+        test_result.labels.append(
+            allure_commons.model2.Label(
+                name=allure_commons.types.LabelType.FRAMEWORK, value="pytest"
+            )
+        )
+        test_result.labels.append(
+            allure_commons.model2.Label(
+                name=allure_commons.types.LabelType.LANGUAGE,
+                value=allure_commons.utils.platform_label(),
+            )
+        )
+        test_result.labels.append(
+            allure_commons.model2.Label(
+                name="package", value=allure_pytest.utils.allure_package(item)
+            )
+        )
+        test_result.links.extend(
+            [
+                allure_commons.model2.Link(link_type, url, name)
+                for link_type, url, name in allure_pytest.utils.allure_links(item)
+            ]
+        )
+
+        # Modified from `allure_pytest.listener.AllureListener.pytest_runtest_protocol`
+        test_result.status = allure_commons.model2.Status.UNKNOWN
+        # Modified from `allure_commons.reporter.AllureReporter.close_test`
+        file_logger.report_result(test_result)
diff --git a/python/pytest_plugins/allure_pytest_collection_report/pyproject.toml b/python/pytest_plugins/allure_pytest_collection_report/pyproject.toml
new file mode 100644
index 000000000..03e6074fe
--- /dev/null
+++ b/python/pytest_plugins/allure_pytest_collection_report/pyproject.toml
@@ -0,0 +1,23 @@
+[tool.poetry]
+name = "allure_pytest_collection_report"
+# Version unused; repository has its own versioning system. (See .github/workflows/__release.yaml)
+version = "0.1.0"
+description = ""
+authors = ["Carl Csaposs <carl.csaposs@canonical.com>"]
+readme = "README.md"
+classifiers = [
+    "Framework :: Pytest",
+]
+
+[tool.poetry.plugins."pytest11"]
+allure_collection_report = "allure_pytest_collection_report._plugin"
+
+[tool.poetry.dependencies]
+python = "^3.8"
+pytest = "*"
+allure-pytest = ">=2.13.5"
+
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
\ No newline at end of file

From a8f2e7c3a183333d8a6c0a5b0c463016aa0e3112 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Fri, 6 Dec 2024 20:58:35 +0530
Subject: [PATCH 19/52] adding default result

---
 .github/workflows/integration_test_run.yaml   | 38 +++++++++----------
 .licenserc.yaml                               |  1 +
 .../__init__.py                               |  2 +
 .../allure_add_default_for_missing_results.py |  2 +
 .../__init__.py                               |  2 +
 .../_plugin.py                                |  2 +
 6 files changed, 26 insertions(+), 21 deletions(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index bd4bf9696..cc2f2995b 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -171,23 +171,9 @@ jobs:
         )) || inputs.runs-on
       }}
     steps:
-      - name: Plan Integration
-        uses: canonical/operator-workflows/internal/plan-integration@main
-        id: plan-integration
-        with:
-          plan: ${{ inputs.plan }}
       - name: Integration tests variable setting
         working-directory: ${{ inputs.working-directory }}/${{ inputs.charm-directory }}
         run: |
-          CHARM_NAME="$([ -f metadata.yaml ] && yq '.name' metadata.yaml || echo UNKNOWN)"
-          if [ "$CHARM_NAME" == "UNKNOWN" ]; then
-            CHARM_NAME="$([ -f charmcraft.yaml ] && yq '.name' charmcraft.yaml || echo UNKNOWN)"
-          fi
-          echo "CHARM_NAME=$CHARM_NAME" >> $GITHUB_ENV
-
-          args="${{ steps.plan-integration.outputs.args }}"
-          echo "ARGS=$args" >> $GITHUB_ENV
-
           allure_artifact_suffix=$(uuidgen)
           series=""
           if [ ! -z ${{ matrix.series }} ]; then
@@ -204,16 +190,11 @@ jobs:
           echo "ALLURE_ARTIFACT_SUFFIX=$allure_artifact_suffix" >> $GITHUB_ENV
       - name: Install pytest plugin for Allure
         run: pip install git+https://github.com/canonical/operator-workflows@ISD-2620-allure#subdirectory=python/pytest_plugins/allure_pytest_collection_report
-      - name: Collect tests for Allure (k8s)
-        working-directory: ${{ inputs.working-directory }}
-        if: ${{ inputs.provider == 'microk8s' }}
-        run: |
-          tox -e ${{ inputs.test-tox-env }} -- --model testing --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} --allure-collection-dir=allure-default ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }} 
-      - name: Collect tests for Allure (lxd)
+      - name: Collect tests for Allure
         working-directory: ${{ inputs.working-directory }}
         if: ${{ inputs.provider == 'lxd' }}
         run: |
-          tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} --allure-collection-dir=allure-default ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
+          tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} --allure-collection-dir=allure-default ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
       - name: Upload Default Allure results
         timeout-minutes: 3
         uses: actions/upload-artifact@v4
@@ -315,7 +296,22 @@ jobs:
           VAULT_APPROLE_SECRET_ID: ${{ secrets.VAULT_APPROLE_SECRET_ID }}
 
       - run: sudo apt install skopeo -y
+      - name: Plan Integration
+        uses: canonical/operator-workflows/internal/plan-integration@main
+        id: plan-integration
+        with:
+          plan: ${{ inputs.plan }}
+      - name: Charm name setting
+        working-directory: ${{ inputs.working-directory }}/${{ inputs.charm-directory }}
+        run: |
+          CHARM_NAME="$([ -f metadata.yaml ] && yq '.name' metadata.yaml || echo UNKNOWN)"
+          if [ "$CHARM_NAME" == "UNKNOWN" ]; then
+            CHARM_NAME="$([ -f charmcraft.yaml ] && yq '.name' charmcraft.yaml || echo UNKNOWN)"
+          fi
+          echo "CHARM_NAME=$CHARM_NAME" >> $GITHUB_ENV
 
+          args="${{ steps.plan-integration.outputs.args }}"
+          echo "ARGS=$args" >> $GITHUB_ENV
       - name: Run k8s integration tests
         working-directory: ${{ inputs.working-directory }}
         if: ${{ inputs.provider == 'microk8s' }}
diff --git a/.licenserc.yaml b/.licenserc.yaml
index 291d80eb6..ca8c7a317 100644
--- a/.licenserc.yaml
+++ b/.licenserc.yaml
@@ -32,4 +32,5 @@ header:
     - 'dist/**'
     - 'internal/**'
     - 'tests/workflows/integration/**'
+    - 'python/**/**/pyproject.toml'
   comment: on-failure
diff --git a/python/cli/allure_add_default_for_missing_results/__init__.py b/python/cli/allure_add_default_for_missing_results/__init__.py
index e69de29bb..e3979c0f6 100644
--- a/python/cli/allure_add_default_for_missing_results/__init__.py
+++ b/python/cli/allure_add_default_for_missing_results/__init__.py
@@ -0,0 +1,2 @@
+# Copyright 2024 Canonical Ltd.
+# See LICENSE file for licensing details.
diff --git a/python/cli/allure_add_default_for_missing_results/allure_add_default_for_missing_results.py b/python/cli/allure_add_default_for_missing_results/allure_add_default_for_missing_results.py
index 9d9de9255..14d2b6bad 100644
--- a/python/cli/allure_add_default_for_missing_results/allure_add_default_for_missing_results.py
+++ b/python/cli/allure_add_default_for_missing_results/allure_add_default_for_missing_results.py
@@ -1,3 +1,5 @@
+# Copyright 2024 Canonical Ltd.
+# See LICENSE file for licensing details.
 import argparse
 import dataclasses
 import json
diff --git a/python/pytest_plugins/allure_pytest_collection_report/__init__.py b/python/pytest_plugins/allure_pytest_collection_report/__init__.py
index e69de29bb..e3979c0f6 100644
--- a/python/pytest_plugins/allure_pytest_collection_report/__init__.py
+++ b/python/pytest_plugins/allure_pytest_collection_report/__init__.py
@@ -0,0 +1,2 @@
+# Copyright 2024 Canonical Ltd.
+# See LICENSE file for licensing details.
diff --git a/python/pytest_plugins/allure_pytest_collection_report/_plugin.py b/python/pytest_plugins/allure_pytest_collection_report/_plugin.py
index b96f762b7..1832d0575 100644
--- a/python/pytest_plugins/allure_pytest_collection_report/_plugin.py
+++ b/python/pytest_plugins/allure_pytest_collection_report/_plugin.py
@@ -1,3 +1,5 @@
+# Copyright 2024 Canonical Ltd.
+# See LICENSE file for licensing details.
 # Upstream feature request to replace this plugin:
 # https://github.com/allure-framework/allure-python/issues/821
 

From bd05b70c023d581d3438cfebdfeba6b3cec8a1ec Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Fri, 6 Dec 2024 21:07:56 +0530
Subject: [PATCH 20/52] adding default result

---
 .github/workflows/integration_test_run.yaml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index cc2f2995b..900a6af1f 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -172,7 +172,6 @@ jobs:
       }}
     steps:
       - name: Integration tests variable setting
-        working-directory: ${{ inputs.working-directory }}/${{ inputs.charm-directory }}
         run: |
           allure_artifact_suffix=$(uuidgen)
           series=""

From 72aec57c993add818aa8613e58434d1b2e364480 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Fri, 6 Dec 2024 21:24:32 +0530
Subject: [PATCH 21/52] adding default result

---
 .../{ => allure_pytest_collection_report}/__init__.py             | 0
 .../{ => allure_pytest_collection_report}/_plugin.py              | 0
 2 files changed, 0 insertions(+), 0 deletions(-)
 rename python/pytest_plugins/allure_pytest_collection_report/{ => allure_pytest_collection_report}/__init__.py (100%)
 rename python/pytest_plugins/allure_pytest_collection_report/{ => allure_pytest_collection_report}/_plugin.py (100%)

diff --git a/python/pytest_plugins/allure_pytest_collection_report/__init__.py b/python/pytest_plugins/allure_pytest_collection_report/allure_pytest_collection_report/__init__.py
similarity index 100%
rename from python/pytest_plugins/allure_pytest_collection_report/__init__.py
rename to python/pytest_plugins/allure_pytest_collection_report/allure_pytest_collection_report/__init__.py
diff --git a/python/pytest_plugins/allure_pytest_collection_report/_plugin.py b/python/pytest_plugins/allure_pytest_collection_report/allure_pytest_collection_report/_plugin.py
similarity index 100%
rename from python/pytest_plugins/allure_pytest_collection_report/_plugin.py
rename to python/pytest_plugins/allure_pytest_collection_report/allure_pytest_collection_report/_plugin.py

From bb9a889d6f1cc952d6701e06a0714dc20c1f3d6f Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Fri, 6 Dec 2024 21:33:28 +0530
Subject: [PATCH 22/52] adding default result

---
 .github/workflows/integration_test_run.yaml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 900a6af1f..aeebc37d5 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -191,7 +191,6 @@ jobs:
         run: pip install git+https://github.com/canonical/operator-workflows@ISD-2620-allure#subdirectory=python/pytest_plugins/allure_pytest_collection_report
       - name: Collect tests for Allure
         working-directory: ${{ inputs.working-directory }}
-        if: ${{ inputs.provider == 'lxd' }}
         run: |
           tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} --allure-collection-dir=allure-default ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
       - name: Upload Default Allure results

From 4ddf4a2b14d8e675f8e80566a42122bbfc1c017a Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Mon, 9 Dec 2024 10:59:00 +0530
Subject: [PATCH 23/52] adding default result

---
 .github/workflows/integration_test_run.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index aeebc37d5..e7463a2d0 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -171,6 +171,7 @@ jobs:
         )) || inputs.runs-on
       }}
     steps:
+      - uses: actions/checkout@v4.2.2
       - name: Integration tests variable setting
         run: |
           allure_artifact_suffix=$(uuidgen)

From 9726ee0a4bd6222db6ed9f7d551d8dd6385c8ede Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Mon, 9 Dec 2024 11:17:08 +0530
Subject: [PATCH 24/52] adding default result

---
 .github/workflows/integration_test_run.yaml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index e7463a2d0..7813477d7 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -190,6 +190,9 @@ jobs:
           echo "ALLURE_ARTIFACT_SUFFIX=$allure_artifact_suffix" >> $GITHUB_ENV
       - name: Install pytest plugin for Allure
         run: pip install git+https://github.com/canonical/operator-workflows@ISD-2620-allure#subdirectory=python/pytest_plugins/allure_pytest_collection_report
+      - name: Install tox
+        run: |
+          pip install tox 
       - name: Collect tests for Allure
         working-directory: ${{ inputs.working-directory }}
         run: |

From ee58e40189ecac9d3d2a6d9ab3c0eb08c255b0cd Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Mon, 9 Dec 2024 11:26:44 +0530
Subject: [PATCH 25/52] adding default result

---
 .github/workflows/integration_test_run.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 7813477d7..5d869db82 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -189,6 +189,7 @@ jobs:
           echo "MODULE=$module" >> $GITHUB_ENV
           echo "ALLURE_ARTIFACT_SUFFIX=$allure_artifact_suffix" >> $GITHUB_ENV
       - name: Install pytest plugin for Allure
+        working-directory: ${{ inputs.working-directory }}
         run: pip install git+https://github.com/canonical/operator-workflows@ISD-2620-allure#subdirectory=python/pytest_plugins/allure_pytest_collection_report
       - name: Install tox
         run: |

From cbc8acefdc2503a3141ad6f2e74b0852f1b8d338 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Mon, 9 Dec 2024 11:40:47 +0530
Subject: [PATCH 26/52] adding default result

---
 .github/workflows/integration_test.yaml               | 2 +-
 .github/workflows/integration_test_run.yaml           | 3 ---
 tests/workflows/integration/test-upload-charm/tox.ini | 1 +
 3 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/integration_test.yaml b/.github/workflows/integration_test.yaml
index 18fa972cf..bc721d136 100644
--- a/.github/workflows/integration_test.yaml
+++ b/.github/workflows/integration_test.yaml
@@ -312,7 +312,7 @@ jobs:
   integration-test:
     name: Integration tests
     uses: ./.github/workflows/integration_test_run.yaml
-    needs: [ plan, build ]
+    needs: [ plan ]
     if: always() && needs.plan.result == 'success' && (needs.build.result == 'success' || toJSON(fromJSON(needs.plan.outputs.plan).build) == '[]')
     secrets: inherit
     with:
diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 5d869db82..ad5cf518e 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -188,9 +188,6 @@ jobs:
           fi
           echo "MODULE=$module" >> $GITHUB_ENV
           echo "ALLURE_ARTIFACT_SUFFIX=$allure_artifact_suffix" >> $GITHUB_ENV
-      - name: Install pytest plugin for Allure
-        working-directory: ${{ inputs.working-directory }}
-        run: pip install git+https://github.com/canonical/operator-workflows@ISD-2620-allure#subdirectory=python/pytest_plugins/allure_pytest_collection_report
       - name: Install tox
         run: |
           pip install tox 
diff --git a/tests/workflows/integration/test-upload-charm/tox.ini b/tests/workflows/integration/test-upload-charm/tox.ini
index 1a868e5b6..1698dee21 100644
--- a/tests/workflows/integration/test-upload-charm/tox.ini
+++ b/tests/workflows/integration/test-upload-charm/tox.ini
@@ -104,6 +104,7 @@ commands =
 [testenv:integration]
 description = Run integration tests
 deps =
+    git+https://github.com/canonical/operator-workflows@ISD-2620-allure#subdirectory=python/pytest_plugins/allure_pytest_collection_report
     juju==2.9.42.4
     pytest
     pytest-operator

From e31c15001a26b31d996777ffb60859710468996b Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Mon, 9 Dec 2024 11:42:24 +0530
Subject: [PATCH 27/52] adding default result

---
 .github/workflows/integration_test.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/integration_test.yaml b/.github/workflows/integration_test.yaml
index bc721d136..284abc6a9 100644
--- a/.github/workflows/integration_test.yaml
+++ b/.github/workflows/integration_test.yaml
@@ -313,7 +313,7 @@ jobs:
     name: Integration tests
     uses: ./.github/workflows/integration_test_run.yaml
     needs: [ plan ]
-    if: always() && needs.plan.result == 'success' && (needs.build.result == 'success' || toJSON(fromJSON(needs.plan.outputs.plan).build) == '[]')
+    if: always()
     secrets: inherit
     with:
       channel: ${{ inputs.channel }}

From cb3a9cca42d60fc651d98e7abbdd3b47da34d977 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Mon, 9 Dec 2024 11:58:59 +0530
Subject: [PATCH 28/52] adding default result

---
 tests/workflows/integration/test-upload-charm/requirements.txt | 3 ++-
 tests/workflows/integration/test-upload-charm/tox.ini          | 1 -
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/workflows/integration/test-upload-charm/requirements.txt b/tests/workflows/integration/test-upload-charm/requirements.txt
index f9239509b..3c7718578 100644
--- a/tests/workflows/integration/test-upload-charm/requirements.txt
+++ b/tests/workflows/integration/test-upload-charm/requirements.txt
@@ -1,2 +1,3 @@
 ops >= 1.5.0
-allure-pytest>=2.8.18
\ No newline at end of file
+allure-pytest>=2.8.18
+git+https://github.com/canonical/operator-workflows@ISD-2620-allure#subdirectory=python/pytest_plugins/allure_pytest_collection_report
\ No newline at end of file
diff --git a/tests/workflows/integration/test-upload-charm/tox.ini b/tests/workflows/integration/test-upload-charm/tox.ini
index 1698dee21..1a868e5b6 100644
--- a/tests/workflows/integration/test-upload-charm/tox.ini
+++ b/tests/workflows/integration/test-upload-charm/tox.ini
@@ -104,7 +104,6 @@ commands =
 [testenv:integration]
 description = Run integration tests
 deps =
-    git+https://github.com/canonical/operator-workflows@ISD-2620-allure#subdirectory=python/pytest_plugins/allure_pytest_collection_report
     juju==2.9.42.4
     pytest
     pytest-operator

From 8da2658d609ef9b1ce16314910a18be862bf062c Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Mon, 9 Dec 2024 12:01:20 +0530
Subject: [PATCH 29/52] adding default result

---
 .github/workflows/integration_test.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/integration_test.yaml b/.github/workflows/integration_test.yaml
index 284abc6a9..18fa972cf 100644
--- a/.github/workflows/integration_test.yaml
+++ b/.github/workflows/integration_test.yaml
@@ -312,8 +312,8 @@ jobs:
   integration-test:
     name: Integration tests
     uses: ./.github/workflows/integration_test_run.yaml
-    needs: [ plan ]
-    if: always()
+    needs: [ plan, build ]
+    if: always() && needs.plan.result == 'success' && (needs.build.result == 'success' || toJSON(fromJSON(needs.plan.outputs.plan).build) == '[]')
     secrets: inherit
     with:
       channel: ${{ inputs.channel }}

From 3baff1f340a09c7a2121329aceb2e72022ddce03 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Mon, 9 Dec 2024 12:38:04 +0530
Subject: [PATCH 30/52] adding default result

---
 tests/workflows/integration/test-upload-charm/requirements.txt | 3 +--
 .../integration/test-upload-charm/test-requirements.txt        | 1 +
 tests/workflows/integration/test-upload-charm/tox.ini          | 2 ++
 3 files changed, 4 insertions(+), 2 deletions(-)
 create mode 100644 tests/workflows/integration/test-upload-charm/test-requirements.txt

diff --git a/tests/workflows/integration/test-upload-charm/requirements.txt b/tests/workflows/integration/test-upload-charm/requirements.txt
index 3c7718578..f9239509b 100644
--- a/tests/workflows/integration/test-upload-charm/requirements.txt
+++ b/tests/workflows/integration/test-upload-charm/requirements.txt
@@ -1,3 +1,2 @@
 ops >= 1.5.0
-allure-pytest>=2.8.18
-git+https://github.com/canonical/operator-workflows@ISD-2620-allure#subdirectory=python/pytest_plugins/allure_pytest_collection_report
\ No newline at end of file
+allure-pytest>=2.8.18
\ No newline at end of file
diff --git a/tests/workflows/integration/test-upload-charm/test-requirements.txt b/tests/workflows/integration/test-upload-charm/test-requirements.txt
new file mode 100644
index 000000000..829504a07
--- /dev/null
+++ b/tests/workflows/integration/test-upload-charm/test-requirements.txt
@@ -0,0 +1 @@
+git+https://github.com/canonical/operator-workflows@ISD-2620-allure#subdirectory=python/pytest_plugins/allure_pytest_collection_report
\ No newline at end of file
diff --git a/tests/workflows/integration/test-upload-charm/tox.ini b/tests/workflows/integration/test-upload-charm/tox.ini
index 1a868e5b6..d8a614c4c 100644
--- a/tests/workflows/integration/test-upload-charm/tox.ini
+++ b/tests/workflows/integration/test-upload-charm/tox.ini
@@ -112,6 +112,7 @@ deps =
     macaroonbakery==1.3.2
     websockets<14.0 # https://github.com/juju/python-libjuju/issues/1184
     -r{toxinidir}/requirements.txt
+    -r{toxinidir}/test-requirements.txt
 commands =
     pytest -v --tb native --ignore={[vars]tst_path}unit --log-cli-level=INFO -s {posargs}
 
@@ -126,5 +127,6 @@ deps =
     macaroonbakery==1.3.2
     websockets<14.0 # https://github.com/juju/python-libjuju/issues/1184
     -r{toxinidir}/requirements.txt
+    -r{toxinidir}/test-requirements.txt
 commands =
     pytest -v --tb native --ignore={[vars]tst_path}unit --log-cli-level=INFO -s {posargs}

From d7eee35878d63a1d4b6c95b80f99939f46f2ef5d Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Mon, 9 Dec 2024 13:51:56 +0530
Subject: [PATCH 31/52] adding default result

---
 python/cli/pyproject.toml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/python/cli/pyproject.toml b/python/cli/pyproject.toml
index 257a49600..2fc63df2c 100644
--- a/python/cli/pyproject.toml
+++ b/python/cli/pyproject.toml
@@ -1,5 +1,5 @@
 [tool.poetry]
-name = "workflows-cli"
+name = "allure_add_default_for_missing_results"
 # Version unused; repository has its own versioning system. (See .github/workflows/__release.yaml)
 version = "0.1.0"
 description = ""
@@ -8,7 +8,7 @@ authors = ["Carl Csaposs <carl.csaposs@canonical.com>"]
 readme = "README.md"
 
 [tool.poetry.scripts]
-allure-add-default-for-missing-results = "workflows_cli.allure_add_default_for_missing_results:main"
+allure-add-default-for-missing-results = "allure_add_default_for_missing_results.allure_add_default_for_missing_results:main"
 
 [tool.poetry.dependencies]
 python = "^3.10"

From c691921bd68a821def88a9b402497776f85dfa18 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Mon, 9 Dec 2024 16:02:11 +0530
Subject: [PATCH 32/52] adding default result

---
 .github/workflows/integration_test_run.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index ad5cf518e..e18c12fcb 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -200,7 +200,7 @@ jobs:
         uses: actions/upload-artifact@v4
         with:
           name: allure-default-results-${{ env.ALLURE_ARTIFACT_SUFFIX }}
-          path: allure-default/
+          path: ${{ inputs.working-directory }}allure-default/
       - name: Setup operator environment
         uses: charmed-kubernetes/actions-operator@main
         with:

From b2ef7aedefcf70251d7b8e2f9543f11436b5d19d Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Mon, 9 Dec 2024 21:28:59 +0530
Subject: [PATCH 33/52] testing operator workflows

---
 .github/workflows/integration_test_allure.md | 4 ++++
 .github/workflows/integration_test_run.yaml  | 4 ++--
 2 files changed, 6 insertions(+), 2 deletions(-)
 create mode 100644 .github/workflows/integration_test_allure.md

diff --git a/.github/workflows/integration_test_allure.md b/.github/workflows/integration_test_allure.md
new file mode 100644
index 000000000..8fcb4a803
--- /dev/null
+++ b/.github/workflows/integration_test_allure.md
@@ -0,0 +1,4 @@
+# Allure Report Integration
+
+[Allure Report](https://allurereport.org/) for [integration_test_run.yaml](https://github.com/canonical/operator-workflows?tab=readme-ov-file#integration-test-workflow-canonicaloperator-workflowsgithubworkflowsintegration_testyamlmain)
+
diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index e18c12fcb..432083aa4 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -178,13 +178,13 @@ jobs:
           series=""
           if [ ! -z ${{ matrix.series }} ]; then
             series="--series ${{ matrix.series }}"
-            allure_artifact_suffix=$(allure_artifact_suffix)-${{ matrix.series }}
+            allure_artifact_suffix="$allure_artifact_suffix"-${{ matrix.series }}
           fi
           echo "SERIES=$series" >> $GITHUB_ENV
           module=""
           if [ ! -z ${{ matrix.modules }} ]; then
             module="-k ${{ matrix.modules }}"
-            allure_artifact_suffix=$(allure_artifact_suffix)-${{ matrix.modules }}
+            allure_artifact_suffix="$allure_artifact_suffix"-${{ matrix.modules }}
           fi
           echo "MODULE=$module" >> $GITHUB_ENV
           echo "ALLURE_ARTIFACT_SUFFIX=$allure_artifact_suffix" >> $GITHUB_ENV

From ba02d1995e7b8440827259a4c948871bce679c16 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Tue, 10 Dec 2024 11:29:39 +0530
Subject: [PATCH 34/52] testing

---
 .github/workflows/allure_report.yaml         |  13 +---
 .github/workflows/image.png                  | Bin 0 -> 81077 bytes
 .github/workflows/integration_test_allure.md |  65 +++++++++++++++++++
 3 files changed, 67 insertions(+), 11 deletions(-)
 create mode 100644 .github/workflows/image.png

diff --git a/.github/workflows/allure_report.yaml b/.github/workflows/allure_report.yaml
index 7afb2bba1..b2883cf09 100644
--- a/.github/workflows/allure_report.yaml
+++ b/.github/workflows/allure_report.yaml
@@ -13,7 +13,7 @@ jobs:
     if: always() && !cancelled()
     steps:
       - name: Download Allure
-        # Following instructions from https://allurereport.org/docs/gettingstarted-installation/#install-via-the-system-package-manager-for-linux
+        # Following instructions from  https://allurereport.org/docs/install-for-linux/#install-from-a-deb-package
         run: gh release download --repo allure-framework/allure2 --pattern 'allure_*.deb'
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -21,15 +21,6 @@ jobs:
         run: |
           sudo apt-get update
           sudo apt-get install ./allure_*.deb -y
-      # For first run, manually create branch with no history
-      # (e.g.
-      # git checkout --orphan gh-pages
-      # git rm -rf .
-      # touch .nojekyll
-      # git add .nojekyll
-      # git commit -m "Initial commit"
-      # git push origin gh-pages
-      # )
       - name: Checkout GitHub pages branch
         uses: actions/checkout@v4
         with:
@@ -48,7 +39,7 @@ jobs:
           pattern: allure-results*
           merge-multiple: true
       - name: Install CLI
-        run: pipx install git+https://github.com/canonical/operator-workflows@ISD-2620-allure#subdirectory=python/cli
+        run: pipx install git+https://github.com/canonical/operator-workflows@${{ github.ref_name }}#subdirectory=python/cli
       - name: Combine Allure default results & actual results
         # For every test: if actual result available, use that. Otherwise, use default result
         # So that, if actual result not available, Allure report will show "unknown"/"failed" test result
diff --git a/.github/workflows/image.png b/.github/workflows/image.png
new file mode 100644
index 0000000000000000000000000000000000000000..4822691beb99c90c70c7426e21f2b095cb9862a3
GIT binary patch
literal 81077
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
SZ0QCDAn<hcb6Mw<&;$T^WJ!bo

literal 0
HcmV?d00001

diff --git a/.github/workflows/integration_test_allure.md b/.github/workflows/integration_test_allure.md
index 8fcb4a803..9e0761454 100644
--- a/.github/workflows/integration_test_allure.md
+++ b/.github/workflows/integration_test_allure.md
@@ -2,3 +2,68 @@
 
 [Allure Report](https://allurereport.org/) for [integration_test_run.yaml](https://github.com/canonical/operator-workflows?tab=readme-ov-file#integration-test-workflow-canonicaloperator-workflowsgithubworkflowsintegration_testyamlmain)
 
+In order to integrate Allure with your repository, perform the following actions:
+
+## 1. Adding allure-pytest and pytest collection plugin
+
+Please add the following into the `requirements.txt` that is called by the integration test -
+
+```
+allure-pytest>=2.8.18
+```
+
+Create a seperate file `test-requirements.txt` in the same location and add the following -
+
+```
+git+https://github.com/canonical/operator-workflows@main#subdirectory=python/pytest_plugins/allure_pytest_collection_report
+```
+
+Add the following line under the dependencies `deps` for the integration test inside `tox.ini` -
+
+```
+-r{toxinidir}/test-requirements.txt
+```
+
+## 2. Calling the allure-workflow
+
+Add the following lines at the end of the workflow that runs the integrations tests by calling the reuable workflow [integration-test.yaml](https://github.com/canonical/operator-workflows/blob/main/.github/workflows/integration_test.yaml):
+
+```
+  allure-report:
+    if: always() && !cancelled()
+    needs:
+      - [list of jobs with tests you would like to visualize]
+    uses: canonical/operator-workflows/.github/workflows/allure_report.yaml@main
+```
+
+**NOTE:** If the workflow is being called inside a matrix with the same test modules run with different parameters, the allure report will only display the results of the last combination.
+
+## 3. Changing branch permissions
+
+**NOTE:** For this, you would require admin access to the repository.
+
+- Go to the repository's **Settings > Branches** and next to Branch protection rules, select **Add rule**
+- Enter the branch name **gh-pages** and select **Allow force pushes** and click **Save changes**
+
+## 4. Github pages branch
+
+- Create `gh-pages` branch:
+
+```
+# For first run, manually create branch with no history 
+ # (e.g. 
+ # git checkout --orphan gh-pages
+ # git rm -rf . 
+ # touch .nojekyll 
+ # git add .nojekyll 
+ # git commit -m "Initial commit" 
+ # git push origin gh-pages
+ # ) 
+ ```
+
+ - Enable gh pages publishing at ** Settings > Pages ** and set branch name as `gh-pages`:
+
+ ![alt text](image.png)
+
+
+ Example: 
\ No newline at end of file

From 08e2a7d308c206f66a6cda9f92e3c22767319897 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Tue, 10 Dec 2024 12:41:55 +0530
Subject: [PATCH 35/52] testing #

---
 .github/workflows/allure_report.yaml                            | 2 +-
 python/cli/pyproject.toml                                       | 1 -
 .../allure_pytest_collection_report/pyproject.toml              | 1 -
 .../integration/test-upload-charm/test-requirements.txt         | 1 -
 tests/workflows/integration/test-upload-charm/tox.ini           | 2 +-
 5 files changed, 2 insertions(+), 5 deletions(-)
 delete mode 100644 tests/workflows/integration/test-upload-charm/test-requirements.txt

diff --git a/.github/workflows/allure_report.yaml b/.github/workflows/allure_report.yaml
index b2883cf09..999fa1d43 100644
--- a/.github/workflows/allure_report.yaml
+++ b/.github/workflows/allure_report.yaml
@@ -39,7 +39,7 @@ jobs:
           pattern: allure-results*
           merge-multiple: true
       - name: Install CLI
-        run: pipx install git+https://github.com/canonical/operator-workflows@${{ github.ref_name }}#subdirectory=python/cli
+        run: pipx install git+https://github.com/canonical/operator-workflows@ISD-2620-allure#subdirectory=python/cli
       - name: Combine Allure default results & actual results
         # For every test: if actual result available, use that. Otherwise, use default result
         # So that, if actual result not available, Allure report will show "unknown"/"failed" test result
diff --git a/python/cli/pyproject.toml b/python/cli/pyproject.toml
index 2fc63df2c..ad7ef259b 100644
--- a/python/cli/pyproject.toml
+++ b/python/cli/pyproject.toml
@@ -1,6 +1,5 @@
 [tool.poetry]
 name = "allure_add_default_for_missing_results"
-# Version unused; repository has its own versioning system. (See .github/workflows/__release.yaml)
 version = "0.1.0"
 description = ""
 license = "Apache-2.0"
diff --git a/python/pytest_plugins/allure_pytest_collection_report/pyproject.toml b/python/pytest_plugins/allure_pytest_collection_report/pyproject.toml
index 03e6074fe..7c721432c 100644
--- a/python/pytest_plugins/allure_pytest_collection_report/pyproject.toml
+++ b/python/pytest_plugins/allure_pytest_collection_report/pyproject.toml
@@ -1,6 +1,5 @@
 [tool.poetry]
 name = "allure_pytest_collection_report"
-# Version unused; repository has its own versioning system. (See .github/workflows/__release.yaml)
 version = "0.1.0"
 description = ""
 authors = ["Carl Csaposs <carl.csaposs@canonical.com>"]
diff --git a/tests/workflows/integration/test-upload-charm/test-requirements.txt b/tests/workflows/integration/test-upload-charm/test-requirements.txt
deleted file mode 100644
index 829504a07..000000000
--- a/tests/workflows/integration/test-upload-charm/test-requirements.txt
+++ /dev/null
@@ -1 +0,0 @@
-git+https://github.com/canonical/operator-workflows@ISD-2620-allure#subdirectory=python/pytest_plugins/allure_pytest_collection_report
\ No newline at end of file
diff --git a/tests/workflows/integration/test-upload-charm/tox.ini b/tests/workflows/integration/test-upload-charm/tox.ini
index d8a614c4c..4dfdf4616 100644
--- a/tests/workflows/integration/test-upload-charm/tox.ini
+++ b/tests/workflows/integration/test-upload-charm/tox.ini
@@ -112,7 +112,7 @@ deps =
     macaroonbakery==1.3.2
     websockets<14.0 # https://github.com/juju/python-libjuju/issues/1184
     -r{toxinidir}/requirements.txt
-    -r{toxinidir}/test-requirements.txt
+    git+https://github.com/canonical/operator-workflows@ISD-2620-allure\#subdirectory=python/pytest_plugins/allure_pytest_collection_report
 commands =
     pytest -v --tb native --ignore={[vars]tst_path}unit --log-cli-level=INFO -s {posargs}
 

From 3bf15ca19e9e627a408b77f2e8bb32e1401b2dfd Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Tue, 10 Dec 2024 13:54:21 +0530
Subject: [PATCH 36/52] testing

---
 .github/workflows/image.png                     | Bin 81077 -> 0 bytes
 .github/workflows/integration_test_allure.md    |  14 ++++----------
 .../integration/test-upload-charm/tox.ini       |   2 +-
 3 files changed, 5 insertions(+), 11 deletions(-)
 delete mode 100644 .github/workflows/image.png

diff --git a/.github/workflows/image.png b/.github/workflows/image.png
deleted file mode 100644
index 4822691beb99c90c70c7426e21f2b095cb9862a3..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 81077
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
SZ0QCDAn<hcb6Mw<&;$T^WJ!bo

diff --git a/.github/workflows/integration_test_allure.md b/.github/workflows/integration_test_allure.md
index 9e0761454..58f27a473 100644
--- a/.github/workflows/integration_test_allure.md
+++ b/.github/workflows/integration_test_allure.md
@@ -12,16 +12,10 @@ Please add the following into the `requirements.txt` that is called by the integ
 allure-pytest>=2.8.18
 ```
 
-Create a seperate file `test-requirements.txt` in the same location and add the following -
+Add the following line under the dependencies (`deps`) in the integration section inside `tox.ini` -
 
 ```
-git+https://github.com/canonical/operator-workflows@main#subdirectory=python/pytest_plugins/allure_pytest_collection_report
-```
-
-Add the following line under the dependencies `deps` for the integration test inside `tox.ini` -
-
-```
--r{toxinidir}/test-requirements.txt
+git+https://github.com/canonical/operator-workflows@main\#subdirectory=python/pytest_plugins/allure_pytest_collection_report
 ```
 
 ## 2. Calling the allure-workflow
@@ -36,6 +30,8 @@ Add the following lines at the end of the workflow that runs the integrations te
     uses: canonical/operator-workflows/.github/workflows/allure_report.yaml@main
 ```
 
+Here's an [example for the above](https://github.com/canonical/github-runner-operator/pull/412).
+
 **NOTE:** If the workflow is being called inside a matrix with the same test modules run with different parameters, the allure report will only display the results of the last combination.
 
 ## 3. Changing branch permissions
@@ -63,7 +59,5 @@ Add the following lines at the end of the workflow that runs the integrations te
 
  - Enable gh pages publishing at ** Settings > Pages ** and set branch name as `gh-pages`:
 
- ![alt text](image.png)
-
 
  Example: 
\ No newline at end of file
diff --git a/tests/workflows/integration/test-upload-charm/tox.ini b/tests/workflows/integration/test-upload-charm/tox.ini
index 4dfdf4616..b6353b92e 100644
--- a/tests/workflows/integration/test-upload-charm/tox.ini
+++ b/tests/workflows/integration/test-upload-charm/tox.ini
@@ -127,6 +127,6 @@ deps =
     macaroonbakery==1.3.2
     websockets<14.0 # https://github.com/juju/python-libjuju/issues/1184
     -r{toxinidir}/requirements.txt
-    -r{toxinidir}/test-requirements.txt
+    git+https://github.com/canonical/operator-workflows@ISD-2620-allure\#subdirectory=python/pytest_plugins/allure_pytest_collection_report
 commands =
     pytest -v --tb native --ignore={[vars]tst_path}unit --log-cli-level=INFO -s {posargs}

From b3c486acadcff8dfbde7b024fc63a160c80a1eeb Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Tue, 10 Dec 2024 13:56:54 +0530
Subject: [PATCH 37/52] testing

---
 .github/workflows/integration_test_run.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 432083aa4..24d733922 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -190,7 +190,7 @@ jobs:
           echo "ALLURE_ARTIFACT_SUFFIX=$allure_artifact_suffix" >> $GITHUB_ENV
       - name: Install tox
         run: |
-          pip install tox 
+          pipx install tox 
       - name: Collect tests for Allure
         working-directory: ${{ inputs.working-directory }}
         run: |

From 177f6f4d8f2e6adeb9fe3e980691d239570b233f Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Tue, 10 Dec 2024 14:01:26 +0530
Subject: [PATCH 38/52] testing

---
 .github/workflows/workflow_test.yaml | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/.github/workflows/workflow_test.yaml b/.github/workflows/workflow_test.yaml
index f9b9b7c56..88425cab4 100644
--- a/.github/workflows/workflow_test.yaml
+++ b/.github/workflows/workflow_test.yaml
@@ -103,6 +103,14 @@ jobs:
       integration-test-workflow-file: workflow_test.yaml
       working-directory: tests/workflows/integration/test-upload-charm/
       workflow-run-id: ${{ github.run_id }}
+  allure-report:
+    if: always() && !cancelled()
+    needs:
+      - integration
+      - integration-juju3
+      - integration-artifact
+      - integration-self-hosted
+    uses: ./.github/workflows/allure_report.yaml
   check:
     runs-on: ubuntu-latest
     if: always() && !cancelled()
@@ -119,6 +127,7 @@ jobs:
       - integration-craft
       - publish
       - publish-artifact
+      - allure-report
     steps:
       - run: |
           [ '${{ needs.simple.result }}' = 'success' ] || (echo simple failed && false)
@@ -132,14 +141,5 @@ jobs:
           [ '${{ needs.integration-craft.result }}' = 'success' ] || (echo integration-craft failed && false)
           [ '${{ needs.publish.result }}' != 'failure' ] || (echo publish failed && false)
           [ '${{ needs.publish-artifact.result }}' != 'failure' ] || (echo publish failed && false)
-  allure-report:
-    if: always() && !cancelled()
-    needs:
-      - integration
-      - integration-juju3
-      - integration-artifact
-      - integration-self-hosted
-      - integration-rock
-      - integration-rock-artifact
-      - integration-craft
-    uses: ./.github/workflows/allure_report.yaml
+          [ '${{ needs.allure-report.result }}' != 'failure' ] || (echo allure-report failed && false)
+

From 53e0331547d6dd1c4e22687ecd8a7fb9c40f77db Mon Sep 17 00:00:00 2001
From: swetha1654 <swetha.swaminathan@canonical.com>
Date: Tue, 10 Dec 2024 14:14:48 +0530
Subject: [PATCH 39/52] Update integration_test_allure.md

Signed-off-by: swetha1654 <swetha.swaminathan@canonical.com>
---
 .github/workflows/integration_test_allure.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/integration_test_allure.md b/.github/workflows/integration_test_allure.md
index 58f27a473..9d1f0ad74 100644
--- a/.github/workflows/integration_test_allure.md
+++ b/.github/workflows/integration_test_allure.md
@@ -59,5 +59,6 @@ Here's an [example for the above](https://github.com/canonical/github-runner-ope
 
  - Enable gh pages publishing at ** Settings > Pages ** and set branch name as `gh-pages`:
 
+<img width="816" alt="image" src="https://github.com/user-attachments/assets/346c04fc-0daa-40bc-92b5-93b0ea639f94">
 
- Example: 
\ No newline at end of file
+ [Example PR for steps 1 & 2](https://github.com/canonical/github-runner-operator/pull/412/files#)

From d8b4254f020f3dc41ecc6523c739bdb307b593a7 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Tue, 10 Dec 2024 16:21:40 +0530
Subject: [PATCH 40/52] remove python folder

---
 .github/workflows/allure_report.yaml          |   4 +-
 .github/workflows/integration_test_run.yaml   |   2 +-
 python/cli/README.md                          |   3 -
 .../__init__.py                               |   2 -
 .../allure_add_default_for_missing_results.py |  51 --------
 python/cli/pyproject.toml                     |  20 ---
 .../allure_pytest_collection_report/README.md |   1 -
 .../__init__.py                               |   2 -
 .../_plugin.py                                | 122 ------------------
 .../pyproject.toml                            |  22 ----
 .../integration/test-upload-charm/tox.ini     |   4 +-
 11 files changed, 5 insertions(+), 228 deletions(-)
 delete mode 100644 python/cli/README.md
 delete mode 100644 python/cli/allure_add_default_for_missing_results/__init__.py
 delete mode 100644 python/cli/allure_add_default_for_missing_results/allure_add_default_for_missing_results.py
 delete mode 100644 python/cli/pyproject.toml
 delete mode 100644 python/pytest_plugins/allure_pytest_collection_report/README.md
 delete mode 100644 python/pytest_plugins/allure_pytest_collection_report/allure_pytest_collection_report/__init__.py
 delete mode 100644 python/pytest_plugins/allure_pytest_collection_report/allure_pytest_collection_report/_plugin.py
 delete mode 100644 python/pytest_plugins/allure_pytest_collection_report/pyproject.toml

diff --git a/.github/workflows/allure_report.yaml b/.github/workflows/allure_report.yaml
index 999fa1d43..06c6f85f3 100644
--- a/.github/workflows/allure_report.yaml
+++ b/.github/workflows/allure_report.yaml
@@ -39,7 +39,7 @@ jobs:
           pattern: allure-results*
           merge-multiple: true
       - name: Install CLI
-        run: pipx install git+https://github.com/canonical/operator-workflows@ISD-2620-allure#subdirectory=python/cli
+        run: pipx install git+https://github.com/canonical/data-platform-workflows@v24.0.0#subdirectory=python/cli
       - name: Combine Allure default results & actual results
         # For every test: if actual result available, use that. Otherwise, use default result
         # So that, if actual result not available, Allure report will show "unknown"/"failed" test result
@@ -93,4 +93,4 @@ jobs:
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
           git commit -m "Allure report ${{ github.run_number }}"
           # Uses token set in checkout step
-          git push origin gh-pages
\ No newline at end of file
+          git push origin gh-pages
diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 24d733922..432083aa4 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -190,7 +190,7 @@ jobs:
           echo "ALLURE_ARTIFACT_SUFFIX=$allure_artifact_suffix" >> $GITHUB_ENV
       - name: Install tox
         run: |
-          pipx install tox 
+          pip install tox 
       - name: Collect tests for Allure
         working-directory: ${{ inputs.working-directory }}
         run: |
diff --git a/python/cli/README.md b/python/cli/README.md
deleted file mode 100644
index 5b6554569..000000000
--- a/python/cli/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-The `allure_add_default_for_missing_results` cli combines the Allure default results & actual results before generating the report. 
-
-Currently, if the result of a test is not available (for reasons such as setup failure), allure omits the test. This CLI ensures that for every test, if actual result is available, it will use that. Otherwise, it uses the default result `unknown`.
\ No newline at end of file
diff --git a/python/cli/allure_add_default_for_missing_results/__init__.py b/python/cli/allure_add_default_for_missing_results/__init__.py
deleted file mode 100644
index e3979c0f6..000000000
--- a/python/cli/allure_add_default_for_missing_results/__init__.py
+++ /dev/null
@@ -1,2 +0,0 @@
-# Copyright 2024 Canonical Ltd.
-# See LICENSE file for licensing details.
diff --git a/python/cli/allure_add_default_for_missing_results/allure_add_default_for_missing_results.py b/python/cli/allure_add_default_for_missing_results/allure_add_default_for_missing_results.py
deleted file mode 100644
index 14d2b6bad..000000000
--- a/python/cli/allure_add_default_for_missing_results/allure_add_default_for_missing_results.py
+++ /dev/null
@@ -1,51 +0,0 @@
-# Copyright 2024 Canonical Ltd.
-# See LICENSE file for licensing details.
-import argparse
-import dataclasses
-import json
-import pathlib
-
-
-@dataclasses.dataclass(frozen=True)
-class Result:
-    test_case_id: str
-    path: pathlib.Path
-
-    def __eq__(self, other):
-        if not isinstance(other, type(self)):
-            return False
-        return self.test_case_id == other.test_case_id
-
-
-def main():
-    """Combine Allure default results & actual results
-
-    For every test: if actual result available, use that. Otherwise, use default result
-
-    So that, if actual result not available, Allure report will show "unknown"/"failed" test result
-    instead of omitting the test
-    """
-    parser = argparse.ArgumentParser()
-    parser.add_argument("--allure-results-dir", required=True)
-    parser.add_argument("--allure-collection-default-results-dir", required=True)
-    args = parser.parse_args()
-
-    actual_results = pathlib.Path(args.allure_results_dir)
-    default_results = pathlib.Path(args.allure_collection_default_results_dir)
-
-    results: dict[pathlib.Path, set[Result]] = {
-        actual_results: set(),
-        default_results: set(),
-    }
-    for directory, results_ in results.items():
-        for path in directory.glob("*-result.json"):
-            with path.open("r") as file:
-                id_ = json.load(file)["testCaseId"]
-            results_.add(Result(id_, path))
-
-    actual_results.mkdir(exist_ok=True)
-
-    missing_results = results[default_results] - results[actual_results]
-    for default_result in missing_results:
-        # Move to `actual_results` directory
-        default_result.path.rename(actual_results / default_result.path.name)
diff --git a/python/cli/pyproject.toml b/python/cli/pyproject.toml
deleted file mode 100644
index ad7ef259b..000000000
--- a/python/cli/pyproject.toml
+++ /dev/null
@@ -1,20 +0,0 @@
-[tool.poetry]
-name = "allure_add_default_for_missing_results"
-version = "0.1.0"
-description = ""
-license = "Apache-2.0"
-authors = ["Carl Csaposs <carl.csaposs@canonical.com>"]
-readme = "README.md"
-
-[tool.poetry.scripts]
-allure-add-default-for-missing-results = "allure_add_default_for_missing_results.allure_add_default_for_missing_results:main"
-
-[tool.poetry.dependencies]
-python = "^3.10"
-pyyaml = "^6.0.1"
-requests = "^2.31.0"
-
-
-[build-system]
-requires = ["poetry-core"]
-build-backend = "poetry.core.masonry.api"
\ No newline at end of file
diff --git a/python/pytest_plugins/allure_pytest_collection_report/README.md b/python/pytest_plugins/allure_pytest_collection_report/README.md
deleted file mode 100644
index e3a5e1b8b..000000000
--- a/python/pytest_plugins/allure_pytest_collection_report/README.md
+++ /dev/null
@@ -1 +0,0 @@
-The `allure-pytest` plugin marks all the test statuses as unknown during collection time.
\ No newline at end of file
diff --git a/python/pytest_plugins/allure_pytest_collection_report/allure_pytest_collection_report/__init__.py b/python/pytest_plugins/allure_pytest_collection_report/allure_pytest_collection_report/__init__.py
deleted file mode 100644
index e3979c0f6..000000000
--- a/python/pytest_plugins/allure_pytest_collection_report/allure_pytest_collection_report/__init__.py
+++ /dev/null
@@ -1,2 +0,0 @@
-# Copyright 2024 Canonical Ltd.
-# See LICENSE file for licensing details.
diff --git a/python/pytest_plugins/allure_pytest_collection_report/allure_pytest_collection_report/_plugin.py b/python/pytest_plugins/allure_pytest_collection_report/allure_pytest_collection_report/_plugin.py
deleted file mode 100644
index 1832d0575..000000000
--- a/python/pytest_plugins/allure_pytest_collection_report/allure_pytest_collection_report/_plugin.py
+++ /dev/null
@@ -1,122 +0,0 @@
-# Copyright 2024 Canonical Ltd.
-# See LICENSE file for licensing details.
-# Upstream feature request to replace this plugin:
-# https://github.com/allure-framework/allure-python/issues/821
-
-import allure_commons.logger
-import allure_commons.model2
-import allure_commons.types
-import allure_commons.utils
-import allure_pytest.listener
-import allure_pytest.utils
-
-
-def pytest_addoption(parser):
-    parser.addoption(
-        "--allure-collection-dir",
-        help="Generate default Allure results (used by GitHub Actions) in \
-            this directory for tests that are missing Allure results",
-    )
-
-
-def pytest_configure(config):
-    if config.option.allure_collection_dir:
-        config.option.collectonly = True
-
-
-def pytest_collection_finish(session):
-    report_dir = session.config.option.allure_collection_dir
-    if not report_dir:
-        return
-
-    # Copied from `allure_pytest.listener.AllureListener._cache`
-    _cache = allure_pytest.listener.ItemCache()
-    # Modified from `allure_pytest.plugin.pytest_configure`
-    file_logger = allure_commons.logger.AllureFileLogger(report_dir)
-
-    for item in session.items:
-        # Modified from
-        # `allure_pytest.listener.AllureListener.pytest_runtest_protocol`
-        uuid = _cache.push(item.nodeid)
-        test_result = allure_commons.model2.TestResult(name=item.name, uuid=uuid)
-
-        # Copied from `allure_pytest.listener.AllureListener.pytest_runtest_setup`
-        params = (
-            allure_pytest.listener.AllureListener._AllureListener__get_pytest_params(
-                item
-            )
-        )
-        test_result.name = allure_pytest.utils.allure_name(item, params)
-        full_name = allure_pytest.utils.allure_full_name(item)
-        test_result.fullName = full_name
-        test_result.testCaseId = allure_commons.utils.md5(full_name)
-        test_result.description = allure_pytest.utils.allure_description(item)
-        test_result.descriptionHtml = allure_pytest.utils.allure_description_html(item)
-        current_param_names = [param.name for param in test_result.parameters]
-        test_result.parameters.extend(
-            [
-                allure_commons.model2.Parameter(
-                    name=name, value=allure_commons.utils.represent(value)
-                )
-                for name, value in params.items()
-                if name not in current_param_names
-            ]
-        )
-
-        # Copied from `allure_pytest.listener.AllureListener.pytest_runtest_teardown`
-        listener = allure_pytest.listener.AllureListener
-        test_result.historyId = allure_pytest.utils.get_history_id(
-            test_result.fullName,
-            test_result.parameters,
-            original_values=listener._AllureListener__get_pytest_params(item),
-        )
-        test_result.labels.extend(
-            [
-                allure_commons.model2.Label(name=name, value=value)
-                for name, value in allure_pytest.utils.allure_labels(item)
-            ]
-        )
-        test_result.labels.extend(
-            [
-                allure_commons.model2.Label(
-                    name=allure_commons.types.LabelType.TAG, value=value
-                )
-                for value in allure_pytest.utils.pytest_markers(item)
-            ]
-        )
-        allure_pytest.listener.AllureListener._AllureListener__apply_default_suites(
-            None, item, test_result
-        )
-        test_result.labels.append(
-            allure_commons.model2.Label(
-                name=allure_commons.types.LabelType.HOST,
-                value=allure_commons.utils.host_tag(),
-            )
-        )
-        test_result.labels.append(
-            allure_commons.model2.Label(
-                name=allure_commons.types.LabelType.FRAMEWORK, value="pytest"
-            )
-        )
-        test_result.labels.append(
-            allure_commons.model2.Label(
-                name=allure_commons.types.LabelType.LANGUAGE,
-                value=allure_commons.utils.platform_label(),
-            )
-        )
-        test_result.labels.append(
-            allure_commons.model2.Label(
-                name="package", value=allure_pytest.utils.allure_package(item)
-            )
-        )
-        test_result.links.extend(
-            [
-                allure_commons.model2.Link(link_type, url, name)
-                for link_type, url, name in allure_pytest.utils.allure_links(item)
-            ]
-        )
-
-        # Modified from `allure_pytest.listener.AllureListener.pytest_runtest_protocol`
-        test_result.status = allure_commons.model2.Status.UNKNOWN
-        # Modified from `allure_commons.reporter.AllureReporter.close_test`
-        file_logger.report_result(test_result)
diff --git a/python/pytest_plugins/allure_pytest_collection_report/pyproject.toml b/python/pytest_plugins/allure_pytest_collection_report/pyproject.toml
deleted file mode 100644
index 7c721432c..000000000
--- a/python/pytest_plugins/allure_pytest_collection_report/pyproject.toml
+++ /dev/null
@@ -1,22 +0,0 @@
-[tool.poetry]
-name = "allure_pytest_collection_report"
-version = "0.1.0"
-description = ""
-authors = ["Carl Csaposs <carl.csaposs@canonical.com>"]
-readme = "README.md"
-classifiers = [
-    "Framework :: Pytest",
-]
-
-[tool.poetry.plugins."pytest11"]
-allure_collection_report = "allure_pytest_collection_report._plugin"
-
-[tool.poetry.dependencies]
-python = "^3.8"
-pytest = "*"
-allure-pytest = ">=2.13.5"
-
-
-[build-system]
-requires = ["poetry-core"]
-build-backend = "poetry.core.masonry.api"
\ No newline at end of file
diff --git a/tests/workflows/integration/test-upload-charm/tox.ini b/tests/workflows/integration/test-upload-charm/tox.ini
index b6353b92e..04a96ee43 100644
--- a/tests/workflows/integration/test-upload-charm/tox.ini
+++ b/tests/workflows/integration/test-upload-charm/tox.ini
@@ -112,7 +112,7 @@ deps =
     macaroonbakery==1.3.2
     websockets<14.0 # https://github.com/juju/python-libjuju/issues/1184
     -r{toxinidir}/requirements.txt
-    git+https://github.com/canonical/operator-workflows@ISD-2620-allure\#subdirectory=python/pytest_plugins/allure_pytest_collection_report
+    git+https://github.com/canonical/data-platform-workflows@v24.0.0\#subdirectory=python/pytest_plugins/allure_pytest_collection_report
 commands =
     pytest -v --tb native --ignore={[vars]tst_path}unit --log-cli-level=INFO -s {posargs}
 
@@ -127,6 +127,6 @@ deps =
     macaroonbakery==1.3.2
     websockets<14.0 # https://github.com/juju/python-libjuju/issues/1184
     -r{toxinidir}/requirements.txt
-    git+https://github.com/canonical/operator-workflows@ISD-2620-allure\#subdirectory=python/pytest_plugins/allure_pytest_collection_report
+    git+https://github.com/canonical/data-platform-workflows@v24.0.0\#subdirectory=python/pytest_plugins/allure_pytest_collection_report
 commands =
     pytest -v --tb native --ignore={[vars]tst_path}unit --log-cli-level=INFO -s {posargs}

From 4c74d546e0f31968bcba5d5755afd85540236691 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Tue, 10 Dec 2024 21:44:05 +0530
Subject: [PATCH 41/52] address review comments

---
 .github/workflows/allure_report.yaml          | 22 ++++++++++---------
 .github/workflows/integration_test_run.yaml   |  2 +-
 .licenserc.yaml                               |  1 -
 .../how-to}/integration_test_allure.md        |  2 +-
 4 files changed, 14 insertions(+), 13 deletions(-)
 rename {.github/workflows => docs/how-to}/integration_test_allure.md (95%)

diff --git a/.github/workflows/allure_report.yaml b/.github/workflows/allure_report.yaml
index 06c6f85f3..c4a78fc79 100644
--- a/.github/workflows/allure_report.yaml
+++ b/.github/workflows/allure_report.yaml
@@ -21,16 +21,18 @@ jobs:
         run: |
           sudo apt-get update
           sudo apt-get install ./allure_*.deb -y
-      - name: Checkout GitHub pages branch
+      - name: Checkout GitHub pages branch 
         uses: actions/checkout@v4
         with:
           ref: gh-pages
-          path: repo/
-      - name: Download default test results
+          path: repo/ 
+        # The `gh-pages` branch is used to host the Allure report site.
+        # With every workflow run, the workflow creates a new folder with the run_number and stores the test results there
+      - name: Download fallback test results
         uses: actions/download-artifact@v4
         with:
-          path: allure-collection-default-results/
-          pattern: allure-default-results*
+          path: allure-collection-fallback-results/
+          pattern: allure-fallback-results*
           merge-multiple: true
       - name: Download actual test results
         uses: actions/download-artifact@v4
@@ -40,11 +42,11 @@ jobs:
           merge-multiple: true
       - name: Install CLI
         run: pipx install git+https://github.com/canonical/data-platform-workflows@v24.0.0#subdirectory=python/cli
-      - name: Combine Allure default results & actual results
-        # For every test: if actual result available, use that. Otherwise, use default result
+      - name: Combine Allure fallback results & actual results
+        # For every test: if actual result available, use that. Otherwise, use fallback result
         # So that, if actual result not available, Allure report will show "unknown"/"failed" test result
         # instead of omitting the test
-        run: allure-add-default-for-missing-results --allure-results-dir=allure-results --allure-collection-default-results-dir=allure-collection-default-results
+        run: allure-add-default-for-missing-results --allure-results-dir=allure-results --allure-collection-fallback-results-dir=allure-collection-fallback-results
       - name: Load test report history
         run: |
           if [[ -d repo/_latest/history/ ]]
@@ -82,7 +84,6 @@ jobs:
               file.write(DATA)
       - name: Update GitHub pages branch
         working-directory: repo/
-        # TODO future improvement: commit message
         run: |
           mkdir '${{ github.run_number }}'
           rm -f _latest
@@ -90,7 +91,8 @@ jobs:
           cp -r ../allure-report/. _latest/
           git add .
           git config user.name "GitHub Actions"
-          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          # user.email obtained from https://github.com/actions/checkout/issues/13#issuecomment-724415212
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com" 
           git commit -m "Allure report ${{ github.run_number }}"
           # Uses token set in checkout step
           git push origin gh-pages
diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 432083aa4..d02e3b42f 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -199,7 +199,7 @@ jobs:
         timeout-minutes: 3
         uses: actions/upload-artifact@v4
         with:
-          name: allure-default-results-${{ env.ALLURE_ARTIFACT_SUFFIX }}
+          name: allure-fallback-results-${{ env.ALLURE_ARTIFACT_SUFFIX }}
           path: ${{ inputs.working-directory }}allure-default/
       - name: Setup operator environment
         uses: charmed-kubernetes/actions-operator@main
diff --git a/.licenserc.yaml b/.licenserc.yaml
index ca8c7a317..291d80eb6 100644
--- a/.licenserc.yaml
+++ b/.licenserc.yaml
@@ -32,5 +32,4 @@ header:
     - 'dist/**'
     - 'internal/**'
     - 'tests/workflows/integration/**'
-    - 'python/**/**/pyproject.toml'
   comment: on-failure
diff --git a/.github/workflows/integration_test_allure.md b/docs/how-to/integration_test_allure.md
similarity index 95%
rename from .github/workflows/integration_test_allure.md
rename to docs/how-to/integration_test_allure.md
index 9d1f0ad74..4320144be 100644
--- a/.github/workflows/integration_test_allure.md
+++ b/docs/how-to/integration_test_allure.md
@@ -39,7 +39,7 @@ Here's an [example for the above](https://github.com/canonical/github-runner-ope
 **NOTE:** For this, you would require admin access to the repository.
 
 - Go to the repository's **Settings > Branches** and next to Branch protection rules, select **Add rule**
-- Enter the branch name **gh-pages** and select **Allow force pushes** and click **Save changes**
+- Enter the branch name **gh-pages** and click **Save changes** (Ensure that "require signed commits" is unchecked)
 
 ## 4. Github pages branch
 

From 163d73506b36ff21bac87bcf0ba93c3048497a5f Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 11 Dec 2024 10:11:20 +0530
Subject: [PATCH 42/52] address review comments

---
 docs/how-to/integration_test_allure.md | 26 ++++++++++++--------------
 1 file changed, 12 insertions(+), 14 deletions(-)

diff --git a/docs/how-to/integration_test_allure.md b/docs/how-to/integration_test_allure.md
index 4320144be..b3f3b43b1 100644
--- a/docs/how-to/integration_test_allure.md
+++ b/docs/how-to/integration_test_allure.md
@@ -1,24 +1,22 @@
-# Allure Report Integration
+# How to set up Allure Reports for integration tests
 
-[Allure Report](https://allurereport.org/) for [integration_test_run.yaml](https://github.com/canonical/operator-workflows?tab=readme-ov-file#integration-test-workflow-canonicaloperator-workflowsgithubworkflowsintegration_testyamlmain)
+This how-to guide describes how to integrate [Allure Reports](https://allurereport.org/) into your code repository's [integration_test_run.yaml](https://github.com/canonical/operator-workflows?tab=readme-ov-file#integration-test-workflow-canonicaloperator-workflowsgithubworkflowsintegration_testyamlmain).
 
-In order to integrate Allure with your repository, perform the following actions:
+## Adding allure-pytest and pytest collection plugin
 
-## 1. Adding allure-pytest and pytest collection plugin
-
-Please add the following into the `requirements.txt` that is called by the integration test -
+Include the following snippet in the `requirements.txt` that is called by the integration test:
 
 ```
 allure-pytest>=2.8.18
 ```
 
-Add the following line under the dependencies (`deps`) in the integration section inside `tox.ini` -
+Add the following line under the dependencies (`deps`) in the integration section inside `tox.ini`:
 
 ```
 git+https://github.com/canonical/operator-workflows@main\#subdirectory=python/pytest_plugins/allure_pytest_collection_report
 ```
 
-## 2. Calling the allure-workflow
+## Calling the allure-workflow
 
 Add the following lines at the end of the workflow that runs the integrations tests by calling the reuable workflow [integration-test.yaml](https://github.com/canonical/operator-workflows/blob/main/.github/workflows/integration_test.yaml):
 
@@ -30,18 +28,18 @@ Add the following lines at the end of the workflow that runs the integrations te
     uses: canonical/operator-workflows/.github/workflows/allure_report.yaml@main
 ```
 
-Here's an [example for the above](https://github.com/canonical/github-runner-operator/pull/412).
+For an example of this implementation, see [the GitHub runner repository](https://github.com/canonical/github-runner-operator/pull/412).
 
 **NOTE:** If the workflow is being called inside a matrix with the same test modules run with different parameters, the allure report will only display the results of the last combination.
 
-## 3. Changing branch permissions
+## Changing branch permissions
 
-**NOTE:** For this, you would require admin access to the repository.
+**NOTE:** For this step, you need admin access to the repository.
 
 - Go to the repository's **Settings > Branches** and next to Branch protection rules, select **Add rule**
 - Enter the branch name **gh-pages** and click **Save changes** (Ensure that "require signed commits" is unchecked)
 
-## 4. Github pages branch
+## Github pages branch
 
 - Create `gh-pages` branch:
 
@@ -57,8 +55,8 @@ Here's an [example for the above](https://github.com/canonical/github-runner-ope
  # ) 
  ```
 
- - Enable gh pages publishing at ** Settings > Pages ** and set branch name as `gh-pages`:
+ - Enable GitHub pages publishing at ** Settings > Pages ** and set branch name as `gh-pages`:
 
 <img width="816" alt="image" src="https://github.com/user-attachments/assets/346c04fc-0daa-40bc-92b5-93b0ea639f94">
 
- [Example PR for steps 1 & 2](https://github.com/canonical/github-runner-operator/pull/412/files#)
+For an example of the first two steps, see [the GitHub runner repository](https://github.com/canonical/github-runner-operator/pull/412).

From b285aaf02663c4336b53ffbd10dbc006324ddaa7 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 11 Dec 2024 10:12:10 +0530
Subject: [PATCH 43/52] address review comments

---
 .github/workflows/allure_report.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/allure_report.yaml b/.github/workflows/allure_report.yaml
index c4a78fc79..cff2139e9 100644
--- a/.github/workflows/allure_report.yaml
+++ b/.github/workflows/allure_report.yaml
@@ -46,7 +46,7 @@ jobs:
         # For every test: if actual result available, use that. Otherwise, use fallback result
         # So that, if actual result not available, Allure report will show "unknown"/"failed" test result
         # instead of omitting the test
-        run: allure-add-default-for-missing-results --allure-results-dir=allure-results --allure-collection-fallback-results-dir=allure-collection-fallback-results
+        run: allure-add-default-for-missing-results --allure-results-dir=allure-results --allure-collection-default-results-dir=allure-collection-fallback-results
       - name: Load test report history
         run: |
           if [[ -d repo/_latest/history/ ]]

From aeac64bb9d2cea3f4e7889db579ca1688e838787 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 11 Dec 2024 10:18:35 +0530
Subject: [PATCH 44/52] address review comments

---
 docs/how-to/integration_test_allure.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/how-to/integration_test_allure.md b/docs/how-to/integration_test_allure.md
index b3f3b43b1..b1721ab43 100644
--- a/docs/how-to/integration_test_allure.md
+++ b/docs/how-to/integration_test_allure.md
@@ -18,19 +18,19 @@ git+https://github.com/canonical/operator-workflows@main\#subdirectory=python/py
 
 ## Calling the allure-workflow
 
-Add the following lines at the end of the workflow that runs the integrations tests by calling the reuable workflow [integration-test.yaml](https://github.com/canonical/operator-workflows/blob/main/.github/workflows/integration_test.yaml):
+To call the reusable workflow [allure_report.yaml](https://github.com/canonical/operator-workflows/blob/main/.github/workflows/allure_report.yaml), add the following lines at the end of the workflow that runs the integrations tests:
 
 ```
   allure-report:
     if: always() && !cancelled()
     needs:
-      - [list of jobs with tests you would like to visualize]
+      - [list of jobs that calls integration_test workflow whose tests you would like to visualize]
     uses: canonical/operator-workflows/.github/workflows/allure_report.yaml@main
 ```
 
 For an example of this implementation, see [the GitHub runner repository](https://github.com/canonical/github-runner-operator/pull/412).
 
-**NOTE:** If the workflow is being called inside a matrix with the same test modules run with different parameters, the allure report will only display the results of the last combination.
+**NOTE:** If the workflow is being called inside a matrix with the same test modules run with different parameters, the Allure Report will only display the results of the last combination.
 
 ## Changing branch permissions
 

From 1fde840fbf8e833123f980d4854a6b1e7eeac83a Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 11 Dec 2024 13:07:03 +0530
Subject: [PATCH 45/52] update tox and add check allure

---
 .github/workflows/allure_report.yaml        |  1 +
 .github/workflows/integration_test_run.yaml | 33 ++++++++++++++++++++-
 2 files changed, 33 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/allure_report.yaml b/.github/workflows/allure_report.yaml
index cff2139e9..10a0cb799 100644
--- a/.github/workflows/allure_report.yaml
+++ b/.github/workflows/allure_report.yaml
@@ -58,6 +58,7 @@ jobs:
         shell: python
         run: |
           # Reverse engineered from https://github.com/simple-elf/allure-report-action/blob/eca283b643d577c69b8e4f048dd6cd8eb8457cfd/entrypoint.sh
+          # Not using the original action due to security concerns over using 3rd party github actions and the risk of running arbitrary code
           import json
 
           DATA = {
diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index d02e3b42f..6be32d0f1 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -190,12 +190,43 @@ jobs:
           echo "ALLURE_ARTIFACT_SUFFIX=$allure_artifact_suffix" >> $GITHUB_ENV
       - name: Install tox
         run: |
-          pip install tox 
+          if which tox &> /dev/null; then
+            echo "tox is already installed."
+            tox --version
+          fi
+
+          pip_path=$(which pip 2>/dev/null)
+          SYSTEM_PIP_PATH="/usr/bin/pip"
+          if [ -n "$pip_path" ] && [ "$pip_path" != "$SYSTEM_PIP_PATH" ]; then
+              echo "Pip is available and not system-managed. Installing tox"
+              pip install tox
+          fi
+
+          if which pipx &> /dev/null; then
+              echo "Pipx is available. Installing tox"
+              pipx install tox
+          fi
+
+          echo "Neither pip nor pipx are available. Installing pipx via apt..."
+          sudo apt-get update -yqq
+          sudo apt-get install -yqq pipx
+          pipx ensurepath
+          sudo pipx ensurepath
+
+          echo "Installing tox with pipx..."
+          pipx install tox
+      - name: Check Allure
+        run: |
+          tox -e ${{ inputs.test-tox-env }} --notest --list-dependencies 2>&1 | grep -q allure \
+            && echo 'ENABLE_ALLURE=true' >> $GITHUB_ENV \
+            || echo 'ENABLE_ALLURE=false' >> $GITHUB_ENV
       - name: Collect tests for Allure
+        if: ${{ env.ENABLE_ALLURE == true }}
         working-directory: ${{ inputs.working-directory }}
         run: |
           tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} --allure-collection-dir=allure-default ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
       - name: Upload Default Allure results
+        if: ${{ env.ENABLE_ALLURE == true }}
         timeout-minutes: 3
         uses: actions/upload-artifact@v4
         with:

From a0da65291066f159f497d0e18da44f80b634edb7 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 11 Dec 2024 13:07:52 +0530
Subject: [PATCH 46/52] update tox and add check allure

---
 .github/workflows/integration_test_run.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 6be32d0f1..0b3afcfa5 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -221,12 +221,12 @@ jobs:
             && echo 'ENABLE_ALLURE=true' >> $GITHUB_ENV \
             || echo 'ENABLE_ALLURE=false' >> $GITHUB_ENV
       - name: Collect tests for Allure
-        if: ${{ env.ENABLE_ALLURE == true }}
+        if: ${{ env.ENABLE_ALLURE == "true" }}
         working-directory: ${{ inputs.working-directory }}
         run: |
           tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} --allure-collection-dir=allure-default ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
       - name: Upload Default Allure results
-        if: ${{ env.ENABLE_ALLURE == true }}
+        if: ${{ env.ENABLE_ALLURE == "true" }}
         timeout-minutes: 3
         uses: actions/upload-artifact@v4
         with:

From 4202ba7c12bf979846e0fe798315080dc0b4180a Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 11 Dec 2024 13:22:54 +0530
Subject: [PATCH 47/52] update tox and add check allure

---
 docs/how-to/integration_test_allure.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/how-to/integration_test_allure.md b/docs/how-to/integration_test_allure.md
index b1721ab43..1ce16787b 100644
--- a/docs/how-to/integration_test_allure.md
+++ b/docs/how-to/integration_test_allure.md
@@ -24,7 +24,7 @@ To call the reusable workflow [allure_report.yaml](https://github.com/canonical/
   allure-report:
     if: always() && !cancelled()
     needs:
-      - [list of jobs that calls integration_test workflow whose tests you would like to visualize]
+      - [list of jobs that call integration_test workflow whose tests you would like to visualize]
     uses: canonical/operator-workflows/.github/workflows/allure_report.yaml@main
 ```
 
@@ -36,6 +36,8 @@ For an example of this implementation, see [the GitHub runner repository](https:
 
 **NOTE:** For this step, you need admin access to the repository.
 
+If your repository is configured to have signed commits for all branches by default, you need to create a seperate protection rule for the `gh-pages` branch with the signed commits disabled.
+
 - Go to the repository's **Settings > Branches** and next to Branch protection rules, select **Add rule**
 - Enter the branch name **gh-pages** and click **Save changes** (Ensure that "require signed commits" is unchecked)
 

From cb41e5200aa9cbf877c0651c5a619657e93502c8 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 11 Dec 2024 13:25:37 +0530
Subject: [PATCH 48/52] update tox and add check allure

---
 .github/workflows/integration_test_run.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 0b3afcfa5..98fa9c794 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -221,12 +221,12 @@ jobs:
             && echo 'ENABLE_ALLURE=true' >> $GITHUB_ENV \
             || echo 'ENABLE_ALLURE=false' >> $GITHUB_ENV
       - name: Collect tests for Allure
-        if: ${{ env.ENABLE_ALLURE == "true" }}
+        if: env.ENABLE_ALLURE == "true"
         working-directory: ${{ inputs.working-directory }}
         run: |
           tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} --allure-collection-dir=allure-default ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
       - name: Upload Default Allure results
-        if: ${{ env.ENABLE_ALLURE == "true" }}
+        if: env.ENABLE_ALLURE == "true"
         timeout-minutes: 3
         uses: actions/upload-artifact@v4
         with:

From 89c33f4e2b8cc3edd3de00ec4a82a604097276be Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 11 Dec 2024 13:26:53 +0530
Subject: [PATCH 49/52] update tox and add check allure

---
 .github/workflows/integration_test_run.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 98fa9c794..86097956a 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -221,12 +221,12 @@ jobs:
             && echo 'ENABLE_ALLURE=true' >> $GITHUB_ENV \
             || echo 'ENABLE_ALLURE=false' >> $GITHUB_ENV
       - name: Collect tests for Allure
-        if: env.ENABLE_ALLURE == "true"
+        if: env.ENABLE_ALLURE == 'true'
         working-directory: ${{ inputs.working-directory }}
         run: |
           tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} --allure-collection-dir=allure-default ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
       - name: Upload Default Allure results
-        if: env.ENABLE_ALLURE == "true"
+        if: env.ENABLE_ALLURE == 'true'
         timeout-minutes: 3
         uses: actions/upload-artifact@v4
         with:

From 90c4f66ad76878f1fa02a216332414bd26bd8737 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 11 Dec 2024 13:48:26 +0530
Subject: [PATCH 50/52] test

---
 .github/workflows/integration_test_run.yaml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 86097956a..84bd1fcf4 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -216,7 +216,9 @@ jobs:
           echo "Installing tox with pipx..."
           pipx install tox
       - name: Check Allure
+        working-directory: ${{ inputs.working-directory }}
         run: |
+          tox -e ${{ inputs.test-tox-env }} --notest --list-dependencies 2>&1
           tox -e ${{ inputs.test-tox-env }} --notest --list-dependencies 2>&1 | grep -q allure \
             && echo 'ENABLE_ALLURE=true' >> $GITHUB_ENV \
             || echo 'ENABLE_ALLURE=false' >> $GITHUB_ENV

From 27f038a4361bab005882536a89747c891bd50bab Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 11 Dec 2024 14:52:23 +0530
Subject: [PATCH 51/52] test

---
 .github/workflows/integration_test_run.yaml | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index 84bd1fcf4..dc26c2552 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -349,12 +349,20 @@ jobs:
         working-directory: ${{ inputs.working-directory }}
         if: ${{ inputs.provider == 'microk8s' }}
         run: |
-          tox -e ${{ inputs.test-tox-env }} -- --model testing --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} --alluredir=allure-results ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }} 
+          if [ "$ENABLE_ALLURE" == "true" ]; then
+            tox -e ${{ inputs.test-tox-env }} -- --model testing --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} --alluredir=allure-results ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }} 
+          else
+            tox -e ${{ inputs.test-tox-env }} -- --model testing --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }} 
+          fi
       - name: Run lxd integration tests
         working-directory: ${{ inputs.working-directory }}
         if: ${{ inputs.provider == 'lxd' }}
         run: |
-          tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} --alluredir=allure-results ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
+          if [ "$ENABLE_ALLURE" == "true" ]; then
+            tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} --alluredir=allure-results ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
+          else
+            tox -e ${{ inputs.test-tox-env }} -- --keep-models ${{ env.SERIES }} ${{ env.MODULE }} ${{ env.ARGS }} ${{ inputs.extra-arguments }} ${{ secrets.INTEGRATION_TEST_ARGS }}
+          fi
       - name: Upload Allure results
         timeout-minutes: 3
         if: always() && !cancelled()

From d4b0c2511bcb9f20c630ff3a945d6a551bf083d7 Mon Sep 17 00:00:00 2001
From: Swetha Swaminathan <swetha.swaminathan@canonical.com>
Date: Wed, 11 Dec 2024 15:14:15 +0530
Subject: [PATCH 52/52] test

---
 .github/workflows/integration_test_run.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/integration_test_run.yaml b/.github/workflows/integration_test_run.yaml
index dc26c2552..0f8566307 100644
--- a/.github/workflows/integration_test_run.yaml
+++ b/.github/workflows/integration_test_run.yaml
@@ -365,7 +365,7 @@ jobs:
           fi
       - name: Upload Allure results
         timeout-minutes: 3
-        if: always() && !cancelled()
+        if: env.ENABLE_ALLURE == 'true' && always()
         uses: actions/upload-artifact@v4
         with:
           name: allure-results-${{ env.ALLURE_ARTIFACT_SUFFIX }}