Unify the style with the new wrappers

We adjust the documentation and enum lookup to match the newly added
wrappers.

The new enum conversion also avoid a double linear search
when creating enums. We can just try to create it and if it fails
create an `UNSPECIFIED` / `UNKNOWN` item, so we do only one search.

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

Author: llucax

src/frequenz/client/microgrid/_component_states.py

@@ -128,20 +128,20 @@ class EVChargerCableState(Enum):
     """The cable is plugged into the EV and locked."""
 
     @classmethod
-    def from_pb(cls, evc_state: ev_charger.CableState) -> Self:
-        """Convert a protobuf CableState value to EVChargerCableState enum.
+    def from_pb(cls, state: ev_charger.CableState) -> Self:
+        """Convert a protobuf state value to this enum.
 
         Args:
-            evc_state: protobuf cable state to convert.
+            state: The protobuf cable state to convert.
 
         Returns:
-            Enum value corresponding to the protobuf message.
+            The enum value corresponding to the protobuf message.
         """
-        if not any(t.value == evc_state for t in EVChargerCableState):
+        try:
+            return cls(state)
+        except ValueError:
             return cls(cls.UNSPECIFIED)
 
-        return cls(evc_state)
-
 
 class EVChargerComponentState(Enum):
     """Component State of an EV Charger."""
@@ -179,20 +179,20 @@ class EVChargerComponentState(Enum):
     """The state is provided by the device, but it is not one of the above states."""
 
     @classmethod
-    def from_pb(cls, evc_state: ev_charger.ComponentState) -> Self:
-        """Convert a protobuf ComponentState value to EVChargerComponentState enum.
+    def from_pb(cls, state: ev_charger.ComponentState) -> Self:
+        """Convert a protobuf state value to this enum.
 
         Args:
-            evc_state: protobuf component state to convert.
+            state: The protobuf component state to convert.
 
         Returns:
-            Enum value corresponding to the protobuf message.
+            The enum value corresponding to the protobuf message.
         """
-        if not any(t.value == evc_state for t in EVChargerComponentState):
+        try:
+            return cls(state)
+        except ValueError:
             return cls(cls.UNKNOWN)
 
-        return cls(evc_state)
-
 
 class InverterComponentState(Enum):
     """Component states of an inverter."""