Improve deprecation messages

Signed-off-by: Leandro Lucarella <[email protected]>

Author: llucax

src/frequenz/client/common/metric/__init__.py

@@ -142,7 +142,10 @@ class Metric(enum.Enum):
     SENSOR_IRRADIANCE = PBMetric.METRIC_SENSOR_IRRADIANCE
 
     @classmethod
-    @deprecated("Use `frequenz.client.common.proto.enum_from_proto` instead.")
+    @deprecated(
+        "frequenz.client.common.metric.Metric.from_proto() is deprecated. "
+        "Use frequenz.client.common.proto.enum_from_proto instead."
+    )
     def from_proto(cls, metric: PBMetric.ValueType) -> Self:
         """Convert a protobuf Metric value to Metric enum.
 

src/frequenz/client/common/microgrid/components/__init__.py

@@ -105,7 +105,10 @@ class ComponentCategory(enum.Enum):
     """A Heating, Ventilation, and Air Conditioning (HVAC) system."""
 
     @classmethod
-    @deprecated("Use `frequenz.client.common.proto.enum_from_proto` instead.")
+    @deprecated(
+        "frequenz.client.common.microgrid.components.ComponentCategory.from_proto() is deprecated. "
+        "Use frequenz.client.common.proto.enum_from_proto instead."
+    )
     def from_proto(
         cls, component_category: PBComponentCategory.ValueType
     ) -> ComponentCategory:
@@ -211,7 +214,11 @@ class ComponentStateCode(enum.Enum):
     """The precharger circuit is closed, allowing full current to flow to the main circuit."""
 
     @classmethod
-    @deprecated("Use `frequenz.client.common.proto.enum_from_proto` instead.")
+    @deprecated(
+        "frequenz.client.common.microgrid.components.ComponentStateCode."
+        "from_proto() is deprecated. "
+        "Use frequenz.client.common.proto.enum_from_proto instead."
+    )
     def from_proto(
         cls, component_state: PBComponentStateCode.ValueType
     ) -> ComponentStateCode:
@@ -390,7 +397,11 @@ class ComponentErrorCode(enum.Enum):
     times."""
 
     @classmethod
-    @deprecated("Use `frequenz.client.common.proto.enum_from_proto` instead.")
+    @deprecated(
+        "frequenz.client.common.microgrid.components."
+        "ComponentErrorCode.from_proto() is deprecated. "
+        "Use frequenz.client.common.proto.enum_from_proto instead."
+    )
     def from_proto(
         cls, component_error_code: PBComponentErrorCode.ValueType
     ) -> ComponentErrorCode:

src/frequenz/client/common/microgrid/electrical_components/__init__.py

@@ -89,7 +89,11 @@ class ElectricalComponentCategory(enum.Enum):
     """A heating, ventilation, and air conditioning (HVAC) system."""
 
     @classmethod
-    @deprecated("Use `frequenz.client.common.proto.enum_from_proto` instead.")
+    @deprecated(
+        "frequenz.client.common.microgrid.electrical_components."
+        "ElectricalComponentCategory.from_proto() is deprecated. "
+        "Use frequenz.client.common.proto.enum_from_proto instead."
+    )
     def from_proto(
         cls, component_category: PBElectricalComponentCategory.ValueType
     ) -> ElectricalComponentCategory:
@@ -217,7 +221,11 @@ class ElectricalComponentStateCode(enum.Enum):
     """The precharger circuit is closed, allowing full current to flow to the main circuit."""
 
     @classmethod
-    @deprecated("Use `frequenz.client.common.proto.enum_from_proto` instead.")
+    @deprecated(
+        "frequenz.client.common.microgrid.electrical_components."
+        "ElectricalComponentStateCode.from_proto() is deprecated. "
+        "Use frequenz.client.common.proto.enum_from_proto instead."
+    )
     def from_proto(
         cls, component_state: PBElectricalComponentStateCode.ValueType
     ) -> ElectricalComponentStateCode:
@@ -432,7 +440,11 @@ class ElectricalComponentDiagnosticCode(enum.Enum):
     times."""
 
     @classmethod
-    @deprecated("Use `frequenz.client.common.proto.enum_from_proto` instead.")
+    @deprecated(
+        "frequenz.client.common.microgrid.electrical_components."
+        "ElectricalComponentDiagnosticCode.from_proto() is deprecated. "
+        "Use frequenz.client.common.proto.enum_from_proto instead."
+    )
     def from_proto(
         cls, component_error_code: PBElectricalComponentDiagnosticCode.ValueType
     ) -> ElectricalComponentDiagnosticCode:

src/frequenz/client/common/pagination/__init__.py

@@ -24,9 +24,9 @@
 
 
 @deprecated(
-    "Params is deprecated, use "
-    "frequenz.api.common.v1.pagination.pagination_params_pb2.PaginationParams"
-    " from the API directly instead.",
+    "frequenz.client.common.pagination.Params is deprecated. "
+    "Use frequenz.api.common.v1.pagination.pagination_params_pb2.PaginationParams "
+    "from the API directly instead.",
 )
 @dataclass(frozen=True, kw_only=True)
 class Params:
@@ -65,7 +65,8 @@ def to_proto(self) -> PBPaginationParams:
 
 
 @deprecated(
-    "Info is deprecated, use PaginationInfo instead.",
+    "frequenz.client.common.pagination.Info is deprecated. "
+    "Use frequenz.client.common.pagination.PaginationInfo instead.",
 )
 @dataclass(frozen=True, kw_only=True)
 class Info: