Add debug mode option (#28)

Co-authored-by: Dave Lunny <4298089+himynameisdave@users.noreply.github.com>

.github/workflows/test.yml

@@ -30,10 +30,17 @@ jobs:
       - name: Build
         run: yarn build
 
-      - name: Run FOSSA scan and upload build data
+      - name: Run FOSSA scan in debug mode and upload build data
         uses: ./
         with:
           api-key: ${{secrets.fossaApiKey}}
+          debug: true
+
+      - name: Upload FOSSA debug bundle as a build artifact
+        uses: actions/upload-artifact@v3
+        with:
+          name: fossa.debug.json.gz
+          path: ./fossa.debug.json.gz
 
       - name: Run FOSSA container scan and upload build data
         uses: ./

README.md

@@ -103,6 +103,29 @@ jobs:
           endpoint: fossa.my-company.com
 ```
 
+### `debug`
+
+**Optional** If set to `true`, run all FOSSA commands in debug mode. Running `fossa analyze` in debug mode will generate a debug bundle that can be uploaded as a build artifact after this action completes.
+
+One way to upload build artifacts is to use the [`upload-artifact`](https://github.com/actions/upload-artifact) GitHub action. Example:
+
+```yml
+jobs:
+  fossa-scan:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: fossas/fossa-action@main
+        with:
+          api-key: ${{secrets.fossaApiKey}}
+          debug: true
+      - uses: actions/upload-artifact@v3
+        with:
+          name: fossa.debug.json.gz
+          path: ./fossa.debug.json.gz
+```
+
+
 ## Examples
 We've provided a few examples of how to use FOSSA's Github Action in your own project. These examples use an API key stored as a Github secret environment variable `fossaAPiKey`.
 

action.yml

@@ -24,6 +24,12 @@ inputs:
       Override the detected FOSSA project branch. If running FOSSA analysis on a
       Pull Request, as a start you can use the contexts `github.ref` or `github.ref_name`.
     required: false
+  debug:
+    description: >-
+      Run all FOSSA commands in debug mode. Running `fossa analyze` in debug
+      mode will generate a debug bundle that can be uploaded as a build artifact
+      after this action completes.
+    default: false
 
 runs:
   using: node16

src/config.ts

@@ -12,3 +12,4 @@ export const CONTAINER = getInput('container', getInputOptions());
 export const RUN_TESTS = getBooleanInput('run-tests', {required: false});
 export const ENDPOINT = getInput('endpoint', getInputOptions());
 export const BRANCH = getInput('branch', getInputOptions());
+export const DEBUG = getBooleanInput('debug', {required: false});

src/index.ts

@@ -6,6 +6,7 @@ import {
   RUN_TESTS,
   ENDPOINT,
   BRANCH,
+  DEBUG,
 } from './config';
 import { fetchFossaCli } from './download-cli';
 
@@ -26,6 +27,7 @@ export async function analyze(): Promise<void> {
     cmd,
     ...getEndpointArgs(),
     ...getBranchArgs(),
+    DEBUG ? '--debug' : null,
   ].filter(arg => arg);
 
   // Setup listeners