build_tools.corpus_db_viewer.formatters

Export formatters for corpus database viewer.

Provides functions to export database query results to various formats.

Functions

`export_to_csv`(rows, output_path)	Export data to CSV format.
`export_to_json`(rows, output_path)	Export data to JSON format.
`format_row_count`(count)	Format row count with thousands separator.
`format_file_size`(size_bytes)	Format file size in human-readable format.

Module Contents

build_tools.corpus_db_viewer.formatters.export_to_csv(rows, output_path)[source]

Export data to CSV format.

Parameters

rowslist[dict[str, Any]]: List of row data as dictionaries
output_pathPath: Path where CSV file will be written

Raises

ValueError: If rows list is empty

Examples

>>> rows = [
...     {'id': 1, 'name': 'Alice', 'age': 30},
...     {'id': 2, 'name': 'Bob', 'age': 25}
... ]
>>> export_to_csv(rows, Path("_working/exports/data.csv"))

build_tools.corpus_db_viewer.formatters.export_to_json(rows, output_path)[source]

Export data to JSON format.

Parameters

rowslist[dict[str, Any]]: List of row data as dictionaries
output_pathPath: Path where JSON file will be written

Raises

ValueError: If rows list is empty

Examples

>>> rows = [
...     {'id': 1, 'name': 'Alice', 'age': 30},
...     {'id': 2, 'name': 'Bob', 'age': 25}
... ]
>>> export_to_json(rows, Path("_working/exports/data.json"))

build_tools.corpus_db_viewer.formatters.format_row_count(count)[source]

Format row count with thousands separator.

Parameters

countint: Number of rows

Returns

str: Formatted count string (e.g., “1,234 rows”)

Examples

>>> format_row_count(1234)
'1,234 rows'
>>> format_row_count(1)
'1 row'

build_tools.corpus_db_viewer.formatters.format_file_size(size_bytes)[source]

Format file size in human-readable format.

Parameters

size_bytesint: Size in bytes

Returns

str: Formatted size (e.g., “1.2 MB”)

Examples

>>> format_file_size(1234567)
'1.2 MB'
>>> format_file_size(1234)
'1.2 KB'