Skip to content

Document the rowalign parameter in tabulate() - #505

Open
HendyGH wants to merge 1 commit into
astanin:masterfrom
HendyGH:docs/rowalign
Open

HendyGH wants to merge 1 commit into
astanin:masterfrom
HendyGH:docs/rowalign

Conversation

@HendyGH

@HendyGH HendyGH commented Nov 10, 2026

Copy link
Copy Markdown

rowalign controls the vertical alignment of cell text in multiline rows, but it is not mentioned in the tabulate() docstring or the README — the only references in the repo are the signature check in test_api.py and test_fancy_grid_multiline_row_align. This adds a 'Row alignment' section to the tabulate() docstring describing the accepted values ("top" (default), "center", "bottom"), the single-string (all rows) vs per-row list forms (None in the list means the default for that row), that single-line rows are unaffected, and that it only takes effect in formats that draw a line between rows (e.g. grid, fancy_grid). Scope: documentation only, one file (tabulate/__init__.py), no behaviour change. No >>> examples were added, since the repo runs pytest with --doctest-modules. Tests: full suite python -m pytest -q --ignore=benchmark — 339 passed, 44 skipped, 0 failed, identical to the clean-base run before the change. --doctest-modules tabulate/__init__.py alone: 16 passed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant