Documentation ¶
Overview ¶
Package blush searches for matches with colours.
Usage
$ blush -b "first search" -g "second one" -g "and another one" files/paths
Any occurrence of "first search" will be in blue, "second one" and "and another one" are in green.
Colouring Method ¶
With this method all texts are shown, but the matching words are coloured. You can activate this mode by providing "--colour" or "-C" argument.
Piping ¶
Blush can also read from a pipe:
$ cat FILENAME | blush -b "print in blue" -g "in green" -g "another green" $ cat FILENAME | blush "some text"
Arguments
+---------------+----------+------------------------------------------------+ | Argument | Shortcut | Notes | +---------------+----------+------------------------------------------------+ | --colour | -C | Colour, don't drop anything. | | N/A | -i | Case insensitive matching | | N/A | -R | Recursive | | --no-colour | N/A | Doesn't colourize matches. | | --no-filename | -h | Suppress the prefixing of file names on output | +---------------+----------+------------------------------------------------+
File names or paths are matched from the end. Any argument that doesn't match any files or paths are considered as regular expression. If regular expressions are not followed by colouring arguments are coloured based on previously provided colour:
$ blush -b match1 match3 FILENAME
Please Note ¶
If no colour is provided, blush will choose blue. If you only provide file/path, it will print them out without colouring. If the matcher contains only alphabets and numbers, a non-regular expression is applied to search.
Colour Groups ¶
You can provide a number for a colour argument to create a colour group:
$ blush -b1 match1 -b2 match2 -b1 match3 FILENAME
All matches will be shown as blue. But `match1` and `match3` will have a different background colour than `match2`. This means the numbers will create colour groups.
You also can provide a colour with a series of grep requests:
$ blush -b match1 match3 -g match2 FILENAME
Colours ¶
You can choose a pre-defined colour, or pass it your own colour with a hash:
+-----------+----------+ | Argument | Shortcut | +-----------+----------+ | --red | -r | | --green | -g | | --blue | -b | | --white | -w | | --black | -bl | | --yellow | -yl | | --magenta | -mg | | --cyan | -cy | | --#11bb22 | --#1b2 | +-----------+----------+
Complex Grep ¶
You must put your complex grep into quotations:
$ blush -b "^age: [0-9]+" FILENAME
Directories ¶
Path | Synopsis |
---|---|
Package blush reads from a given io.Reader line by line and looks for patterns.
|
Package blush reads from a given io.Reader line by line and looks for patterns. |
Package cmd bootstraps the application.
|
Package cmd bootstraps the application. |
internal
|
|
tools
Package tools contains common tools used throughout this application.
|
Package tools contains common tools used throughout this application. |