pl2html 0.6.0__tar.gz → 0.6.2__tar.gz

{pl2html-0.6.0 → pl2html-0.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pl2html
-Version: 0.6.0
+Version: 0.6.2
 Summary: Add your description here
 Requires-Dist: polars>=1.42.1
 Requires-Python: >=3.14
@@ -83,20 +83,22 @@ from pl2html import formats as fmt
 
 df = pl.DataFrame(
     {
-        "asset_a": [5400600, 2100],
-        "asset_b": [45100000, -850000],
-        "growth": [0.1256, -0.024],
-        "is_active": [True, False],
-        "status_code": [0, 404]
+        'asset_a': [5400600, 2100],
+        'asset_b': [45100000, -850000],
+        'growth': [0.1256, -0.024],
+        'is_active': [True, False],
+        'status_code': [0, 404],
     }
 )
 
 # Format multiple financial asset columns compactly in one pass using lists
 df_f = df.with_columns(
-    fmt.fmt_integer(["asset_a", "asset_b"], compact=True, compact_system="financial"),
-    fmt.fmt_percent("growth", decimals=1),
-    fmt.fmt_tf("is_active", tf_style="check-mark"),
-    fmt.sub_zero("status_code", zero_text="OK")
+    fmt.fmt_integer(
+        ['asset_a', 'asset_b'], compact=True, compact_system='financial'
+    ),
+    fmt.fmt_percent('growth', decimals=1),
+    fmt.fmt_tf('is_active', tf_style='check-mark'),
+    fmt.sub_zero('status_code', zero_text='OK'),
 )
 
 html = to_html(df_f)
@@ -125,7 +127,7 @@ styles.update(
     data_color(
         column='performance_score',
         palette=['#ff7675', '#fdcb6e', '#00b894'],
-        auto_contrast=True
+        auto_contrast=True,
     )
 )
 
@@ -135,7 +137,7 @@ styles.update(
         column='utilization',
         palette=['#000000', '#FFFFFF'],
         descending=False,
-        auto_contrast=True
+        auto_contrast=True,
     )
 )
 

{pl2html-0.6.0 → pl2html-0.6.2}/README.md

@@ -74,20 +74,22 @@ from pl2html import formats as fmt
 
 df = pl.DataFrame(
     {
-        "asset_a": [5400600, 2100],
-        "asset_b": [45100000, -850000],
-        "growth": [0.1256, -0.024],
-        "is_active": [True, False],
-        "status_code": [0, 404]
+        'asset_a': [5400600, 2100],
+        'asset_b': [45100000, -850000],
+        'growth': [0.1256, -0.024],
+        'is_active': [True, False],
+        'status_code': [0, 404],
     }
 )
 
 # Format multiple financial asset columns compactly in one pass using lists
 df_f = df.with_columns(
-    fmt.fmt_integer(["asset_a", "asset_b"], compact=True, compact_system="financial"),
-    fmt.fmt_percent("growth", decimals=1),
-    fmt.fmt_tf("is_active", tf_style="check-mark"),
-    fmt.sub_zero("status_code", zero_text="OK")
+    fmt.fmt_integer(
+        ['asset_a', 'asset_b'], compact=True, compact_system='financial'
+    ),
+    fmt.fmt_percent('growth', decimals=1),
+    fmt.fmt_tf('is_active', tf_style='check-mark'),
+    fmt.sub_zero('status_code', zero_text='OK'),
 )
 
 html = to_html(df_f)
@@ -116,7 +118,7 @@ styles.update(
     data_color(
         column='performance_score',
         palette=['#ff7675', '#fdcb6e', '#00b894'],
-        auto_contrast=True
+        auto_contrast=True,
     )
 )
 
@@ -126,7 +128,7 @@ styles.update(
         column='utilization',
         palette=['#000000', '#FFFFFF'],
         descending=False,
-        auto_contrast=True
+        auto_contrast=True,
     )
 )
 

pl2html-0.6.2/pl2html/__init__.py

@@ -0,0 +1 @@
+__version__ = '0.6.2'

{pl2html-0.6.0 → pl2html-0.6.2}/pl2html/compiler.py

@@ -1,27 +1,39 @@
 from html import escape as _escape
+from warnings import catch_warnings as _catch_warnings
 
 from polars import (
     DataFrame as _DataFrame,
     DataType as _DataType,
     Expr as _Expr,
     LazyFrame as _LazyFrame,
+    Object as _Object,
     String as _String,
     col as _col,
     concat_str as _concat_str,
     lit as _lit,
     when as _when,
 )
