viewx 0.2.1__tar.gz → 0.2.2__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: viewx
-Version: 0.2.1
+Version: 0.2.2
 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
@@ -52,7 +52,7 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
-# 📦 ViewX — v2.1
+# ViewX — v2.2
 
 **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.
 
@@ -60,15 +60,14 @@ Este proyecto ofrece una solución **ligera, intuitiva y escalable**, ideal para
 
 ---
 
-## ✨ Características principales
+## Características principales
 
-- ⚡ **Rápido y minimalista**: cero dependencias pesadas por defecto.  
-- 🧩 **API intuitiva**: crea páginas y dashboards en segundos.  
-- 📐 **Diseño adaptativo**: cada componente se acomoda automáticamente.  
-- 🌐 **Modo HTML**: genera páginas `.html` totalmente autónomas.  
-- 📊 **Modo Dashboard**: plantillas escalables con soporte opcional para Streamlit/Dash.  
-- 🛠️ **Extensible**: añade tus propias plantillas y módulos personalizados.  
-- 🔮 **Visión a futuro**: pensado para expandirse a interfaces inteligentes.
+- **Rápido y minimalista**: cero dependencias pesadas por defecto.  
+- **API intuitiva**: crea páginas y dashboards en segundos.  
+- **Diseño adaptativo**: cada componente se acomoda automáticamente.  
+- **Modo HTML**: genera páginas `.html` totalmente autónomas.  
+- **Extensible**: añade tus propias plantillas y módulos personalizados.  
+- **Visión a futuro**: pensado para expandirse a interfaces inteligentes.
 
 ---
 
@@ -77,7 +76,7 @@ Este proyecto ofrece una solución **ligera, intuitiva y escalable**, ideal para
 pip install viewx
 ```
 
-## 🚀 Ejemplo rápido
+## Ejemplo rápido
 
 ### Crear una página HTML
 ```python
@@ -156,54 +155,9 @@ dashboard.generate("mi_dashboard.html")
 
 ```
 
-![DashBoardIris](https://raw.githubusercontent.com/GhostAnalyst30/ViewX/main/images_for_git/DashBoard_Example.png
+![DashBoardViewX](https://raw.githubusercontent.com/GhostAnalyst30/ViewX/main/images_for_git/DashBoard_Example.png
 )
 
-### Crear un DashBoard
-```python
-from viewx.DashBoard import DashBoard
-from viewx.datasets import load_dataset
-
-df = load_dataset("iris.csv")
-
-db = DashBoard(df, title="StreamOps: Mini Dashboard", title_align="center")
-db.set_theme(background="#071021", text="#E9F6F2", primary="#19D3A3", card="#0b1620")
-# Sidebar
-db.add_sidebar(db.comp_text("Parámetros del reporte"))
-db.add_sidebar(db.comp_metric("Longitud del dataset", df.shape[0]))
-db.add_sidebar(db.comp_metric("Cantidad de Flores", df["species"].unique().shape[0]))
-# Main layout
-db.add_blank()
-db.add_row(
-    col_widths=[1, 2, 1],
-    components=[
-        db.comp_blank(),
-        db.comp_plot(x="sepal_length", y="sepal_width", kind="scatter", color="#FFB86B"),
-        db.comp_metric("sepal_width", df["sepal_width"].sum(), delta="▲ 5%")
-    ]
-)
-
-db.add_tabs({
-    "Overview": [
-        db.comp_title("Resumen por Región"),
-        db.comp_table()
-    ],
-    "Details": [
-        db.comp_title("Distribución de Flores"),
-        db.comp_plot(x="species", y=None, kind="hist", color="#7C4DFF")
-    ]
-})
-
-db.add_expander("Detalles técnicos", [
-    db.comp_text("Este panel fue generado automáticamente."),
-    db.comp_text("Metadata: filas=" + str(len(df)), size="12px")
-], expanded=True)
-
-db.run(open_browser=True)   
-```
-
-![DashBoard Streamlit](https://raw.githubusercontent.com/GhostAnalyst30/ViewX/main/images_for_git/DashBoard_Streamlit_1.png)
-
 ### Crear una Presentacion
 
 ```python
