Metadata-Version: 2.1
Name: nef
Version: 0.1.4
Summary: CLI (simple command line client) for AWS cloudwatch logs
Home-page: https://gitlab.com/shindagger/nef
Author: Andy Klier
Author-email: andyklier@gmail.com
License: UNKNOWN
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
Requires-Dist: setuptools
Requires-Dist: string-color (>=0.2.7)

# nef  

simple command line client for aws cloudwatch logs.  

in the search for a cloudwatch CLI, you will find several other (3 as of writing this) tools:  
https://github.com/jorgebastida/awslogs  
https://github.com/winebarrel/cwli  
https://github.com/knqyf263/utern  

while these tools are great, they all have more features than i needed, and those i've tried are kind of complicated to figure out.  

my goal in writing `nef` was to have a command line tool that lets me view logs and log groups easily and quickly without logging into the aws web console. it amounts to a thin wrapper for the aws cli log command, which simplifies both the input and the output.  

see below for installation and usage info. see the project homepage for more info: https://gitlab.com/shindagger/nef  

# installation  

`pip install nef`  

# dependencies  

- aws cli
- python 3.6

# flags  

```
positional arguments:
  log            Which log group to view

optional arguments:
  -h, --help     show this help message and exit
  --start START  optional. give a start date and time.
                 format: YYYY-MM-DD HH:MM:SS
                 example: nef /path/to/log-group --start 2019-11-25
                 example 2: nef /path/to/log-group --start "2019-11-25 10:24"
                 example 3: nef /path/to/log-group --start "2019-11-25 10:24:32"
                 default (if arg not given): 2019-11-25 15:26:50
  --end END      optional. define an end date/time.
                 see --start for formatting info
  -c, --columns  show log groups in columns
  -j, --json     display output as json
  -v, --version  show program's version number and exit
  ```  

# usage   

`$ nef -h`  

show help message and exit.  

`$ nef`  

print out all log groups.   

`$ nef -c`  

print log groups in concise columnar format.  

`$ nef /path/to/log_group`   

show info (the last 24 hours) of the log group `/path/to/log_group`  

`$ nef /path/to/log_group --start 2019-11-25`   

show logs since the 25th of Nov 2019.  

`$ nef /path/to/log_group --start "2019-11-25 10:30"`  

optionally include a time part (be sure to wrap the string in quotes for the space).  

### example    

![Usage example][example]

[example]: https://believe-it-or-not-im-walking-on-air.s3.amazonaws.com/nef.gif "Usage example"  


