Add ACTIVITY_RUN output

Author: olivier-lacroix

README.md

@@ -348,7 +348,13 @@ jobs:
 
 ### Outputs
 
-The action makes available some data for downstream processing. All outputs are only available when running in PR mode.
+The action makes available some data for downstream processing.
+
+| Name | Description |
+| --- | --- |
+| `ACTIVITY_RUN` | The type of activity that was run. One of `process_pr`, `post_comment`, `save_coverage_data_files`. |
+
+All the following outputs are only available when running in PR mode.
 
 | Name | Description |
 | --- | --- |

action.yml

@@ -111,6 +111,9 @@ inputs:
       Deprecated, see https://docs.github.com/en/actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging
     default: false
 outputs:
+  ACTIVITY_RUN:
+    description: >
+      The type of activity that was run. One of `process_pr`, `post_comment`, `save_coverage_data_files`.
   COMMENT_FILE_WRITTEN:
     description: >
       A boolean indicating whether a comment file was written to COMMENT_FILENAME or not.

coverage_comment/main.py

@@ -268,7 +268,8 @@ def process_pr(
             ],
         )
 
-    outputs = coverage.info.as_output(prefix="NEW")
+    outputs = {"ACTIVITY_RUN": "process_pr"}
+    outputs |= coverage.info.as_output(prefix="NEW")
     outputs |= diff_coverage.as_output(prefix="DIFF")
     if previous_coverage:
         outputs |= previous_coverage.info.as_output(prefix="REFERENCE")
@@ -370,6 +371,7 @@ def post_comment(
     )
     log.info("Comment posted in PR")
 
+    github.set_output(github_output=config.GITHUB_OUTPUT, ACTIVITY_RUN="post_comment")
     return 0
 
 
@@ -447,4 +449,8 @@ def save_coverage_data_files(
 
     log.info(log_message)
 
+    github.set_output(
+        github_output=config.GITHUB_OUTPUT, ACTIVITY_RUN="save_coverage_data_files"
+    )
+
     return 0

tests/integration/test_main.py

@@ -66,6 +66,7 @@ def get_expected_output(
     comment_written: bool, reference_coverage: bool
 ) -> dict[str, str]:
     output = {
+        "ACTIVITY_RUN": '"process_pr"',
         "COMMENT_FILE_WRITTEN": str(comment_written).lower(),
         "NEW_COVERED_LINES": "7",
         "NEW_NUM_STATEMENTS": "9",