gsbparse

gsbparse is a Python library for parsing Grisbi .gsb accounting files into typed domain objects, with an optional pandas adapter for DataFrame output.

Features

• Parses every section defined in the Grisbi 2.3.2 format spec into frozen dataclasses.

• Resolves foreign-key integers to nested domain objects (DetailedTransaction.Ac is an Account, not a raw integer).

• Hexagonal architecture: pure domain layer, XML adapter, pandas adapter — swap output formats with a one-line import change.

• Tolerant reader: unknown XML tags log a warning and are skipped.

• Typed throughout — works with mypy strict mode.

Navigation

Contents

• Quickstart
  • Installation
  • Reading a file
  • Inspecting sections
  • Detailed transactions
  • Converting to pandas DataFrames
  • Error handling
  • Future output adapters
• API Reference
  • Top-level entry point
  • Domain objects
  • Section classes
  • Pandas adapter
  • Errors

Indices and tables

• Index

• Module Index