feat: add interface for expt.delete_all_gates_and_populations

This is a public API but is missing from CE's API documentation.

Author: zbjornson

cellengine/resources/experiment.py

@@ -592,6 +592,10 @@ def delete_gates(self, ids: List[str]) -> None:
         """Deletes multiple gates provided a list of _ids."""
         ce.APIClient().delete_gates(self._id, ids)
 
+    def delete_all_gates_and_populations(self) -> None:
+        """Delete all gates and populations in the experiment."""
+        ce.APIClient().delete_all_gates_and_populations(self._id)
+
     @overload
     def create_rectangle_gate(
         self, *args, create_population: Literal[True], **kwargs

cellengine/utils/api_client/APIClient.py

@@ -639,6 +639,10 @@ def delete_gates(self, experiment_id: str, ids: List[str]):
         url = f"{self.base_url}/api/v1/experiments/{experiment_id}/gates/"
         [self._delete(url + _id) for _id in ids]
 
+    def delete_all_gates_and_populations(self, experiment_id: str) -> None:
+        url = f"{self.base_url}/api/v1/experiments/{experiment_id}/gates/reset"
+        self._post(url)
+
     def _parse_gate_population(
         self, res: Any
     ) -> Tuple[Gate, Union[Population, List[Population], None]]:

tests/integration/test_experiment.py

@@ -277,3 +277,10 @@ def test_create_gates(full_experiment):
             }
         ]
     )
+
+def test_delete_all_gates_and_populations(full_experiment):
+    experiment = full_experiment["experiment"]
+    experiment.delete_all_gates_and_populations()
+
+    assert len(experiment.gates) == 0
+    assert len(experiment.populations) == 0