Add enable and disable a Workflow (#3088)

- add method to disable a workflow ([API
reference](https://docs.github.com/en/rest/actions/workflows?apiVersion=2022-11-28#disable-a-workflow))
- add method to enable a workflow ([API
reference](https://docs.github.com/en/rest/actions/workflows?apiVersion=2022-11-28#enable-a-workflow))

Fixes #2846

---------

Co-authored-by: Enrico Minack <github@enrico.minack.dev>

Author: nickrmcclorey

github/Workflow.py

@@ -214,6 +214,22 @@ def get_runs(
             list_item="workflow_runs",
         )
 
+    def disable(self) -> bool:
+        """
+        :calls: `PUT /repos/{owner}/{repo}/actions/workflows/{workflow_id}/disable <https://docs.github.com/en/rest/actions/workflows?apiVersion=2022-11-28#disable-a-workflow>`_
+        :rtype: bool
+        """
+        status, _, _ = self._requester.requestJson("PUT", f"{self.url}/disable")
+        return status == 204
+
+    def enable(self) -> bool:
+        """
+        :calls: `PUT /repos/{owner}/{repo}/actions/workflows/{workflow_id}/enable <https://docs.github.com/en/rest/actions/workflows?apiVersion=2022-11-28#enable-a-workflow>`_
+        :rtype: bool
+        """
+        status, _, _ = self._requester.requestJson("PUT", f"{self.url}/enable")
+        return status == 204
+
     def _useAttributes(self, attributes: dict[str, Any]) -> None:
         if "badge_url" in attributes:  # pragma no branch
             self._badge_url = self._makeStringAttribute(attributes["badge_url"])

tests/ReplayData/Workflow.testDisable.txt

@@ -139,3 +139,19 @@ def testCreateDispatchWithString(self):
     def testCreateDispatchForNonTriggerEnabled(self):
         workflow = self.g.get_repo("wrecker/PyGithub").get_workflow("check.yml")
         self.assertFalse(workflow.create_dispatch("main"))
+
+    def testDisable(self):
+        workflow = self.g.get_repo("nickrmcclorey/PyGithub").get_workflow("ci.yml")
+        self.assertTrue(workflow.disable())
+
+    def testDisabledWhenAlreadyDisabled(self):
+        workflow = self.g.get_repo("nickrmcclorey/PyGithub").get_workflow("ci.yml")
+        self.assertFalse(workflow.disable())
+
+    def testEnable(self):
+        workflow = self.g.get_repo("nickrmcclorey/PyGithub").get_workflow("ci.yml")
+        self.assertTrue(workflow.enable())
+
+    def testEnableWhenAlreadyEnabled(self):
+        workflow = self.g.get_repo("nickrmcclorey/PyGithub").get_workflow("ci.yml")
+        self.assertTrue(workflow.enable())