Update deprecation message

Author: tcompa

fractal_tasks_core/dev/create_manifest.py

@@ -20,6 +20,7 @@
 
 from typing_extensions import deprecated
 
+from fractal_tasks_core.dev.deprecation_message import DEPRECATION_MSG_FUN
 from fractal_tasks_core.dev.lib_args_schemas import (
     create_schema_for_single_task,
 )
@@ -32,7 +33,7 @@
 ARGS_SCHEMA_VERSION = "pydantic_v2"
 
 
-@deprecated("Please move to `fractal-task-tools`")
+@deprecated(DEPRECATION_MSG_FUN)
 def create_manifest(
     package: str = "fractal_tasks_core",
     authors: Optional[str] = None,

fractal_tasks_core/dev/deprecation_message.py

@@ -0,0 +1,16 @@
+DEPRECATION_MSG_FUN = (
+    "This function is deprecated and will be removed in a future release of "
+    "`fractal-tasks-core`. Please migrate to `fractal-task-tools` for "
+    "manifest building and task wrappers. See "
+    "https://fractal-analytics-platform.github.io/fractal-task-tools/usage/"
+    "#migrate-from-fractal-tasks-core."
+)
+
+
+DEPRECATION_MSG_CLASS = (
+    "This class is deprecated and will be removed in a future release of "
+    "`fractal-tasks-core`. Please migrate to `fractal-task-tools` for "
+    "manifest building and task wrappers. See "
+    "https://fractal-analytics-platform.github.io/fractal-task-tools/usage/"
+    "#migrate-from-fractal-tasks-core."
+)

fractal_tasks_core/dev/lib_args_schemas.py

@@ -26,6 +26,7 @@
 from pydantic._internal._config import ConfigWrapper
 from typing_extensions import deprecated
 
+from fractal_tasks_core.dev.deprecation_message import DEPRECATION_MSG_FUN
 from fractal_tasks_core.dev.lib_descriptions import (
     _get_class_attrs_descriptions,
 )
@@ -146,7 +147,7 @@ def _create_schema_for_function(function: Callable) -> _Schema:
     return json_schema
 
 
-@deprecated("Please move to `fractal-task-tools`")
+@deprecated(DEPRECATION_MSG_FUN)
 def create_schema_for_single_task(
     executable: str,
     package: Optional[str] = "fractal_tasks_core",

fractal_tasks_core/dev/lib_pydantic_generatejsonschema.py

@@ -17,11 +17,12 @@
 from pydantic_core.core_schema import WithDefaultSchema
 from typing_extensions import deprecated
 
+from fractal_tasks_core.dev.deprecation_message import DEPRECATION_MSG_CLASS
 
 logger = logging.getLogger("CustomGenerateJsonSchema")
 
 
-@deprecated("Please move to `fractal-task-tools`")
+@deprecated(DEPRECATION_MSG_CLASS)
 class CustomGenerateJsonSchema(GenerateJsonSchema):
     def get_flattened_anyof(
         self, schemas: list[JsonSchemaValue]

fractal_tasks_core/dev/task_models.py

@@ -22,6 +22,8 @@
 from pydantic import Field
 from typing_extensions import deprecated
 
+from fractal_tasks_core.dev.deprecation_message import DEPRECATION_MSG_CLASS
+
 
 class _BaseTask(BaseModel):
     class Config:
@@ -39,7 +41,7 @@ class Config:
     docs_info: Optional[str] = None
 
 
-@deprecated("Please move to `fractal-task-tools`")
+@deprecated(DEPRECATION_MSG_CLASS)
 class CompoundTask(_BaseTask):
     """
     A `CompoundTask` object must include both `executable_init` and
@@ -67,7 +69,7 @@ def meta_parallel(self) -> Optional[dict[str, Any]]:
         return self.meta
 
 
-@deprecated("Please move to `fractal-task-tools`")
+@deprecated(DEPRECATION_MSG_CLASS)
 class NonParallelTask(_BaseTask):
     """
     A `NonParallelTask` object must include the `executable` attribute, and it
@@ -91,7 +93,7 @@ def meta_parallel(self) -> None:
         return None
 
 
-@deprecated("Please move to `fractal-task-tools`")
+@deprecated(DEPRECATION_MSG_CLASS)
 class ParallelTask(_BaseTask):
     """
     A `ParallelTask` object must include the `executable` attribute, and it may

fractal_tasks_core/tasks/_utils.py

@@ -21,6 +21,8 @@
 
 from typing_extensions import deprecated
 
+from fractal_tasks_core.dev.deprecation_message import DEPRECATION_MSG_FUN
+
 
 class TaskParameterEncoder(JSONEncoder):
     """
@@ -37,7 +39,7 @@ def default(self, value):
         return JSONEncoder.default(self, value)
 
 
-@deprecated("Please move to `fractal-task-tools`")
+@deprecated(DEPRECATION_MSG_FUN)
 def run_fractal_task(
     *,
     task_function: Callable,