=pod

=encoding utf8

=head1 NAME

Test::More::YAMLScript - Write Perl tests in YAMLScript

=head2 SYNOPSIS

A file C<t/test.t>:

    #!/usr/bin/env test-more-yamlscript

    - plan: 10

    - pass: "This test will always 'pass'"

    - todo:
      - "Testing 'todo'"
      - fail: "This test will always 'fail'"

    - note: "NOTE: This is awesome"

    - diag: "This is a WARNING!"

    - ok(true, "Testing 'ok'")

    - is:
      - (2 + 2)
      - 4
      - "2 + 2 'is' 4"

    - isnt:
      - (2 + 2)
      - 5
      - "2 + 2 'isnt' 5"

    - like:
      - "I like pie!"
      - \#"\blike\b"
      - "Testing 'like'"

    - unlike:
      - "Please like me on Facebook"
      - \#"\bunlike\b"
      - "Testing 'unlike'"

    - skip:
      - "Skipping - Highway to the danger zone"
      - danger: zone

    - subtest:
      - "Testing skip-all in subtest"
      - skip-all: "Skipping all these subtests"
      - pass: "I wanna pass..."
      - fail: "Gonna fail..."

    - subtest:
      - "Testing 'subtests'"
      - pass: "Subtest 1"
      - pass: "Subtest 2"
      - pass: "Subtest 3"
      - done-testing: []

Run C<prove t/test.t>:

    t/test.t ..
    1..10
    ok 1 - This test will always 'pass'
    not ok 2 # TODO & SKIP Testing 'todo'
    # NOTE: This is awesome
    # This is a WARNING!
    ok 3 - Testing 'ok'
    ok 4 - 2 + 2 'is' 4
    ok 5 - 2 + 2 'isnt' 5
    ok 6 - Testing 'like'
    ok 7 - Testing 'unlike'
    ok 8 # skip Skipping - Highway to the danger zone
    # Subtest: Testing skip-all in subtest
        1..0 # SKIP Skipping all these subtests
    ok 9 # skip Skipping all these subtests
    # Subtest: Testing 'subtests'
        ok 1 - Subtest 1
        ok 2 - Subtest 2
        ok 3 - Subtest 3
        1..3
    ok 10 - Testing 'subtests'
    ok
    All tests successful.
    Files=1, Tests=10,  0 wallclock secs ( 0.02 usr  0.00 sys +  0.15 cusr  0.01 csys =  0.18 CPU)
    Result: PASS

Also works with C<yath t/test.t>.

=head2 DESCRIPTION

Test::More::YAMLScript let's you write Perl module tests in YAMLScript.

You just add this shebang line to a C<t/test-file.t>:

    #!/usr/bin/env test-more-yamlscript

=head2 AUTHORS

=over

=item * Ingy döt Net L<ingy@ingy.net|mailto:ingy@ingy.net>

=back

=head2 COPYRIGHT AND LICENSE

Copyright 2022-2023 by Ingy döt Net

This library is free software and may be distributed under the same terms as perl itself.

=cut
