pandas-plots 0.11.0__py3-none-any.whl → 0.11.1__py3-none-any.whl

pandas_plots/hlp.py

@@ -1,6 +1,7 @@
 import pandas as pd
 import numpy as np
 import scipy.stats
+import importlib.metadata as md
 
 from io import BytesIO
 from matplotlib import pyplot as plt
@@ -261,3 +262,24 @@ def add_datetime_columns(df: pd.DataFrame, date_column: str = None) -> pd.DataFr
     )
 
     return df_
+
+
+def show_package_version(packages: list[str] = ["pandas","numpy","duckdb","pandas-plots", "connection_helper"], sep: str = " | ") -> None:
+    """
+    Display the versions of the specified packages.
+
+    Parameters:
+        packages (list[str], optional): A list of package names. Defaults to ["pandas","numpy","duckdb","pandas-plots", "connection_helper"].
+        sep (str, optional): The separator to use when joining the package names and versions. Defaults to " | ".
+
+    Returns:
+        None
+    """
+    items = []
+    for item in packages:
+        try:
+            version = md.version(item)
+            items.append(f"📦 {item}: {version}")
+        except md.PackageNotFoundError:
+            items.append(f"❌ {item}: Package not found")
+    print(sep.join(items))

pandas_plots/pls.py

@@ -125,7 +125,7 @@ def plot_stacked_bars(
     Parameters:
     - df: pd.DataFrame - The DataFrame containing the data to plot.
     - top_n_index: int = 0 - The number of top indexes to include in the plot.
-    - top_n_index: int = 0 - The number of top colors to include in the plot. WARNING: this forces distribution to 100% on a subset
+    - top_n_color: int = 0 - The number of top colors to include in the plot. WARNING: this forces distribution to 100% on a subset
     - dropna: bool = False - Whether to include NULL values in the plot.
     - swap: bool = False - Whether to swap the x-axis and y-axis.
     - normalize: bool = False - Whether to normalize the values.

pandas_plots/tbl.py

@@ -17,6 +17,7 @@ from scipy import stats
 from .hlp import wrap_text
 
 # from devtools import debug
+
 pd.options.display.colheader_justify = "right"
 # pd.options.mode.chained_assignment = None
 
@@ -225,6 +226,7 @@ def pivot_df(
     kpi_shape: Literal["squad", "circle"] = "squad",
 ) -> pd.DataFrame:
     """
+    DEPR: This function is deprecated and will be removed in the future.
     A function to pivot a DataFrame based on specified parameters and return the result as a new DataFrame.
 
     Args:
@@ -365,6 +367,7 @@ def show_num_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: a boolean indicating whether to show value as percentage (only advised on values ~1)
 
     The function returns a styled representation of the DataFrame.
     """
@@ -472,8 +475,13 @@ def show_num_df(
         Returns:
         str: The appropriate icon based on the value and KPI mode.
         """
+
+        # * no icon if no mode. (or Total column, but total index cannot be located)
         if not kpi_mode:
+        # if not kpi_mode or col == "Total":
             return ""
+        
+        
 
         dict_icons = {
             "squad": {
@@ -486,7 +494,6 @@ def show_num_df(
             },
         }
         icons = dict_icons[kpi_shape][theme]
-
         # * transform values into percentiles if relative mode
         kpi_rag_list_ = kpi_rag_list
         if kpi_mode == "rag_rel":
@@ -517,19 +524,14 @@ def show_num_df(
         min_ = tbl_min if kpi_mode.endswith("_xy") else col_min[col]
         max_ = tbl_max if kpi_mode.endswith("_xy") else col_max[col]
 
-        # * omit Total column for min/max
-        if col == "Total":
-            return ""
-
         # * calculate order of icons
         if kpi_mode.startswith("min_max"):
             result = icons[0] if val == min_ else icons[2] if val == max_ else icons[3]
         elif kpi_mode.startswith("max_min"):
             result = icons[0] if val == max_ else icons[2] if val == min_ else icons[3]
         else:
-            # * no matching mode founf
+            # * no matching mode found
             result = ""
-
         return result
 
     # * all cell formatting in one place
@@ -562,7 +564,7 @@ def show_num_df(
             return f"{val:.{precision}%} {kpi}"
         return f"{val:_.{precision}f} {kpi}"
 
-    # * formatter is now unified, col wise
+    # * formatter is a dict comprehension, only accepts column names
     formatter = {col: lambda x, col=col: format_cell(x, col=col) for col in df_.columns}
 
     # ? pct_axis y is not implemented, needs row wise formatting
@@ -572,6 +574,7 @@ def show_num_df(
     #     }
 
     # * apply formatter
+    # debug(formatter)
     out.format(formatter=formatter)
 
     # * apply fonts for cells

pandas_plots/ven.py

@@ -231,7 +231,6 @@ def show_venn2(
     a_label: str,
     b_set: set,
     b_label: str,
-    # theme: Literal["light", "dark"] = "dark",
     max_set_len: int = 100,
     max_line_width: int = 120,
     alpha: float = 0.7,

{pandas_plots-0.11.0.dist-info → pandas_plots-0.11.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pandas-plots
-Version: 0.11.0
+Version: 0.11.1
 Summary: A collection of helper for table handling and vizualization
 Home-page: https://github.com/smeisegeier/pandas-plots
 Author: smeisegeier
@@ -29,7 +29,7 @@ Requires-Dist: requests >=2.31.0
 
 # pandas-plots
 
-![PyPI - Version](https://img.shields.io/pypi/v/pandas-plots) ![GitHub last commit](https://img.shields.io/github/last-commit/smeisegeier/pandas-plots?logo=github) ![GitHub License](https://img.shields.io/github/license/smeisegeier/pandas-plots?logo=github) ![py3.10](https://img.shields.io/badge/python-3.10-blue.svg?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxMDAgMTAwIj4KICA8ZGVmcz4KICAgIDxsaW5lYXJHcmFkaWVudCBpZD0icHlZZWxsb3ciIGdyYWRpZW50VHJhbnNmb3JtPSJyb3RhdGUoNDUpIj4KICAgICAgPHN0b3Agc3RvcC1jb2xvcj0iI2ZlNSIgb2Zmc2V0PSIwLjYiLz4KICAgICAgPHN0b3Agc3RvcC1jb2xvcj0iI2RhMSIgb2Zmc2V0PSIxIi8+CiAgICA8L2xpbmVhckdyYWRpZW50PgogICAgPGxpbmVhckdyYWRpZW50IGlkPSJweUJsdWUiIGdyYWRpZW50VHJhbnNmb3JtPSJyb3RhdGUoNDUpIj4KICAgICAgPHN0b3Agc3RvcC1jb2xvcj0iIzY5ZiIgb2Zmc2V0PSIwLjQiLz4KICAgICAgPHN0b3Agc3RvcC1jb2xvcj0iIzQ2OCIgb2Zmc2V0PSIxIi8+CiAgICA8L2xpbmVhckdyYWRpZW50PgogIDwvZGVmcz4KCiAgPHBhdGggZD0iTTI3LDE2YzAtNyw5LTEzLDI0LTEzYzE1LDAsMjMsNiwyMywxM2wwLDIyYzAsNy01LDEyLTExLDEybC0yNCwwYy04LDAtMTQsNi0xNCwxNWwwLDEwbC05LDBjLTgsMC0xMy05LTEzLTI0YzAtMTQsNS0yMywxMy0yM2wzNSwwbDAtM2wtMjQsMGwwLTlsMCwweiBNODgsNTB2MSIgZmlsbD0idXJsKCNweUJsdWUpIi8+CiAgPHBhdGggZD0iTTc0LDg3YzAsNy04LDEzLTIzLDEzYy0xNSwwLTI0LTYtMjQtMTNsMC0yMmMwLTcsNi0xMiwxMi0xMmwyNCwwYzgsMCwxNC03LDE0LTE1bDAtMTBsOSwwYzcsMCwxMyw5LDEzLDIzYzAsMTUtNiwyNC0xMywyNGwtMzUsMGwwLDNsMjMsMGwwLDlsMCwweiBNMTQwLDUwdjEiIGZpbGw9InVybCgjcHlZZWxsb3cpIi8+CgogIDxjaXJjbGUgcj0iNCIgY3g9IjY0IiBjeT0iODgiIGZpbGw9IiNGRkYiLz4KICA8Y2lyY2xlIHI9IjQiIGN4PSIzNyIgY3k9IjE1IiBmaWxsPSIjRkZGIi8+Cjwvc3ZnPgo=)
+![PyPI - Version](https://img.shields.io/pypi/v/pandas-plots) ![GitHub last commit](https://img.shields.io/github/last-commit/smeisegeier/pandas-plots?logo=github) ![GitHub License](https://img.shields.io/github/license/smeisegeier/pandas-plots?logo=github) ![py3.10](https://img.shields.io/badge/python-3.10_|_3.11_|_3.12-blue.svg?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxMDAgMTAwIj4KICA8ZGVmcz4KICAgIDxsaW5lYXJHcmFkaWVudCBpZD0icHlZZWxsb3ciIGdyYWRpZW50VHJhbnNmb3JtPSJyb3RhdGUoNDUpIj4KICAgICAgPHN0b3Agc3RvcC1jb2xvcj0iI2ZlNSIgb2Zmc2V0PSIwLjYiLz4KICAgICAgPHN0b3Agc3RvcC1jb2xvcj0iI2RhMSIgb2Zmc2V0PSIxIi8+CiAgICA8L2xpbmVhckdyYWRpZW50PgogICAgPGxpbmVhckdyYWRpZW50IGlkPSJweUJsdWUiIGdyYWRpZW50VHJhbnNmb3JtPSJyb3RhdGUoNDUpIj4KICAgICAgPHN0b3Agc3RvcC1jb2xvcj0iIzY5ZiIgb2Zmc2V0PSIwLjQiLz4KICAgICAgPHN0b3Agc3RvcC1jb2xvcj0iIzQ2OCIgb2Zmc2V0PSIxIi8+CiAgICA8L2xpbmVhckdyYWRpZW50PgogIDwvZGVmcz4KCiAgPHBhdGggZD0iTTI3LDE2YzAtNyw5LTEzLDI0LTEzYzE1LDAsMjMsNiwyMywxM2wwLDIyYzAsNy01LDEyLTExLDEybC0yNCwwYy04LDAtMTQsNi0xNCwxNWwwLDEwbC05LDBjLTgsMC0xMy05LTEzLTI0YzAtMTQsNS0yMywxMy0yM2wzNSwwbDAtM2wtMjQsMGwwLTlsMCwweiBNODgsNTB2MSIgZmlsbD0idXJsKCNweUJsdWUpIi8+CiAgPHBhdGggZD0iTTc0LDg3YzAsNy04LDEzLTIzLDEzYy0xNSwwLTI0LTYtMjQtMTNsMC0yMmMwLTcsNi0xMiwxMi0xMmwyNCwwYzgsMCwxNC03LDE0LTE1bDAtMTBsOSwwYzcsMCwxMyw5LDEzLDIzYzAsMTUtNiwyNC0xMywyNGwtMzUsMGwwLDNsMjMsMGwwLDlsMCwweiBNMTQwLDUwdjEiIGZpbGw9InVybCgjcHlZZWxsb3cpIi8+CgogIDxjaXJjbGUgcj0iNCIgY3g9IjY0IiBjeT0iODgiIGZpbGw9IiNGRkYiLz4KICA8Y2lyY2xlIHI9IjQiIGN4PSIzNyIgY3k9IjE1IiBmaWxsPSIjRkZGIi8+Cjwvc3ZnPgo=)
 
 ## usage
 
@@ -98,8 +98,9 @@ tbl.show_num_df(
   - `mean_confidence_interval()` calculates mean and confidence interval for a series
   - `wrap_text()` formats strings or lists to a given width to fit nicely on the screen
   - `replace_delimiter_outside_quotes()` when manual import of csv files is needed: replaces delimiters only outside of quotes
-  - 🆕 `create_barcode_from_url()` creates a barcode from a given URL
-  - 🆕 `add_datetime_col()` adds a datetime columns to a dataframe
+  - `create_barcode_from_url()` creates a barcode from a given URL
+  - `add_datetime_col()` adds a datetime columns to a dataframe
+  - 🆕 `show_package_version` prints version of a list of packages
 
 > note: theme setting can be controlled through all functions by setting the environment variable `THEME` to either light or dark
 

pandas_plots-0.11.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+pandas_plots/hlp.py,sha256=polax8sI3z4fKXzIjmjIvDmgnIs3xpBLf4__HPdW9CM,10069
+pandas_plots/pls.py,sha256=BzZge7TnECjCs47MZ7P63_y2WU23P9sLaMl7SKB5h1Q,35043
+pandas_plots/tbl.py,sha256=IhDjn-ZD63af6R9WXLSaVGRXA35YM8BDj3OR_SIjG2M,23360
+pandas_plots/ven.py,sha256=2x3ACo2vSfO3q6fv-UdDQ0h1SJyt8WChBGgE5SDCdCk,11673
+pandas_plots-0.11.1.dist-info/LICENSE,sha256=6KQ5KVAAhRaB-JJKpX4cefKvRZRgI7GUPc92_2d31XY,1051
+pandas_plots-0.11.1.dist-info/METADATA,sha256=LFXFik6-kCkSOiWspbRrQ9m4TXf2f0yFGGoJRclGLJE,6703
+pandas_plots-0.11.1.dist-info/WHEEL,sha256=cpQTJ5IWu9CdaPViMhC9YzF8gZuS5-vlfoFihTBC86A,91
+pandas_plots-0.11.1.dist-info/top_level.txt,sha256=XnaNuIHBqMmCeh_U7nKOYTwFue_SIA0wxuDgdPmnnSk,13
+pandas_plots-0.11.1.dist-info/RECORD,,

{pandas_plots-0.11.0.dist-info → pandas_plots-0.11.1.dist-info}/WHEEL

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

pandas_plots-0.11.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-pandas_plots/hlp.py,sha256=sv0cRy_orkGnv3H6yQiaOIZ771cfA2aR-mz2upMC50A,9257
-pandas_plots/pls.py,sha256=9nztIx9Nzec092KsBXSg7EEIyQnqNS5cUhdD7NgjkMg,35043
-pandas_plots/tbl.py,sha256=Z7LraRWoFkLIKgI92-SV1Txs42uMwVsnSitZ57hr7h4,23078
-pandas_plots/ven.py,sha256=nDKS7cTIHOJhIXKnAxAkEoqPgVZCUPJld5CvSiB2JC4,11721
-pandas_plots-0.11.0.dist-info/LICENSE,sha256=6KQ5KVAAhRaB-JJKpX4cefKvRZRgI7GUPc92_2d31XY,1051
-pandas_plots-0.11.0.dist-info/METADATA,sha256=5g7Jr_uVDt2QCidgNL6JgnqfJFYWsviv-Si6CJZFf-4,6630
-pandas_plots-0.11.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-pandas_plots-0.11.0.dist-info/top_level.txt,sha256=XnaNuIHBqMmCeh_U7nKOYTwFue_SIA0wxuDgdPmnnSk,13
-pandas_plots-0.11.0.dist-info/RECORD,,