Refactor deprecation handling for LMM and from_lmm, replacing @deprecated with warnings.warn

Author: Borda

supervision/detection/core.py

@@ -2,12 +2,11 @@
 
 from collections.abc import Iterator
 from dataclasses import dataclass, field
-from enum import Enum
+import warnings
 from functools import reduce
 from typing import Any
 
 import numpy as np
-from deprecate import deprecated
 
 from supervision.config import (
     CLASS_NAME_DATA_FIELD,
@@ -818,11 +817,6 @@ def from_paddledet(cls, paddledet_result) -> Detections:
         )
 
     @classmethod
-    @deprecated(
-        target=None,
-        deprecated_in="0.26.0",
-        remove_in="0.30.0",
-    )
     def from_lmm(cls, lmm: LMM | str, result: str | dict, **kwargs: Any) -> Detections:
         """
         !!! deprecated "Deprecated"
@@ -1201,6 +1195,14 @@ def from_lmm(cls, lmm: LMM | str, result: str | dict, **kwargs: Any) -> Detectio
             ```
         """  # noqa: E501
 
+        warnings.warn(
+            "`Detections.from_lmm` is deprecated since `supervision-0.26.0` "
+            "and will be removed in `supervision-0.30.0`. "
+            "Use `Detections.from_vlm` instead.",
+            FutureWarning,
+            stacklevel=2,
+        )
+
         # filler logic mapping old from_lmm to new from_vlm
         lmm_to_vlm = {
             LMM.PALIGEMMA: VLM.PALIGEMMA,
@@ -1211,8 +1213,7 @@ def from_lmm(cls, lmm: LMM | str, result: str | dict, **kwargs: Any) -> Detectio
             LMM.GOOGLE_GEMINI_2_5: VLM.GOOGLE_GEMINI_2_5,
         }
 
-        # (this works even if the LMM enum is wrapped by @deprecated)
-        if isinstance(lmm, Enum) and lmm.__class__.__name__ == "LMM":
+        if isinstance(lmm, LMM):
             vlm = lmm_to_vlm[lmm]
 
         elif isinstance(lmm, str):

supervision/detection/vlm.py

@@ -5,27 +5,26 @@
 import io
 import json
 import re
+import warnings
 from enum import Enum
 from typing import Any
 
 import numpy as np
-from deprecate import deprecated
 from PIL import Image
 
 from supervision.detection.utils.boxes import denormalize_boxes
 from supervision.detection.utils.converters import polygon_to_mask, polygon_to_xyxy
 from supervision.validators import validate_resolution
 
 
-@deprecated(
-    target=None,
-    deprecated_in="0.27.0",
-    remove_in="0.31.0",
-)
 class LMM(Enum):
     """
     Enum specifying supported Large Multimodal Models (LMMs).
 
+    .. deprecated:: 0.27.0
+        `LMM` is deprecated and will be removed in `supervision-0.31.0`.
+        Use `VLM` instead.
+
     Attributes:
         PALIGEMMA: Google's PaliGemma vision-language model.
         FLORENCE_2: Microsoft's Florence-2 vision-language model.
@@ -51,6 +50,12 @@ def list(cls):
 
     @classmethod
     def from_value(cls, value: LMM | str) -> LMM:
+        warnings.warn(
+            "`LMM` is deprecated since `supervision-0.27.0` and will be removed in "
+            "`supervision-0.31.0`. Use `VLM` instead.",
+            FutureWarning,
+            stacklevel=2,
+        )
         if isinstance(value, cls):
             return value
         if isinstance(value, str):