Home

Awesome

Rust Version

drep is dynamic regular expression print

drep is grep with dynamic reloadable filter expressions. This allows filtering stream of logs/lines, while changing filters on the fly.

Filter is either a regex or plain text match, provided via input file.
Here is an example usage:

tail -f /var/log/nginx/error.log | drep -f /etc/drep/filters

Usually you will end up using this with your servers:

java -jar my-server.jar | drep -f server-filters

or

./uwsgi -s :8080 -w my_app  | drep -f server-filters

Filter file syntax

Each line of the filters file is an expression that starts with ~, =, !=, or !~. The matches will be done in the order filters written in the file, and if a filter matches subsequent filters won't be executed.

Everything else is ignored, as you can see from plain text. For regular expression documentation please refer to this document.

Why?

While grep --line-buffered can do something similar changing regex on the fly is not possible. Change filter regex on the fly is extremely useful in server/process environments where it's not possible to restart the process just to change the grep filter.

Building on unix philosophy drep does only one job well, given bunch of filter from an input file it can filter input lines to stdout.

Features

Usage example

Given following simple fizzbuzz.py:

import time

i = 1
while True:
    fb = ""
    if i % 3 == 0:
        fb = "fizz"
    if i % 5 == 0:
        fb = "{}buzz".format(fb)

    if fb:
        print("{}. {}".format(i, fb), flush=True)

    i = i + 1
    time.sleep(0.1)

We can launch and pipe it's output python fizzbuzz.py | drep -f filters. Now if the contents of filters are:

~\sfizz\n

drep will only emit logs with fizz. e.g.

642. fizz
648. fizz
651. fizz
654. fizz
...

While keeping the process running without exiting you can just modify filters to:

~\sbuzz\n

This will change the drep output on the fly to only emit buzz:

805. buzz
815. buzz
820. buzz
...

Building

Just clone the repo and run cargo build --release.