Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Log digging helper

Project description


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

PyPI version build status codecov Checked with mypy Code style: black


pip3 install --upgrade scribehog


hog [options] logcategory [interval]

-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.


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

hog - Photo by Fabian Blank on Unsplash

Project details

Download files

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

Files for scribehog, version 1.4.3
Filename, size File type Python version Upload date Hashes
Filename, size scribehog-1.4.3-py3-none-any.whl (13.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size scribehog-1.4.3.tar.gz (8.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page