Table of Contents

Class: Example ./src/peak/util/_doctest.py

A single doctest example, consisting of source code and expected output. `Example` defines the following attributes:

  • source: A single Python statement, always ending with a newline. The constructor adds a newline if needed.

  • want: The expected output from running the source code (either from stdout, or a traceback in case of exception). `want` ends with a newline unless it's empty, in which case it's an empty string. The constructor adds a newline if needed.

  • exc_msg: The exception message generated by the example, if the example is expected to generate an exception; or `None` if it is not expected to generate an exception. This exception message is compared against the return value of `traceback.format_exception_only()`. `exc_msg` ends with a newline unless it's `None`. The constructor adds a newline if needed.

  • lineno: The line number within the DocTest string containing this Example where the Example begins. This line number is zero-based, with respect to the beginning of the DocTest.

  • indent: The example's indentation in the DocTest string. I.e., the number of space characters that preceed the example's first prompt.

  • options: A dictionary mapping from option flags to True or False, which is used to override default options for this example. Any option flags not contained in this dictionary are left at their default value (as specified by the DocTestRunner's optionflags). By default, no options are set.

Methods   
__init__
  __init__ 
__init__ (
        self,
        source,
        want,
        exc_msg=None,
        lineno=0,
        indent=0,
        options=None,
        )


Table of Contents

This document was automatically generated on Mon Apr 22 01:11:04 2024 by HappyDoc version 2.1