logan-iq 1.0.3

Python command-line tool for parsing, filtering, summarizing, and exporting log files.

Logan-IQ: Log Analyzer Tool

A Python command-line tool for parsing, filtering, summarizing, and exporting log files. Designed to handle multiple log formats with custom regex support and user-configurable preferences.

⚠️ Notice About Installation

Version 1.0.1 contains unintended scripts and should not be used.
Please use 1.0.2 or later for correct functionality.

Features

• Parse logs using regex patterns (default or custom)
• Filter logs by level, date range, or limit
• Generate summary tables
• Export logs to CSV or JSON
• Interactive CLI
• Colorful output and clean formatting
• Easily testable and extensible

Install

Package is available on PyPI

pip install logan-iq

This installs the CLI globally and makes the logan-iq command available in your terminal.

How it Works

Core flow:

1. Load Config or Defaults: Loads user preferences from config.json if it exists. CLI arguments always override the config file. If no file is provided and no config exists, the app prompts the user to specify a file.
2. Parse Log File:

Each log line is converted into a structured dictionary with fields like datetime, level, message,and optionally ip or other fields depending on the format.

3. Filter (Optional):

Narrow results by log level, date range, or limit the number of entries displayed.

4. Analyze or Summarize:

Display logs in a terminal table or generate summary reports.

5. Export (Optional):

Export filtered data to CSV or JSON for further analysis.

Available Formats

You can supply your own regex directly via CLI or in config.json. Or use the Built-in formats:

• simple → generic logs with datetime, level and message

2025-08-28 12:34:56 [INFO] Server started: Listening on port 8080

• apache → Apache access logs (common format)

192.200.2.2 - - [28/Aug/2025:12:34:56 +0000] "GET /index.html HTTP/1.1" 200 512

• nginx → Nginx access logs (combined format, includes referrer & user-agent)

192.100.1.1 - - [28/Aug/2025:12:34:56 +0000] "GET /index.html HTTP/1.1" 200 1024 "http://example.com" "Mozilla/5.0"

• custom → Any user-defined regex Example (inline via CLI):

python main.py analyze --file logs/app.log --format custom --regex "^(?P<ts>\S+) (?P<level>\w+) (?P<msg>.*)$"

Or define in config.json:

{
  "default_file": "logs/custom_app.log",
  "format": "custom",
  "custom_regex": "^(?P<ts>\\S+) (?P<level>\\w+) (?P<msg>.*)$"
}

Running the CLI

Once installed, commands can be run directly via logan-iq:

• For Interactive Mode

logan-iq interactive
logan-iq>> analyze --file logs/access.log --format nginx

• Analyze Logs

logan-iq analyze --file path/to/logfile.log --format apache

• Custom Regex

logan-iq analyze --file app.log --format custom --regex "^(?P<ts>\\S+) (?P<msg>.*)$"

• Summarize Log Levels

logan-iq summarize --file path/to/logfile.log

• Export Logs

logan-iq export --file path/to/logfile.log --output-format csv --output-path logs.csv

Configuration

On installation, a config.json is created on the user's system.

• To show configurations

logan-iq interactive
logan-iq>> config show

• To modify configurations

logan-iq>> config set --default-file logs/access.log --format nginx
logan-iq>> config set --format custom --custom-regex "^(?P<ts>\\S+) (?P<msg>.*)$"

Example with built-in format:

{
  "default_file": "logs/server_logs.log",
  "format": "nginx"
}

Example with custom format:

{
  "default_file": "logs/app.log",
  "format": "custom",
  "custom_regex": "^(?P<ts>\\S+) (?P<msg>.*)$"
}

• CLI args always override config values.

• If neither CLI args nor config exist, the app prompts for a file.

Testing

Run tests from root directory:

pytest -s

• Validates parsing, filtering, summarization, export, and error handling.
• Editable install ensures tests can import modules with absolute imports.

Project Structure

.
├── src/logan_iq/          # Core logic
│   ├── __init__.py
│   ├── __main__.py            # CLI entry point
│   ├── core/
│   │    ├── analyzer.py
│   │    ├── parser.py
│   │    ├── filter.py
│   │    ├── summary.py
│   │    ├── exporter.py
│   │    └── config.py
│   │    └── helpers.py
│   └── tests/                 # Unit tests
├── LICENSE
├── README.md
├── pyproject.toml
└── venv/                      # Virtual environment (optional)

Dependencies

• CLI built with Typer
• Pretty tables via Tabulate
• Colored output via PyFiglet
• Unit testing via Pytest

---

Developed by heisdanielade

---