feat: add OUTPUT_FILENAME to customize markdown output

Expose OUTPUT_FILENAME env var with default contributors.md,
wire into markdown output, and document/test it.

Signed-off-by: Venu Vardhan Reddy Tekula <venuvrtekula@gmail.com>

Author: vchrombie

README.md

@@ -93,6 +93,7 @@ This action can be configured to authenticate with GitHub App Installation or Pe
 | `END_DATE`          | False                                           | Current Date      | The date at which you want to stop gathering contributor information. Must be later than the `START_DATE`. ie. Aug 2nd, 2023 would be `2023-08-02`                                                                       |
 | `SPONSOR_INFO`      | False                                           | False             | If you want to include sponsor information in the output. This will include the sponsor count and the sponsor URL. This will impact action performance. ie. SPONSOR_INFO = "False" or SPONSOR_INFO = "True"              |
 | `LINK_TO_PROFILE`   | False                                           | True              | If you want to link usernames to their GitHub profiles in the output. ie. LINK_TO_PROFILE = "True" or LINK_TO_PROFILE = "False"                                                                                          |
+| `OUTPUT_FILENAME`   | False                                           | contributors.md   | The output filename for the markdown report. ie. OUTPUT_FILENAME = "my-report.md"                                                                                                                                        |
 
 **Note**: If `start_date` and `end_date` are specified then the action will determine if the contributor is new. A new contributor is one that has contributed in the date range specified but not before the start date.
 
@@ -244,7 +245,7 @@ jobs:
 
 When running as a GitHub Action, the contributors report is automatically displayed in the [GitHub Actions Job Summary](https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions#adding-a-job-summary). This provides immediate visibility of the results directly in the workflow run interface without needing to check separate files or issues.
 
-The job summary contains the same markdown content that is written to the `contributors.md` file, making it easy to view contributor information right in the GitHub Actions UI.
+The job summary contains the same markdown content that is written to the configured output file, making it easy to view contributor information right in the GitHub Actions UI.
 
 ## Local usage without Docker
 

contributors.py

@@ -27,6 +27,7 @@ def main():
         end_date,
         sponsor_info,
         link_to_profile,
+        output_filename,
     ) = env.get_env_vars()
 
     # Auth to GitHub.com
@@ -75,7 +76,7 @@ def main():
     # print(contributors)
     markdown.write_to_markdown(
         contributors,
-        "contributors.md",
+        output_filename,
         start_date,
         end_date,
         organization,

env.py

@@ -115,6 +115,7 @@ def get_env_vars(
     str,
     bool,
     bool,
+    str,
 ]:
     """
     Get the environment variables for use in the action.
@@ -135,6 +136,7 @@ def get_env_vars(
         end_date (str): The end date to get contributor information to.
         sponsor_info (str): Whether to get sponsor information on the contributor
         link_to_profile (str): Whether to link username to Github profile in markdown output
+        output_filename (str): The output filename for the markdown report
     """
 
     if not test:
@@ -176,6 +178,7 @@ def get_env_vars(
 
     sponsor_info = get_bool_env_var("SPONSOR_INFO", False)
     link_to_profile = get_bool_env_var("LINK_TO_PROFILE", False)
+    output_filename = os.getenv("OUTPUT_FILENAME", "").strip() or "contributors.md"
 
     # Separate repositories_str into a list based on the comma separator
     repositories_list = []
@@ -197,4 +200,5 @@ def get_env_vars(
         end_date,
         sponsor_info,
         link_to_profile,
+        output_filename,
     )

test_env.py

@@ -23,6 +23,7 @@ def setUp(self):
             "GITHUB_APP_ENTERPRISE_ONLY",
             "GH_TOKEN",
             "ORGANIZATION",
+            "OUTPUT_FILENAME",
             "REPOSITORY",
             "START_DATE",
         ]
@@ -65,6 +66,7 @@ def test_get_env_vars(self):
             end_date,
             sponsor_info,
             link_to_profile,
+            output_filename,
         ) = env.get_env_vars()
 
         self.assertEqual(organization, "org")
@@ -79,6 +81,7 @@ def test_get_env_vars(self):
         self.assertEqual(end_date, "2022-12-31")
         self.assertFalse(sponsor_info)
         self.assertTrue(link_to_profile)
+        self.assertEqual(output_filename, "contributors.md")
 
     @patch.dict(
         os.environ,
@@ -175,6 +178,7 @@ def test_get_env_vars_no_dates(self):
             end_date,
             sponsor_info,
             link_to_profile,
+            output_filename,
         ) = env.get_env_vars()
 
         self.assertEqual(organization, "org")
@@ -189,6 +193,45 @@ def test_get_env_vars_no_dates(self):
         self.assertEqual(end_date, "")
         self.assertFalse(sponsor_info)
         self.assertTrue(link_to_profile)
+        self.assertEqual(output_filename, "contributors.md")
+
+    @patch.dict(
+        os.environ,
+        {
+            "ORGANIZATION": "org",
+            "REPOSITORY": "repo,repo2",
+            "GH_APP_ID": "",
+            "GH_APP_INSTALLATION_ID": "",
+            "GH_APP_PRIVATE_KEY": "",
+            "GH_TOKEN": "token",
+            "GH_ENTERPRISE_URL": "",
+            "START_DATE": "",
+            "END_DATE": "",
+            "SPONSOR_INFO": "False",
+            "LINK_TO_PROFILE": "True",
+            "OUTPUT_FILENAME": "custom-report.md",
+        },
+        clear=True,
+    )
+    def test_get_env_vars_custom_output_filename(self):
+        """Test that OUTPUT_FILENAME overrides the default output filename."""
+        (
+            _organization,
+            _repository_list,
+            _gh_app_id,
+            _gh_app_installation_id,
+            _gh_app_private_key,
+            _gh_app_enterprise_only,
+            _token,
+            _ghe,
+            _start_date,
+            _end_date,
+            _sponsor_info,
+            _link_to_profile,
+            output_filename,
+        ) = env.get_env_vars()
+
+        self.assertEqual(output_filename, "custom-report.md")
 
     @patch.dict(os.environ, {})
     def test_get_env_vars_missing_org_or_repo(self):