pl2html 0.3.0__tar.gz → 0.4.1__tar.gz

{pl2html-0.3.0 → pl2html-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pl2html
-Version: 0.3.0
+Version: 0.4.1
 Summary: Add your description here
 Requires-Dist: polars>=1.42.1
 Requires-Python: >=3.14
@@ -51,10 +51,8 @@ df = pl.DataFrame(
 )
 
 # Compiles safely to a Polars LazyFrame containing the HTML output
-html_lazy = to_html(df)
+html_table_string = to_html(df)
 
-# Collect and extract the compiled string
-html_table_string = html_lazy.collect().item()
 print(html_table_string)
 ```
 
@@ -101,7 +99,7 @@ df_f = df.with_columns(
     fmt.sub_zero("status_code", zero_text="OK")
 )
 
-html = to_html(df_f).collect().item()
+html = to_html(df_f)
 ```
 
 ### 3. Advanced Styling via Native Attributes (`attrs`)
@@ -141,7 +139,7 @@ styles.update(
     )
 )
 
-html_table = to_html(df, attrs=styles).collect().item()
+html_table = to_html(df, attrs=styles)
 ```
 
 Output (github may override table colors, but they are there):
@@ -213,5 +211,4 @@ Most of the API design and formatting parameters in this library are heavily ins
 However, this library was born out of distinct architectural and environment constraints:
 
 * **Zero Overhead Styling:** While `great-tables` is incredibly feature-rich, it often produces dense HTML styles and boilerplate structures that were unnecessary for the target use cases. This library optimizes for minimal, highly clean HTML output.
-* **Modern Python Compatibility (Py 3.14+):** `great-tables` pulls in heavy external dependencies, including binary wheels like `multimark`. At the time of development, these dependencies did not support Python 3.14. To unblock workflows and maintain an ultra-lightweight, future-proof stack with zero complex binary dependencies, this native, Rust-backed Polars formatter was built from the ground up.
-
+* **Modern Python Compatibility (Py 3.14+):** `great-tables` pulls in heavy external dependencies, including binary wheels like `multimark`. At the time of development, these dependencies did not support Python 3.14 (see [multimark #3](https://github.com/posit-dev/multimark/issues/3)). To unblock workflows and maintain an ultra-lightweight, future-proof stack with zero complex binary dependencies, this native, Rust-backed Polars formatter was built from the ground up.

{pl2html-0.3.0 → pl2html-0.4.1}/README.md

@@ -42,10 +42,8 @@ df = pl.DataFrame(
 )
 
 # Compiles safely to a Polars LazyFrame containing the HTML output
-html_lazy = to_html(df)
+html_table_string = to_html(df)
 
-# Collect and extract the compiled string
-html_table_string = html_lazy.collect().item()
 print(html_table_string)
 ```
 
@@ -92,7 +90,7 @@ df_f = df.with_columns(
     fmt.sub_zero("status_code", zero_text="OK")
 )
 
-html = to_html(df_f).collect().item()
+html = to_html(df_f)
 ```
 
 ### 3. Advanced Styling via Native Attributes (`attrs`)
@@ -132,7 +130,7 @@ styles.update(
     )
 )
 
-html_table = to_html(df, attrs=styles).collect().item()
+html_table = to_html(df, attrs=styles)
 ```
 
 Output (github may override table colors, but they are there):
@@ -204,5 +202,4 @@ Most of the API design and formatting parameters in this library are heavily ins
 However, this library was born out of distinct architectural and environment constraints:
 
 * **Zero Overhead Styling:** While `great-tables` is incredibly feature-rich, it often produces dense HTML styles and boilerplate structures that were unnecessary for the target use cases. This library optimizes for minimal, highly clean HTML output.
