add depreceation warning

Author: vincentkoppen

src/power_grid_model_ds/_core/model/graphs/models/base.py

@@ -2,6 +2,7 @@
 #
 # SPDX-License-Identifier: MPL-2.0
 
+import warnings
 from abc import ABC, abstractmethod
 from contextlib import contextmanager
 from typing import Generator
@@ -249,6 +250,18 @@ def get_all_paths(self, ext_start_node_id: int, ext_end_node_id: int) -> list[li
 
     def get_components(self, substation_nodes: list[int]) -> list[list[int]]:
         """Returns all separate components when the substation_nodes are removed of the graph as lists"""
+        if len(substation_nodes):
+            warnings.warn(
+                message="""
+get_components: substation_nodes argument is deprecated and will be removed in a future release.
+Replace with the tmp_remove_nodes context manager.
+
+with graph.tmp_remove_nodes(substation_nodes):
+    compontents = graph.get_components()
+""",
+                category=DeprecationWarning,
+                stacklevel=2,
+            )
         with self.tmp_remove_nodes(substation_nodes):
             internal_components = self._get_components()
         return [self._internals_to_externals(component) for component in internal_components]