Deprecate process IDs (#118)

* deprecate process IDs

* remove README

cads_api_client/api_client.py

@@ -364,19 +364,6 @@ def get_processes(
         limit: int | None = None,
         sortby: Literal[None, "id", "-id"] = None,
     ) -> cads_api_client.Processes:
-        """Retrieve available processes.
-
-        Parameters
-        ----------
-        limit: int or None
-            Number of processes per page.
-        sortby: {None, 'id', '-id'}
-            Field to sort results by.
-
-        Returns
-        -------
-        cads_api_client.Processes
-        """
         params = {
             k: v for k, v in zip(["limit", "sortby"], [limit, sortby]) if v is not None
         }

cads_api_client/processing.py

@@ -286,12 +286,19 @@ def prev(self) -> Self | None:
 
 @attrs.define
 class Processes(ApiResponsePaginated):
-    """A class to interact with available processes."""
+    @property
+    def collection_ids(self) -> list[str]:
+        """Available collection IDs."""
+        return [proc["id"] for proc in self._json_dict["processes"]]
 
     @property
     def process_ids(self) -> list[str]:
-        """Available process IDs."""
-        return [proc["id"] for proc in self._json_dict["processes"]]
+        warnings.warn(
+            "`.process_ids` has been deprecated, and in the future will raise an error."
+            " Please use `.collection_ids` from now on.",
+            DeprecationWarning,
+        )
+        return self.collection_ids
 
 
 @attrs.define

tests/integration_test_20_processing.py

@@ -9,19 +9,19 @@
 def test_processig_processes_limit(api_anon_client: ApiClient) -> None:
     processes = api_anon_client.get_processes(limit=1)
     assert isinstance(processes, Processes)
-    assert len(processes.process_ids) == 1
+    assert len(processes.collection_ids) == 1
     next_processes = processes.next
     assert next_processes is not None
     assert len(next_processes.process_ids) == 1
 
 
 def test_processing_processes_sortby(api_anon_client: ApiClient) -> None:
     processes = api_anon_client.get_processes(sortby="id")
-    assert len(processes.process_ids) > 1
-    assert processes.process_ids == sorted(processes.process_ids)
+    assert len(processes.collection_ids) > 1
+    assert processes.collection_ids == sorted(processes.collection_ids)
 
     processes = api_anon_client.get_processes(sortby="-id")
-    assert processes.process_ids == sorted(processes.process_ids, reverse=True)
+    assert processes.collection_ids == sorted(processes.collection_ids, reverse=True)
 
 
 def test_processing_process(