Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
C
cpython
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
Kirill Smelkov
cpython
Commits
5d2f515d
Commit
5d2f515d
authored
Jun 28, 2003
by
Fred Drake
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
fix markup nits
parent
c0fac96c
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
12 additions
and
12 deletions
+12
-12
Doc/lib/libdoctest.tex
Doc/lib/libdoctest.tex
+12
-12
No files found.
Doc/lib/libdoctest.tex
View file @
5d2f515d
...
...
@@ -153,7 +153,7 @@ if __name__ == "__main__":
\end{verbatim}
If you want to test the module as the main module, you don't need to
pass M to
\function
{
testmod
}
; in this case, it will test the current
pass M to
\function
{
testmod
()
}
; in this case, it will test the current
module.
Then running the module as a script causes the examples in the docstrings
...
...
@@ -176,11 +176,12 @@ python M.py -v
and a detailed report of all examples tried is printed to
\code
{
stdout
}
,
along with assorted summaries at the end.
You can force verbose mode by passing
\code
{
verbose=1
}
to testmod, or
You can force verbose mode by passing
\code
{
verbose=1
}
to
\function
{
testmod()
}
, or
prohibit it by passing
\code
{
verbose=0
}
. In either of those cases,
\code
{
sys.argv
}
is not examined by
testmod
.
\code
{
sys.argv
}
is not examined by
\function
{
testmod()
}
.
In any case,
testmod
returns a 2-tuple of ints
\code
{
(
\var
{
f
}
,
In any case,
\function
{
testmod()
}
returns a 2-tuple of ints
\code
{
(
\var
{
f
}
,
\var
{
t
}
)
}
, where
\var
{
f
}
is the number of docstring examples that
failed and
\var
{
t
}
is the total number of docstring examples
attempted.
...
...
@@ -210,8 +211,8 @@ from \module{M}'s globals are skipped, all names reached from
\subsection
{
What's the Execution Context?
}
By default, each time
testmod finds a docstring to test, it uses a
\emph
{
copy
}
of
\module
{
M
}
's globals, so that running tests on a module
By default, each time
\function
{
testmod()
}
finds a docstring to test, it uses
a
\emph
{
copy
}
of
\module
{
M
}
's globals, so that running tests on a module
doesn't change the module's real globals, and so that one test in
\module
{
M
}
can't leave behind crumbs that accidentally allow another test
to work. This means examples can freely use any names defined at top-level
...
...
@@ -400,21 +401,20 @@ def _test():
\end{verbatim}
\item
WYSIWYG isn't always the case, starting in Python 2.3. The
string form of boolean results changed from
\code
{
"0"
}
and
\code
{
"1"
}
to
\code
{
"False"
}
and
\code
{
"True"
}
in Python 2.3.
string form of boolean results changed from
\code
{
'0'
}
and
\code
{
'1'
}
to
\code
{
'False'
}
and
\code
{
'True'
}
in Python 2.3.
This makes it clumsy to write a doctest showing boolean results that
passes under multiple versions of Python. In Python 2.3, by default,
and as a special case, if an expected output block consists solely
of
\code
{
"0"
}
and the actual output block consists solely of
\code
{
"False"
}
, that's accepted as an exact match, and similarly for
\code
{
"1"
}
versus
\code
{
"True"
}
. This behavior can be turned off by
of
\code
{
'0'
}
and the actual output block consists solely of
\code
{
'False'
}
, that's accepted as an exact match, and similarly for
\code
{
'1'
}
versus
\code
{
'True'
}
. This behavior can be turned off by
passing the new (in 2.3) module constant
\constant
{
DONT
_
ACCEPT
_
TRUE
_
FOR
_
1
}
as the value of
\function
{
testmod()
}
's
new (in 2.3) optional
\var
{
optionflags
}
argument. Some years after
the integer spellings of booleans are history, this hack will
probably be removed again.
\end{enumerate}
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment