pandas-plots 0.10.1__tar.gz → 0.11.1__tar.gz

{pandas-plots-0.10.1/src/pandas_plots.egg-info → pandas_plots-0.11.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pandas-plots
-Version: 0.10.1
+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
 
@@ -154,3 +155,7 @@ _df, _details = ven.show_venn3(
 ```
 
 ![venn](https://github.com/smeisegeier/pandas-plots/blob/main/img/2024-02-19-20-49-52.png?raw=true)
+
+## tags
+
+#pandas, #plotly, #visualizations, #statistics

{pandas-plots-0.10.1 → pandas_plots-0.11.1}/README.md

@@ -1,6 +1,6 @@
 # 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
 
@@ -69,8 +69,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
 
@@ -125,3 +126,7 @@ _df, _details = ven.show_venn3(
 ```
 
 ![venn](https://github.com/smeisegeier/pandas-plots/blob/main/img/2024-02-19-20-49-52.png?raw=true)
+
+## tags
+
+#pandas, #plotly, #visualizations, #statistics

{pandas-plots-0.10.1 → pandas_plots-0.11.1}/setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = pandas-plots
-version = 0.10.1
+version = 0.11.1
 author = smeisegeier
 author_email = dexterDSDo@googlemail.com
 description = A collection of helper for table handling and vizualization

{pandas-plots-0.10.1 → pandas_plots-0.11.1}/src/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
@@ -8,7 +9,7 @@ from PIL import Image
 import requests
 import re
 
-from tenacity import retry
+# from devtools import debug
 
 URL_REGEX = r"^(?:http|ftp)s?://"  # https://stackoverflow.com/a/1617386
 
@@ -125,53 +126,67 @@ def replace_delimiter_outside_quotes(
 
 
 def wrap_text(
-    text: str | list, max_items_in_line: int = 70, sep: bool = True, apo: bool = False
+    text: str | list,
+    max_items_in_line: int = 70,
+    use_sep: bool = True,
+    use_apo: bool = False,
 ):
     """
     A function that wraps text into lines with a maximum number of items per line.
+    Important: enclose this function in a print() statement to print the text
 
     Args:
         text (str | list): The input text or list of words to be wrapped.
         max_items_in_line (int): The maximum number of items allowed in each line.
-        sep (bool, optional): Whether to include a comma separator between items. Defaults to True.
-        apo (bool, optional): Whether to enclose each word in single quotes. Defaults to False.
+        use_sep (bool, optional): When list: Whether to include a comma separator between items. Defaults to True.
+        use_apo (bool, optional): When list: Whether to enclose each word in single quotes. Defaults to False.
+    Returns: the wrapped text
     """
 
-    # * check if text is string, then strip and build word list
+    # * check if text is string
     is_text = isinstance(text, str)
     if is_text:
+        # ! when splitting the text later by blanks, newlines are not correctly handled
+        # * to detect them, they must be followed by a blank:
+        pattern = r'(\n)(?=\S)' # *forward lookup for newline w/ no blank
+        # * add blank after these newlines
+        new_text = re.sub(pattern, r"\1 ", text)
+        text=new_text
+
+        # * then strip and build word list
         text = (
             text.replace(",", "")
             .replace("'", "")
             .replace("[", "")
             .replace("]", "")
+            # * use explicit blanks to prevent newline split
             .split(" ")
         )
 
-    # * start
+    # * loop setup
     i = 0
     line = ""
-
     # * loop through words
     out = ""
     for word in text:
-        apo_s = "'" if apo else ""
-        sep_s = "," if sep and not is_text else ""
+        apo_s = "'" if use_apo and not is_text else ""
+        sep_s = "," if use_sep and not is_text else ""
         word_s = f"{apo_s}{str(word)}{apo_s}{sep_s}"
         # * inc counter
         i = i + len(word_s)
         # * construct print line
         line = line + word_s + " "
-        # * reset if counter exceeds limit
-        if i >= max_items_in_line:
+        # * reset if counter exceeds limit, or if word ends with newline
+        if i >= max_items_in_line or str(word).endswith("\n"):
             out = out + line + "\n"
             line = ""
             i = 0
         # else:
-    # * on short lists no reset happens, trigger manually
-    out = line if not out else out
-    # * cut last newline
-    return f"[{out[:-1]}]"
+    # * on short lists no line reset happens, so just print the line
+    # * else add last line
+    out = line if not out else out + line
+    # * cut off last newline
+    return f"[{out[:-1].strip()}]"
 
 
 def create_barcode_from_url(
@@ -211,21 +226,24 @@ def create_barcode_from_url(
         # plt.axis('off')  # Turn off axis numbers
         plt.show()
 
+
 def add_datetime_columns(df: pd.DataFrame, date_column: str = None) -> pd.DataFrame:
-    df_= df.copy()
+    df_ = df.copy()
     if not date_column:
-        date_column = [col for col in df_.columns if pd.api.types.is_datetime64_any_dtype(df_[col])][0]
+        date_column = [
+            col for col in df_.columns if pd.api.types.is_datetime64_any_dtype(df_[col])
+        ][0]
     else:
         df_[date_column] = pd.to_datetime(df_[date_column])
 
     if not date_column or not pd.api.types.is_datetime64_any_dtype(df_[date_column]):
         print("❌ No datetime column found")
         return
-    
+
     if [col for col in df_.columns if "YYYY-WW" in col]:
         print("❌ Added datetime columns already exist")
         return
-    
+
     print(f"⏳ Adding datetime columns basing off of: {date_column}")
 
     df_["YYYY"] = df_[date_column].dt.year
@@ -235,9 +253,33 @@ def add_datetime_columns(df: pd.DataFrame, date_column: str = None) -> pd.DataFr
     df_["YYYY-MM"] = df_[date_column].dt.to_period("M").astype(str)
     df_["YYYYQ"] = df_[date_column].dt.to_period("Q").astype(str)
     df_["YYYY-WW"] = (
-        df_[date_column].dt.isocalendar().year.astype(str) + "-W" +
-        df_[date_column].dt.isocalendar().week.astype(str).str.zfill(2)
+        df_[date_column].dt.isocalendar().year.astype(str)
+        + "-W"
+        + df_[date_column].dt.isocalendar().week.astype(str).str.zfill(2)
     )
-    df_["DDD"] = df_[date_column].dt.weekday.map({0: "Mon", 1: "Tue", 2: "Wed", 3: "Thu", 4: "Fri", 5: "Sat", 6: "Sun"})
-    
+    df_["DDD"] = df_[date_column].dt.weekday.map(
+        {0: "Mon", 1: "Tue", 2: "Wed", 3: "Thu", 4: "Fri", 5: "Sat", 6: "Sun"}
+    )
+
     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-0.10.1 → pandas_plots-0.11.1}/src/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-0.10.1 → pandas_plots-0.11.1}/src/pandas_plots/tbl.py

@@ -1,4 +1,5 @@
 import warnings
+
 warnings.filterwarnings("ignore")
 
 import math
@@ -14,14 +15,18 @@ from plotly.subplots import make_subplots
 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
 
 TOTAL_LITERAL = Literal[
     "sum", "mean", "median", "min", "max", "std", "var", "skew", "kurt"
 ]
-KPI_LITERAL = Literal["rag_abs","rag_rel", "min_max_xy", "max_min_xy", "min_max_x", "max_min_x"]
+KPI_LITERAL = Literal[
+    "rag_abs", "rag_rel", "min_max_xy", "max_min_xy", "min_max_x", "max_min_x"
+]
 
 
 def describe_df(
@@ -108,7 +113,7 @@ def describe_df(
             is_str = df.loc[:, col].dtype.kind == "O"
             # * wrap output
             print(
-                f"{_h} {wrap_text(_u[:top_n_uniques], max_items_in_line=70, apo=is_str)}"
+                f"{_h} {wrap_text(_u[:top_n_uniques], max_items_in_line=70, use_apo=is_str)}"
             )
             # print(f"{_h} {_u[:top_n_uniques]}")
         else:
@@ -130,14 +135,16 @@ def describe_df(
     # ! *** PLOTS ***
     if not use_plot:
         return
-    
+
     # * reduce column names len if selected
     if top_n_chars_in_columns > 0:
         # * minumum 10 chars, or display is cluttered
-        top_n_chars_in_columns = 10 if top_n_chars_in_columns < 10 else top_n_chars_in_columns
+        top_n_chars_in_columns = (
+            10 if top_n_chars_in_columns < 10 else top_n_chars_in_columns
+        )
         col_list = []
         for i, col in enumerate(df.columns):
-            col_list.append(col[:top_n_chars_in_columns]+"_"+str(i).zfill(3))
+            col_list.append(col[:top_n_chars_in_columns] + "_" + str(i).zfill(3))
         df.columns = col_list
 
     # * respect fig_offset to exclude unwanted plots from maintanance columns
@@ -183,7 +190,7 @@ def describe_df(
                     else s[:top_n_chars_in_index]
                 )
                 x = [_cut(item) for item in x]
-            
+
             figsub = px.bar(
                 x=x,
                 y=y,
@@ -219,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:
@@ -318,7 +326,7 @@ def pivot_df(
         heatmap_axis=heatmap_axis,
         kpi_mode=kpi_mode,
         kpi_rag_list=kpi_rag_list,
-        kpi_shape=kpi_shape
+        kpi_shape=kpi_shape,
     )
 
 
@@ -359,12 +367,15 @@ 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.
     """
     # * ensure arguments match parameter definition
     if any([df[col].dtype.kind not in ["i", "u", "f"] for col in df.columns]) == True:
-        print(f"❌ table must contain numeric data only. Maybe you forgot to convert this table with pivot or pivot_table first?")
+        print(
+            f"❌ table must contain numeric data only. Maybe you forgot to convert this table with pivot or pivot_table first?"
+        )
         return
 
     if (
@@ -383,16 +394,16 @@ def show_num_df(
         print(f"❌ kpi_mode '{kpi_mode}' not supported")
         return
 
-    if (kpi_mode and kpi_mode.startswith("rag")) and (not isinstance(kpi_rag_list, abc.Iterable) 
-        or len(kpi_rag_list) != 2
-        ):
+    if (kpi_mode and kpi_mode.startswith("rag")) and (
+        not isinstance(kpi_rag_list, abc.Iterable) or len(kpi_rag_list) != 2
+    ):
         print(f"❌ kpi_rag_list must be a list of 2 if kpi_mode is set")
         return
-    
+
     if kpi_mode == "rag_rel":
         # * transform values into percentiles
         if all(i <= 1 and i >= 0 for i in kpi_rag_list):
-            kpi_rag_list = [int(i*100) for i in kpi_rag_list]
+            kpi_rag_list = [int(i * 100) for i in kpi_rag_list]
         else:
             print(f"❌ kpi_list for relative mode must be between 0 and 1")
             return
@@ -415,17 +426,21 @@ def show_num_df(
         df_.loc["Total"] = df_.agg(total_mode, axis=0)
     if total_mode and total_axis in ["y", "xy"]:
         df_.loc[:, "Total"] = df_.agg(total_mode, axis=1)
-    
+
     # hack
     # * column sum values are distorted by totals, these must be rendered out
-    col_divider = 2 if (total_axis in ["x", "xy"] and pct_axis == "x" and total_mode=="sum") else 1
+    col_divider = (
+        2
+        if (total_axis in ["x", "xy"] and pct_axis == "x" and total_mode == "sum")
+        else 1
+    )
     col_sum = df_.sum() / col_divider
-    
+
     # * min values are unaffected
     col_min = df_.min()
 
     # * max values are affected by totals, ignore total row if present
-    last_row = -1 if (total_axis in ["x", "xy"] and total_mode=="sum") else None
+    last_row = -1 if (total_axis in ["x", "xy"] and total_mode == "sum") else None
     col_max = df_[:last_row].max()
 
     # * derive style
@@ -449,41 +464,44 @@ def show_num_df(
             # align="zero",
         )
 
-    
     def get_kpi(val: float, col: str) -> str:
         """
         Function to calculate and return the appropriate icon based on the given value and key performance indicator (KPI) mode.
-        
+
         Parameters:
         val (float): The value to be evaluated.
         col (str): The column associated with the value.
-        
+
         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": {
-                "light":["🟩", "🟨", "🟥", "⬜"],
-                "dark":["🟩", "🟨", "🟥", "⬛"]
-                },
+                "light": ["🟩", "🟨", "🟥", "⬜"],
+                "dark": ["🟩", "🟨", "🟥", "⬛"],
+            },
             "circle": {
-                "light":["🟢", "🟡", "🔴", "⚪"],
-                "dark":["🟢", "🟡", "🔴", "⚫"]
-                },
+                "light": ["🟢", "🟡", "🔴", "⚪"],
+                "dark": ["🟢", "🟡", "🔴", "⚫"],
+            },
         }
         icons = dict_icons[kpi_shape][theme]
-        
         # * transform values into percentiles if relative mode
-        kpi_rag_list_= kpi_rag_list
-        if kpi_mode=="rag_rel":
+        kpi_rag_list_ = kpi_rag_list
+        if kpi_mode == "rag_rel":
             # * get both percentile thresholds
             pcntl_1 = np.percentile(df_orig, kpi_rag_list[0])
             pcntl_2 = np.percentile(df_orig, kpi_rag_list[1])
             kpi_rag_list_ = [pcntl_1, pcntl_2]
-        
+
         # * for rag mopde both rel and abs
         if kpi_mode.startswith("rag"):
             # * get fitting icon
@@ -500,39 +518,26 @@ def show_num_df(
                     else icons[1] if val > kpi_rag_list_[1] else icons[2]
                 )
             return icon
-        
+
         # * for min/max mode, get min and max either from table or column
         # ! care for max values
         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]
-            )
+        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]
-            )
+            result = icons[0] if val == max_ else icons[2] if val == min_ else icons[3]
         else:
-            # * no matching mode founf
-            result=""
-
+            # * no matching mode found
+            result = ""
         return result
 
     # * all cell formatting in one place
     def format_cell(val, col):
         """
-        A function to format a cell value based on the sum and percentage axis. 
+        A function to format a cell value based on the sum and percentage axis.
         Parameters:
         - val: The value of the cell.
         - col: The column index of the cell.
@@ -540,8 +545,8 @@ def show_num_df(
         Returns a formatted string for the cell value.
         """
         # * calc sum depending on pct_axis
-        sum_=tbl_sum if pct_axis=="xy" else col_sum[col] if pct_axis=="x" else val
-        val_rel= 0 if sum_== 0 else val / sum_
+        sum_ = tbl_sum if pct_axis == "xy" else col_sum[col] if pct_axis == "x" else val
+        val_rel = 0 if sum_ == 0 else val / sum_
 
         # * get kpi icon
         kpi = get_kpi(val, col=col)
@@ -556,14 +561,11 @@ def show_num_df(
         if pct_axis:
             return f'{val:_.{precision}f} <span style="color: {color_pct}">({val_rel:.1%}) {kpi}</span>'
         if show_as_pct:
-            return f'{val:.{precision}%} {kpi}'
+            return f"{val:.{precision}%} {kpi}"
         return f"{val:_.{precision}f} {kpi}"
 
-    # * formatter is now unified, col wise
-    formatter = {
-        col: lambda x, col=col: format_cell(x, col=col)
-        for col in df_.columns
-    }
+    # * 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
     #     row_sums = _df.sum(axis=1) / divider
@@ -572,6 +574,7 @@ def show_num_df(
     #     }
 
     # * apply formatter
+    # debug(formatter)
     out.format(formatter=formatter)
 
     # * apply fonts for cells

{pandas-plots-0.10.1 → pandas_plots-0.11.1}/src/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.10.1 → pandas_plots-0.11.1/src/pandas_plots.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pandas-plots
-Version: 0.10.1
+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
 
@@ -154,3 +155,7 @@ _df, _details = ven.show_venn3(
 ```
 
 ![venn](https://github.com/smeisegeier/pandas-plots/blob/main/img/2024-02-19-20-49-52.png?raw=true)
+
+## tags
+
+#pandas, #plotly, #visualizations, #statistics