@@ -447,10 +401,10 @@ report_path = dm.generate_report("demo_datamatrix_report.html", title="Análisis
 print(f"Reporte generado exitosamente en: {report_path}")
 ```
 
-## 🤝 Contribuciones
+## Contribuciones
 
 ¡Todas las ideas, mejoras y plantillas son bienvenidas!
 ViewX está diseñado para crecer y evolucionar con la comunidad.
 
-## 📬 Contacto:
+## Contacto:
 ascendraemmanuel@gmail.com

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

@@ -1,4 +1,4 @@
-# 📦 ViewX — v2.1
+# ViewX — v2.2
 
 **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.
 
@@ -6,15 +6,14 @@ Este proyecto ofrece una solución **ligera, intuitiva y escalable**, ideal para
 
 ---
 
-## ✨ Características principales
+## Características principales
 
-- ⚡ **Rápido y minimalista**: cero dependencias pesadas por defecto.  
-- 🧩 **API intuitiva**: crea páginas y dashboards en segundos.  
-- 📐 **Diseño adaptativo**: cada componente se acomoda automáticamente.  
-- 🌐 **Modo HTML**: genera páginas `.html` totalmente autónomas.  
-- 📊 **Modo Dashboard**: plantillas escalables con soporte opcional para Streamlit/Dash.  
-- 🛠️ **Extensible**: añade tus propias plantillas y módulos personalizados.  
-- 🔮 **Visión a futuro**: pensado para expandirse a interfaces inteligentes.
+- **Rápido y minimalista**: cero dependencias pesadas por defecto.  
+- **API intuitiva**: crea páginas y dashboards en segundos.  
+- **Diseño adaptativo**: cada componente se acomoda automáticamente.  
+- **Modo HTML**: genera páginas `.html` totalmente autónomas.  
+- **Extensible**: añade tus propias plantillas y módulos personalizados.  
+- **Visión a futuro**: pensado para expandirse a interfaces inteligentes.
 
 ---
 
@@ -23,7 +22,7 @@ Este proyecto ofrece una solución **ligera, intuitiva y escalable**, ideal para
 pip install viewx
 ```
 
-## 🚀 Ejemplo rápido
+## Ejemplo rápido
 
 ### Crear una página HTML
 ```python
@@ -102,54 +101,9 @@ dashboard.generate("mi_dashboard.html")
 
 ```
 
-![DashBoardIris](https://raw.githubusercontent.com/GhostAnalyst30/ViewX/main/images_for_git/DashBoard_Example.png
+![DashBoardViewX](https://raw.githubusercontent.com/GhostAnalyst30/ViewX/main/images_for_git/DashBoard_Example.png
 )
 
-### Crear un DashBoard
-```python
-from viewx.DashBoard import DashBoard
-from viewx.datasets import load_dataset
-
-df = load_dataset("iris.csv")
-
-db = DashBoard(df, title="StreamOps: Mini Dashboard", title_align="center")
-db.set_theme(background="#071021", text="#E9F6F2", primary="#19D3A3", card="#0b1620")
-# Sidebar
-db.add_sidebar(db.comp_text("Parámetros del reporte"))
-db.add_sidebar(db.comp_metric("Longitud del dataset", df.shape[0]))
-db.add_sidebar(db.comp_metric("Cantidad de Flores", df["species"].unique().shape[0]))
-# Main layout
-db.add_blank()
-db.add_row(
-    col_widths=[1, 2, 1],
-    components=[
-        db.comp_blank(),
-        db.comp_plot(x="sepal_length", y="sepal_width", kind="scatter", color="#FFB86B"),
-        db.comp_metric("sepal_width", df["sepal_width"].sum(), delta="▲ 5%")
-    ]
-)
-
-db.add_tabs({
-    "Overview": [
-        db.comp_title("Resumen por Región"),
-        db.comp_table()
-    ],
-    "Details": [
-        db.comp_title("Distribución de Flores"),
-        db.comp_plot(x="species", y=None, kind="hist", color="#7C4DFF")
-    ]
-})
-
-db.add_expander("Detalles técnicos", [
-    db.comp_text("Este panel fue generado automáticamente."),
-    db.comp_text("Metadata: filas=" + str(len(df)), size="12px")
-], expanded=True)
-
-db.run(open_browser=True)   
-```
-
-![DashBoard Streamlit](https://raw.githubusercontent.com/GhostAnalyst30/ViewX/main/images_for_git/DashBoard_Streamlit_1.png)
-
 ### Crear una Presentacion
 
 ```python
@@ -393,10 +347,10 @@ report_path = dm.generate_report("demo_datamatrix_report.html", title="Análisis
 print(f"Reporte generado exitosamente en: {report_path}")
 ```
 
-## 🤝 Contribuciones
+## Contribuciones
 
 ¡Todas las ideas, mejoras y plantillas son bienvenidas!
 ViewX está diseñado para crecer y evolucionar con la comunidad.
 
-## 📬 Contacto:
+## Contacto:
 ascendraemmanuel@gmail.com

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

@@ -9,7 +9,7 @@ except FileNotFoundError:
 
 setup(
     name="viewx",
-    version="0.2.1",
+    version="0.2.2",
     author="Emmanuel Ascendra Perez",
     author_email="ascendraemmanuel@gmail.com",
     description="Librería de visualización adaptable para HTML, Dashboards y PDFs en Python",

viewx-0.2.2/tests/test1.py

@@ -0,0 +1,150 @@
+import pandas as pd
+import numpy as np
+from datetime import datetime, timedelta
+from viewx.HTML.html_engine import HTML
+
+# ── Generar datos de demo ────────────────────────────────────────────────────
+np.random.seed(42)
+n = 200
+
+fechas    = [datetime(2024, 1, 1) + timedelta(days=i) for i in range(n)]
+regiones  = np.random.choice(["Norte", "Sur", "Este", "Oeste", "Centro"], n)
+productos = np.random.choice(["Laptop", "Tablet", "Phone", "Monitor", "Teclado"], n)
+ventas    = np.random.randint(500, 10000, n)
+utilidad  = ventas * np.random.uniform(0.1, 0.4, n)
+unidades  = np.random.randint(1, 50, n)
+activo    = np.random.choice([True, False], n)
+
+df = pd.DataFrame({
+    "fecha"    : fechas,
+    "region"   : regiones,
+    "producto" : productos,
+    "ventas"   : ventas,
+    "utilidad" : utilidad.astype(int),
+    "unidades" : unidades,
+    "activo"   : activo,
+})
+
+print("Columnas disponibles:", df.columns.tolist())
+print(df.head(3))
+
+# ════════════════════════════════════════════════════════════════════════════
+# DEMO 1 — Layout automático, tema por defecto
+# ════════════════════════════════════════════════════════════════════════════
+HTML.auto_generate(
+    df,
+    title    = "Demo 1 · Auto Layout",
+    filename = "demo1_auto.html",
+)
+
+# ════════════════════════════════════════════════════════════════════════════
+# DEMO 2 — Solo algunas columnas + tema oscuro
+# ════════════════════════════════════════════════════════════════════════════
+HTML.auto_generate(
+    df,
+    columns  = ["fecha", "ventas", "utilidad", "region"],
+    template = "dark_enterprise",
+    title    = "Demo 2 · Columnas seleccionadas",
+    filename = "demo2_cols.html",
+    authors  = [
+        {"name": "Ana García",  "email": "ana@empresa.com"},
+        {"name": "Luis Torres", "email": "luis@empresa.com"},
+    ]
+)
+
+# ════════════════════════════════════════════════════════════════════════════
+# DEMO 3 — Preset kpi_focus + tema void_indigo
+# ════════════════════════════════════════════════════════════════════════════
+HTML.auto_generate(
+    df,
+    columns  = ["ventas", "utilidad", "unidades", "region", "producto"],
+    template = "void_indigo",
+    title    = "Demo 3 · KPI Focus",
+    filename = "demo3_kpi_focus.html",
+    layout   = "kpi_focus",
+    authors  = "Carlos Méndez",
+)
+
+# ════════════════════════════════════════════════════════════════════════════
+# DEMO 4 — Preset chart_focus + tema glass_ocean
+# ════════════════════════════════════════════════════════════════════════════
+HTML.auto_generate(
+    df,
+    columns  = ["fecha", "ventas", "utilidad", "region"],
+    template = "glass_ocean",
+    title    = "Demo 4 · Chart Focus",
+    filename = "demo4_chart_focus.html",
+    layout   = "chart_focus",
+)
+
+# ════════════════════════════════════════════════════════════════════════════
+# DEMO 5 — Preset table_first + tema cyberpunk_neon
+# ════════════════════════════════════════════════════════════════════════════
+HTML.auto_generate(
+    df,
+    columns  = ["fecha", "region", "producto", "ventas", "unidades"],
+    template = "cyberpunk_neon",
+    title    = "Demo 5 · Table First",
+    filename = "demo5_table_first.html",
+    layout   = "table_first",
+)
+
+# ════════════════════════════════════════════════════════════════════════════
+# 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,
+    columns  = ["fecha", "region", "ventas", "utilidad", "unidades"],
+    template = "modern_green",
+    title    = "Demo 6 · Layout Personalizado",
+    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": "table",             "row": 8, "col": 1,  "height": 4, "width": 12},
+    ]
+)
+
+# ════════════════════════════════════════════════════════════════════════════
+# DEMO 7 — DataFrame con strings numéricos (prueba parseo automático)
+# ════════════════════════════════════════════════════════════════════════════
+df_strings = pd.DataFrame({
+    "mes"      : ["Ene", "Feb", "Mar", "Abr", "May", "Jun"],
+    "ingresos" : ["$12,500", "$9,800", "$15,200", "$11,000", "$18,400", "$14,700"],
+    "costos"   : ["8500",    "7200",   "9800",    "8100",    "12000",   "10500"],
+    "margen%"  : ["32%",     "27%",    "36%",     "26%",     "35%",     "29%"],
+    "ciudad"   : ["Bogotá",  "Medellín","Cali",   "Bogotá",  "Cali",    "Medellín"],
+})
+
+HTML.auto_generate(
+    df_strings,
+    template = "corporate_blue",
+    title    = "Demo 7 · Parseo Automático de Strings",
+    filename = "demo7_parseo.html",
+)
+
+print("\n✅ Todos los dashboards generados:")
+for i, name in enumerate([
+    "demo1_auto.html",
+    "demo2_cols.html",
+    "demo3_kpi_focus.html",
+    "demo4_chart_focus.html",
+    "demo5_table_first.html",
+    "demo6_custom.html",
+    "demo7_parseo.html",
+], 1):
+    print(f"   {i}. {name}")

{viewx-0.2.1 → viewx-0.2.2}/tests/test4.py

@@ -38,7 +38,9 @@ dashboard = HTML(
             {"label": "Clientes", "link": "#"},
             {"label": "Reportes", "link": "#"}
         ]
-    }
+    },
+    authors=[{"name": "Emmanuel Ascendra", "email": "ascendraemmanuel@gmail.com"},
+             {"name": "Juan Perez", "email": "juanperez@gmail.com"}]
 )
 
 # 3. Añadir componentes (row, col, height, width)