Dies ist der Befehlsnachweis, der beim kostenlosen Hosting-Anbieter OnWorks mit einer unserer zahlreichen kostenlosen Online-Workstations wie Ubuntu Online, Fedora Online, dem Windows-Online-Emulator oder dem MAC OS-Online-Emulator ausgeführt werden kann
PROGRAMM:
NAME/FUNKTION
beweisen – Führen Sie Tests über einen TAP-Kabelbaum durch.
ANWENDUNG
beweisen [Optionen] [Dateien oder Verzeichnisse]
OPTIONAL
Boolesche Optionen:
-v, --verbose Gibt alle Testzeilen aus.
-l, --lib Fügen Sie „lib“ zum Pfad für Ihre Tests hinzu (-Ilib).
-b, --blib Fügen Sie „blib/lib“ und „blib/arch“ zum Pfad für hinzu
Deine Tests
-s, --shuffle Führen Sie die Tests in zufälliger Reihenfolge aus.
-c, --color Farbige Testausgabe (Standard).
--nocolor Testausgabe nicht färben.
--count Zeigt die X/Y-Testanzahl an, wenn nicht ausführlich
(Default)
--nocount Deaktiviert die X/Y-Testzählung.
-D --dry Trockenlauf. Test anzeigen, der gelaufen wäre.
-f, --failures Fehlgeschlagene Tests anzeigen.
-o, --comments Kommentare anzeigen.
--ignore-exit Ignoriert den Exit-Status von Testskripten.
-m, --merge Führt die STDERR von Testskripten mit ihrer STDOUT zusammen.
-r, --recurse Rekursiv in Verzeichnisse absteigen.
--reverse Führen Sie die Tests in umgekehrter Reihenfolge aus.
-q, --quiet Unterdrückt einige Testausgaben während der Ausführung von Tests.
-Q, --QUIET Nur Zusammenfassungsergebnisse drucken.
-p, --parse Vollständige Liste der TAP-Analysefehler anzeigen, falls vorhanden.
--directives Zeigt nur Ergebnisse mit TODO- oder SKIP-Anweisungen an.
--timer Verstrichene Zeit nach jedem Test drucken.
--trap Strg-C abfangen und Zusammenfassung bei Interrupt ausgeben.
--normalize TAP-Ausgabe in ausführlicher Ausgabe normalisieren
-T Verunreinigungsprüfungen aktivieren.
-t Verunreinigungswarnungen aktivieren.
-W Schwerwiegende Warnungen aktivieren.
-w Warnungen aktivieren.
-h, --help Diese Hilfe anzeigen
-?, Diese Hilfe anzeigen
-V, --version Zeigt die Version an
-H, --man Längere Manpage zum Beweisen
--norc Standard-.proverc nicht verarbeiten
Optionen, die Argumente annehmen:
-I Einzuschließende Bibliothekspfade.
-P Plugin laden (durchsucht App::Prove::Plugin::*.)
-M Ein Modul laden.
-e, --exec Interpreter zum Ausführen der Tests ('' für kompiliert
Tests.)
--ext Setzt die Erweiterung für Tests (Standard „.t“)
--harness Definiert den zu verwendenden Test-Harness. Siehe TAP::Harness.
--formatter Zu verwendender Ergebnisformatierer. Siehe FORMATTER.
--source Einen SourceHandler laden und/oder konfigurieren. Sehen
QUELLHANDLER.
-a, --archive out.tgz Speichern Sie das resultierende TAP in einer Archivdatei.
-j, --jobs N N Testjobs parallel ausführen (versuchen Sie es mit 9.)
--state=opts Kontrolliert den dauerhaften Zustand des Nachweises.
--rc=rcfile Verarbeitet Optionen von rcfile
--rules Regeln für parallele vs. sequentielle Verarbeitung.
ANMERKUNG
~/.proverc / ./.provec
If ~/.proverc or ./.provec Sind sie vorhanden, werden sie gelesen und alle darin enthaltenen Optionen verarbeitet
vor den Befehlszeilenoptionen. Optionen in .provec werden auf die gleiche Weise angegeben wie
Befehlszeilenoptionen:
# .provc
--state=heiß, schnell, speichern
-j9
Mit der Option „--rc“ können zusätzliche Optionsdateien angegeben werden. Standardoptionsdatei
Die Verarbeitung wird durch die Option „--norc“ deaktiviert.
Unter Windows und VMS wird die Optionsdatei benannt _Provinz statt .provec und wird gesucht
nur im aktuellen Verzeichnis.
Lesebrillen von „STDIN“
Wenn Sie eine Liste von Tests (oder URLs oder irgendetwas anderem, das Sie testen möchten) in einer Datei haben, können Sie
Sie können sie zu Ihren Tests hinzufügen, indem Sie ein „-“ verwenden:
beweisen - < my_list_of_things_to_test.txt
Weitere Informationen finden Sie in der „README“-Datei im Verzeichnis „examples“ dieser Distribution.
Standard Test Verzeichnis
Wenn keine Dateien oder Verzeichnisse angegeben werden, sucht „prove“ nach allen Dateien, die dem Muster entsprechen
„t/*.t“.
Farbig Test Ausgang
Die farbige Testausgabe mit TAP::Formatter::Color ist die Standardeinstellung, wenn die Ausgabe jedoch nicht an a erfolgt
Terminal, Farbe ist deaktiviert. Sie können dies überschreiben, indem Sie den Schalter „--color“ hinzufügen.
Für die Farbunterstützung ist Term::ANSIColor auf Unix-ähnlichen Plattformen und Win32::Console erforderlich
Fenster. Wenn das erforderliche Modul nicht installiert ist, ist keine farbige Ausgabe verfügbar.
Beenden Code
Wenn die Tests fehlschlagen, wird „beweisen“ mit einem Status ungleich Null beendet.
Argumente zu Tests
Es ist möglich, Argumente für Tests bereitzustellen. Um dies zu tun, trennen Sie sie von Beweisen
Argumente mit dem Arisdottle, '::'. Zum Beispiel
beweisen -vt/mytest.t :: --url http://example.com
würde Rennen t/mytest.t mit den Optionen '--url http://example.com'. Beim Ausführen mehrerer
Tests erhalten sie jeweils die gleichen Argumente.
„--exec“
Normalerweise können Sie einfach eine Liste von Perl-Tests bestehen und das System weiß, wie es auszuführen ist
ihnen. Wenn Ihre Tests jedoch nicht in Perl geschrieben sind oder Sie möchten, dass alle Tests aufgerufen werden
Genauso verwenden Sie den Schalter „-e“ oder „--exec“:
beweisen --exec '/usr/bin/ruby -w't/
beweisen --exec '/ Usr / bin / perl -Tw -mstrict -Ilib' t/
beweisen --exec '/path/to/my/customer/exec'
"--verschmelzen"
Wenn Sie sicherstellen müssen, dass Ihre Diagnosen in der richtigen Reihenfolge relativ zu angezeigt werden
Testergebnisse können Sie mit der Option „--merge“ die STDERR der Testskripte in ihre zusammenführen
STDOUT.
Dies garantiert, dass STDOUT (wo die Testergebnisse angezeigt werden) und STDERR (wo die Testergebnisse angezeigt werden).
(Diagnose erscheint) bleiben synchron. Der Kabelbaum zeigt alle Diagnosen Ihrer Tests an
emittieren auf STDERR.
Vorsichtsmaßnahme: Das ist eine kleine Flickschusterei. Beachten Sie insbesondere, dass ggf. etwas angezeigt wird
STDERR sieht aus wie ein Testergebnis, das die Testumgebung verwirrt. Verwenden Sie nur diese Option
wenn Sie die Konsequenzen verstehen und mit dem Risiko leben können.
"--fangen"
Die Option „--trap“ versucht, SIGINT (Strg-C) während eines Testlaufs abzufangen und anzuzeigen
Testzusammenfassung, auch wenn der Lauf unterbrochen wird
"--Zustand"
Sie können „Beweisen“ anfordern, um sich den Status früherer Testläufe zu merken und diese auszuwählen und/oder zu bestellen
die Tests, die basierend auf diesem gespeicherten Status ausgeführt werden sollen.
Der Schalter „--state“ erfordert ein Argument, das eine durch Kommas getrennte Liste von einem oder sein muss
weitere der folgenden Optionen.
"letzte"
Führen Sie dieselben Tests durch wie beim letzten Speichern des Status. Dadurch ist es möglich, z
B. um die Reihenfolge eines gemischten Tests nachzubilden.
# Führen Sie alle Tests in zufälliger Reihenfolge aus
$ beweisen -b --state=save --shuffle
# Führen Sie sie in derselben Reihenfolge erneut aus
$ beweisen -b --state=last
"gescheitert"
Führen Sie nur die Tests aus, die bei der letzten Ausführung fehlgeschlagen sind.
# Führen Sie alle Tests aus
$ beweisen -b --state=speichern
# Ausführungsfehler
$ beweisen -b --state=fehlgeschlagen
Wenn Sie zusätzlich die Option „Speichern“ angeben, werden neu bestandene Prüfungen von der Prüfung ausgeschlossen
Folgeläufe.
# Wiederholen, bis keine Fehler mehr auftreten
$ beweisen -b --state=failed,save
"bestanden"
Führen Sie nur die bestandenen Tests des letzten Mals aus. Nützlich, um sicherzustellen, dass keine neuen Probleme auftreten
wurde vorgestellt.
"alle"
Führen Sie alle Tests in normaler Reihenfolge durch. Es können mehrere Optionen angegeben werden, um alle Tests auszuführen
mit den Ausfällen vom letzten Mal zuerst:
$ beweisen -b --state=failed,all,save
"heiße"
Führen Sie zuerst die Tests aus, die zuletzt fehlgeschlagen sind. Der letzte Fehlerzeitpunkt jedes Tests ist
gelagert. Die Option „Hot“ bewirkt, dass die Tests in der Reihenfolge der aktuellsten Fehler ausgeführt werden.
$ beweisen -b --state=hot,save
Tests, die noch nie fehlgeschlagen sind, werden nicht ausgewählt. Alle Tests mit den meisten ausführen
Kürzlich ist die erste Verwendung fehlgeschlagen
$ beweisen -b --state=hot,all,save
Diese Kombination von Optionen kann auch so angegeben werden
$ beweisen -b --state=adrian
"alles"
Führen Sie alle Tests mit Todos aus.
"langsam"
Führen Sie die Tests in der Reihenfolge vom langsamsten zum schnellsten aus. Dies ist in Verbindung mit dem „-j“ nützlich.
Parallel-Testing-Schalter, um sicherzustellen, dass Ihre langsamsten Tests zuerst ausgeführt werden.
$ beweisen -b --state=slow -j9
"schnell"
Führen Sie Testtests in der Reihenfolge vom schnellsten zum langsamsten aus.
"Neu"
Führen Sie die Tests in der Reihenfolge vom neuesten zum ältesten aus, basierend auf den Änderungszeiten des Tests
Skripte.
"alt"
Führen Sie die Tests in der Reihenfolge vom ältesten zum neuesten aus.
"frisch"
Führen Sie die Testskripte aus, die seit dem letzten Testlauf geändert wurden.
"speichern"
Speichern Sie den Status beim Beenden. Der Zustand wird in einer Datei namens gespeichert .beweisen (_beweisen unter Windows
und VMS) im aktuellen Verzeichnis.
Der Schalter „--state“ kann mehr als einmal verwendet werden.
$ beweisen -b --state=hot --state=all,speichern
--Regeln
Mit der Option „--rules“ wird gesteuert, welche Tests nacheinander ausgeführt werden und welche ausgeführt werden
parallel, wenn die Option „--jobs“ angegeben ist. Die Option kann mehrfach angegeben werden
Zeiten, und die Reihenfolge ist wichtig.
Die praktischste Verwendung dürfte die Angabe sein, dass einige Tests nicht „parallelbereit“ sind.
Da die Erwähnung einer Datei mit --rules nicht dazu führt, dass sie als Testausführung ausgewählt wird, haben Sie
Sie können einige Regeleinstellungen in Ihrer .proverc-Datei „festlegen und vergessen“. Dann wirst du es können
Nutzen Sie die Leistungsvorteile paralleler Tests optimal aus, während einige
Ausnahmen werden weiterhin parallel ausgeführt.
--Regeln Beispiele
# Alle Tests dürfen parallel ausgeführt werden, außer denen, die mit „p“ beginnen.
--rules='seq=t/p*.t' --rules='par=**'
# Alle Tests müssen nacheinander ausgeführt werden, mit Ausnahme derjenigen, die mit „p“ beginnen und parallel ausgeführt werden sollten
--rules='par=t/p*.t'
--Regeln Auflösung
· Standardmäßig können alle Tests parallel ausgeführt werden. Geben Sie Ihre eigenen an
Regeln entfernt dieses.
· „Das erste Spiel gewinnt“. Die erste Regel, die mit einem Test übereinstimmt, ist diejenige, die gilt.
· Jeder Test, der nicht mit einer Regel übereinstimmt, wird am Ende des Laufs nacheinander ausgeführt.
· Das Vorhandensein einer Regel bedeutet nicht, dass ein Test ausgewählt wird. Sie müssen noch angeben
auszuführende Tests.
· Wenn Sie eine Regel angeben, die die parallele Ausführung von Tests zulässt, führt dies nicht dazu, dass diese ausgeführt werden
parallel. Sie müssen noch die Anzahl der parallelen „Jobs“ in Ihrem Harness-Objekt angeben.
--Regeln Glob-Stil Anleitungen Abstimmung
Wir implementieren unseren eigenen Mustervergleich im Glob-Stil für --rules. Hier sind die unterstützten
Muster:
** ist eine beliebige Anzahl von Zeichen, einschließlich /, innerhalb eines Pfadnamens
* ist null oder mehr Zeichen innerhalb eines Dateinamens/Verzeichnisnamens
? ist genau ein Zeichen innerhalb eines Dateinamens/Verzeichnisnamens
{foo,bar,baz} steht für foo, bar oder baz.
\ ist ein Escape-Zeichen
Weitere Informationen advanced Spezifikationen für den Parallel vs Reihenfolge Lauf Ohne eine erfahrene Medienplanung zur Festlegung von Regeln und Strategien beschleunigt der programmatische Medieneinkauf einfach die Rate der verschwenderischen Ausgaben.
Wenn Sie eine erweiterte Verwaltung dessen benötigen, was parallel oder nacheinander ausgeführt wird, lesen Sie die Seite
zugehörige „Regeln“-Dokumentation in TAP::Harness und TAP::Parser::Scheduler. Wenn was ist
Wenn die Möglichkeit direkt über „beweisen“ nicht ausreicht, können Sie Ihren eigenen Kabelbaum dazu schreiben
Sie können direkt auf diese Funktionen zugreifen.
@INK
Beweisen führt eine Trennung zwischen „Optionen, die an das Perl übergeben werden, das Beweisen ausführt“ und ein
„Optionen, die an das Perl übergeben werden, das Tests ausführt“; Diese Unterscheidung ist beabsichtigt. Und so kam es dass der
Perl, das einen Test ausführt, beginnt mit dem Standard-@INC. Zusätzliche Bibliotheksverzeichnisse
kann über die Umgebungsvariable „PERL5LIB“, über -Ifoo in „PERL5OPT“ oder über das hinzugefügt werden
Option „-Ilib“ für beweisen.
Verderben Model
Wenn ein Perl-Programm im Taint-Modus ausgeführt wird, wird normalerweise der Inhalt der Datei „PERL5LIB“ angezeigt.
Umgebungsvariablen erscheinen nicht in @INC.
Denn „PERL5LIB“ wird beim Testen oft verwendet, um Build-Verzeichnisse zum @INC-Proof hinzuzufügen
übergibt die Namen aller in „PERL5LIB“ gefundenen Verzeichnisse als -I-Schalter. Der Nettoeffekt von
Dies bedeutet, dass „PERL5LIB“ auch dann berücksichtigt wird, wenn die Prüfung im Taint-Modus ausgeführt wird.
FORMATIERER
Sie können einen benutzerdefinierten TAP::Parser::Formatter laden:
Beweisen Sie --formatter MyFormatter
SOURCE HANDLER
Sie können benutzerdefinierte TAP::Parser::SourceHandlers laden, um die Art und Weise zu ändern, wie der Parser interpretiert
besondere Quellen von TAP.
beweisen --source MyHandler --source YetAnother t
Wenn Sie der Quelle eine Konfiguration bereitstellen möchten, können Sie Folgendes verwenden:
beweisen --source MyCustom \
--source Perl --perl-option 'foo=bar baz' --perl-option avg=0.278 \
--source File --file-option extensions=.txt --file-option extensions=.tmp t
--source pgTAP --pgtap-option pset=format=html --pgtap-option pset=border=2
Jede „--$source-option“-Option muss ein durch ein „=“ getrenntes Schlüssel/Wert-Paar angeben. Wenn ein
Die Option kann mehrere Werte annehmen. Geben Sie sie einfach mehrmals an, wie bei „extensions=".
Beispiele oben. Wenn die Option eine Hash-Referenz sein soll, geben Sie den Wert als zweiten Wert an
Paar durch ein „=" getrennt, wie in den „pset="-Beispielen oben (Escape „=" mit einem Backslash).
Alle „--sources“ werden zu einem Hash zusammengefasst und an „new“ in den „sources“ von TAP::Harness übergeben.
Parameters.
Weitere Informationen zur Übergabe der Konfiguration finden Sie unter TAP::Parser::IteratorFactory
SourceHandler.
PLUGINS
Plugins können mit dem Befehl „-P“ geladen werdenPlugin“ Syntax, zB:
beweisen -PMyPlugin
Dadurch wird nach einem Modul namens „App::Prove::Plugin::MyPlugin“ gesucht. Andernfalls wird nach einem Modul mit dem Namen „App::Prove::Plugin::MyPlugin“ gesucht.
„Mein Plugin“. Wenn das Plugin nicht gefunden werden kann, wird sich „prove“ beschweren und beenden.
Sie können Ihrem Plugin Argumente übergeben, indem Sie „=arg1,arg2,etc“ an den Plugin-Namen anhängen:
Beweisen Sie -PMyPlugin=fou,du,fafa
Weitere Informationen finden Sie in der Dokumentation der einzelnen Plugins.
Verfügbare Plugins
Eine aktuelle Liste der verfügbaren Plugins finden Sie im CPAN:
<http://search.cpan.org/search?query=App%3A%3AProve+Plugin>
Schreiben Plugins
Bitte sehen Sie sich „PLUGINS“ in App::Prove an.
Nutzen Sie Proofp online über die Dienste von onworks.net