pandas-plots 0.11.19__tar.gz → 0.11.21__tar.gz

{pandas_plots-0.11.19/src/pandas_plots.egg-info → pandas_plots-0.11.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pandas-plots
-Version: 0.11.19
+Version: 0.11.21
 Summary: A collection of helper for table handling and vizualization
 Home-page: https://github.com/smeisegeier/pandas-plots
 Author: smeisegeier

{pandas_plots-0.11.19 → pandas_plots-0.11.21}/setup.cfg

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

{pandas_plots-0.11.19 → pandas_plots-0.11.21}/src/pandas_plots/tbl.py

@@ -30,10 +30,34 @@ KPI_LITERAL = Literal[
 ]
 
 
-def descr_db(db: ddb.duckdb.DuckDBPyRelation, caption: str = "db")->None:
+def descr_db(
+    db: ddb.duckdb.DuckDBPyRelation, 
+    caption: str = "db",
+    use_preview: bool = True,
+)->None:
+    """
+    Print a short description of the given duckdb relation.
+
+    Parameters
+    ----------
+    db: ddb.duckdb.DuckDBPyRelation
+        The relation to be described
+    caption: str, optional
+        A caption to be printed left of the description. Defaults to "db".
+    use_preview: bool, optional
+        Whether to print a preview of the first 3 rows of the relation. Defaults to True.
+
+    Returns
+    -------
+    None
+    """
     cols = ", ".join(db.columns)
     print(f'🗄️ {caption}\t{db.count("*").fetchone()[0]:_}, {db.columns.__len__()}\n\t("{cols}")')
 
+    if use_preview:
+        db.limit(3).show()
+    return
+
 def describe_df(
     df: pd.DataFrame,
     caption: str,
@@ -99,7 +123,10 @@ def describe_df(
     print(f"🟣 shape: ({df.shape[0]:_}, {df.shape[1]}) columns: {np.array(df.columns)} ")
     # print(f"🟣 shape: ({df.shape[0]:_}, {df.shape[1]}) columns: {df.columns.tolist()} ")
     print(f"🟣 duplicates: {df.duplicated().sum():_}")
-    print(f"🟣 missings: {dict(df.isna().sum())}")
+    print(f"🟣 uniques: { {col: f'{df[col].nunique():_}' for col in df} }")
+    # print(f"🟣 uniques: {{ {', '.join(f'{col}: {df[col].nunique():_}' for col in df)} }}")
+    print(f"🟣 missings: { {col: f'{df[col].isna().sum():_}' for col in df} }")
+    # print(f"🟣 missings: {dict(df.isna().sum())}")
 
     def get_uniques_header(col: str):
         # * sorting has issues when col is of mixed type (object)
@@ -367,6 +394,7 @@ def show_num_df(
     kpi_mode: KPI_LITERAL = None,
     kpi_shape: Literal["squad", "circle"] = "squad",
     show_as_pct: bool = False,
+    alter_font: bool = True,
 ):
     """
     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.
@@ -391,6 +419,7 @@ def show_num_df(
     - 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)
+    - alter_font: a boolean indicating whether to alter the font family
 
     The function returns a styled representation of the DataFrame.
     """
@@ -601,7 +630,8 @@ def show_num_df(
     out.format(formatter=formatter)
 
     # * apply fonts for cells
-    out.set_properties(**{"font-family": "Courier"})
+    if alter_font:
+        out.set_properties(**{"font-family": "Courier"})
 
     # * apply fonts for th (inkl. index)
     _props = [

{pandas_plots-0.11.19 → pandas_plots-0.11.21/src/pandas_plots.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pandas-plots
-Version: 0.11.19
+Version: 0.11.21
 Summary: A collection of helper for table handling and vizualization
 Home-page: https://github.com/smeisegeier/pandas-plots
 Author: smeisegeier