+from polars.exceptions import (
+    PolarsInefficientMapWarning as _PolarsInefficientMapWarning,
+)
 
 
-def _escape_expr(expr: _Expr) -> _Expr:
+def _escape_expr(expr: _Expr, is_object: bool) -> _Expr:
     """
     Escapes an expression's string representations for secure HTML compatibility.
-    Using literal=True is critical; otherwise, the '&' character in the replacement
-    string acts as a regex match expansion macro and corrupts the entities.
     """
+    if is_object:
+        with _catch_warnings(
+            action='ignore', category=_PolarsInefficientMapWarning
+        ):
+            expr = expr.map_elements(
+                str, return_dtype=_String, skip_nulls=True
+            )
+    else:
+        expr = expr.cast(_String)
+
     return (
-        expr.cast(_String)
-        .str.replace_all('&', '&', literal=True)
+        expr.str.replace_all('&', '&', literal=True)
         .str.replace_all('<', '&lt;', literal=True)
         .str.replace_all('>', '&gt;', literal=True)
         .str.replace_all('"', '&quot;', literal=True)
@@ -80,23 +92,20 @@ def _build_cell_expr(
     elif dtype.is_float():
         fmt_expr = _format_float(col_name)
     else:
-        fmt_expr = _escape_expr(_col(col_name))
+        fmt_expr = _escape_expr(_col(col_name), dtype == _Object)
 
     fmt_expr = fmt_expr.fill_null('')
 
-    attr_expr_list = []
-    if col_name in attrs:
-        for attr_name, val_expr in attrs[col_name].items():
-            val_str_expr = val_expr.cast(_String)
-
-            compiled_attr = (
-                _when(val_str_expr.is_not_null() & (val_str_expr != ''))
-                .then(_lit(f' {attr_name}="') + val_str_expr + _lit('"'))
-                .otherwise(_lit(''))
+    if col_attrs := attrs.get(col_name):
+        attr_expr_list = [
+            _when(
+                (val_str_expr := val_expr.cast(_String)).is_not_null()
+                & (val_str_expr != '')
             )
-            attr_expr_list.append(compiled_attr)
-
-    if attr_expr_list:
+            .then(_lit(f' {attr_name}="') + val_str_expr + _lit('"'))
+            .otherwise(_lit(''))
+            for attr_name, val_expr in col_attrs.items()
+        ]
         opening_td = _lit('<td') + _concat_str(attr_expr_list) + _lit('>')
     else:
         opening_td = _lit('<td>')
@@ -134,7 +143,7 @@ def _resolve_attributes(
         if col_name in visible_columns:
             for attr_name, expr in attr_map.items():
                 alias_key = f'__attr_{col_name}_{attr_name}'
-                attr_exprs.append(_escape_expr(expr).alias(alias_key))
+                attr_exprs.append(_escape_expr(expr, False).alias(alias_key))
                 attr_aliases[(col_name, attr_name)] = alias_key
 
     if not attr_exprs:
@@ -155,17 +164,6 @@ def _resolve_attributes(
     return lf, new_attrs
 
 
-def _apply_user_formatters(
-    lf: _LazyFrame, formatters: _Expr | list[_Expr] | None
-) -> _LazyFrame:
-    """Applies layout transformation modifications/conversions to columns."""
-    if formatters is None:
-        return lf
-    if isinstance(formatters, _Expr):
-        formatters = [formatters]
-    return lf.with_columns(formatters)
-
-
 def _compile_html(
     lf: _LazyFrame,
     visible_columns: list[str],
@@ -258,9 +256,7 @@ def to_html(
     """
     lf = df.lazy() if isinstance(df, _DataFrame) else df
     exclude_columns = exclude_columns or []
-    attrs = attrs or {}
 
-    # Setup the evaluation context data
     df_eager = lf.collect()
     lf = df_eager.lazy()
 
@@ -268,7 +264,12 @@ def to_html(
         c for c in df_eager.schema.names() if c not in exclude_columns
     ]
 
-    lf, attrs = _resolve_attributes(lf, df_eager, attrs, visible_columns)
-    lf = _apply_user_formatters(lf, formatters)
+    if attrs:
+        lf, attrs = _resolve_attributes(lf, df_eager, attrs, visible_columns)
+    else:
+        attrs = {}
+
+    if formatters is not None:
+        lf = lf.with_columns(formatters)
 
     return _compile_html(lf, visible_columns, attrs)

{pl2html-0.6.0 → pl2html-0.6.2}/pl2html/styles.py

@@ -34,9 +34,24 @@ def _interpolate_segment(
     local_factor = (norm_val - seg_start) / segment_width
 
     # Linear interpolation formula applied directly to Polars Expressions
-    r_expr = (_lit(r1) + (_lit(r2 - r1) * local_factor)).round(0).cast(_Int32)
-    g_expr = (_lit(g1) + (_lit(g2 - g1) * local_factor)).round(0).cast(_Int32)
-    b_expr = (_lit(b1) + (_lit(b2 - b1) * local_factor)).round(0).cast(_Int32)
+    r_expr = (
+        (_lit(r1) + (_lit(r2 - r1) * local_factor))
+        .fill_nan(None)
+        .round(0)
+        .cast(_Int32)
+    )
+    g_expr = (
+        (_lit(g1) + (_lit(g2 - g1) * local_factor))
+        .fill_nan(None)
+        .round(0)
+        .cast(_Int32)
+    )
+    b_expr = (
+        (_lit(b1) + (_lit(b2 - b1) * local_factor))
+        .fill_nan(None)
+        .round(0)
+        .cast(_Int32)
+    )
 
     return r_expr, g_expr, b_expr
 

{pl2html-0.6.0 → pl2html-0.6.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = 'uv_build'
 
 [project]
 name = "pl2html"
-version = "0.6.0"
+version = "0.6.2"
 description = "Add your description here"
 readme = "README.md"
 requires-python = ">=3.14"
@@ -23,44 +23,46 @@ module-name = "pl2html"
 [tool.ruff]
 line-length = 79
 format.quote-style = 'single'
-lint.isort.combine-as-imports = true
-lint.extend-select = [
+
+[tool.ruff.lint]
+extend-select = [
     'W605', # invalid-escape-sequence
     'FA',   # flake8-future-annotations
     'I',    # isort
     'UP',   # pyupgrade
     'RUF',  # Ruff-specific rules (RUF)
 ]
-lint.ignore = [
-    'E721',   # Do not compare types, use `isinstance()`
+ignore = [
+    'B023', # function-uses-loop-variable
+    'BLE001', # blind-except
+    'DTZ', # flake8-datetimez
+    'E721', # Do not compare types, use `isinstance()`
+    'PLE2502', # bidirectional-unicode
+    'PLW1510', # subprocess-run-without-check
     'RUF001', # ambiguous-unicode-character-string
     'RUF002', # ambiguous-unicode-character-docstring
     'RUF003', # ambiguous-unicode-character-comment
     'RUF012', # mutable-class-default
     'RUF059', # Unpacked variable never used
+    'SIM102', # collapsible-if
+    'SIM103', # Return the condition directly
+    'SIM115', # Use a context manager for opening files
 ]
 
-[tool.pytest]
-addopts = ["--quiet", "--tb=short"]
-truncation_limit_lines = '0'
-truncation_limit_chars = '0'
+[tool.ruff.lint.isort]
+combine-as-imports = true
 
-[tool.pyright]
-typeCheckingMode = 'standard'
-reportInvalidStringEscapeSequence = false
-reportConstantRedefinition = 'error'
-reportDeprecated = 'warning'
-reportPropertyTypeMismatch = 'error'
-reportTypeCommentUsage = 'warning'
-reportUnnecessaryCast = 'warning'
-reportUnnecessaryComparison = 'warning'
-reportUnnecessaryContains = 'warning'
-reportUnnecessaryIsInstance = 'warning'
-reportUnnecessaryTypeIgnoreComment = 'warning'
-venvPath = "."
-venv = ".venv"
+[tool.pytest]
+addopts = ["--quiet", "--tb=short", "--report-chars=N"]
+truncation_limit_lines = 0
+truncation_limit_chars = 0
 
+[tool.pyrefly]
+infer-with-first-use = false
+min-severity = "info"
+[tool.pyrefly.errors]
+incompatible-comparison = "warn"
 [dependency-groups]
 dev = [
-    "pytest>=9.1.1",
+    "pytest>=9.2.0",
 ]

pl2html-0.6.0/pl2html/__init__.py

@@ -1 +0,0 @@
-__version__ = '0.6.0'