Badger::Rainbow - colour functionality

       Andy Wardley <http://wardley.org/>

       Copyright (C) 1996-2009 Andy Wardley.  All Rights Reserved.

       This module is free software; you can redistribute it and/or modify it under the same terms as Perl
       itself.

perl v5.36.0                                       2023-08-28                               Badger::Rainbow(3pm)

       This module implements colour-related functionality.  It is currently only used for debugging purposes
       but may be extended in the future.

ANSI_escape($code,$line1,$line2,...)
       This function applies an ANSI escape code to each line of text, with the effect of colouring output on
       compatible terminals.

           use Badger::Rainbow 'ANSI_escape';
           print ANSI_escape(31, 'Hello World');     # 31 is red

   strip_ANSI_escapes($text)
       This function removes any ANSI escapes from the text passed as an argument.

   ANSI
       This is an export hook which allows you to import subroutines which apply the correct ANSI escape codes
       to render text in colour on compatible terminals.

           use Badger::Rainbox ANSI => 'red green blue';

           print red("This is red");
           print green("This is green");
           print blue("This is blue");

       Available colours are: "black", "red", "green", "yellow", "blue", "magenta", "cyan", "white" and "grey".
       The "bold" and "dark" styles can also be specified.

           use Badger::Rainbox ANSI => 'dark bold red green blue';

           print bold red "Hello World\n";
           print dark blue "Hello Badger\n";

       Colours and styles can be specified as a single whitespace-delimited string or as a reference to a list
       of individual items.

           use Badger::Rainbox ANSI => 'red green blue';
           use Badger::Rainbox ANSI => ['red', 'green', 'blue'];

       All ANSI colours can be loaded by specifying "all".

           use Badger::Rainbox ANSI => 'all';

       Badger::Rainbow - colour functionality

           use Badger::Rainbow ANSI => 'red green blue';

           print red("This is red");
           print green("This is green");
           print blue("This is blue");