Skip to main content

Colorize terminal text with regular expressions.

Project description

https://badge.fury.io/py/grec.png https://travis-ci.org/brisad/grec.png?branch=master https://pypip.in/d/grec/badge.png

Colorize terminal text with regular expressions.

Features

grec is similar to grep; the difference being that instead of printing matching lines in a file, grec colorizes lines. Lines that do not match any pattern are still printed, but without color.

The key feature that separates this utility from other similar ones is that it’s possible to colorize a matching string several times without letting previously matched colors mess up following regular expression matches.

Quick Start

Install with pip:

pip install grec

Print the contents of log_file.txt in its entirety but also colorize any occurrences of errors and warnings:

grec -m ERROR red -m WARN yellow log_file.txt

Or use a pipe:

cat log_file.txt | grec -m ERROR red -m WARN yellow -

To colorize strings in Python code, use the Matcher class from the grec package:

>>> from grec import Matcher
>>> m = Matcher()
>>> m.add_pattern('ERROR', 'red')
>>> m.add_pattern('WARN', 'yellow')
>>> print m.match('ERROR WARN INFO')
ERROR WARN INFO  (with color)

Command line

The command line interface is the following:

grec -m PATTERN COLOR_INFO [-m ... ] file

The -m argument

This argument takes a regular expression and color information. Here’s an example that will make all lines starting with the character “#” have a green color with white background:

-m '^#.*' green_on_white

Whenever a line matches the regular expression, the part of the line that matched is colorized with the color information. Any number of -m arguments can be specified, and colorization will be applied in the order specified on the command line.

The regular expression will be matched by the re module. So for each regular expression, only non-overlapping matches will be colorized. To get overlapping matches use several patterns by adding more -m arguments.

Color information consists of a foreground and optionally a background. Colorization is performed with the termcolor package and thus the following colors are supported: grey, red, green, yellow, blue, magenta, cyan, white.

To only set the foreground color, simply specify the name of the color. To also set a background color, add it to the foreground color. Use quotes or underlines to prevent the shell from interpreting it as several arguments. Examples:

-m <regex> blue_on_yellow
-m <regex> blue_yellow
-m <regex> 'blue on yellow'
-m <regex> 'blue yellow'

The file argument

This is the file to colorize. If “-” is specified, stdin will be read instead and can be used to colorize the output of a pipe.

TODO

  • Provide a way to colorize only groups in regular expression

  • Add support for attributes like blinking

  • Add support for only changing background color from CLI

  • Python 3 support

History

0.1.0 (2014-09-26)

  • First release on PyPI.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

grec-0.1.0.tar.gz (29.3 kB view details)

Uploaded Source

File details

Details for the file grec-0.1.0.tar.gz.

File metadata

  • Download URL: grec-0.1.0.tar.gz
  • Upload date:
  • Size: 29.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for grec-0.1.0.tar.gz
Algorithm Hash digest
SHA256 50e520eef86d18e5ccc28f65a9bbf409395b63538dbffe0eeacaa14906f2bd19
MD5 3ac93c2d692cb1e622d4117648e3b388
BLAKE2b-256 090ad3841b59782b3dc49fbe4c4ef37cd4b60203d853df02977c03786fef8105

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page