viewx 0.2.2__tar.gz → 0.2.4__tar.gz

{viewx-0.2.2 → viewx-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: viewx
-Version: 0.2.2
+Version: 0.2.4
 Summary: Librería de visualización adaptable para HTML, Dashboards y PDFs en Python
 Home-page: https://github.com/GhostAnalyst30/ViewX
 Author: Emmanuel Ascendra Perez
@@ -25,7 +25,6 @@ Requires-Dist: matplotlib>=3.8.0
 Requires-Dist: pylatex>=1.4.2
 Requires-Dist: seaborn>=0.12.2
 Requires-Dist: plotly>=6.0.0
-Requires-Dist: streamlit>=1.32.0
 Provides-Extra: streamlit
 Requires-Dist: streamlit>=1.32.0; extra == "streamlit"
 Provides-Extra: dash
@@ -52,7 +51,7 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
-# ViewX — v2.2
+# ViewX — v2.4
 
 **ViewX** es un paquete moderno de Python diseñado para generar **páginas HTML interactivas**, **dashboards dinámicos** y **visualizaciones inteligentes** que se adaptan automáticamente a los objetos agregados por el usuario.
 
@@ -78,81 +77,53 @@ pip install viewx
 
 ## Ejemplo rápido
 
-### Crear una página HTML
+### Crear un DashBoard HTML
 ```python
-import pandas as pd
-from viewx.HTML import HTML
-
-# 1. Crear datos de ejemplo
-df_ventas = pd.DataFrame({
-    'Mes': ['Ene', 'Feb', 'Mar', 'Abr', 'May', 'Jun', 'Jul', 'Ago', 'Sep', 'Oct', 'Nov', 'Dic'],
-    'Ventas': [120, 135, 148, 170, 195, 210, 245, 268, 290, 310, 335, 400],
-    'Beneficio': [30, 35, 42, 51, 58, 63, 73, 80, 87, 93, 100, 120],
-    'Clientes': [45, 48, 52, 58, 65, 72, 80, 88, 95, 102, 110, 125]
-})
-
-# Datos para gráfico de barras
-df_productos = pd.DataFrame({
-    'Producto': ['Producto A', 'Producto B', 'Producto C', 'Producto D', 'Producto E'],
-    'Ventas': [450, 320, 280, 190, 150]
+df = pd.DataFrame({
+    "date": dates, "region": regions, "product": products,
+    "revenue": revenue_str, "costs": costs.round(2),
+    "units": units, "rating": rating, "returned": returned,
 })
-
-# Datos para scatter
-df_clientes = pd.DataFrame({
-    'Edad': [25, 32, 28, 45, 38, 29, 51, 42, 35, 30],
-    'Gasto': [120, 200, 150, 300, 250, 180, 400, 320, 220, 160],
-    'Segmento': ['Joven', 'Adulto', 'Joven', 'Senior', 'Adulto', 'Joven', 'Senior', 'Adulto', 'Adulto', 'Joven']
-})
-
-# 2. Configurar el dashboard
-dashboard = HTML(
-    title="📊 Dashboard Ejecutivo - Demo",
-    theme="corporate_blue",  # Temas: corporate_blue, dark_enterprise, modern_green, void_indigo, glass_ocean, cyberpunk_neon
-    cols=12,  # Grid de 12 columnas
-    rows=12,  # 12 filas de altura
-    gap=16,
-    padding=20,
-    navbar={
-        "title": "📈 ViewX PRO",
-        "items": [
-            {"label": "Inicio", "link": "#"},
-            {"label": "Ventas", "link": "#"},
-            {"label": "Clientes", "link": "#"},
-            {"label": "Reportes", "link": "#"}
-        ]
-    }
+df["revenue"] = pd.to_numeric(
+    df["revenue"].str.replace(r"[$,]", "", regex=True), errors="coerce"
 )
 
-# 3. Añadir componentes (row, col, height, width)
-# Fila 1: KPIs
-dashboard.add_valuebox("Ventas Totales", "$2.8M", "💰", row=1, col=1, height=2, width=3)
-dashboard.add_valuebox("Beneficio Neto", "$942K", "📈", "#00A86B", row=1, col=4, height=2, width=3)
-dashboard.add_valuebox("Clientes Activos", "1,247", "👥", "#FF6B35", row=1, col=7, height=2, width=3)
-dashboard.add_valuebox("Tasa Conversión", "24.5%", "🎯", "#9B59B6", row=1, col=10, height=2, width=3)
-
-# Fila 2-5: Gráfico de líneas (ventas mensuales) - Método sencillo con datos
-dashboard.add_chart(
-    data=df_ventas,
-    chart_type="line",
-    x="Mes",
-    y="Ventas",
-    title="📈 Evolución de Ventas 2024",
-    row=3, col=1, height=10, width=6
+fig_bar = px.bar(
+    df.groupby("region")["revenue"].sum().reset_index().sort_values("revenue"),
+    x="revenue", y="region", orientation="h", color="region",
+    color_discrete_sequence=["#059669", "#10B981", "#34D399", "#6EE7B7"],
 )
+fig_bar.update_layout(showlegend=False)
 
-# Fila 2-5: Gráfico de barras (productos) - Otro ejemplo sencillo
-dashboard.add_chart(
-    data=df_productos,
-    chart_type="bar",
-    x="Producto",
-    y="Ventas",
-    title="🏷️ Ventas por Producto",
-    row=3, col=7, height=10, width=6
+fig_line = px.line(
+    df.groupby("date")["revenue"].sum().reset_index(),
+    x="date", y="revenue", color_discrete_sequence=["#059669"],
 )
 
-# 4. Generar el archivo
-dashboard.generate("mi_dashboard.html")
+dash = HTML(
+    title="Manual Dashboard", theme="modern_green",
+    cols=12, rows=9, gap=14, padding=20,
+    navbar={"title": "Manual Dashboard",
+            "items": [{"label": "Home", "link": "#"}, {"label": "Analytics", "link": "#"}]},
+    authors=[{"name": "Data Team", "email": "data@acme.com"}],
+    data_button=True, df=df,
+)
 
+dash.add_valuebox("Total Revenue", "$2.4M",  icon_key="dollar",  row=1, col=1,  height=2, width=3)
+dash.add_valuebox("Total Units",   "18.4K",  icon_key="box",     row=1, col=4,  height=2, width=3)
+dash.add_valuebox("Avg Rating",    "4.12",   icon_key="award",   row=1, col=7,  height=2, width=3)
+dash.add_valuebox("Return Rate",   "12%",    icon_key="percent", row=1, col=10, height=2, width=3)
+
+dash.add_infobox(df=df, variable="revenue",
+    info=["mean", "median", "std", "min", "max", "kurtosis", "skewness", "nulls"],
+    title="Revenue Stats", row=3, col=1, height=4, width=3)
+dash.add_chart(fig=fig_bar, title="Revenue by Region",
+    row=3, col=4, height=4, width=9, show_info_btn=True,
+    _info_stats={"Regions": "4", "Total": "$2.4M"})
+dash.add_chart(fig=fig_line, title="Daily Revenue Trend",
+    row=7, col=1, height=3, width=12, show_info_btn=True)
+
+dash.generate("demo6_manual.html")
 ```
 
 ![DashBoardViewX](https://raw.githubusercontent.com/GhostAnalyst30/ViewX/main/images_for_git/DashBoard_Example.png

{viewx-0.2.2 → viewx-0.2.4}/README.md

@@ -1,4 +1,4 @@
-# ViewX — v2.2
+# ViewX — v2.4
 
 **ViewX** es un paquete moderno de Python diseñado para generar **páginas HTML interactivas**, **dashboards dinámicos** y **visualizaciones inteligentes** que se adaptan automáticamente a los objetos agregados por el usuario.
 
@@ -24,81 +24,53 @@ pip install viewx
 
 ## Ejemplo rápido
 
-### Crear una página HTML
+### Crear un DashBoard HTML
 ```python
-import pandas as pd
-from viewx.HTML import HTML
-
-# 1. Crear datos de ejemplo
-df_ventas = pd.DataFrame({
-    'Mes': ['Ene', 'Feb', 'Mar', 'Abr', 'May', 'Jun', 'Jul', 'Ago', 'Sep', 'Oct', 'Nov', 'Dic'],
-    'Ventas': [120, 135, 148, 170, 195, 210, 245, 268, 290, 310, 335, 400],
-    'Beneficio': [30, 35, 42, 51, 58, 63, 73, 80, 87, 93, 100, 120],
-    'Clientes': [45, 48, 52, 58, 65, 72, 80, 88, 95, 102, 110, 125]
-})
-
-# Datos para gráfico de barras
-df_productos = pd.DataFrame({
-    'Producto': ['Producto A', 'Producto B', 'Producto C', 'Producto D', 'Producto E'],
-    'Ventas': [450, 320, 280, 190, 150]
+df = pd.DataFrame({
+    "date": dates, "region": regions, "product": products,
+    "revenue": revenue_str, "costs": costs.round(2),
+    "units": units, "rating": rating, "returned": returned,
 })
-
-# Datos para scatter
-df_clientes = pd.DataFrame({
-    'Edad': [25, 32, 28, 45, 38, 29, 51, 42, 35, 30],
-    'Gasto': [120, 200, 150, 300, 250, 180, 400, 320, 220, 160],
-    'Segmento': ['Joven', 'Adulto', 'Joven', 'Senior', 'Adulto', 'Joven', 'Senior', 'Adulto', 'Adulto', 'Joven']
-})
-
-# 2. Configurar el dashboard
-dashboard = HTML(
-    title="📊 Dashboard Ejecutivo - Demo",
-    theme="corporate_blue",  # Temas: corporate_blue, dark_enterprise, modern_green, void_indigo, glass_ocean, cyberpunk_neon
-    cols=12,  # Grid de 12 columnas
-    rows=12,  # 12 filas de altura
-    gap=16,
-    padding=20,
-    navbar={
-        "title": "📈 ViewX PRO",
-        "items": [
-            {"label": "Inicio", "link": "#"},
-            {"label": "Ventas", "link": "#"},
-            {"label": "Clientes", "link": "#"},
-            {"label": "Reportes", "link": "#"}
-        ]
-    }
+df["revenue"] = pd.to_numeric(
+    df["revenue"].str.replace(r"[$,]", "", regex=True), errors="coerce"
 )
 
-# 3. Añadir componentes (row, col, height, width)
-# Fila 1: KPIs
-dashboard.add_valuebox("Ventas Totales", "$2.8M", "💰", row=1, col=1, height=2, width=3)
-dashboard.add_valuebox("Beneficio Neto", "$942K", "📈", "#00A86B", row=1, col=4, height=2, width=3)
-dashboard.add_valuebox("Clientes Activos", "1,247", "👥", "#FF6B35", row=1, col=7, height=2, width=3)
-dashboard.add_valuebox("Tasa Conversión", "24.5%", "🎯", "#9B59B6", row=1, col=10, height=2, width=3)
-
-# Fila 2-5: Gráfico de líneas (ventas mensuales) - Método sencillo con datos
-dashboard.add_chart(
-    data=df_ventas,
-    chart_type="line",
-    x="Mes",
-    y="Ventas",
-    title="📈 Evolución de Ventas 2024",
-    row=3, col=1, height=10, width=6
+fig_bar = px.bar(
+    df.groupby("region")["revenue"].sum().reset_index().sort_values("revenue"),
+    x="revenue", y="region", orientation="h", color="region",
+    color_discrete_sequence=["#059669", "#10B981", "#34D399", "#6EE7B7"],
 )
+fig_bar.update_layout(showlegend=False)
 
-# Fila 2-5: Gráfico de barras (productos) - Otro ejemplo sencillo
-dashboard.add_chart(
-    data=df_productos,
-    chart_type="bar",
-    x="Producto",
-    y="Ventas",
-    title="🏷️ Ventas por Producto",
-    row=3, col=7, height=10, width=6
+fig_line = px.line(
+    df.groupby("date")["revenue"].sum().reset_index(),
+    x="date", y="revenue", color_discrete_sequence=["#059669"],
 )
 
-# 4. Generar el archivo
-dashboard.generate("mi_dashboard.html")
+dash = HTML(
+    title="Manual Dashboard", theme="modern_green",
+    cols=12, rows=9, gap=14, padding=20,
+    navbar={"title": "Manual Dashboard",
+            "items": [{"label": "Home", "link": "#"}, {"label": "Analytics", "link": "#"}]},
+    authors=[{"name": "Data Team", "email": "data@acme.com"}],
+    data_button=True, df=df,
+)
 
+dash.add_valuebox("Total Revenue", "$2.4M",  icon_key="dollar",  row=1, col=1,  height=2, width=3)
+dash.add_valuebox("Total Units",   "18.4K",  icon_key="box",     row=1, col=4,  height=2, width=3)
+dash.add_valuebox("Avg Rating",    "4.12",   icon_key="award",   row=1, col=7,  height=2, width=3)
+dash.add_valuebox("Return Rate",   "12%",    icon_key="percent", row=1, col=10, height=2, width=3)
+
+dash.add_infobox(df=df, variable="revenue",
+    info=["mean", "median", "std", "min", "max", "kurtosis", "skewness", "nulls"],
+    title="Revenue Stats", row=3, col=1, height=4, width=3)
+dash.add_chart(fig=fig_bar, title="Revenue by Region",
+    row=3, col=4, height=4, width=9, show_info_btn=True,
+    _info_stats={"Regions": "4", "Total": "$2.4M"})
+dash.add_chart(fig=fig_line, title="Daily Revenue Trend",
+    row=7, col=1, height=3, width=12, show_info_btn=True)
+
+dash.generate("demo6_manual.html")
 ```
 
 ![DashBoardViewX](https://raw.githubusercontent.com/GhostAnalyst30/ViewX/main/images_for_git/DashBoard_Example.png

{viewx-0.2.2 → viewx-0.2.4}/setup.py

@@ -9,7 +9,7 @@ except FileNotFoundError:
 
 setup(
     name="viewx",
-    version="0.2.2",
+    version="0.2.4",
     author="Emmanuel Ascendra Perez",
     author_email="ascendraemmanuel@gmail.com",
     description="Librería de visualización adaptable para HTML, Dashboards y PDFs en Python",
@@ -47,8 +47,7 @@ setup(
         "matplotlib>=3.8.0",
         "pylatex>=1.4.2",  # Para PDFs
         "seaborn>=0.12.2",
-        "plotly>=6.0.0",
-        "streamlit>=1.32.0"
+        "plotly>=6.0.0"
     ],
 
     # Dependencias opcionales

{viewx-0.2.2 → viewx-0.2.4}/tests/test1.py

@@ -35,6 +35,7 @@ HTML.auto_generate(
     df,
     title    = "Demo 1 · Auto Layout",
     filename = "demo1_auto.html",
+    show     = False,
 )
 
 # ════════════════════════════════════════════════════════════════════════════
@@ -49,7 +50,8 @@ HTML.auto_generate(
     authors  = [
         {"name": "Ana García",  "email": "ana@empresa.com"},
         {"name": "Luis Torres", "email": "luis@empresa.com"},
-    ]
+    ],
+    show     = False,
 )
 
 # ════════════════════════════════════════════════════════════════════════════
@@ -63,6 +65,7 @@ HTML.auto_generate(
     filename = "demo3_kpi_focus.html",
     layout   = "kpi_focus",
     authors  = "Carlos Méndez",
+    show     = False,
 )
 
 # ════════════════════════════════════════════════════════════════════════════
@@ -75,6 +78,7 @@ HTML.auto_generate(
     title    = "Demo 4 · Chart Focus",
     filename = "demo4_chart_focus.html",
     layout   = "chart_focus",
+    show     = False,
 )
 
 # ════════════════════════════════════════════════════════════════════════════
@@ -87,14 +91,11 @@ HTML.auto_generate(
     title    = "Demo 5 · Table First",
     filename = "demo5_table_first.html",
     layout   = "table_first",
+    show     = False,
 )
 
 # ════════════════════════════════════════════════════════════════════════════
 # DEMO 6 — Layout 100% personalizado
-#   Diseño:
-#   [KPI ventas] [KPI utilidad] [KPI unidades] | [Chart barras región]
-#   [Chart línea temporal (ventas)            ] | [Chart scatter        ]
-#   [Tabla completa                                                      ]
 # ════════════════════════════════════════════════════════════════════════════
 HTML.auto_generate(
     df,
@@ -104,19 +105,15 @@ HTML.auto_generate(
     filename = "demo6_custom.html",
     authors  = [{"name": "Equipo BI", "email": "bi@empresa.com"}],
     layout   = [
-        # Fila 1: 3 KPIs a la izquierda + 1 chart a la derecha
         {"type": "kpi",   "index": 0, "row": 1, "col": 1,  "height": 2, "width": 3},
         {"type": "kpi",   "index": 1, "row": 1, "col": 4,  "height": 2, "width": 3},
         {"type": "kpi",   "index": 2, "row": 1, "col": 7,  "height": 2, "width": 3},
-        {"type": "chart", "index": 1, "row": 1, "col": 10, "height": 7, "width": 3},  # barras región
-
-        # Fila 2: línea temporal grande + scatter
-        {"type": "chart", "index": 0, "row": 3, "col": 1,  "height": 5, "width": 6},  # línea tiempo
-        {"type": "chart", "index": 2, "row": 3, "col": 7,  "height": 5, "width": 3},  # scatter
-
-        # Fila 3: tabla completa
+        {"type": "chart", "index": 1, "row": 1, "col": 10, "height": 7, "width": 3},
+        {"type": "chart", "index": 0, "row": 3, "col": 1,  "height": 5, "width": 6},
+        {"type": "chart", "index": 2, "row": 3, "col": 7,  "height": 5, "width": 3},
         {"type": "table",             "row": 8, "col": 1,  "height": 4, "width": 12},
-    ]
+    ],
+    show     = False,
 )
 
 # ════════════════════════════════════════════════════════════════════════════
@@ -135,9 +132,10 @@ HTML.auto_generate(
     template = "corporate_blue",
     title    = "Demo 7 · Parseo Automático de Strings",
     filename = "demo7_parseo.html",
+    show     = False,
 )
 
-print("\n✅ Todos los dashboards generados:")
+print("\nTodos los dashboards generados:")
 for i, name in enumerate([
     "demo1_auto.html",
     "demo2_cols.html",
@@ -147,4 +145,4 @@ for i, name in enumerate([
     "demo6_custom.html",
     "demo7_parseo.html",
 ], 1):
-    print(f"   {i}. {name}")
+    print(f"   {i}. {name}")

viewx-0.2.4/tests/test8_slides_auto.py

@@ -0,0 +1,15 @@
+"""Auto-generated slides from a DataFrame."""
+
+from viewx.datasets import load_iris
+from viewx.Slides import Presentation
+
+df = load_iris()
+
+path = Presentation.auto_generate(
+    df,
+    title="Iris Dataset Overview",
+    theme="ocean",
+    filename="output/test8_auto_slides.html",
+    show=False,
+)
+print(f"Presentation.auto_generate -> {path}")

viewx-0.2.4/tests/test9_report_auto.py

@@ -0,0 +1,22 @@
+"""Auto-generated PDF quality report from a DataFrame."""
+
+import shutil
+
+from viewx.datasets import load_iris
+from viewx import Report
+
+if not shutil.which("pdflatex"):
+    print("SKIP: pdflatex not found — install a LaTeX distribution to run this test.")
+    raise SystemExit(0)
+
+df = load_iris()
+
+path = Report.auto_generate(
+    df,
+    title="Iris Dataset Quality Report",
+    author="ViewX Test",
+    filename="test9_auto_report",
+    outdir="output",
+    include_plots=True,
+)
+print(f"Report.auto_generate -> {path}")

viewx-0.2.4/viewx/DataMatrix/__init__.py

@@ -0,0 +1,30 @@
+from .analyzers import (
+    AnalyzerEngine,
+    BooleanStrategy,
+    CategoricalStrategy,
+    ColumnProfile,
+    ColumnTypeStrategy,
+    DatasetReport,
+    DateTimeStrategy,
+    NumericStrategy,
+)
+from .bibliometrics import BibliometricsAnalyzer
+from .datamatrix_engine import DataMatrix, ReportTheme
+from .explorer import build_explorer_payload
+from .visualizer import Visualizer
+
+__all__ = [
+    "DataMatrix",
+    "ReportTheme",
+    "AnalyzerEngine",
+    "Visualizer",
+    "BibliometricsAnalyzer",
+    "DatasetReport",
+    "ColumnProfile",
+    "ColumnTypeStrategy",
+    "NumericStrategy",
+    "CategoricalStrategy",
+    "DateTimeStrategy",
+    "BooleanStrategy",
+    "build_explorer_payload",
+]