pandas-plots 0.12.15__py3-none-any.whl → 0.12.17__py3-none-any.whl

pandas_plots/hlp.py

@@ -6,6 +6,8 @@ from enum import Enum, auto
 from io import BytesIO
 from platform import python_version
 from typing import List, Literal
+import json
+import uuid
 
 import duckdb as ddb
 import numpy as np
@@ -490,4 +492,56 @@ def find_cols(all_cols: list[str], stubs=list[str]):
     return [col for col in all_cols if any(match in col for match in stubs)]
 
 # * extend objects to enable chaining
-pd.DataFrame.find_cols = find_cols
+pd.DataFrame.find_cols = find_cols
+
+def add_measures_to_pyg_config(json_path: str, nodes: list[tuple[str, str]]) -> None:
+    """
+    Reads a pygwalker json config file, adds new measures from given nodes if not already present, and writes back to the file.
+
+    Parameters
+    ----------
+    json_path : `str`
+        The path to the pyg_json config file.
+    nodes : `list[tuple[str, str]]`
+        A list of tuples, where the first element in the tuple is the name of the measure and the second element is the SQL expression that defines the measure.
+
+    Returns
+    -------
+    None
+    
+    Example
+    -------
+    `node = [("cnt_tum", "count(distinct z_tum_id)")]`
+    """
+    
+    with open(json_path, "r", encoding="utf-8") as file:
+        config = json.load(file)
+
+    for node in nodes:
+        fid = uuid.uuid4().hex
+        
+        # Define the measure
+        new_json_node = {
+            "analyticType": "measure",
+            "fid": f"{fid}",
+            "name": f"{node[0]}",
+            "semanticType": "quantitative",
+            "computed": True,
+            "aggName": "expr",
+            "expression": {
+                "op": "expr",
+                "as": f"{fid}",
+                "params": [{"type": "sql", "value": f"{node[1]}"}]
+            }
+        }
+
+        # Get the measures list
+        measures = config["config"][0]["encodings"]["measures"]
+
+        # Ensure the measure is present
+        if not any(measure.get("name") == node[0] for measure in measures):
+            measures.append(new_json_node)
+
+    # Write the updated JSON back to the file
+    with open(json_path, "w", encoding="utf-8") as file:
+        json.dump(config, file, indent=2)

pandas_plots/pls.py

