Improve docstring tests.

[CEXT-Dan]

I just ignore them as it’s not clear to me where the failures are, it just dumps the whole stub into the file

[gswifort]

That's true, I didn't have a better idea for a test. In the logs it throws EXPECTED: ... and RESULT: ... the only thing you can do is find the EXPECTED fragment in RESULT and see where the difference occurs.

[gswifort]

I can probably use difflib to find the bad fragment

[gswifort]

Fixed in 7319a55

Based on the BEST MATCH section, you can easily see what is missing and where the best matching fragment is located in the text.

Sample:

================================== FAILURES ===================================
____________________ Test_ModulePyiGenerator.test_gen[002] ____________________
*** NOT FOUND: ***


_CommandDecorator: TypeAlias = c.Callable[[T], T]

@overload
def Command() -> _CommandDecorator: ...
@overload
def Command(commandName: str, /) -> _CommandDecorator: ...
@overload
def Command(commandName: str, CmdFlags: PyAp.CmdFlags, /) -> _CommandDecorator:
    """
    Decorator to register a command.

    Examples::

        import traceback
        from pyrx import Ap

        @Ap.Command()
        def my_command() -> None:
            try:
                # do something
            except Exception:
                traceback.print_exc()
    """

*** BEST MATCH: ***

Decorator: TypeAlias = c.Callable[[T], T]

@overload
def Command() -> _CommandDecorator: ...
@overload
def Command(commandName: str, /) -> _CommandDecorator: ...
@overload
def Command(commandName: str, CmdFlags: PyAp.CmdFlags, /) -> _CommandDecorator:
    """
    Decorator to register a command.

    Examples::

        import traceback
        from pyrx import Ap

        @Ap.Command()
        def my_command() -> None:
            try:
                # do something
            except Exception:
                traceback.print_exc()
    """

*** RESULT: ***
from __future__ import annotations
from typing import Any, ClassVar, Collection, Iterator, Self, overload
from pyrx import Ap as PyAp
from pyrx import Ax as PyAx
from pyrx import Br as PyBr
from pyrx import Db as PyDb
from pyrx import Ed as PyEd

(...)