Linux Certif

Toute la documentation sur la certification Linux LPI

py.test

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 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 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