in python/datafusion/html_formatter.py [0:0]
def configure_formatter(**kwargs: Any) -> None:
"""Configure the global DataFrame HTML formatter.
This function creates a new formatter with the provided configuration
and sets it as the global formatter for all DataFrames.
Args:
**kwargs: Formatter configuration parameters like max_cell_length,
max_width, max_height, enable_cell_expansion, etc.
Raises:
ValueError: If any invalid parameters are provided
Example:
>>> from datafusion.html_formatter import configure_formatter
>>> configure_formatter(
... max_cell_length=50,
... max_height=500,
... enable_cell_expansion=True,
... use_shared_styles=True
... )
"""
# Valid parameters accepted by DataFrameHtmlFormatter
valid_params = {
"max_cell_length",
"max_width",
"max_height",
"max_memory_bytes",
"min_rows_display",
"repr_rows",
"enable_cell_expansion",
"custom_css",
"show_truncation_message",
"style_provider",
"use_shared_styles",
}
# Check for invalid parameters
invalid_params = set(kwargs) - valid_params
if invalid_params:
msg = (
f"Invalid formatter parameters: {', '.join(invalid_params)}. "
f"Valid parameters are: {', '.join(valid_params)}"
)
raise ValueError(msg)
# Create and set formatter with validated parameters
set_formatter(DataFrameHtmlFormatter(**kwargs))