Ignore false positives for pydoclint check DOC503

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

Author: llucax

src/frequenz/core/asyncio/_service.py

@@ -327,8 +327,10 @@ def cancel(self, msg: str | None = None) -> None:
             self._main_task.cancel(msg)
         self._task_group.cancel(msg)
 
+    # We need to use noqa here because pydoclint can't figure out that rest is actually
+    # an instance of BaseExceptionGroup.
     @override
-    async def stop(self, msg: str | None = None) -> None:
+    async def stop(self, msg: str | None = None) -> None:  # noqa: DOC503
         """Stop this service.
 
         This method cancels all running tasks spawned by this service and waits for them

src/frequenz/core/asyncio/_task_group.py

@@ -227,7 +227,9 @@ def cancel(self, msg: str | None = None) -> None:
         for task in self._running:
             task.cancel(msg)
 
-    async def stop(self, msg: str | None = None) -> None:
+    # We need to use noqa here because pydoclint can't figure out that rest is actually
+    # an instance of BaseExceptionGroup.
+    async def stop(self, msg: str | None = None) -> None:  # noqa: DOC503
         """Stop this task group.
 
         This method cancels all running tasks spawned by this group and waits for them

src/frequenz/core/typing.py

@@ -137,7 +137,9 @@ def decorator(inner_cls: TypeT) -> TypeT:
 class _NoInitConstructibleMeta(type):
     """A metaclass that disables the __init__ constructor."""
 
-    def __new__(
+    # We need to use noqa here because pydoclint can't figure out that
+    # _get_no_init_constructible_error() returns a TypeError.
+    def __new__(  # noqa: DOC503
         mcs,
         name: str,
         bases: tuple[type, ...],
@@ -173,7 +175,9 @@ def __init__(
         super().__init__(name, bases, namespace)
         cls._no_init_constructible_error = kwargs.get("no_init_constructible_error")
 
-    def __call__(cls, *args: Any, **kwargs: Any) -> NoReturn:
+    # We need to use noqa here because pydoclint can't figure out that
+    # _get_no_init_constructible_error() returns a TypeError.
+    def __call__(cls, *args: Any, **kwargs: Any) -> NoReturn:  # noqa: DOC503
         """Raise an error when the __init__ constructor is called.
 
         Args: