Deprecate a few unused functions in utils.py

Signed-off-by: Fabrice Normandin <[email protected]>

Author: lebrice

simple_parsing/utils.py

@@ -36,7 +36,7 @@
     overload,
 )
 
-from typing_extensions import Literal, Protocol, TypeGuard, get_args, get_origin
+from typing_extensions import Literal, Protocol, TypeGuard, deprecated, get_args, get_origin
 
 # There are cases where typing.Literal doesn't match typing_extensions.Literal:
 # https://github.com/python/typing_extensions/pull/148
@@ -115,6 +115,7 @@ def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
 
 
+@deprecated("This is unused internally and will be removed soon.")
 def camel_case(name):
     s1 = re.sub("(.)([A-Z][a-z]+)", r"\1_\2", name)
     return re.sub("([a-z0-9])([A-Z])", r"\1_\2", s1).lower()
@@ -614,6 +615,7 @@ def get_container_nargs(container_type: type) -> int | str:
     raise NotImplementedError(f"Not sure what 'nargs' should be for type {container_type}")
 
 
+@deprecated("This is likely going to be removed soon.")
 def _parse_multiple_containers(
     container_type: type, append_action: bool = False
 ) -> Callable[[str], list[Any]]:
@@ -888,6 +890,7 @@ def dict_union(*dicts: dict[K, V], recurse: bool = True, dict_factory=dict) -> d
     return result
 
 
+@deprecated("This is buggy and unused internally and will be removed soon.")
 def flatten(nested: PossiblyNestedMapping[K, V]) -> dict[tuple[K, ...], V]:
     """Flatten a dictionary of dictionaries. The returned dictionary's keys are tuples, one entry
     per layer.
@@ -954,16 +957,19 @@ def unflatten_split(
     return unflatten({tuple(key.split(sep)): value for key, value in flattened.items()})
 
 
+@deprecated("This is unused internally and will be removed soon.")
 @overload
 def getitem_recursive(d: PossiblyNestedDict[K, V], keys: Iterable[K]) -> V:
     ...
 
 
+@deprecated("This is unused internally and will be removed soon.")
 @overload
 def getitem_recursive(d: PossiblyNestedDict[K, V], keys: Iterable[K], default: T) -> V | T:
     ...
 
 
+@deprecated("This is unused internally and will be removed soon.")
 def getitem_recursive(
     d: PossiblyNestedDict[K, V], keys: Iterable[K], default: T | _MISSING_TYPE = MISSING
 ) -> V | T: