Metadata-Version: 2.4
Name: logpeek
Version: 0.1.1
Summary: A colorful CLI log viewer with filtering and follow mode
Author-email: Clemdevlin <clemdevlin0@gmail.com>
License: MIT
Keywords: cli,devtools,logs,terminal
Requires-Python: >=3.9
Requires-Dist: click>=8.3.2
Provides-Extra: dev
Requires-Dist: build; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: twine; extra == 'dev'
Description-Content-Type: text/markdown

# logpeek

A colorful CLI log viewer with filtering and follow mode.

```
logpeek app.log
logpeek app.log --level ERROR
logpeek app.log -f -n 20
logpeek app.log -i "database" -e "debug"
cat app.log | logpeek
```

## Install

```bash
pip install logpeek
# or
uv add logpeek
```

## Usage

```
Usage: logpeek [OPTIONS] [FILE]

  logpeek — colorful log viewer

  Read a log FILE (or stdin) and pretty-print it with color-coded levels.

Options:
  --version               Show the version and exit.
  -f, --follow            Follow file (like tail -f).
  -n, --lines INTEGER     Show last N lines before following (use with -f).
  -i, --include TEXT      Only show lines containing this text.
  -e, --exclude TEXT      Hide lines containing this text.
  --level [DEBUG|INFO|WARNING|ERROR|CRITICAL]
                          Only show lines at this log level.
  --no-color              Disable colored output.
  --help                  Show this message and exit.
```

## Log level colors

| Level    | Color   |
|----------|---------|
| DEBUG    | Cyan    |
| INFO     | Green   |
| WARNING  | Yellow  |
| ERROR    | Red     |
| CRITICAL | Magenta |

## License

MIT
