pandas-plots 0.11.19__py3-none-any.whl → 0.11.21__py3-none-any.whl

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.dist-info → pandas_plots-0.11.21.dist-info}/METADATA

@@ -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
@@ -19,18 +19,18 @@ Classifier: Topic :: Scientific/Engineering
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: pandas >=2.0.0
-Requires-Dist: plotly >=5.18.0
-Requires-Dist: matplotlib >=3.8.2
-Requires-Dist: matplotlib-venn ==0.11.10
-Requires-Dist: seaborn >=0.13.2
-Requires-Dist: Jinja2 >=3.1.4
-Requires-Dist: requests >=2.32.0
-Requires-Dist: numpy <2.0.0
-Requires-Dist: missingno >=0.5.2
-Requires-Dist: duckdb >=1.0.0
-Requires-Dist: kaleido >=0.2.1
-Requires-Dist: nbformat >=4.2.0
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: plotly>=5.18.0
+Requires-Dist: matplotlib>=3.8.2
+Requires-Dist: matplotlib-venn==0.11.10
+Requires-Dist: seaborn>=0.13.2
+Requires-Dist: Jinja2>=3.1.4
+Requires-Dist: requests>=2.32.0
+Requires-Dist: numpy<2.0.0
+Requires-Dist: missingno>=0.5.2
+Requires-Dist: duckdb>=1.0.0
+Requires-Dist: kaleido>=0.2.1
+Requires-Dist: nbformat>=4.2.0
 
 # pandas-plots
 

pandas_plots-0.11.21.dist-info/RECORD

@@ -0,0 +1,10 @@
+pandas_plots/hlp.py,sha256=wrvy36rnSdg1I4uQjIzzwGmjcN0gvSfKylRf_7GKpXs,12001
+pandas_plots/pii.py,sha256=2WKE-W9s285jPdsTqCgt1uxuW4lj1PYCVOYB2fYDNwQ,2195
+pandas_plots/pls.py,sha256=C-EUvt9u7aXd6va7BGamf6HSODOnvbERwxu2Gb8PgbQ,35449
+pandas_plots/tbl.py,sha256=EH7fkNcc9ZDUionnrPYm6isq4AwTvUjC3qb9NMj_hXY,28181
+pandas_plots/ven.py,sha256=2x3ACo2vSfO3q6fv-UdDQ0h1SJyt8WChBGgE5SDCdCk,11673
+pandas_plots-0.11.21.dist-info/LICENSE,sha256=6KQ5KVAAhRaB-JJKpX4cefKvRZRgI7GUPc92_2d31XY,1051
+pandas_plots-0.11.21.dist-info/METADATA,sha256=E5yHO2tYJ9Jl6GfYA3XERhFKIYPSMx9Ne0bjsWqw7tk,7071
+pandas_plots-0.11.21.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+pandas_plots-0.11.21.dist-info/top_level.txt,sha256=XnaNuIHBqMmCeh_U7nKOYTwFue_SIA0wxuDgdPmnnSk,13
+pandas_plots-0.11.21.dist-info/RECORD,,

{pandas_plots-0.11.19.dist-info → pandas_plots-0.11.21.dist-info}/WHEEL

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

pandas_plots-0.11.19.dist-info/RECORD

@@ -1,10 +0,0 @@
-pandas_plots/hlp.py,sha256=wrvy36rnSdg1I4uQjIzzwGmjcN0gvSfKylRf_7GKpXs,12001
-pandas_plots/pii.py,sha256=2WKE-W9s285jPdsTqCgt1uxuW4lj1PYCVOYB2fYDNwQ,2195
-pandas_plots/pls.py,sha256=C-EUvt9u7aXd6va7BGamf6HSODOnvbERwxu2Gb8PgbQ,35449
-pandas_plots/tbl.py,sha256=iHaheCl4ZCh1NflzmNTR3zGHJJkY9ui_2Q5odCFw4v8,27261
-pandas_plots/ven.py,sha256=2x3ACo2vSfO3q6fv-UdDQ0h1SJyt8WChBGgE5SDCdCk,11673
-pandas_plots-0.11.19.dist-info/LICENSE,sha256=6KQ5KVAAhRaB-JJKpX4cefKvRZRgI7GUPc92_2d31XY,1051
-pandas_plots-0.11.19.dist-info/METADATA,sha256=DxRdBZ5oAChkvypXpvgYpOo12_0LxtYjQa5R9sHPa_c,7083
-pandas_plots-0.11.19.dist-info/WHEEL,sha256=R06PA3UVYHThwHvxuRWMqaGcr-PuniXahwjmQRFMEkY,91
-pandas_plots-0.11.19.dist-info/top_level.txt,sha256=XnaNuIHBqMmCeh_U7nKOYTwFue_SIA0wxuDgdPmnnSk,13
-pandas_plots-0.11.19.dist-info/RECORD,,