pandas-plots 0.11.25__py3-none-any.whl → 0.11.26__py3-none-any.whl

pandas_plots/tbl.py

@@ -4,6 +4,7 @@
 import math
 import os
 from collections import abc
+from pathlib import Path
 from typing import Literal, get_args
 import numpy as np
 
@@ -12,6 +13,7 @@ import pandas as pd
 import plotly.express as px
 from plotly.subplots import make_subplots
 from scipy import stats
+import dataframe_image as dfi
 
 from .hlp import wrap_text
 
@@ -268,6 +270,11 @@ def pivot_df(
     kpi_rag_list: list[float] = None,
     kpi_mode: KPI_LITERAL = None,
     kpi_shape: Literal["squad", "circle"] = "squad",
+    show_as_pct: bool = False,
+    alter_font: bool = True,
+    font_size_th: int = 0,
+    font_size_td: int = 0,
+    png_path: str | Path = None,
 ) -> pd.DataFrame:
     """
     A function to pivot a DataFrame based on specified parameters hand over to the *show_num_df* function.
@@ -299,6 +306,11 @@ def pivot_df(
             max_min_x: max value green, min valued red for x axis
         kpi_rag_list: a list of floats indicating the thresholds for rag lights. The list should have 2 elements.
         kpi_shape: a Literal indicating the shape of the KPIs ["squad", "circle"]
+        show_as_pct (bool, optional): Whether to show values as percentages. Defaults to False.
+        alter_font (bool, optional): Whether to alter the font. Defaults to True.
+        font_size_th (int, optional): The font size for the header. Defaults to 0.
+        font_size_td (int, optional): The font size for the table data. Defaults to 0.
+        png_path (str | Path, optional): The path to save the output PNG file. Defaults to None.
 
     Returns:
         pd.DataFrame: The pivoted DataFrame.
@@ -380,6 +392,11 @@ def pivot_df(
         kpi_mode=kpi_mode,
         kpi_rag_list=kpi_rag_list,
         kpi_shape=kpi_shape,
+        show_as_pct=show_as_pct,
+        alter_font=alter_font,
+        font_size_th=font_size_th,
+        font_size_td=font_size_td,
+        png_path=png_path,
     )
 
 
@@ -398,6 +415,9 @@ def show_num_df(
     kpi_shape: Literal["squad", "circle"] = "squad",
     show_as_pct: bool = False,
     alter_font: bool = True,
+    font_size_th: int = 0,
+    font_size_td: int = 0,
+    png_path: str | Path = None,
 ):
     """
     A function to display a DataFrame with various options for styling and formatting, including the ability to show totals, apply data bar coloring, and control the display precision.
