endreymarcell/hog

Easily specify some log files and print their contents to stdout.

hog

Hog helps you specify the files you want to open when looking through your Scribe logs.

Install

pip3 install --upgrade scribehog

Usage

hog [options] logcategory [interval]

Options:
-h, --help Print usage information.
-v, --verbose Verbose logging.
-y, --verify Require user confirmation before printing the selected logs.

logcategory a hyphen-separated list of words or word prefixes to test against the hyphen- or underscore-separated logcategory names.
For example: if your logcategory is called alpha_bravo_charlie, you can match it with alpha-bravo-charlie, or just al-brav-c, maybe even a-b-c, as long as it's unambigious given the list of all logcategories.
Note that the order of the words does not matter, ie. al-br-ch and ch-br-al are the same.

interval a reference to the file or files you want to read. The default value is -1, meaning the most recent file. You can either use negative numbers as relative references like this, or specify a date and time in the format of hh, dd-hh, mm-dd-hh, or yyyy-mm-dd-hh. For example, you can pass -3 for the third most recent logfile, or 10-09 for the logfile on the 10th at 9:00 AM (note the leading 0 in the hour).

Ranges can also be specified by using a colon, eg. -3:-2 or 10-15:10-18.
Relative and absolute references can be freely mixed, eg. -10:12-31-20.
When omitting a reference from either side of the colon, the end of the list is assumed, just like in Python list slicing, eg. -5:.

You don't have to know if the specified files are gzip-compressed or not, hog takes care of that for you.
The contents are uniformly printed to stdout, so you can pipe the output into grep, less or whatever you need to use.

Development

Make sure you have Python (>=3.5) installed.
Clone the repository, then call make develop.

hog's Issues

Add interactive query prompt

so that you don't have to know in advance what your logcategory is called.

Unable to distinguis foo_bar from bar_foo

The order of keywords is not important, therefore foo-bar will match the foo_bar and bar_foo categories the same, and there's no way to differentiate between them. Let's update the logic so that when order is to only differentiating feature, then it does make a difference.

Extend date specifiers with wildcards

Currently there's no easy way to get all the logfiles from a specific day (if the day is specified, the hour is also required). This is a frequent use-case, hog should be extended to support this, eg. with some kind of wildcard syntax (11-27-*).