Add template for running D2D on project build and source archive

.github/workflows/map-deploy-to-develop-template.yml

@@ -0,0 +1,40 @@
+name: Run D2D on build and source archives
+on:
+  workflow_call:
+    inputs:
+      artifact-name:
+        description: "Artifact containing the build archive"
+        required: true
+        type: string
+      steps:
+        description: "Comma separated D2D steps to run"
+        required: false
+        type: string
+
+jobs:
+  run-d2d-pipeline:
+    runs-on: 'ubuntu-latest'
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Download build artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: ${{ inputs['artifact-name'] }}
+          path: ../scancode-inputs/
+
+      - name: Prepare D2D inputs
+        shell: bash
+        run: |
+          for file in ../scancode-inputs/*; do
+            base=$(basename "$file")
+            mv "$file" "../scancode-inputs/to_$base"
+          done
+          git archive --format=tar.gz -o ../scancode-inputs/from.tar.gz HEAD
+
+      - name: Run D2D pipeline
+        uses: aboutcode-org/scancode-action@beta
+        with:
+          pipelines: ${{ inputs.steps && format('map_deploy_to_develop:%s', inputs.steps) || 'map_deploy_to_develop' }}
+          inputs-path: ../scancode-inputs

README.md

@@ -25,7 +25,8 @@ from your **GitHub Workflows**.
   - [Check for compliance issues](#check-for-compliance-issues)
   - [Define a custom project name](#define-a-custom-project-name)
   - [Install ScanCode.io from a repository branch](#install-scancodeio-from-a-repository-branch)
-- [Where does the scan results go?](#where-does-the-scan-results-go)
+  - [Run source to binary mapping using GitHub action template](#run-source-to-binary-mapping-using-github-action-template)
+- [Where does the scan results go?](#where-are-the-scan-results)
 
 ## Usage
 
@@ -226,6 +227,18 @@ Activate this behavior by enabling `check-compliance` and setting
     scancodeio-repo-branch: "main"
 ```
 
+### Run source to binary mapping using GitHub action template
+1. Add job to build your binary and upload it as a GitHub actions artifact.
+2. Add a job to run `map-deploy-to-develop` pipeline.
+   ```yaml
+     run-d2d-pipeline:
+       needs: # Job id from step 1
+       uses: aboutcode-org/scancode-action/.github/workflows/map-deploy-to-develop-template.yml
+       with:
+         artifact-name: # Label of uploaded artifact from step 1
+         steps: "python,java" # Comma separated optional steps. See https://scancodeio.readthedocs.io/en/latest/built-in-pipelines.html#map-deploy-to-develop
+   ```
+
 ## Where are the Scan Results?
 
 Upon completion of the workflow, you can **find the scan results** in the dedicated