snakewatch

snakewatch v1.0.0 A log watcher


Keywords
log, tail
License
Other
Install
pip install snakewatch==1.0.0

Documentation

A log watcher written in Python

Allows RegEx-based line matching for various actions.

Configs are JSON files of the following format:

[
    {
        "regex": "<pattern>",
        "action": "<action>"[,
        "<argument>": "<value>"[, ...]
        ]
    }[, ...]
]

Currently supported ConsoleUI actions:

  • Print (with colours!) – prints the line to stdout
    • additional arguments: fore, back, and style (see colorama for a list of supported values)
  • Ignore – ignores the input line
  • Write – write the line to a file. Multiple actions can write to the same file (truncate must be the same).
    • additional arguments: truncate

Required action arguments:

  • regex – the regular expression to match against
  • action – the action to perform if the regex matches a line from the input

Optional action arguments:

  • continue – if set to true, matching will continue even if the action is called (default is false)

Example config for monitoring SASS output:

[
    {
        "regex": "^>>>.*",
        "action": "Print",
        "fore": "GRAY"
    },
    {
        "regex": "^\\s+error.*",
        "action": "Print",
        "fore": "WHITE",
        "back": "RED"
    },
    {
        "regex": ".*",
        "action": "Print",
        "fore": "YELLOW",
        "style": "DIM"
    }
]

Credits

colorama – Terminal output colours