Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Perl 6 test suite
Perl6 Other
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
S01-perl-5-integration Use 'Perl5' as consistent name for EVAL and use :from
S02-lexical-conventions Replace more eval-dies-ok with throws-like
S02-lists change 'parcel' to 'raw' or 'list', depending
S02-literals Test to cover RT #120895.
S02-magicals Fix test that passed for the wrong reason on Win.
S02-names-vars Tests for RT #113892 and RT #115608.
S02-names Tests for RT #126523 do not die on Moar anymore
S02-one-pass-parsing Remove any Pugs fudges
S02-packages prefer RT #ticket
S02-types Merge branch 'resupply'
S03-binding Replace eval-dies-ok with throws-like in S03-binding/*
S03-feeds Remove dubious test
S03-junctions prefer RT #ticket
S03-metaops Revert "Fudge for the JVM so we can complete the test."
S03-operators test scaled tolerance on =~= and <=>
S03-sequence Expect Exception, not X::AdHoc.
S03-smartmatch prefer RT #ticket
S04-blocks-and-statements Replace more eval-dies-ok with throws-like (S04)
S04-declarations Fudge tests for 'will first' on JVM
S04-exception-handlers Test for X::AdHoc (with throws-like) instead of using eval-dies-ok
S04-exceptions Unfudge tests for JVM RT #126673, psch++
S04-phasers Fudge tests for FIRST phase on JVM, RT #126701
S04-statement-modifiers prefer RT #ticket
S04-statement-parsing s/lives_ok/lives-ok/g
S04-statements Fudge tests for JVM: Failures not handled as expected
S05-capture Tests to cover RT #88340.
S05-grammar Expect Exception, not X::AdHoc.
S05-interpolation Expect Exception, not X::AdHoc.
S05-mass Expect Exception, not X::AdHoc.
S05-match Tighten fudge for rakudo.jvm
S05-metachars Test for RT #122891.
S05-metasyntax test that <![a]> always matches at eos
S05-modifier Fudge test for match with *-1 index on JVM
S05-nonstrings Remove any Pugs fudges
S05-substitution Unfudge tests for JVM RT #126679, psch++
S05-syntactic-categories Expect Exception, not X::AdHoc.
S05-transliteration Replace some more eval-dies-ok with throws-like
S06-advanced Unfudge tests for JVM RT #126673, psch++
S06-currying Fudge for JVM: NPE in sub 'is-primed-call'
S06-macros Tweaks for PR#475 (new Exception code.)
S06-multi Tests for RT #74900.
S06-operator-overloading tests EVAL with %*LANG modifications
S06-other Replace some eval-dies-ok in S06-* with throws-like
S06-parameters Expect Exception, not X::AdHoc.
S06-routine-modifiers Replace some eval-dies-ok in S06-* with throws-like
S06-signature Add test for RT #125988.
S06-traits Fudge tests for correct exception on JVM, RT #126531
S07-iterators Remove all superstitious "done"s
S07-slip slip tests
S09-autovivification Fix creation of nested arrays in S09-autovivification/autoincrement.t
S09-hashes .list needed before indexing Seq
S09-multidim Tests for assignment to native shaped arrays.
S09-subscript Update test for GLR.
S09-typed-arrays Update tests for .flat behavior on native arrays.
S10-packages Unfudge a now-passing test.
S11-modules add tests for RT #126100
S12-attributes Test for RT #123757, correct a wrong test.
S12-class Add tests for RT #115310
S12-coercion Replace some eval-dies-ok in S12-* with throws-like
S12-construction prefer RT #ticket
S12-enums Expect Exception, not X::AdHoc.
S12-introspection Fix now-passing `of Foo` tests on vars.
S12-meta tests EVAL with %*LANG modifications
S12-methods Tests codifying decision on RT #119193.
S12-subset Fudge another test for role mixin on JVM
S12-traits Replace remaining eval-dies-ok with throws-like
S13-overloading Expect Exception, not X::AdHoc.
S13-syntax s/lives_ok/lives-ok/g
S13-type-casting Use isa-ok instead of isa_ok
S14-roles Unfudge test for RT #120919 on JVM
S14-traits prefer RT #ticket
S15-literals test for unival literals
S15-nfg Add streaming decode tests for \r\n handling.
S15-normalization Add generated normalization sanity tests.
S15-string-types .graphs is gone, remove tests and comments
S15-unicode-information Use existing RT number
S16-filehandles Fudge tests for for JVM
S16-io Bring basic print tests inline with new MMD setup
S16-unfiled fixed appended RT number to be within quoted string
S17-channel fix minor typo
S17-lowlevel Unfudge lock/join test
S17-procasync Test for RT #125515.
S17-promise Test for RT #125196.
S17-scheduler detach adverb from name it glommed onto
S17-supply Test :done argument to act.
S19-command-line-options Fix Windows line ending workarounds.
S19-command-line Bring basic -e tests inline with new MMD setup
S22-package-format use merged ticket #
S24-testing Replace last 'done' with 'done-testing'
S26-documentation Fix Windows line ending workarounds.
S28-named-variables s/lives_ok/lives-ok/g
S29-any Replace more eval-dies-ok with throws-like (S15/S29)
S29-context prefer RT #ticket
S29-conversions Z needs flat now
S29-os Test run/shell in sink context throw on failure.
S32-array Do not rely on order of @.unexpected in X::Adverb
S32-basics Fudge tests for typename in X::Assignment::RO on JVM
S32-container Also switch to current "LoL" standard.
S32-exceptions Enums are now augmentable
S32-hash Do not rely on order of @.unexpected in X::Adverb
S32-io Unfudge tests for rakudo.jvm
S32-list Add tests for List.head()
S32-num test that .narrow approximates on Complex and Num
S32-scalar remove a couple of test fossils
S32-str Fix index/rindex tests
S32-temporal prefer RT #ticket
S32-trig Replace some eval-dies-ok with throws-like in S32-*/*
integration Apparently the exception type has changed
packages A (over-simple) fake scheduler.
rosettacode Fix Windows line ending workarounds.
t Add more tests for fudging
.gitignore Remove any Pugs fudges
LICENSE Add Artistic License 2
README kebab case skip-rest
TODO Add a note about RTs.
fudge utilize does-ok test assertion
fudgeall Added quotes in case fudge path has spaces. (Tested on Linux and Win3…
test_summary avoid unnecessary differences in output


	The Official Perl 6 Test Suite (someday...)

This is the Official Perl 6 test suite. It evolved out of the pugs
test suite, and is now maintained in a separate repository.

Its purpose is to validate implementations that wish to be known
as a conforming Perl 6 implementation. 

Please consider this test suite to be the result
of an ongoing negotiation: since many of these tests are inspired
by seeing how the various prototype implementations are screwed up
(or even more likely, how the design of Perl 6 is screwed up), this
test suite should be considered a work in progress until one or more
of the implementations gets close to passing the entire test suite,
at which point we will freeze version 6.0 of the test suite, and any
implementation that passes it can then call itself Perl 6.

As they develop, different implementations will certainly be in
different states of readiness with respect to the test suite, so
in order for the various implementations to track their progress
independently, we've established a mechanism for "fudging" the
tests in a kind of failsoft fashion.  To pass a test officially,
an implementation must be able to run a test file unmodified, but an
implementation may (temporarily) skip tests or mark them as "todo" via
the fudging mechanism, which is implemented via the fudge preprocessor.
Individual implementations are not allowed to modify the actual test
code, but may insert line comments before each actual test (or block
of tests) that changes how those tests are to be treated for this
platform.  The fudge preprocessor pays attention only to the comments
that belong to the current platform and ignores all the rest.  If your
platform is named "humpty" then your special comment lines look like:

    #?humpty: [NUM] VERB ARGS

(The colon is optional.)

The optional NUM says how many statements or blocks to apply the
verb to.  (If not supplied, a value of 1 is assumed).  A statement
is arbitrarily defined as one or more lines starting with a test call
and ending in semicolon (with an optional comment).

VERBs include:

    skip "reason"	# skip test entirely
    eval "reason"	# eval the test because it doesn't parse yet
    try "reason"	# try the test because it throws exception
    todo "reason"	# mark "todo" because "not ok" is expected
    emit code		# insert code (such as "skip-rest();") inline

All fudged tests return an exit code of 1 by default, so the test harness
will mark it as "dubious" even if all the tests supposedly pass.

You may also negate the test:

    #!humpty: [NUM] VERB ARGS

This will apply the verb on any system that *isn't* humpty.

Sometimes environment variables distinguish syntactic or semantic
variants, so you may apply a verb depending on the presence or absence
of such a setting:


The environement variable must be uppercase.

There is also the following directive which modifies the test count of
the next construct:

    #?DOES count

The count may be an expression as long as any variables referenced in
the expression are in scope at the location fudge eventually inserts a
"skip()" call.

When applied to a subsequent sub definition, registers the sub name as
doing that many tests when called.  Note, however, that any skipping
is done at the point of the call, not within the subroutine, so the count
may not refer to any parameter of the sub.

When you run the fudge preprocessor, if it decides the test needs
fudging, it returns the new fudged filename; otherwise it returns
the original filename.  (Generally you don't run "fudge" directly,
but your test harness runs the "fudgeall" program for you; see below.)
If there is already a fudged program in the directory that is newer
than the unfudged version, fudge just returns the fudged version
without regenerating it.  If the fudged version is older, it removes
it and then decides anew whether to regenerate it based on the internal
fudge comments.

The "fudgeall" program may be called to process all the needed fudging
for a particular platform:

    fudgeall humpty */*.t */*/*.t

will use the "fudge" program to translate any fudged files to a new
file where the extension is not *.t but instead is *.humpty to indicate
the platform dependency.  It also returns the fudged list of filenames
to run, where unfudged tests are just passed through unchanged as *.t.
Each test comes through as either fudged or not, but never both.
The test harness then runs the selected test files as it normally
would (it shouldn't care whether they are named *.t or *.humpty).

In cases where the current working directory makes a difference, the tests
assume that the working directory is the root of the test suite, so that the
relative path to itself is t/spec/S\d\d-$section/$filename.
Something went wrong with that request. Please try again.