Skip to content

Display options

HTML repr limits for Jupyter and terminals.

pydantable.display

HTML preview limits for :meth:~pydantable.dataframe.DataFrame._repr_html_.

Environment variables (optional, read when no programmatic override is set):

  • PYDANTABLE_REPR_HTML_MAX_ROWS (default 20)
  • PYDANTABLE_REPR_HTML_MAX_COLS (default 40)
  • PYDANTABLE_REPR_HTML_MAX_CELL_LEN (default 500)

Use :func:set_display_options / :func:reset_display_options in notebooks to override without env vars. Thread safety is not guaranteed (typical notebook use).

get_repr_html_limits 

get_repr_html_limits()

Effective limits for HTML table previews (see module docstring).

Source code in python/pydantable/display.py 
49
50
51
52
53
54
55
56
57
def get_repr_html_limits() -> ReprHtmlLimits:
    """Effective limits for HTML table previews (see module docstring)."""
    if _override is not None:
        return ReprHtmlLimits(*_override)
    return ReprHtmlLimits(
        max_rows=_env_int("PYDANTABLE_REPR_HTML_MAX_ROWS", _DEFAULT_ROWS),
        max_cols=_env_int("PYDANTABLE_REPR_HTML_MAX_COLS", _DEFAULT_COLS),
        max_cell_len=_env_int("PYDANTABLE_REPR_HTML_MAX_CELL_LEN", _DEFAULT_CELL),
    )

set_display_options 

set_display_options(*, max_rows=None, max_cols=None, max_cell_len=None)

Set module-level overrides for HTML preview limits (positive integers only).

Source code in python/pydantable/display.py 
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
def set_display_options(
    *,
    max_rows: int | None = None,
    max_cols: int | None = None,
    max_cell_len: int | None = None,
) -> None:
    """Set module-level overrides for HTML preview limits (positive integers only)."""
    cur = get_repr_html_limits()
    nr = cur.max_rows if max_rows is None else max_rows
    nc = cur.max_cols if max_cols is None else max_cols
    nl = cur.max_cell_len if max_cell_len is None else max_cell_len
    if nr <= 0 or nc <= 0 or nl <= 0:
        raise ValueError("Display limits must be positive integers.")
    global _override
    _override = (nr, nc, nl)

reset_display_options 

reset_display_options()

Clear programmatic overrides; env vars and defaults apply again.

Source code in python/pydantable/display.py 
77
78
79
80
def reset_display_options() -> None:
    """Clear programmatic overrides; env vars and defaults apply again."""
    global _override
    _override = None