Fix linting and pytest issues for types.py

Signed-off-by: Mihai Criveti <[email protected]>

Author: crivetimihai

mcpgateway/types.py

@@ -479,14 +479,61 @@ class Config:
 
 # Root types
 class FileUrl(AnyUrl):
-    """A specialized URL for file resources.
-
-    This URL accepts only the "file" scheme and does not require a host.
-    """
-
+    """A specialized URL type for local file-scheme resources.
+
+    Key characteristics
+    -------------------
+    * Scheme restricted – only the "file" scheme is permitted
+      (e.g. file:///path/to/file.txt).
+    * No host required – "file" URLs typically omit a network host;
+      therefore, the host component is not mandatory.
+    * String-friendly equality – developers naturally expect
+      FileUrl("file:///data") == "file:///data" to evaluate True.
+      AnyUrl (Pydantic) does not implement that, so we override
+      __eq__ to compare against plain strings transparently.
+      Hash semantics are kept consistent by delegating to the parent class.
+
+    Examples
+    --------
+    >>> url = FileUrl("file:///etc/hosts")
+    >>> url.scheme
+    'file'
+    >>> url == "file:///etc/hosts"
+    True
+    >>> {"path": url}  # hashable
+    {'path': FileUrl('file:///etc/hosts')}
+
+    Notes
+    -----
+    The override does not interfere with comparisons to other
+    AnyUrl/FileUrl instances; those still use the superclass
+    implementation.
+    """
+
+    # Restrict to the "file" scheme and omit host requirement
     allowed_schemes = {"file"}
     host_required = False
 
+    def __eq__(self, other):  # type: ignore[override]
+        """Return True when other is an equivalent URL or string.
+
+        If other is a str it is coerced with str(self) for comparison;
+        otherwise defer to AnyUrl's comparison.
+
+        Args:
+            other (Any): The object to compare against. May be a str, FileUrl, or AnyUrl.
+
+        Returns:
+            bool: True if the other value is equal to this URL, either as a string
+            or as another URL object. False otherwise.
+        """
+        if isinstance(other, str):
+            return str(self) == other
+        return super().__eq__(other)
+
+    # Keep hashing behaviour aligned with equality
+    __hash__ = AnyUrl.__hash__
+
 
 class Root(BaseModel):
     """A root directory or file.