termcolor

Termcolor

Termcolor es una biblioteca C ++ de solo encabezado para imprimir mensajes de colores en la terminal. Escrito solo por diversión con la ayuda de la fuerza. Termcolor utiliza el formato de color ANSI, por lo que puede usarlo en cada sistema que se utilice tales terminales (la mayoría de los sistemas *Nix, incluidos Linux y Mac OS).

Nota

En Windows, se usa la API de Windows en lugar de los códigos de escape, pero se aplican algunas limitaciones (no todo es compatible). Es por eso que se recomienda ingresar al modo de procesamiento de terminal virtual y establecer TERMCOLOR_USE_ANSI_ESCAPE_SEQUENCES para engañar a TermColor para usar códigos de color ANSI.

Tiene licencia bajo la licencia BSD (3 cláusula). Eso básicamente significa: Haz lo que quieras siempre que los derechos de autor se queden.

Instalación

• Agregue termcolor.hpp (agarrarlo de include/termcolor/termcolor.hpp ) al proyecto y usar manipuladores de flujo desde el espacio de nombres termcolor .

• También puede usar VCPKG para instalar la biblioteca:

  $ vcpkg install termcolor

• O si está en MacOS, puede usar Homebrew para ese propósito:

  $ brew install termcolor

• Para obtener información actualizada sobre los paquetes existentes, consulte la siguiente imagen:

¿Cómo usar?

Es muy fácil de usar. La idea se basa en los manipuladores de la corriente C ++. La aplicación típica de «Hello World» se ve así:

# include < iostream >
# include < termcolor/termcolor.hpp >

int main ( int /* argc */ , char ** /* argv */ )
{
    std::cout << termcolor::red << " Hello, " ;                   // 16 colors
    std::cout << termcolor::color< 100 > << " Colorful " ;          // 256 colors
    std::cout << termcolor::color< 211 , 54 , 130 > << " World! " ;    // true colors
    std::cout << std::endl;
    return 0 ;
}

La aplicación anterior imprime una cadena usando diferentes colores. Sin embargo, hay una advertencia. No debe olvidar restablecer los colores, de lo contrario también se aplicarán a otras impresiones.

std::cout << termcolor::red << " Hello, Colorful World! " << std::endl;
std::cout << " I'm RED too! " << std::endl;

La versión correcta del código anterior debería verse así:

std::cout << termcolor::red << " Hello, Colorful World! " << termcolor::reset << std::endl;
std::cout << termcolor::reset << " Here I'm! " << std::endl;

Por defecto, TermColor ignora cualquier color para transmisiones que no son TTY (por ejemplo std::stringstream ), por lo que el siguiente fragmento

std::stringstream ss;
ss << termcolor::red << " unicorn " ;
std::cout << ss.str();

Imprimirá «unicornio» usando color predeterminado, no rojo. Para cambiar este comportamiento, se puede usar termcolor::colorize Manipulator que hace cumplir los colores sin importar qué.

¿Qué manipuladores son apoyados?

Los manipuladores se dividen en cuatro grupos:

• primer plano , que cambia el color del texto;
• fondo , que cambia el color de fondo de texto;
• atributos , que cambian de estilo de texto (en negrita, subrayan, etc.);
• control , que cambia el comportamiento de Termcolor.

Además, hay manipuladores de color para 16 colores, 256 colores y paletas de colores verdaderos.

Nota

Si bien termcolor admite el color verdadero, es necesario que el emulador terminal que usa para ejecutar su software también admite el color verdadero. Por lo tanto, asegúrese de que sea compatible antes de presentar un problema.

Manipuladores de primer plano

16 colores

1. termcolor::grey
2. termcolor::red
3. termcolor::green
4. termcolor::yellow
5. termcolor::blue
6. termcolor::magenta
7. termcolor::cyan
8. termcolor::white
9. termcolor::bright_grey
10. termcolor::bright_red
11. termcolor::bright_green
12. termcolor::bright_yellow
13. termcolor::bright_blue
14. termcolor::bright_magenta
15. termcolor::bright_cyan
16. termcolor::bright_white

256 colores

1. termcolor::color<256_COLOR_CODE>

verdaderos colores

1. termcolor::color<RED, GREEN, BLUE>

Manipuladores de fondo

16 colores

1. termcolor::on_grey
2. termcolor::on_red
3. termcolor::on_green
4. termcolor::on_yellow
5. termcolor::on_blue
6. termcolor::on_magenta
7. termcolor::on_cyan
8. termcolor::on_white
9. termcolor::on_bright_grey
10. termcolor::on_bright_red
11. termcolor::on_bright_green
12. termcolor::on_bright_yellow
13. termcolor::on_bright_blue
14. termcolor::on_bright_magenta
15. termcolor::on_bright_cyan
16. termcolor::on_bright_white

256 colores

1. termcolor::on_color<256_COLOR_CODE>

verdaderos colores

1. termcolor::on_color<RED, GREEN, BLUE>

Manipuladores de atributos

(La API de Windows no es compatible con estos manipuladores, excepto el underline )

1. termcolor::bold
2. termcolor::dark
3. termcolor::italic
4. termcolor::underline
5. termcolor::blink
6. termcolor::reverse
7. termcolor::concealed
8. termcolor::crossed

Manipuladores de control

(La API de Windows no es compatible con estos manipuladores)

1. termcolor::colorize
2. termcolor::nocolorize

Advertencias

1. En Windows, debido al uso interno de <windows.h> , el espacio de nombres global podría contaminarse con macros Min/Max. Si dicho efecto es deseable, considere usar #define NOMINMAX antes de #include <termcolor.hpp> .