@@ -661,7 +661,6 @@ def plot_bars(
 
     # * layot caption if provided
     caption = _set_caption(caption)
-
     # ! plot
     _fig = px.bar(
         df.sort_values(
@@ -674,7 +673,7 @@ def plot_bars(
         orientation=orientation,
         # * retrieve the original columns from series
         title=title
-        or f"{caption}{_title_str_minval}{_title_str_top}[{df.columns[1]}] by [{col_index}]{_title_str_null}{_title_str_n}",
+        or f"{caption}{_title_str_minval}{_title_str_top}[{col_name}] by [{col_index}]{_title_str_null}{_title_str_n}",
         # * retrieve theme from env (intro.set_theme) or default
         template="plotly_dark" if os.getenv("THEME") == "dark" else "plotly",
         width=width,
@@ -732,8 +731,22 @@ def plot_bars(
 
     # * looks better on single bars
     _fig.update_traces(
-        textposition="outside" if not use_ci else "auto", error_y=dict(thickness=5)
+        error_y=dict(thickness=5)
     )
+    if use_ci:
+        _fig.update_traces(
+            textposition="inside",  # Put labels inside bars
+            insidetextanchor="start",  # Align labels at the bottom
+            textfont=dict(size=14, color="white")  # Adjust text color for visibility
+        )
+    else:
+        _fig.update_traces(
+            textposition="outside",
+            # error_y=dict(thickness=0)
+        )
+
+    # * set axis title
+
     _fig.show(renderer)
 
     # * save to png if path is provided

pandas_plots/tbl.py

@@ -57,7 +57,7 @@ def descr_db(
     print(f'🗄️ {caption}\t{db.count("*").fetchone()[0]:_}, {db.columns.__len__()}\n\t("{cols}")')
 
     if use_preview:
-        db.limit(3).show()
+        db.limit(3).show(max_width=2000)
     return
 
 def describe_df(
@@ -269,6 +269,7 @@ def pivot_df(
     alter_font: bool = True,
     font_size_th: int = 0,
     font_size_td: int = 0,
+    col1_width: int = 0,
     png_path: str | Path = None,
     png_conversion: Literal["chrome", "selenium"] = "selenium",
 ) -> pd.DataFrame:
@@ -306,6 +307,7 @@ def pivot_df(
         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.
+        col1_width (int, optional): The width of the first column in px. Defaults to 0.
         png_path (str | Path, optional): The path to save the output PNG file. Defaults to None.
         png_conversion (Literal["chrome", "selenium"], optional): The conversion method for the PNG file. Defaults to "selenium".
 
@@ -393,6 +395,7 @@ def pivot_df(
         alter_font=alter_font,
         font_size_th=font_size_th,
         font_size_td=font_size_td,
+        col1_width=col1_width,
         png_path=png_path,
         png_conversion=png_conversion,
         
@@ -416,6 +419,7 @@ def show_num_df(
     alter_font: bool = True,
     font_size_th: int = 0,
     font_size_td: int = 0,
+    col1_width: int = 0,
     png_path: str | Path = None,
     png_conversion: Literal["chrome", "selenium"] = "selenium",
 ):
@@ -445,6 +449,7 @@ def show_num_df(
     - 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
+    - col1_width: an integer indicating the width of the first column in px
     - png_path: a string or Path indicating the path to save the PNG file
     - png_conversion: a Literal indicating the conversion method for the PNG file ["chrome", "selenium"]
 
@@ -680,6 +685,15 @@ def show_num_df(
             dict(selector="td", props=_props_td),
         ]
     )
+    
+    if  col1_width > 0:
+        out.set_table_styles([
+            {'selector': 'th:first-child, td:first-child', 
+            'props': [(f'min-width', f'{col1_width}px !important'), 
+                    (f'max-width', f'{col1_width}px !important'), 
+                    ('white-space', 'nowrap'), 
+                    ('overflow', 'hidden')]}
+        ])
 
     if heatmap_axis:
         out.background_gradient(

{pandas_plots-0.12.15.dist-info → pandas_plots-0.12.17.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: pandas-plots
-Version: 0.12.15
+Version: 0.12.17
 Summary: A collection of helper for table handling and visualization
 Home-page: https://github.com/smeisegeier/pandas-plots
 Author: smeisegeier
@@ -115,6 +115,7 @@ tbl.show_num_df(
   - `get_os` helps to identify and ensure operating system at runtime
   - `add_bitmask_label()` adds a column to the data that resolves a bitmask column into human-readable labels
   - `find_cols()` finds all columns in a list of columns that contain any of the given stubs
+  - `add_measures_to_pyg_config()` adds measures to a pygwalker config file to avoid frequent manual update
 <br>
 
 - `pii` has routines for handling of personally identifiable information

pandas_plots-0.12.17.dist-info/RECORD

@@ -0,0 +1,11 @@
+pandas_plots/hlp.py,sha256=ggIe9uwF4tlVWqaBxQOkn8Dz8955xjY-TYG-lzypWFE,18905
+pandas_plots/pii.py,sha256=2WKE-W9s285jPdsTqCgt1uxuW4lj1PYCVOYB2fYDNwQ,2195
+pandas_plots/pls.py,sha256=YbWPk34oJ3SJ-n7O-FvMOYR2FT2uNbMe93E0dbVTetk,48170
+pandas_plots/tbl.py,sha256=LxMKJh4qkGuQZ1DdCZIq1tMS26F6elsqbe_uabvQx4E,32535
+pandas_plots/ven.py,sha256=2x3ACo2vSfO3q6fv-UdDQ0h1SJyt8WChBGgE5SDCdCk,11673
+pandas_plots-0.12.17.dist-info/LICENSE,sha256=6KQ5KVAAhRaB-JJKpX4cefKvRZRgI7GUPc92_2d31XY,1051
+pandas_plots-0.12.17.dist-info/METADATA,sha256=SVkqVo2s4V_1kd9dk5PuHQe6svOxRLLusfYI--jKzsM,7550
+pandas_plots-0.12.17.dist-info/WHEEL,sha256=52BFRY2Up02UkjOa29eZOS2VxUrpPORXg1pkohGGUS8,91
+pandas_plots-0.12.17.dist-info/pii.py,sha256=2WKE-W9s285jPdsTqCgt1uxuW4lj1PYCVOYB2fYDNwQ,2195
+pandas_plots-0.12.17.dist-info/top_level.txt,sha256=XnaNuIHBqMmCeh_U7nKOYTwFue_SIA0wxuDgdPmnnSk,13
+pandas_plots-0.12.17.dist-info/RECORD,,

{pandas_plots-0.12.15.dist-info → pandas_plots-0.12.17.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.8.2)
+Generator: setuptools (76.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

pandas_plots-0.12.15.dist-info/RECORD

@@ -1,11 +0,0 @@
-pandas_plots/hlp.py,sha256=eKJaQqd03tYlbWXoicHi9j32zrNlpIQngj4Dni2fYTo,17230
-pandas_plots/pii.py,sha256=2WKE-W9s285jPdsTqCgt1uxuW4lj1PYCVOYB2fYDNwQ,2195
-pandas_plots/pls.py,sha256=OLaX5gWbsuYniikpojqPxZt9oQK_PI1XyJEQkbNlSk8,47809
-pandas_plots/tbl.py,sha256=205LfHkLhZKvqaIqPGEo-t6m7nLPTT5FNGVfVH_o1WA,31916
-pandas_plots/ven.py,sha256=2x3ACo2vSfO3q6fv-UdDQ0h1SJyt8WChBGgE5SDCdCk,11673
-pandas_plots-0.12.15.dist-info/LICENSE,sha256=6KQ5KVAAhRaB-JJKpX4cefKvRZRgI7GUPc92_2d31XY,1051
-pandas_plots-0.12.15.dist-info/METADATA,sha256=c7RcgTtnI2qpgk5Xm8Uu67rGmeRf1Nw1V5uXZTnmyRc,7442
-pandas_plots-0.12.15.dist-info/WHEEL,sha256=jB7zZ3N9hIM9adW7qlTAyycLYW9npaWKLRzaoVcLKcM,91
-pandas_plots-0.12.15.dist-info/pii.py,sha256=2WKE-W9s285jPdsTqCgt1uxuW4lj1PYCVOYB2fYDNwQ,2195
-pandas_plots-0.12.15.dist-info/top_level.txt,sha256=XnaNuIHBqMmCeh_U7nKOYTwFue_SIA0wxuDgdPmnnSk,13
-pandas_plots-0.12.15.dist-info/RECORD,,