Added from_name method for VocationFilter

Author: Galarzaa90

docs/api.rst

@@ -48,6 +48,8 @@ Enumerations are provided for various values in order to avoid depending on stri
     :members:
     :undoc-members:
 
+    .. automethod:: VocationFilter.from_name
+
 .. autoclass:: WorldLocation
     :members:
     :undoc-members:

tibiapy/enums.py

@@ -86,6 +86,30 @@ class VocationFilter(Enum):
     SORCERERS = 3
     DRUIDS = 4
 
+    @classmethod
+    def from_name(cls, name, all_fallback=True):
+        """Gets a vocation filter from a vocation's name.
+
+        Parameters
+        ----------
+        name: :class:`str`
+            The name of the vocation.
+        all_fallback: :class:`bool`
+            Whether to return :py:attr:`ALL` if no match is found. Otherwise, ``None`` will be returned.
+
+        Returns
+        -------
+        VocationFilter, optional:
+            The matching vocation filter.
+        """
+        name = name.upper()
+        for vocation in cls:  # type: VocationFilter
+            if vocation.name in name or vocation.name[:-1] in name and vocation != cls.ALL:
+                return vocation
+        if all_fallback or name.upper() == "ALL":
+            return cls.ALL
+        return None
+
 
 class WorldLocation(BaseEnum):
     """The possible physical locations for servers."""