Convenience functions for ANSI terminal colour sequences [color].
Project description
Convenience functions for ANSI terminal colour sequences [color].
Latest release 20200729:
- New env_no_color() test function honouring the $NO_COLOUR envvar per https://no-color.org/
- colourise: get the "normal" default from the global NORMAL_COLOUR.
Mapping and function for adding ANSI terminal colour escape sequences to strings for colour highlighting of output.
Function colourise(s, colour=None, uncolour=None)
Return a string enclosed in colour-on and colour-off ANSI sequences.
colour
: names the desired ANSI colour.uncolour
: may be used to specify the colour-off colour; the default is 'normal' (fromNORMAL_COLOUR
).
Function colourise_patterns(s, patterns, default_colour=None)
Colourise a string s
according to patterns
.
Parameters:
s
: the string.patterns
: a sequence of patterns.default_colour
: if a string pattern has no colon, or starts with a colon, use this colour; default "cyan" (fromDEFAULT_HIGHLIGHT
).
Each pattern may be:
- a string of the form "[colour]:regexp"
- a string containing no colon, taken to be a regexp
- a tuple of the form
(colour,regexp)
- a regexp object
Returns the string with ANSI colour escapes embedded.
Function env_no_color(environ=None)
Test the $NO_COLOR
environment variable per the specification at
https://no-color.org/
Function make_pattern(pattern, default_colour=None)
Convert a pattern
specification into a (colour,regexp)
tuple.
Parameters:
pattern
: the pattern to parsedefault_colour
: the highlight colour, default "cyan" (fromDEFAULT_HIGHLIGHT
).
Each pattern
may be:
- a string of the form "[colour]:regexp"
- a string containing no colon, taken to be a regexp
- a tuple of the form
(colour,regexp)
- a regexp object
Function make_patterns(patterns, default_colour=None)
Convert an iterable of pattern specifications into a list of
(colour,regexp)
tuples.
Parameters:
patterns
: an iterable of patterns to parsedefault_colour
: the highlight colour, default "cyan" (fromDEFAULT_HIGHLIGHT
).
Each pattern may be:
- a string of the form "[colour]:regexp"
- a string containing no colon, taken to be a regexp
- a tuple of the form (colour, regexp)
- a regexp object
Release Log
Release 20200729:
- New env_no_color() test function honouring the $NO_COLOUR envvar per https://no-color.org/
- colourise: get the "normal" default from the global NORMAL_COLOUR.
Release 20180726: greater markdowning of docstrings
Release 20180725.2: some markdown, still release testing
Release 20180725.1: Trivial changes, testing release process.
Release 20180725: rename second colourise function to colourise_patterns, was shadowing things
Release 20180422:
- New function colourise to colour strings with regexp matches.
- New helper functions make_pattern and make_patterns to construct (colour, regexp)s from specifications.
- New public names NORMAL_COLOUR and DEFAULT_HIGHLIGHT.
Release 20170902: Release metadata changes.
Release 20160828: Add PyPI category, other minor tweaks.
Release 20150112: PyPI release.
Release 20150107: first standalone pypi release
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.