various improvements

gazu/task.py

@@ -2,6 +2,8 @@
 
 import json
 
+from deprecated import deprecated
+
 from gazu.exception import (
     TaskStatusNotFoundException,
     TaskMustBeADictException,
@@ -403,20 +405,15 @@ def all_done_tasks_for_person(person, client=default):
 
 
 @cache
-def get_task_by_entity(entity, task_type, client=default):
-    return get_task_by_name(entity, task_type, client=client)
-
-
-@cache
-def get_task_by_name(entity, task_type, name="main", client=default):
+def get_task_by_entity(entity, task_type, name="main", client=default):
     """
     Args:
         entity (str / dict): The entity dict or the entity ID.
         task_type (str / dict): The task type dict or ID.
         name (str): Name of the task to look for.
 
     Returns:
-        Task matching given name for given entity and task type.
+        Task matching given entity, task type and name.
     """
     entity = normalize_model_parameter(entity)
     task_type = normalize_model_parameter(task_type)
@@ -431,6 +428,15 @@ def get_task_by_name(entity, task_type, name="main", client=default):
     )
 
 
+@deprecated(
+    version="0.9.17",
+    reason="You should use another function: gazu.task.get_task_by_entity, it will be removed in a future version of Gazu (0.10.0).",
+)
+@cache
+def get_task_by_name(entity, task_type, name="main", client=default):
+    return get_task_by_entity(entity, task_type, name=name, client=client)
+
+
 @cache
 def get_task_type(task_type_id, client=default):
     """
@@ -450,6 +456,8 @@ def get_task_type_by_name(
     """
     Args:
         task_type_name (str): Name of claimed task type.
+        for_entity (str): The entity type for which the task type is created.
+        department (str): The department for which the task type is created.
 
     Returns:
         dict: Task type object for given name.

setup.cfg

@@ -32,6 +32,7 @@ packages = find:
 install_requires =
     python-socketio[client]==5.11.0; python_version != '2.7'
     requests>=2.25.1
+    Deprecated==1.2.14
 
 [options.packages.find]
 # ignore gazutest directory