//!
//! the mark up text with color program.
//!
//! ```text
//! Usage:
//! aki-mcolor [options]
//!
//! mark up text with color
//!
//! Options:
//! -r, --red <exp> write it in red
//! -g, --green <exp> write it in green
//! -b, --blue <exp> write it in blue
//! -c, --cyan <exp> write it in cyan
//! -m, --magenda <exp> write it in magenda
//! -y, --yellow <exp> write it in yellow
//! -u, --unmark <exp> write it in non-color
//!
//! -H, --help display this help and exit
//! -V, --version display version information and exit
//!
//! Option Parameters:
//! <exp> regular expression, color the entire match.
//!
//! Environments:
//! AKI_MCOLOR_COLOR_SEQ_RED_ST red start sequence specified by ansi
//! AKI_MCOLOR_COLOR_SEQ_GREEN_ST greep start sequence specified by ansi
//! AKI_MCOLOR_COLOR_SEQ_BLUE_ST blue start sequence specified by ansi
//! AKI_MCOLOR_COLOR_SEQ_CYAN_ST cyan start sequence specified by ansi
//! AKI_MCOLOR_COLOR_SEQ_MAGENDA_ST magenda start sequence specified by ansi
//! AKI_MCOLOR_COLOR_SEQ_YELLOW_ST yellow start sequence specified by ansi
//! AKI_MCOLOR_COLOR_SEQ_ED color end sequence specified by ansi
//! ```
//!
//! # Examples
//!
//! ### Command line example 1
//!
//! Makes "`ca`" **red** and "`b`" **green** in standard input text.
//!
//! ```text
//! echo "abcabca" | aki-mcolor -r "ca" -g "b"
//! ```
//!
//! result output :
//!
//! ![out abcabca image]
//!
//! [out abcabca image]: https://raw.githubusercontent.com/aki-akaguma/aki-mcolor/main/img/out-abcabca-1.png
//!
//!
//! ### Command line example 2
//!
//! Extract "`arm`" from the rustup target list and make "`musl`" **green** and "`android`" **cyan**.
//!
//! ```text
//! rustup target list | aki-mline -e arm | aki-mcolor -g "musl" -c "android"
//! ```
//!
//! result output :
//!
//! ![out rustup image]
//!
//! [out rustup image]: https://raw.githubusercontent.com/aki-akaguma/aki-mcolor/main/img/out-rustup-1.png
//!
//! - [aki-mline](https://crates.io/crates/aki-mline): extract match line command like grep.
//!
//! ### Library example
//!
//! See [`fn execute()`] for this library examples.
//!
//! [`fn execute()`]: crate::execute
//!
extern crate anyhow;
use HelpVersion;
use *;
use Write;
const TRY_HELP_MSG: &str = "Try --help for help.";
///
/// execute mcolor
///
/// params:
/// - sioe: stream in/out/err
/// - program: program name. etc. "mcolor"
/// - args: parameter arguments.
///
/// return:
/// - ok: ()
/// - err: anyhow
///
/// example:
///
/// ```
/// use runnel::RunnelIoeBuilder;
///
/// let r = libaki_mcolor::execute(&RunnelIoeBuilder::new().build(),
/// "mcolor", &["-r", "Error", "-g", "Warn"]);
/// ```
///