Metadata-Version: 2.1
Name: histy
Version: 1.0.2
Summary: A command-line tool for generating histograms from timestamped logs
Home-page: https://github.com/fmhall/histy
Author: Mason Hall
Author-email: masonhall@gmail.com
License: UNKNOWN
Description: <p align="center">
          <a href="https://github.com/fmhall/histy/blob/master/LICENSE">
            <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="histy is released under the MIT license." />
          </a>
          <a>
            <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs welcome!" />
          </a>
          <a href="https://badge.fury.io/py/histy">
            <img src="https://badge.fury.io/py/histy.svg" alt="PyPI version" height="18">
          </a>
          <a href="https://python.org">
            <img alt="Python" src="https://img.shields.io/badge/Python-3.6%20%7C%203.7-blue">  
          </a>
        </p>
        
        # Histy
        
        Histy is a command line tool for generating histogram plots from timestamped logs. 
        Timestamps must be in ISO format.
        Histy is useful for quick visual analysis of log frequencies from the command line
        
        ### Installation (Requires Python 3.6+ and pip)
        `pip install histy`
        ### Parameters:
        `--bucket_time_s` or `-b` : the duration of each histogram bucket in seconds 
        
        ### Sample usage:
        ```bash
        cat server.log | histy -b 60
        ```
        
        ```bash
        docker logs my-app --since "2020-01-06 12:37:30" --until "2020-01-06 12:38:30" | histy -b 10
        ```
        
        Output:
        ```
        Histogram:
        2020-01-15T03:13:01  :  ######### 63
        2020-01-15T03:13:11  :  ###### 41
        2020-01-15T03:13:21  :  #### 28
        2020-01-15T03:13:31  :  ##### 34
        2020-01-15T03:13:41  :  ############# 88
        2020-01-15T03:13:51  :  ######### 61
        2020-01-15T03:14:01  :  ########################## 181
        2020-01-15T03:14:11  :  ###################################################################### 470
        2020-01-15T03:14:21  :  #### 31
        2020-01-15T03:14:31  :  ######## 54
        2020-01-15T03:14:41  :  ####### 48
        2020-01-15T03:14:51  :   5
        
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
