<!DOCTYPE html PUBLIC
"-//W3C//DTD HTML 4.0 Transitional//EN">
<link rel=
"STYLESHEET" href=
"lib.css" type='text/css'
/>
<link rel=
"SHORTCUT ICON" href=
"../icons/pyfav.png" type=
"image/png" />
<link rel='start' href='../index.html' title='Python Documentation Index'
/>
<link rel=
"first" href=
"lib.html" title='Python Library Reference'
/>
<link rel='contents' href='contents.html'
title=
"Contents" />
<link rel='index' href='genindex.html' title='Index'
/>
<link rel='last' href='about.html' title='About this document...'
/>
<link rel='help' href='about.html' title='About this document...'
/>
<link rel=
"next" href=
"doctest-execution-context.html" />
<link rel=
"prev" href=
"doctest-which-docstrings.html" />
<link rel=
"parent" href=
"doctest-how-it-works.html" />
<link rel=
"next" href=
"doctest-execution-context.html" />
<meta name='aesop' content='information'
/>
<title>5.2.3.2 How are Docstring Examples Recognized?
</title>
<div id='top-navigation-panel' xml:id='top-navigation-panel'
>
<table align=
"center" width=
"100%" cellpadding=
"0" cellspacing=
"2">
<td class='online-navigation'
><a rel=
"prev" title=
"5.2.3.1 Which Docstrings Are"
href=
"doctest-which-docstrings.html"><img src='../icons/previous.png'
border='
0' height='
32' alt='Previous Page' width='
32'
/></A></td><td class='online-navigation'
><a rel=
"parent" title=
"5.2.3 How It Works"
href=
"doctest-how-it-works.html"><img src='../icons/up.png'
border='
0' height='
32' alt='Up One Level' width='
32'
/></A></td><td class='online-navigation'
><a rel=
"next" title=
"5.2.3.3 What's the Execution"
href=
"doctest-execution-context.html"><img src='../icons/next.png'
border='
0' height='
32' alt='Next Page' width='
32'
/></A></td><td align=
"center" width=
"100%">Python Library Reference
</td>
<td class='online-navigation'
><a rel=
"contents" title=
"Table of Contents"
href=
"contents.html"><img src='../icons/contents.png'
border='
0' height='
32' alt='Contents' width='
32'
/></A></td><td class='online-navigation'
><a href=
"modindex.html" title=
"Module Index"><img src='../icons/modules.png'
border='
0' height='
32' alt='Module Index' width='
32'
/></a></td><td class='online-navigation'
><a rel=
"index" title=
"Index"
href=
"genindex.html"><img src='../icons/index.png'
border='
0' height='
32' alt='Index' width='
32'
/></A></td><div class='online-navigation'
>
<b class=
"navlabel">Previous:
</b>
<a class=
"sectref" rel=
"prev" href=
"doctest-which-docstrings.html">5.2.3.1 Which Docstrings Are
</A>
<b class=
"navlabel">Up:
</b>
<a class=
"sectref" rel=
"parent" href=
"doctest-how-it-works.html">5.2.3 How It Works
</A>
<b class=
"navlabel">Next:
</b>
<a class=
"sectref" rel=
"next" href=
"doctest-execution-context.html">5.2.3.3 What's the Execution
</A>
<!--End of Navigation Panel-->
<H3><A NAME=
"SECTION007232000000000000000"></A><A NAME=
"doctest-finding-examples"></A>
5.2.3.2 How are Docstring Examples
In most cases a copy-and-paste of an interactive console session works
fine, but doctest isn't trying to do an exact emulation of any specific
Python shell. All hard tab characters are expanded to spaces, using
8-column tab stops. If you don't believe tabs should mean that, too
bad: don't use hard tabs, or write your own
<tt class=
"class">DocTestParser
</tt><span class=
"versionnote">Changed in version
2.4:
Expanding tabs to spaces is new; previous versions
tried to preserve hard tabs, with confusing results.
</span><div class=
"verbatim"><pre>
>>> # comments are ignored
Any expected output must immediately follow the final
<code>'
><code>></code>> '
</code> or
<code>'...
'
</code> line containing the code, and
the expected output (if any) extends to the next
<code>'
><code>></code>> '
</code><LI>Expected output cannot contain an all-whitespace line, since such a
line is taken to signal the end of expected output. If expected
output does contain a blank line, put
<code><BLANKLINE
></code> in your
doctest example each place a blank line is expected.
<span class=
"versionnote">Changed in version
2.4:
<code><BLANKLINE
></code> was added; there was no way to
use expected output containing empty lines in
previous versions.
</span><LI>Output to stdout is captured, but not output to stderr (exception
tracebacks are captured via a different means).
<LI>If you continue a line via backslashing in an interactive session,
or for any other reason use a backslash, you should use a raw
docstring, which will preserve your backslashes exactly as you type
<div class=
"verbatim"><pre>
... r'''Backslashes in a raw docstring: m\n'''
>>> print f.__doc__
Backslashes in a raw docstring: m\n
Otherwise, the backslash will be interpreted as part of the string.
For example, the
"\" above would be interpreted as a
newline character. Alternatively, you can double each backslash in the
doctest version (and not use a raw string):
<div class=
"verbatim"><pre>
... '''Backslashes in a raw docstring: m\\n'''
>>> print f.__doc__
Backslashes in a raw docstring: m\n
<LI>The starting column doesn't matter:
<div class=
"verbatim"><pre>
>>> assert
"Easy!"
>>> math.floor(
1.9)
and as many leading whitespace characters are stripped from the
expected output as appeared in the initial
<code>'
><code>></code>> '
</code> line
that started the example.
<div class='online-navigation'
>
<table align=
"center" width=
"100%" cellpadding=
"0" cellspacing=
"2">
<td class='online-navigation'
><a rel=
"prev" title=
"5.2.3.1 Which Docstrings Are"
href=
"doctest-which-docstrings.html"><img src='../icons/previous.png'
border='
0' height='
32' alt='Previous Page' width='
32'
/></A></td><td class='online-navigation'
><a rel=
"parent" title=
"5.2.3 How It Works"
href=
"doctest-how-it-works.html"><img src='../icons/up.png'
border='
0' height='
32' alt='Up One Level' width='
32'
/></A></td><td class='online-navigation'
><a rel=
"next" title=
"5.2.3.3 What's the Execution"
href=
"doctest-execution-context.html"><img src='../icons/next.png'
border='
0' height='
32' alt='Next Page' width='
32'
/></A></td><td align=
"center" width=
"100%">Python Library Reference
</td>
<td class='online-navigation'
><a rel=
"contents" title=
"Table of Contents"
href=
"contents.html"><img src='../icons/contents.png'
border='
0' height='
32' alt='Contents' width='
32'
/></A></td><td class='online-navigation'
><a href=
"modindex.html" title=
"Module Index"><img src='../icons/modules.png'
border='
0' height='
32' alt='Module Index' width='
32'
/></a></td><td class='online-navigation'
><a rel=
"index" title=
"Index"
href=
"genindex.html"><img src='../icons/index.png'
border='
0' height='
32' alt='Index' width='
32'
/></A></td><div class='online-navigation'
>
<b class=
"navlabel">Previous:
</b>
<a class=
"sectref" rel=
"prev" href=
"doctest-which-docstrings.html">5.2.3.1 Which Docstrings Are
</A>
<b class=
"navlabel">Up:
</b>
<a class=
"sectref" rel=
"parent" href=
"doctest-how-it-works.html">5.2.3 How It Works
</A>
<b class=
"navlabel">Next:
</b>
<a class=
"sectref" rel=
"next" href=
"doctest-execution-context.html">5.2.3.3 What's the Execution
</A>
<span class=
"release-info">Release
2.4.2, documentation updated on
28 September
2005.
</span>
<!--End of Navigation Panel-->
See
<i><a href=
"about.html">About this document...
</a></i> for information on suggesting changes.
projects / OpenSPARC-T2-SAM / blob