proofp - Online in de cloud

PROGRAMMA:

NAAM

bewijzen - Voer tests uit via een TAP-harnas.

GEBRUIK

bewijs [opties] [bestanden of mappen]

OPTIES

Booleaanse opties:

-v, --verbose Druk alle testregels af.
-l, --lib Voeg 'lib' toe aan het pad voor uw tests (-Ilib).
-b, --blib Voeg 'blib/lib' en 'blib/arch' toe aan het pad voor
uw testen
-s, --shuffle Voer de tests in willekeurige volgorde uit.
-c, --color Gekleurde testuitvoer (standaard).
--nocolor Testuitvoer niet in kleur.
--count Toont het aantal X/Y-tests als dit niet uitgebreid is
(Standaard)
--nocount Schakel het aantal X/Y-tests uit.
-D --droog Drooglopen. Toon test die zou zijn uitgevoerd.
-f, --failures Toon mislukte tests.
-o, --comments Toon commentaren.
--ignore-exit Negeer de afsluitstatus van testscripts.
-m, --merge Voeg de STDERR van testscripts samen met hun STDOUT.
-r, --recurse Recursief afdalen in mappen.
--reverse Voer de tests in omgekeerde volgorde uit.
-q, --quiet Onderdruk een deel van de testuitvoer tijdens het uitvoeren van tests.
-Q, --QUIET Druk alleen samenvattende resultaten af.
-p, --parse Toon de volledige lijst met eventuele TAP-parseerfouten.
--directives Toon alleen resultaten met TODO- of SKIP-richtlijnen.
--timer Print verstreken tijd na elke test.
--trap Trap Ctrl-C en druk de samenvatting af bij onderbreking.
--normalize Normaliseer TAP-uitvoer in uitgebreide uitvoer
-T Besmettingscontroles inschakelen.
-t Schakel waarschuwingen voor besmetting in.
-W Fatale waarschuwingen inschakelen.
-w Waarschuwingen inschakelen.
-h, --help Geef deze hulp weer
-?, Deze hulp weergeven
-V, --version Geef de versie weer
-H, --man Langere manpagina voor bewijs
--norc Verwerk standaard .proverc niet

Opties waarvoor argumenten nodig zijn:

-I Bibliotheekpaden die moeten worden opgenomen.
-P Plugin laden (zoekt App::Prove::Plugin::*.)
-M Laad een module.
-e, --exec Interpreter om de tests uit te voeren ('' voor gecompileerd
testen.)
--ext Stel de extensie voor tests in (standaard '.t')
--harness Definieer het te gebruiken testharnas. Zie TAP::Harnas.
--formatter Te gebruiken resultaatformatter. Zie FORATTERS.
--source Laad en/of configureer een SourceHandler. Zien
BRONBEHEERDERS.
-a, --archive out.tgz Bewaar de resulterende TAP in een archiefbestand.
-j, --jobs N Voer N testtaken parallel uit (probeer 9.)
--state=opteert de persistente status van Control bewijzen.
--rc=rcfile Procesopties uit rcfile
--rules Regels voor parallelle versus sequentiële verwerking.

OPMERKINGEN

~/.spreekwoord / ./.spreekwoord
If ~/.spreekwoord or ./.spreekwoord bestaan, worden ze gelezen en worden alle opties die ze bevatten verwerkt
vóór de opdrachtregelopties. Opties binnen .spreekwoord worden op dezelfde manier gespecificeerd als
opdrachtregelopties:

# .spreekwoord
--state=heet,snel,opslaan
-j9

Extra optiebestanden kunnen worden opgegeven met de optie "--rc". Standaard optiebestand
verwerking wordt uitgeschakeld door de "--norc" optie.

Onder Windows en VMS wordt het optiebestand genoemd _prov dan .spreekwoord en wordt gezocht
alleen in de huidige map.

