Metadata-Version: 2.1
Name: watchlogs
Version: 0.1.3.10
Summary: A simple, colourful logfile watcher
Home-page: https://github.com/albanie/watchlogs
Author: Samuel Albanie
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.6
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: colored
Requires-Dist: seaborn
Requires-Dist: pygtail

## watchlogs

`watchlogs` is a simple command line utility for watching multilpe log files and interleaving their contents to `stdout` as each log is appended to.  It aims to achieve the functionality of `tail -F`, but with more colour.

### Usage

`watchlogs --log_files /path/to/log1.txt,/path/to/log2.txt,....`

 <img src="misc/demo.gif" height="350">

### Installation

Install via `pip install watchlogs`.  If you prefer to hack around with the source code, it's a [single python file](watchlogs/watchlogs.py).

### Behaviour

`watchlogs` has the following behaviour when `log.txt` is updated (assuming that `watchlogs --log_files log.txt` has been run):

* action: *appending* (**supported**) `echo "x" >> log.txt` (prints `x` to screen)


* action: *moving/rotating* (**supported**) `touch log2.txt ; echo "y" > log2.txt ; mv log2.txt log.txt` (prints`y` to screen)

* action: *overwritng in-place* (**not supported**): `echo "z" > log.txt` (`z` is lost)

### Implementation


`watchlogs` uses the [pygtail](https://github.com/bgreenlee/pygtail) library to monitor OS events.  


### Dependencies

* `Python >= 3.6`
* `seaborn`
* `colored`
* `pygtail`


