colorist - Add colors to your plain old output
version 0.141760
colorist [ options ] files... Options: -c --configuration - name the configuration to use -R --ruleset - name the colorist ruleset to use -C --colorset - name the colorist colorset to use -I --include - add a directory to the config search path -e --execute - the remaining arguments are a command to run -E --stderr - when running a command, colorize STDERR too --debug - turn on debugging (you probably don't want to)
Before this application will work, it must be configured. See App::Colorist for information on getting started with existing configuration or writing your own.
This is a script to colorize a file or command output in place. There are three basic ways to use this command.
The common intended use is to work as a tool for running other programs and capturing their output. For example, to colorize the output of the cpanm program, you can perform the following (if you have the configuration for this command available in your .colorist directory):
cpanm
alias cpanm="colorist -E cpanm" cpanm App::Colorist
Now, anytime cpanm is run, it will have it's output colorized.
You can colorize arbitrary files, so if you want to colorize a log file you have configured:
colorist -c errorlog error.log error-20140622.log error-20140621.log
Each file on the command-line will be read and colorized in order. You might want to pipe to less after doing this. When doing this, you must use the -c option to name which colorist configuration should be used to colorize the lines.
less
-c
You can colorize any input piped into the program as well:
cat error.log | colorist -c errorlog
As with the previous example, you must pass the -c option to name the configuration to use.
For example,
-c cpanm
This names the set of configuration files to use. This is the name of the sub-directory containing the rulesets and colorsets used to configure colorist. The actual locations of the directories containing colorist configuration are described in "Finding Configuration" in App::Colorist.
-R rules
Each named configuration may contain more than one ruleset. If this option is not set, the ruleset named "rules" will be used.
-C colors
Each named configuration may contain more than one colorset (or color theme, if you prefer). If this option is not set, the colorset named "colors" will be used.
-I $HOME/colorist-configs
Normally, only /etc/colorist and ~/.colorist are searched for colorist configuration. With this option set, it will look in other directories you name.
If this flag is set, the additional arguments on the command line are treated as a command name and arguments to pass to it during execution. The standard output stream of the command will be captured and colored.
This flag implies -e. In addition to capturing standard out, this will also capture standard error and colorize it too.
-e
You probably don't want to bother with this. It is primarily helpful for testing, though it might be helpful in testing colorist configurations. Instead of colorizing the output, the output will have notation like "{10}" added where each color would be. The number inside is the ANSI color number that would have been used normally. Also "{reset}" is used when the ANSI reset code would be sent.
This application will read a single environment variable, COLORIST_CONFIG, which is basically identical to passing an --include option to the command-line. It is a colon-separated list of paths that will be searched for configuration.
COLORIST_CONFIG
--include
Andrew Sterling Hanenkamp <hanenkamp@cpan.org>
This software is copyright (c) 2014 by Qubling Software LLC.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install App::Colorist, copy and paste the appropriate command in to your terminal.
cpanm App::Colorist
CPAN shell
perl -MCPAN -e shell install App::Colorist
For more information on module installation, please visit the detailed CPAN module installation guide.