structas 0.1.0

A library for chopping logs.

structas🪵

A lightweight Python library that transforms unstructed log data into structured data, this can be ran locally, as a kubernetes sidecar or run as a service to parse logs for Data Engineering processes.

Install

uv pip install .  # or via pip/pipx/poetry.

Quick Start

1. Define your log structure in YAML:

structas sample > sample_logs.yaml

2. Parse logs with one command:

structas parse --structure <structure>.yaml --input <file_name> --format json

Python API

from structas import LogParser, StructureDefinition

# Parse logs with just three lines of code
structure = StructureDefinition.from_file("<structure>.yaml")
parser = LogParser(structure)
structured_data = parser.parse_file("<file>.log")