lezing van "STDIN"
Als u een lijst met tests (of URL's, of iets anders dat u wilt testen) in een bestand hebt, kunt u
kunt ze aan uw tests toevoegen door een '-' te gebruiken:

bewijzen - < mijn_lijst_van_dingen_naar_test.txt

Zie de "README" in de directory "examples" van deze distributie.

Standaard Test Directory
Als er geen bestanden of mappen zijn opgegeven, zoekt "prove" naar alle bestanden die overeenkomen met het patroon
"t/*.t".

Gekleurde Test uitgang
Gekleurde testuitvoer met TAP::Formatter::Color is de standaardwaarde, maar als de uitvoer niet a
terminal, kleur is uitgeschakeld. U kunt dit overschrijven door de schakelaar "--color" toe te voegen.

Kleurondersteuning vereist Term::ANSIColor op Unix-achtige platforms en Win32::Console ingeschakeld
ramen. Als de benodigde module niet is geïnstalleerd, is er geen gekleurde uitvoer beschikbaar.

afrit Code
Als de tests mislukken, wordt "bewijzen" afgesloten met een niet-nulstatus.

argumenten naar Tests
Het is mogelijk om argumenten aan tests mee te geven. Om dit te doen, scheidt u ze van de bewijzen zelf
argumenten met de arisdottle, '::'. Bijvoorbeeld

bewijzen -vt/mijntest.t :: --url http://example.com

zou rennen t/mijntest.t met de opties '--url http://example.com'. Bij het uitvoeren van meerdere
Bij de tests krijgen ze allemaal dezelfde argumenten.

"--exec"
Normaal gesproken kunt u gewoon een lijst met Perl-tests doorstaan, waarna het harnas weet hoe het moet worden uitgevoerd
hen. Als uw tests echter niet in Perl zijn geschreven of als u wilt dat alle tests worden aangeroepen
op precies dezelfde manier gebruikt u de schakelaar "-e" of "--exec":

bewijzen --exec '/usr/bin/ruby -w' t/
bewijzen --exec '/usr/bin/perl -Tw -mstrict -Ilib' t/
bewijzen --exec '/pad/naar/mijn/klant/exec'

"--samenvoegen"
Als u er zeker van wilt zijn dat uw diagnosegegevens in de juiste volgorde worden weergegeven ten opzichte van
testresultaten kunt u de optie "--merge" gebruiken om de STDERR van de testscripts in hun
STDOUT.

Dit garandeert dat STDOUT (waar de testresultaten verschijnen) en STDERR (waar de
diagnostische gegevens verschijnen) blijft gesynchroniseerd. Het harnas geeft alle diagnostische gegevens van uw tests weer
uitzenden op STDERR.

Let op: dit is een beetje een kluns. Houd er in het bijzonder rekening mee dat als er iets op verschijnt
STDERR ziet eruit als een testresultaat, het testharnas zal in de war raken. Gebruik alleen deze optie
als u de gevolgen begrijpt en met het risico kunt leven.

"--val"
De "--trap" optie zal proberen SIGINT (Ctrl-C) te vangen tijdens een testrun en het
testoverzicht, zelfs als de run wordt onderbroken

"--staat"
U kunt "bewijzen" vragen om de status van eerdere testritten te onthouden en te selecteren en/of te bestellen
de tests die moeten worden uitgevoerd op basis van die opgeslagen status.

De "--state"-schakelaar vereist een argument dat een door komma's gescheiden lijst van één of moet zijn
meer van de volgende opties.

"laatste"
Voer dezelfde tests uit als de laatste keer dat de status werd opgeslagen. Dit maakt het mogelijk bijv
om bijvoorbeeld de volgorde van een willekeurige toets opnieuw te creëren.

# Voer alle tests in willekeurige volgorde uit
$ bewijzen -b --state=opslaan --shuffle

# Voer ze opnieuw uit in dezelfde volgorde
$ bewijzen -b --state=laatste

"mislukt"
Voer alleen de tests uit die tijdens de laatste keer zijn mislukt.

# Voer alle tests uit
$ bewijzen -b --state=opslaan

# Run-fouten
$ bewijzen -b --state=mislukt

Als u ook de optie "opslaan" opgeeft, worden nieuwe examens uitgesloten
daaropvolgende runs.

# Herhaal totdat er geen fouten meer zijn
$ bewijzen -b --state=mislukt, opslaan

"geslaagd"
Voer alleen de geslaagde tests van de vorige keer uit. Handig om ervoor te zorgen dat er geen nieuwe problemen optreden
zijn geïntroduceerd.

"alle"
Voer alle tests in de normale volgorde uit. Er kunnen meerdere opties worden opgegeven, zodat alle tests kunnen worden uitgevoerd
met eerst de mislukkingen van de vorige keer:

$ bewijzen -b --state=mislukt,alles,opslaan

"heet"
Voer eerst de tests uit die het laatst zijn mislukt. De laatste faaltijd van elke test is
opgeslagen. De "hot"-optie zorgt ervoor dat tests worden uitgevoerd in de volgorde van de meest recente fouten.

$ bewijzen -b --state=hot,opslaan

Tests die nooit zijn mislukt, worden niet geselecteerd. Om alle tests uit te voeren met de meeste
onlangs mislukt eerste gebruik

$ bewijzen -b --state=hot,all,save

Ook deze combinatie van mogelijkheden kan aldus worden gespecificeerd

$ bewijzen -b --state=adrian

"Alles"
Voer eventuele tests uit met todos.

"traag"
Voer de tests uit in de langzaamste naar de snelste volgorde. Dit is handig in combinatie met de "-j"
parallelle testschakelaar om ervoor te zorgen dat uw langzaamste tests als eerste worden uitgevoerd.

$ bewijzen -b --state=langzaam -j9

"snel"
Voer testtests uit in de snelste naar de langzaamste volgorde.

"nieuw"
Voer de tests uit in de volgorde van nieuw naar oud, op basis van de wijzigingstijden van de test
scripts.

"oud"
Voer de tests uit in de volgorde van oud naar nieuw.

"vers"
Voer de testscripts uit die zijn gewijzigd sinds de laatste testuitvoering.

"redden"
Bewaar de staat bij het verlaten. De status wordt opgeslagen in een bestand genaamd .bewijzen (_bewijzen op Windows
en VMS) in de huidige map.

De "--state"-schakelaar kan meerdere keren worden gebruikt.

$ bewijzen -b --state=hot --state=all,opslaan

--reglement
De optie "--rules" wordt gebruikt om te bepalen welke tests opeenvolgend worden uitgevoerd en welke
parallel, als de optie "--jobs" is opgegeven. De optie kan meerdere worden opgegeven
tijden, en de volgorde is belangrijk.

Het meest praktische gebruik zal waarschijnlijk specificeren dat sommige tests niet "parallel-ready" zijn.
Omdat het vermelden van een bestand met --rules er niet voor zorgt dat het wordt geselecteerd om als test te worden uitgevoerd, kunt u
kunt een aantal regelvoorkeuren in uw .proverc-bestand "instellen en vergeten". Dan zul je dat kunnen
maximaal profiteren van de prestatievoordelen van parallel testen, terwijl sommige
uitzonderingen worden nog steeds parallel uitgevoerd.

--reglement voorbeelden

# Alle tests mogen parallel worden uitgevoerd, behalve degene die beginnen met "p"
--rules='seq=t/p*.t' --rules='par=**'

# Alle tests moeten op volgorde worden uitgevoerd, behalve de tests die beginnen met "p", die parallel moeten worden uitgevoerd
--rules='par=t/p*.t'

--reglement resolutie

· Standaard kunnen alle tests parallel worden uitgevoerd. Geef uw eigen gegevens op
regels verwijdert deze.

· "Eerste wedstrijd wint". De eerste regel die bij een toets past, is degene die van toepassing is.

· Elke test die niet aan een regel voldoet, wordt aan het einde van de run op volgorde uitgevoerd.

· Het bestaan ​​van een regel impliceert niet dat er voor een test wordt gekozen. U moet nog steeds de
testen uit te voeren.

· Het specificeren van een regel om tests parallel te laten uitvoeren, zorgt er niet voor dat ze worden uitgevoerd
parallel. U moet nog steeds het aantal parallelle "taken" opgeven in uw Harness-object.

--reglement Glob-stijl patroon matching

We implementeren onze eigen glob-stijl patroonmatching voor --rules. Dit zijn de ondersteunde
patronen:

** is een willekeurig aantal tekens, inclusief /, binnen een padnaam
* is nul of meer tekens binnen een bestandsnaam/mapnaam
? is precies één teken binnen een bestandsnaam/mapnaam
{foo,bar,baz} is een van foo, bar of baz.
\ is een escape-teken

Details of vergevorderd specificaties voor parallel vs volgorde lopen reglement

Als u meer geavanceerd beheer nodig heeft van wat parallel of opeenvolgend wordt uitgevoerd, raadpleegt u de
bijbehorende 'regels'-documentatie in TAP::Harness en TAP::Parser::Scheduler. Als wat is
direct via "bewijzen" is niet voldoende, je kunt er je eigen harnas naar schrijven
rechtstreeks toegang tot deze functies.

@INC
bewijzen introduceert een scheiding tussen "opties doorgegeven aan de perl die bewijs uitvoert" en
"opties doorgegeven aan de perl die tests uitvoert"; dit onderscheid is inherent aan het ontwerp. Dus de
perl waarmee een test wordt uitgevoerd, begint met de standaard @INC. Extra bibliotheekmappen
kan worden toegevoegd via de omgevingsvariabele "PERL5LIB", via -Ifoo in "PERL5OPT" of via de
"-Ilib" optie om bewijzen.

bederven Mode
Normaal gesproken, wanneer een Perl-programma in de taint-modus wordt uitgevoerd, wordt de inhoud van de "PERL5LIB"
omgevingsvariabele verschijnt niet in @INC.

Omdat "PERL5LIB" vaak wordt gebruikt tijdens het testen om build-mappen toe te voegen aan @INC proof
geeft de namen van alle mappen in "PERL5LIB" door als -I-schakelaars. Het netto-effect van
dit is dat "PERL5LIB" wordt gerespecteerd, zelfs als het bewijs in de taint-modus wordt uitgevoerd.

FORMAAT

U kunt een aangepaste TAP::Parser::Formatter: laden

bewijzen --formatter MijnFormatter

BRON BEHANDELERS

U kunt aangepaste TAP::Parser::SourceHandlers laden om de manier te wijzigen waarop de parser interpreteert
bijzonder bronnen van TAP.

bewijzen --bron MyHandler --bron YetAnother t

Als u configuratie aan de bron wilt opgeven, kunt u het volgende gebruiken:

bewijzen --bron MyCustom \
--source Perl --perl-optie 'foo=bar baz' --perl-optie avg=0.278 \
--bronbestand --bestandsoptieextensies=.txt --bestandsoptieextensies=.tmp t
--bron pgTAP --pgtap-optie pset=format=html --pgtap-optie pset=border=2

Elke "--$source-option" optie moet een sleutel/waarde-paar specificeren, gescheiden door een "=". Als een
optie kan meerdere waarden aannemen, specificeer deze gewoon meerdere keren, zoals bij de "extensions="
voorbeelden hierboven. Als de optie een hash-referentie moet zijn, geeft u de waarde als tweede op
paar gescheiden door een "=", zoals in de "pset=" voorbeelden hierboven (escape "=" met een backslash).

Alle "--bronnen" worden gecombineerd tot een hash en doorgegeven aan "nieuw" in de "bronnen" van TAP::Harness
parameter.

Zie TAP::Parser::IteratorFactory voor meer informatie over hoe de configuratie wordt doorgegeven
BronHandlers.

PLUGINS

Plug-ins kunnen worden geladen met behulp van de "-Pinpluggen" syntaxis, bijvoorbeeld:

bewijzen -PMyPlugin

Hiermee wordt gezocht naar een module met de naam "App::Prove::Plugin::MyPlugin", of als dat niet lukt,
"MijnPlugin". Als de plug-in niet kan worden gevonden, zal "prove" klagen en afsluiten.

U kunt argumenten aan uw plug-in doorgeven door "=arg1,arg2,etc" aan de plug-innaam toe te voegen:

bewijzen -PMyPlugin=fou,du,fafa

Raadpleeg de afzonderlijke plug-indocumentatie voor meer details.

Beschikbaar Plugins
Voor een actuele lijst met beschikbare plug-ins, raadpleeg CPAN:

<http://search.cpan.org/search?query=App%3A%3AProve+Plug-in>

schrijf- Plugins
Zie "PLUGINS" in App::Prove.

Gebruik proofp online met behulp van onworks.net-services