python-codespeak-l(1)
NAME
py.test - pylib test runner
SYNOPSIS
py.test [option] [query] [filenames of tests...]
DESCRIPTION
This manual page documents briefly the py.test command.
This manual page was written for the Debian(TM) distribution because
the original program does not have a manual page. Instead, it has
documentation in html available in
/usr/share/doc/python-codespeak-lib/py/doc/test.html.
py.test is a program that runs tests in a module or directory specified
on the command line. It looks for functions and methods with names
starting with ´test_´ and run those methods. Assertions about test
outcomes are done via the standard ´assert´ statement.
OPTIONS
These programs follow the usual GNU command line syntax, with long
options starting with two dashes (`-´). A summary of options is
included below.
- -h --help
- Show summary of options and exit.
- -v --verbose
- Increase verbosity.
- -x --exitfirst
- Exit on first error or failed test.
- -s --nocapture
- Disable catching of sys.stdout/stderr output.
- -k KEYWORD
- only run tests matching the given keyword expression
- -l --showlocals
- Show local variables in traceback (disabled by default)
- --pdb
- Start the python debugger on errors
- --tb=TBSTYLE
- set the traceback style. TBSTYLE can be ´long´, ´short´ or ´no´)
- --fulltrace
- Do not cut tracebacks (default behavior is to cut)
- --nomagic
- Refrain from using magic as much as possible
- --collectonly
- Only collect tests, don´t execute them
- --traceconfig
- Trace consideration of conftest.py files
- --apigen
- Generate api documentation while testing (requires initpkg/conftest config).
- --tkinter
- use tkinter test session frontend (requires python-tkinter).
- --looponfailing
- Loop on failing tests
- --session=SESSION
- Use the given session class. Default is ´terminal´.
- --exec
- python executable with which the tests should be run
- -w --startserver
- Start an HTTP server on localhost:8000 for test.
- --runbrowser
- Point your browser to the server started with --startserver
- -r --rest
- Restructured Text test result output.
AUTHOR
This manual page was written by Alexandre Fayolle <afayolle@debian.org>
for the Debian(TM) system (but may be used by others). Permission is
granted to copy, distribute and/or modify this document under the terms
of the GNU General Public License, Version 2 any later version
published by the Free Software Foundation.
On Debian systems, the complete text of the GNU General Public License
can be found in /usr/share/common-licenses/GPL.
AUTHOR
- Alexandre Fayolle
- Author.
COPYRIGHT
- Copyright © 2007 Alexandre Fayolle