txt: ## dist_zef-lizmat-Test-Assertion.md
  [![Actions Status](https://github.com/lizmat/Test-Assertion/workflows/test/badge.svg)](https://github.com/lizmat/Test-Assertion/actions)
  
  # NAME
  
  provide 'is test-assertion' trait for older Rakus
  
  # SYNOPSIS
  
  ```
  use Test;
  use Test::Assertion;
  
  sub foo-test() is test-assertion {  # will never be compile-time error
      subtest "we do many tests" => {
          flunk "failed this one";    # <-- points here if doesn't work
      }
  }
  
  foo-test();  # <-- points here if test-assertion *does* work
  
  ```
  
  # DESCRIPTION
  
  Test::Assertion is a module that provides the `is test-assertion` trait for subroutines, which was introduced in Rakudo 2020.10, to older versions of Raku. This allows module authors to use the `is test-assertion` trait in a module without having to worry whether the version of Raku actually supports that trait.
  
  If a distribution does not use any external testing functionality, then this module should probably be added as a dependency to the "test-depends" section of the META information of a module, as it will (most likely) only be needed during testing.
  
  If this module is used by a distribution that is geared towards offering additional testing facilities, then clearly this module must be listed in the "depends" section.
  
  Please note that this does **not** actually implement the `is test-assertion` error reporting logic: it merely makes sure that the use of the trait will not be a compile time error in the test-file where it is being used.
  
  # AUTHOR
  
  Elizabeth Mattijsen [liz@raku.rocks](mailto:liz@raku.rocks)
  
  Source can be located at: <https://github.com/lizmat/Test-Assertion> . Comments and Pull Requests are welcome.
  
  If you like this module, or what I’m doing more generally, committing to a [small sponsorship](https://github.com/sponsors/lizmat/) would mean a great deal to me!
  
  # COPYRIGHT AND LICENSE
  
  Copyright 2020, 2021, 2024 Elizabeth Mattijsen
  
  This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.
  