---
id: table-logger
version: "0.3.6"
license: GNU GPL 2.0
license_treatment: copyleft
maintenance: dormant
---

# table-logger — TableLogger is a handy Python utility for logging tabular data into a console or a file.

License: copyleft · Maintenance: dormant · Downloads: 155.9K/mo

## What it is and what it does

TableLogger is a lightweight utility for printing structured data as formatted tables in the console or writing to CSV files. It handles alignment, type-specific formatting (dates, floats, strings), and optional metadata columns (row numbers, timestamps, time deltas) with minimal configuration. The package depends on numpy and is designed for simple tabular logging tasks where you want readable output without heavy dependencies.

The library is in production/stable status but dormant—last updated in 2019 with no active maintenance. It supports Python 2.7 and 3, though compatibility with modern Python versions is unverified. Installation is straightforward via pip with low friction, but the copyleft GPL 2.0 license means any project using it must also be GPL-compatible.

Use it for:

- Log experiment results or metrics to console during processing with automatic alignment and formatting.
- Export structured data to CSV files with proper escaping and type formatting.
- Display multi-column status updates in long-running scripts with optional row counts and elapsed time.
- Format and print database query results or API responses as readable tables without external dependencies.
- Create simple formatted reports in batch scripts where heavier libraries are unwanted.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

TableLogger formats and outputs tabular data to console or file with minimal setup, handling alignment and formatting of mixed data types automatically.

Yes, if you need lightweight tabular logging and accept the GPL 2.0 copyleft constraint. The package is stable and low-friction to install, but dormant maintenance means no active support for modern Python versions or bug fixes. Suitable for internal tools and GPL-compatible projects; avoid in proprietary codebases due to license incompatibility.

## Install

pip install table-logger
uv add table-logger
poetry add table-logger

## Installing table-logger

Before you install: Low friction installation with a single runtime dependency (numpy). Maintenance is dormant—last release was 2019-08-26 and no commits since 2023-09-29—so expect no active bug fixes or feature updates.

License in practice: Licensed under GNU GPL 2.0 (copyleft). Any code that imports and uses this package must also be distributed under a compatible copyleft license; proprietary or permissively-licensed projects may face licensing conflicts.

Quickstart:

from table_logger import TableLogger
import numpy

tbl = TableLogger(columns='a,b,c')
tbl(1, 'Row1', 3.14)
tbl(2, 'Row2', 1.5)

Verify before relying:

- Whether numpy is truly required at runtime or only for development/testing
- Current compatibility with Python 3.10+ given last release predates modern versions
- Whether dormant status means the package is stable enough for production use or abandoned

## Package facts

- License: GNU GPL 2.0 (copyleft)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 155.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

tabular data logging, console table formatting, structured data output, formatted table printer, csv logging utility, data table display, console logging tables, tabular-output, logging-utility, gpl-copyleft

[View on SkillFed](https://skillfed.io/packages/table-logger) · [View on PyPI](https://pypi.org/project/table-logger/)