Create tpip report and commit on main

Author: JonatanAntoni

.github/workflows/tpip.yml

@@ -0,0 +1,41 @@
+name: CI
+
+on:
+  push:
+    paths:
+      - '.github/workflows/tpip.yml'
+      - docs/third-party-licenses.json
+      - docs/tpip-header.md
+      - scripts/tpip-reporter.ts
+    branches:
+      - main
+    
+  workflow_dispatch:
+
+jobs:
+  report:
+    name: Generate Third-Party licenses report
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.ref_name }}
+
+      - uses: actions/setup-node@v2
+        with:
+          node-version: '20'
+          cache: 'yarn'
+
+      - name: Install dependencies
+        run: yarn --frozen-lockfile --prefer-offline
+
+      - name: Generate third-party licenses report
+        run: yarn run tpip:report
+
+      - name: Commit changes
+        run: |
+          git config --local user.email "[email protected]
+          git config --local user.name "GitHub Action"
+          git add TPIP.md
+          git commit -m "Update third-party licenses report [skip ci]"
+          git push

TPIP.md

@@ -0,0 +1,7 @@
+# TPIP Report for vscode-cmsis-debugger
+
+Report prepared at : 26/02/2025, 16:50:28
+
+| *Package* | *Version* | *Repository* | *License* |
+|---|---|---|---|
+| pyocd | 0.36.0 | https://github.com/pyocd/pyOCD | https://github.com/pyocd/pyOCD/blob/v0.36.0/LICENSE |

docs/third-party-licenses.json

@@ -0,0 +1,9 @@
+[
+    {
+        "name": "pyocd",
+        "version": "0.36.0",
+        "spdx": "Apache-2.0",
+        "url": "https://github.com/pyocd/pyOCD",
+        "license": "https://github.com/pyocd/pyOCD/blob/v0.36.0/LICENSE"
+    }
+]

docs/tpip-header.md

@@ -0,0 +1,2 @@
+# TPIP Report for vscode-cmsis-debugger
+

package.json

@@ -228,7 +228,8 @@
     "watch": "webpack -w",
     "lint": "eslint .",
     "test": "jest",
-    "package": "vsce package --yarn"
+    "package": "vsce package --yarn",
+    "tpip:report": "ts-node scripts/tpip-reporter --header docs/tpip-header.md docs/third-party-licenses.json TPIP.md"
   },
   "vsce": {
     "yarn": true,

scripts/tpip-reporter.ts

@@ -0,0 +1,69 @@
+#!npx ts-node
+
+/**
+ * Copyright 2025 Arm Limited
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+import fs from "fs";
+
+async function main() {
+
+    const { json, report, header } = yargs(hideBin(process.argv))
+        .usage('Usage: $0 <json> <report> [--header <header>]')
+        .options('header', {
+            describe: 'Header to add to the report',
+            type: 'string'
+        })
+        .command('$0 <json> <report>', '', y => {
+            y.positional('json', {
+                describe: 'JSON file to parse',
+                type: 'string'
+            });
+            y.positional('report', {
+                describe: 'Report file to generate',
+                type: 'string'
+            });
+        })
+        .help('h')
+        .version(false)
+        .strict()
+        .parseSync();
+
+    const tpipJson = JSON.parse(fs.readFileSync(json as string, "utf8"));
+    
+    var data: string = '';
+    if (header && fs.existsSync(header as string)) {
+        data += fs.readFileSync(header as string, "utf8");
+    } else {
+        data += "# TPIP Report\n\n";
+    }
+
+    data += `Report prepared at: ${new Date().toLocaleString('en-GB')}\n\n`;
+    data += '| *Package* | *Version* | *Repository* | *License* |\n';
+    data += '|---|---|---|---|\n';
+
+    for(const value of tpipJson) {
+        data += `| ${value.name} | ${value.version} | ${value.url} | ${value.license} |\n`;
+    }
+
+    fs.writeFileSync(report as string, data);
+}
+
+main().catch(error => {
+    console.error(error);
+    process.exit(1);
+});