lsst.pex.config.history.Color Class Reference

Public Member Functions
	__init__ (self, text, category)
	__str__ (self)

Static Public Member Functions
	colorize (val=None)

Public Attributes
	rawText = str(text)
	color = color.lower().split(";")

Static Public Attributes
dict	categories
dict	colors

Protected Attributes
str	_code = "%s" % (30 + Color.colors[self.color])

Static Protected Attributes
bool	_colorize = True

Detailed Description

A controller that determines whether strings should be colored.

Parameters
----------
text : `str`
    Text content to print to a terminal.
category : `str`
    Semantic category of the ``text``. See `categories` for possible
    values.

Raises
------
RuntimeError
    Raised when the ``category`` is not a key of ``Color.categories``.

Notes
-----
The usual usage is ``Color(string, category)`` which returns a string that
may be printed; categories are given by the keys of `Color.categories`.

`Color.colorize` may be used to set or retrieve whether the user wants
color. It always returns `False` when `sys.stdout` is not attached to a
terminal.

Member Function Documentation

colorize()

lsst.pex.config.history.Color.colorize ( val = None )

static

Get or set whether the string should be colorized.

Parameters
----------
val : `bool` or `dict`, optional
    The value is usually a bool, but it may be a dict which is used
    to modify `Color.categories`.

Returns
-------
shouldColorize : `bool`
    If `True`, the string should be colorized. A string **will not** be
    colorized if standard output or standard error are not attached to
    a terminal or if the ``val`` argument was `False`.

    Only strings written to a terminal are colorized.

Member Data Documentation

categories

dict lsst.pex.config.history.Color.categories

static

Initial value:

=  {
        "NAME": "blue",
        "VALUE": "yellow",
        "FILE": "green",
        "TEXT": "red",
        "FUNCTION_NAME": "blue",
    }

colors

dict lsst.pex.config.history.Color.colors

static

Initial value:

=  {
        "black": 0,
        "red": 1,
        "green": 2,
        "yellow": 3,
        "blue": 4,
        "magenta": 5,
        "cyan": 6,
        "white": 7,
    }

---

The documentation for this class was generated from the following file:

• python/lsst/pex/config/history.py