Steven Haryanto > SHARYANTO-Roles-0.72 > SHARYANTO::Role::TermAttrs

Download:
SHARYANTO-Roles-0.72.tar.gz

Dependencies

Annotate this POD

Website

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.72   Source  

NAME ^

SHARYANTO::Role::TermAttrs - Role for terminal-related attributes

VERSION ^

version 0.72

DESCRIPTION ^

This role gives several options to turn on/off terminal-oriented features like whether to use UTF8 characters, whether to use colors, and color depth. Defaults are set from environment variables or by detecting terminal software/capabilities.

ATTRIBUTES ^

use_utf8 => BOOL (default: from env, or detected from terminal)

The default is retrieved from environment: if UTF8 is set, it is used. Otherwise, the default is on if terminal emulator software supports Unicode and language (LANG/LANGUAGE) setting has /utf-?8/i in it.

use_box_chars => BOOL (default: from env, or detected from OS)

Default is 0 for Windows.

interactive => BOOL (default: from env, or detected from terminal)

use_color => BOOL (default: from env, or detected from terminal)

For convenience, this attribute is "linked" with color_depth. Setting use_color will also set color_depth when the value is not ''/1/0 and matches color depth pattern. For example, setting use_color to 256 or '8bit' will also set color_depth to 256.

color_depth => INT (or STR, default: from env, or detected from terminal)

Get/set color depth. When setting, you can use string like '8 bit' or '24b' and it will be converted to 256 (2**8) or 16777216 (2**24).

For convenience, this attribute is "linked" with use_color. Setting color_depth to non-zero value will enable use_color, while setting it to 0 will disable use_color.

term_width => INT (default: from env, or detected from terminal)

term_height => INT (default: from env, or detected from terminal)

METHODS ^

detect_terminal() => HASH

Call Term::Detect::Software's detect_terminal_cached.

ENVIRONMENT ^

HOMEPAGE ^

Please visit the project's homepage at https://metacpan.org/release/SHARYANTO-Roles.

SOURCE ^

Source repository is at https://github.com/sharyanto/perl-SHARYANTO-Roles.

BUGS ^

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=SHARYANTO-Roles

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

AUTHOR ^

Steven Haryanto <stevenharyanto@gmail.com>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2014 by Steven Haryanto.

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

syntax highlighting: