From fd9c1eb7a5bf1851a44808b78bc99a0a2b7f2798 Mon Sep 17 00:00:00 2001
From: Archit Aggarwal <architag@amazon.com>
Date: Wed, 21 Apr 2021 13:52:01 -0700
Subject: [PATCH] Automate doxygen ZIP creation with GitHub Action (#568)

Automate creation of doxygen ZIP output by using the custom doxygen GitHub Action, that has been updated to generate ZIP artifact in PR
---
 .github/workflows/ci.yml                      | 38 +++++++++++++++++++
 .../Application-Protocols/coreMQTT-Agent      |  2 +-
 2 files changed, 39 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index decab8c8d1..8912224fa9 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -1,8 +1,10 @@
 name: CI Checks
+
 on:
   push:
   pull_request:
   workflow_dispatch:
+
 jobs:
   git-secrets:
     runs-on: ubuntu-latest
@@ -22,3 +24,39 @@ jobs:
         run: |
           git-secrets --register-aws
           git-secrets --scan
+  doxygen:
+    runs-on: ubuntu-20.04
+    steps:
+      - name: Clone repository
+        uses: actions/checkout@v2
+        with:
+          submodules: recursive
+          path: freertos
+      - name: Install Python3
+        uses: actions/setup-python@v2
+        with:
+          python-version: '3.8'
+      - name: Download tag dependency of coreMQTT-Agent
+        run: |
+          # We don't need to generate the coreMQTT docs, we only need the tag file.
+          # Therefore, we can just download it.
+          mkdir -p freertos/FreeRTOS-Plus/Source/Application-Protocols/coreMQTT-Agent/source/dependency/coreMQTT/docs/doxygen/output
+          wget -O freertos/FreeRTOS-Plus/Source/Application-Protocols/coreMQTT-Agent/source/dependency/coreMQTT/docs/doxygen/output/mqtt.tag \
+          "https://freertos.org/Documentation/api-ref/coreMQTT/docs/doxygen/output/mqtt.tag"
+      - name: Generate doxygen ZIP
+        uses: FreeRTOS/CI-CD-GitHub-Actions/doxygen@main
+        with:
+          path: ./freertos
+          # List of directories containing libraries whose doxygen output will be generated.
+          libs_parent_dir_path: FreeRTOS-Plus/Source,FreeRTOS-Plus/Source/AWS,FreeRTOS-Plus/Source/Application-Protocols
+          generate_zip: true
+      - name: Upload doxygen artifact if main branch
+        if: success() && github.ref == 'refs/heads/main'
+        env:
+          GIT_SHA: 
+        uses: actions/upload-artifact@v2
+        with:
+          name: doxygen.zip-${{ github.sha }}
+          path: ./freertos/doxygen.zip
+          retention-days: 2
+
diff --git a/FreeRTOS-Plus/Source/Application-Protocols/coreMQTT-Agent b/FreeRTOS-Plus/Source/Application-Protocols/coreMQTT-Agent
index d61dd0921b..134b478a48 160000
--- a/FreeRTOS-Plus/Source/Application-Protocols/coreMQTT-Agent
+++ b/FreeRTOS-Plus/Source/Application-Protocols/coreMQTT-Agent
@@ -1 +1 @@
-Subproject commit d61dd0921bd651c0bfbaa2e41bb0eda56245a36b
+Subproject commit 134b478a4862aa084575e3c37ab9fc86c04d3509