+
    WBi                     P    R t RR lt]R8X  d   ^ RIt]P                  ! 4        R# R# )z
Documentation Example

This is the example used in the doxypypy documentation.
It demonstrates basic docstring usage (including doctests).
c                    \        V \        4      '       g   Q hV^8  d   \        hRP                  W,           W,          V4      # )a  
Does nothing more than demonstrate syntax.

This is an example of how a Pythonic human-readable docstring can
get parsed by doxypypy and marked up with Doxygen commands as a
regular input filter to Doxygen.

Args:
    arg1:   A positional argument.
    arg2:   Another positional argument.

Kwargs:
    kwarg:  A keyword argument.

Returns:
    A string holding the result.

Raises:
    ZeroDivisionError, AssertionError, & ValueError.

Examples:
    >>> myfunction(2, 3)
    '5 - 0, whatever.'
    >>> myfunction(5, 0, 'oops.')
    Traceback (most recent call last):
        ...
    ZeroDivisionError: integer division or modulo by zero
    >>> myfunction(4, 1, 'got it.')
    '5 - 4, got it.'
    >>> myfunction(23.5, 23, 'oh well.')
    Traceback (most recent call last):
        ...
    AssertionError
    >>> myfunction(5, 50, 'too big.')
    Traceback (most recent call last):
        ...
    ValueError
z{0} - {1}, {2})
isinstanceint
ValueErrorformat)arg1arg2kwargs   &&&D/usr/lib/python3.14/site-packages/doxypypy/test/sample_docexample.py
myfunctionr      s>    N dC    by""4;UCC    __main__N)z	whatever.)__doc__r   __name__doctesttestmod r   r
   <module>r      s-   *DZ zOO r   