TestRunner

Filter

-s my.package, --package my.package, --dir my.package

durchsucht die angegebenen Verzeichnisse nach Tests.

-m test_setup, --module test_setup

spezifiziert ein Testmodul als regulären Ausdruck, z.B.:

$ ./bin/instance test -s my.package  -m 'test_setup'

-t  '.*installed.*', --test test_theme_installed

spezifiziert einen Testfilter als regulären Ausdruck, z.B.:

$ ./bin/instance test -s vs.policy -m '.*setup.*' -t '.*installed.*'

Hiermit werden im Paket vs.policy alle, mit installed endenden, Methoden in allen Testmodulen, die auf setup enden, durchlaufen.

-u, --unit

durchläuft ausschließlich Unit tests und ingoriert andere layer-Optionen.

-f, --non-unit

durchläuft alle Tests, die keine Unit Tests sind

Report

-v, --verbose

führt zu ausführlicherer Ausgabe

--ndiff

falls ein Doctest fehlschlägt, wird ndiff.py zur Darstellung der Unterschiede verwendet

--udiff

When there is a doctest failure, show it as a unified diff. falls ein Doctest fehlschlägt, wird Unified Diff zur Darstellung der Unterschiede verwendet

--cdiff

falls ein Doctest fehlschlägt, wird Context Diff zur Darstellung der Unterschiede verwendet

Analyse

-d, post-mortem

stoppt die Ausführung nach dem ersten nicht-bestandenen Test und ermöglicht post-mortem-Debugging, d.h. die Debug-Session wird nur gestartet, wenn ein Test fehlschlägt.

Setup

--path src/my.package

fügt einen Pfad zu Pythons Suchpfad hinzu, wobei die Option mehrfach angegeben werden kann.

Weitere Optionen

Diese erhalten Sie mit:

$ ./bin/instance test --help

Wenn die relevanten Tests erfolgreich verliefen, sollten schließlich noch alle Tests durchgeführt werden um sicherzustellen, dass nicht an anderer Stelle etwas gebrochen ist. Wenn alle Tests erfolgreich durchlaufen wurden, erscheint eine Meldung:

Ran 10 tests with 0 failures and 0 errors in 4.830 seconds.

Falls nicht alle Tests erfolgreich durchlaufen wurden, ändert sich die Meldung:

Ran 10 tests with 2 failures and 3 errors in 9.688 seconds.

Dabei wurden dann zwei Tests nicht bestanden und drei Tests enthielten Fehler.

Plone 4

Ab Zope 2.12 kommt der test-Befehl nicht mehr unmittelbar mit Zope mit. Stattdessen kann ein Buildout-Abschnitt mit zc.recipe.testrunner erstellt werden:

[buildout]
parts =
    …
    test
…
eggs =
    vs.policy
develop =
    src/vs.policy

[test]
recipe = zc.recipe.testrunner
eggs =
    vs.policy
script = test

Anschließend können Sie ein Egg testen z.B. mit:

$ ./bin/test -s vs.policy

Weitere Informationen erhalten Sie in zc.recipe.testrunner

roadrunner

roadrunner ist ein Testrunner, der die testgetriebene Entwicklung deutlich beschleunigen kann, da er vorab das Standard-Zope- und Plone-Environment für PloneTestCase läd. zur Installation wird einfach folgendes in die buildout.cfg-Datei eingetragen:

[buildout]
parts =
    …
    roadrunner

[roadrunner]
recipe = roadrunner:plone
packages-under-test = vs.policy

Anschließend kann es wie der reguläre Zope-Testrunner aufgerufen werden:

$ ./bin/roadrunner -s vs.policy