-* **Modern Python Compatibility (Py 3.14+):** `great-tables` pulls in heavy external dependencies, including binary wheels like `multimark`. At the time of development, these dependencies did not support Python 3.14. To unblock workflows and maintain an ultra-lightweight, future-proof stack with zero complex binary dependencies, this native, Rust-backed Polars formatter was built from the ground up.
-
+* **Modern Python Compatibility (Py 3.14+):** `great-tables` pulls in heavy external dependencies, including binary wheels like `multimark`. At the time of development, these dependencies did not support Python 3.14 (see [multimark #3](https://github.com/posit-dev/multimark/issues/3)). To unblock workflows and maintain an ultra-lightweight, future-proof stack with zero complex binary dependencies, this native, Rust-backed Polars formatter was built from the ground up.

{pl2html-0.3.0 → pl2html-0.4.1}/pl2html/__init__.py

@@ -10,7 +10,7 @@ from polars import (
     when as _when,
 )
 
-__version__ = '0.3.0'
+__version__ = '0.4.1'
 
 
 def _escape_polars_string(col_name: str) -> _Expr:
@@ -126,7 +126,7 @@ def to_html(
     *,
     attrs: dict[str, dict[str, _Expr]] | None = None,
     exclude_columns: list[str] | None = None,
-) -> _LazyFrame:
+) -> str:
     """
     Compiles a Polars DataFrame safely into an HTML string layout.
     Accepts structural custom attributes mappings to handle layout modifications natively.
@@ -151,8 +151,14 @@ def to_html(
     # 4. Generate wrappers and frame the query graph
     html_header, html_footer = _build_html_skeleton(visible_columns)
 
-    return lf.select(row_expr.alias('html_row')).select(
-        (html_header + _col('html_row').str.join('\n') + html_footer).alias(
-            'html_table'
+    # 5. Execute the query graph and pull out the raw python string directly
+    return (
+        lf.select(row_expr.alias('html_row'))
+        .select(
+            (
+                html_header + _col('html_row').str.join('\n') + html_footer
+            ).alias('html_table')
         )
+        .collect()
+        .item()
     )

{pl2html-0.3.0 → pl2html-0.4.1}/pl2html/formats.py

@@ -48,6 +48,7 @@ def fmt_number(
     Highly optimized, native Polars numeric formatter matching great_tables features.
     Runs entirely in the parallel Rust engine without dropping into Python row loops.
     """
+    col_name = columns if isinstance(columns, str) else str(columns)
     val = _col(columns)
     if scale_by != 1.0:
         val = val * scale_by
@@ -61,6 +62,13 @@ def fmt_number(
         )
         thousands_exponent = (log10_expr / 3.0).floor().cast(_Int32) * 3
 
+        # Force exponent to 0 for fractional numbers (< 1.0) so we don't scale up without micro-suffixes
+        thousands_exponent = (
+            _when(thousands_exponent < 0)
+            .then(_lit(0))
+            .otherwise(thousands_exponent)
+        )
+
         if compact_system == 'engineering':
             suffix_chain = (
                 _when(thousands_exponent == 3)
@@ -96,28 +104,23 @@ def fmt_number(
         if n_sigfig < 1:
             raise ValueError('n_sigfig must be a positive integer >= 1')
 
-        # Round natively using Polars' built-in significant figures feature
         rounded = val_scaled.round_sig_figs(n_sigfig)
         abs_rounded = rounded.abs()
 
-        # Determine the number of dynamic decimal places needed for padding per row
         log10_expr = (
             _when(abs_rounded > 0)
             .then(abs_rounded.log10())
             .otherwise(_lit(0.0))
         )
-        # decimals required = n_sigfig - 1 - floor(log10(x))
         dynamic_decimals = (_lit(n_sigfig - 1) - log10_expr.floor()).cast(
             _Int32
         )
-        # Ensure we don't try to pad negative decimal places for large numbers
         dynamic_decimals = (
             _when(dynamic_decimals < 0)
             .then(_lit(0))
             .otherwise(dynamic_decimals)
         )
     else:
-        # Fallback to standard fixed decimal logic
         epsilon = (
             _when(val_scaled >= 0).then(_lit(1e-9)).otherwise(_lit(-1e-9))
         )
@@ -134,7 +137,6 @@ def fmt_number(
         .otherwise(_lit(''))
     )
 
-    # Use native Python string multiplication inside _lit()
     pad_len = n_sigfig if n_sigfig is not None else decimals
     frac_part = (
         _when(dynamic_decimals > 0)
@@ -175,7 +177,6 @@ def fmt_number(
                 + _lit(')')
             )
             .otherwise(
-                # If force_sign is True, explicitly prepend '+' to positive values
                 _lit('+' if force_sign else '')
                 + _lit(prefix)
                 + base_num_str
@@ -186,13 +187,12 @@ def fmt_number(
         formatted_expr = (
             _when(val < 0)
             .then(_lit('-') + _lit(prefix) + base_num_str + _lit(suffix))
-            # Handle zero explicitly if you don't want a sign on exactly 0.0
             .when((val == 0) | (not force_sign))
             .then(_lit(prefix) + base_num_str + _lit(suffix))
             .otherwise(_lit('+') + _lit(prefix) + base_num_str + _lit(suffix))
         )
 
-    return formatted_expr
+    return formatted_expr.alias(col_name)
 
 
 @_multicolumn

{pl2html-0.3.0 → pl2html-0.4.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = 'uv_build'
 
 [project]
 name = "pl2html"
-version = "0.3.0"
+version = "0.4.1"
 description = "Add your description here"
 readme = "README.md"
 requires-python = ">=3.14"