@@ -423,6 +443,9 @@ def show_num_df(
     - kpi_shape: a Literal indicating the shape of the KPIs ["squad", "circle"]
     - show_as_pct: a boolean indicating whether to show value as percentage (only advised on values ~1)
     - alter_font: a boolean indicating whether to alter the font family
+    - font_size_th: an integer indicating the font size for the header
+    - font_size_td: an integer indicating the font size for the table data
+    - png_path: a string or Path indicating the path to save the PNG file
 
     The function returns a styled representation of the DataFrame.
     """
@@ -637,16 +660,23 @@ def show_num_df(
         out.set_properties(**{"font-family": "Courier"})
 
     # * apply fonts for th (inkl. index)
-    _props = [
-        # ("font-size", "10pt"),
+    _props_th = [
         # ("font-weight", "bold"),
-        # ("font-family", "Courier"),
         ("text-align", "right")
     ]
+
+    _props_td = [
+        ("text-align", "right")
+    ]
+    if font_size_th > 0:
+        _props_th.append(("font-size", f"{font_size_th}pt"))
+    if font_size_td > 0:
+        _props_td.append(("font-size", f"{font_size_td}pt"))
+    
     out.set_table_styles(
         [
-            dict(selector="th", props=_props),
-            # dict(selector="th:nth-child(1)", props=_props),
+            dict(selector="th", props=_props_th),
+            dict(selector="td", props=_props_td),
         ]
     )
 
@@ -657,6 +687,10 @@ def show_num_df(
             subset=(df_orig.index, df_orig.columns) if total_exclude else None,
         )
 
+    if png_path is not None:
+        # * 72dpi default is too low for high res displays
+        dfi.export(obj=out, filename=png_path, dpi=120)
+
     return out
 
 def print_summary(df: pd.DataFrame | pd.Series, name: str="🟠 "):

{pandas_plots-0.11.25.dist-info → pandas_plots-0.11.26.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pandas-plots
-Version: 0.11.25
+Version: 0.11.26
 Summary: A collection of helper for table handling and visualization
 Home-page: https://github.com/smeisegeier/pandas-plots
 Author: smeisegeier
@@ -31,6 +31,7 @@ Requires-Dist: missingno>=0.5.2
 Requires-Dist: duckdb>=1.0.0
 Requires-Dist: kaleido>=0.2.0
 Requires-Dist: nbformat>=4.2.0
+Requires-Dist: dataframe_image==0.2.3
 
 # pandas-plots
 

pandas_plots-0.11.26.dist-info/RECORD

@@ -0,0 +1,10 @@
+pandas_plots/hlp.py,sha256=N6NrbFagVMMX-ZnV0rIBEz82SeSoOkksfMcCap55W7E,16588
+pandas_plots/pii.py,sha256=2WKE-W9s285jPdsTqCgt1uxuW4lj1PYCVOYB2fYDNwQ,2195
+pandas_plots/pls.py,sha256=U-tjh0DnYQYg-n02hh_HyvObMerkGCBP8tirKFIEEn4,37376
+pandas_plots/tbl.py,sha256=vnaRonXKntFePMX8U5pF92HMp04bxiQ6s4ZNninnlfU,29797
+pandas_plots/ven.py,sha256=2x3ACo2vSfO3q6fv-UdDQ0h1SJyt8WChBGgE5SDCdCk,11673
+pandas_plots-0.11.26.dist-info/LICENSE,sha256=6KQ5KVAAhRaB-JJKpX4cefKvRZRgI7GUPc92_2d31XY,1051
+pandas_plots-0.11.26.dist-info/METADATA,sha256=9FNqRPjwHGYxsWn9VOy5w8xlSS1sKgVe73f2iwkLNrw,7258
+pandas_plots-0.11.26.dist-info/WHEEL,sha256=A3WOREP4zgxI0fKrHUG8DC8013e3dK3n7a6HDbcEIwE,91
+pandas_plots-0.11.26.dist-info/top_level.txt,sha256=XnaNuIHBqMmCeh_U7nKOYTwFue_SIA0wxuDgdPmnnSk,13
+pandas_plots-0.11.26.dist-info/RECORD,,

pandas_plots-0.11.25.dist-info/RECORD

@@ -1,10 +0,0 @@
-pandas_plots/hlp.py,sha256=N6NrbFagVMMX-ZnV0rIBEz82SeSoOkksfMcCap55W7E,16588
-pandas_plots/pii.py,sha256=2WKE-W9s285jPdsTqCgt1uxuW4lj1PYCVOYB2fYDNwQ,2195
-pandas_plots/pls.py,sha256=U-tjh0DnYQYg-n02hh_HyvObMerkGCBP8tirKFIEEn4,37376
-pandas_plots/tbl.py,sha256=A1SqvssDA4ofI_WJ-sdWIb9Bo5X-sELD8pley22Y4X4,28380
-pandas_plots/ven.py,sha256=2x3ACo2vSfO3q6fv-UdDQ0h1SJyt8WChBGgE5SDCdCk,11673
-pandas_plots-0.11.25.dist-info/LICENSE,sha256=6KQ5KVAAhRaB-JJKpX4cefKvRZRgI7GUPc92_2d31XY,1051
-pandas_plots-0.11.25.dist-info/METADATA,sha256=ozN_fz1-7R1-lEMGUQD_XJ4qa3RBUsGdS0gXw7EGBrY,7220
-pandas_plots-0.11.25.dist-info/WHEEL,sha256=A3WOREP4zgxI0fKrHUG8DC8013e3dK3n7a6HDbcEIwE,91
-pandas_plots-0.11.25.dist-info/top_level.txt,sha256=XnaNuIHBqMmCeh_U7nKOYTwFue_SIA0wxuDgdPmnnSk,13
-pandas_plots-0.11.25.dist-info/RECORD,,