txt: ## dist_zef-raku-community-modules-Test-Notice.md
  [![Tests on source](https://github.com/raku-community-modules/Test-Notice/actions/workflows/test.yaml/badge.svg)](https://github.com/raku-community-modules/Test-Notice/actions/workflows/test.yaml)
  
  # NAME
  
  Test::Notice - Display noticable messages to users during tests
  
  # SYNOPSIS
  
  ```
      use Test::Notice;
      notice 'Install Foo::Bar::Baz for extra awesome features!';
      
      # Do not use colors
      notice 'Now without colors!', :!try-color;
  
  ```
  
  # DESCRIPTION
  
  This module lets you display highly visible messages to users during
  the run of your test, pausing long enough for them to read it.
  
  ![](sample.png)
  
  # EXPORTED SUBROUTINES
  
  ## `notice( Str $message, Bool :$try-color = True )`
  
  ```
      notice 'Install Foo::Bar::Baz for extra awesome features!';
  
  ```
  
  Takes one mandatory argument: the string to display in the message.
  Does not return anything meaningful. The message will be coloured if optional
  `Terminal::ANSIColor` is installed. The output also pauses long enough
  for an average reader to read the entire message (regardless of its length),
  unless `NONINTERACTIVE_TESTING` environmental variable is set.
  
  You can turn detection of the coloring module by setting `:try-color` to
  `False`.
  
  # LIMITATIONS
  
  The current implementation always assumes the terminal width of 80 characters.
  If you can figure out how to get the actual width when test is run with
  `prove`, patches are more than welcome.
  
  Currently, any amount of whitespace in the displayed message will be squashed
  into a single space.
  
  ---
  
  # REPOSITORY
  
  Fork this module on GitHub:
  <https://github.com/raku-community-modules/Test-Notice>
  
  # BUGS
  
  To report bugs or request features, please use
  <https://github.com/raku-community-modules/Test-Notice/issues>
  
  # AUTHOR
  
  Zoffix Znet (<http://zoffix.com/>)
  
  Currently maintained by the Raku Community Adoption devs.
  
  # LICENSE
  
  You can use and distribute this module under the terms of the
  The Artistic License 2.0. See the `LICENSE` file included in this
  distribution for complete details.
  