truthound-dashboard 1.5.0__tar.gz → 1.5.2__tar.gz

{truthound_dashboard-1.5.0 → truthound_dashboard-1.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: truthound-dashboard
-Version: 1.5.0
+Version: 1.5.2
 Summary: Open-source data quality dashboard - GX Cloud alternative
 Author-email: Truthound Team <team@truthound.dev>
 License-Expression: Apache-2.0
@@ -44,8 +44,9 @@ Provides-Extra: translate
 Description-Content-Type: text/markdown
 
 # truthound-dashboard
+<img width="1697" height="847" alt="truthound-dashboard" src="https://github.com/user-attachments/assets/2239ebff-470b-49fe-ab09-81bc3117880d" />
 
-> **UNDER ACTIVE DEVELOPMENT**: This project is currently in active development. APIs and features may change without notice. Not recommended for production use yet.
+> **Alpha Version**: APIs and features may change without notice.
 
 ## Overview
 <img width="300" height="300" alt="Truthound_icon" src="https://github.com/user-attachments/assets/90d9e806-8895-45ec-97dc-f8300da4d997" />
@@ -60,7 +61,9 @@ A web-based data quality monitoring dashboard for [truthound](https://github.com
 
 truthound-dashboard provides a graphical interface for managing data sources, executing validations, tracking historical results, scheduling automated checks, and configuring notifications. It serves as an alternative to commercial data quality platforms.
 
-[Documentation](https://truthound.netlify.app) | [PyPI](https://pypi.org/project/truthound-dashboard/)
+[Documentation](https://truthound.netlify.app) | [PyPI](https://pypi.org/project/truthound-dashboard/) | [Live Demo](https://truthound-dashboard.vercel.app)
+
+> **Demo Note**: The live demo uses a free-tier backend ([Render](https://render.com)), which enters sleep mode after 15 minutes of inactivity. The first request may take 30–60 seconds to wake up the server.
 
 ## Design Principles
 

{truthound_dashboard-1.5.0 → truthound_dashboard-1.5.2}/README.md

@@ -1,6 +1,7 @@
 # truthound-dashboard
+<img width="1697" height="847" alt="truthound-dashboard" src="https://github.com/user-attachments/assets/2239ebff-470b-49fe-ab09-81bc3117880d" />
 
-> **UNDER ACTIVE DEVELOPMENT**: This project is currently in active development. APIs and features may change without notice. Not recommended for production use yet.
+> **Alpha Version**: APIs and features may change without notice.
 
 ## Overview
 <img width="300" height="300" alt="Truthound_icon" src="https://github.com/user-attachments/assets/90d9e806-8895-45ec-97dc-f8300da4d997" />
@@ -15,7 +16,9 @@ A web-based data quality monitoring dashboard for [truthound](https://github.com
 
 truthound-dashboard provides a graphical interface for managing data sources, executing validations, tracking historical results, scheduling automated checks, and configuring notifications. It serves as an alternative to commercial data quality platforms.
 
-[Documentation](https://truthound.netlify.app) | [PyPI](https://pypi.org/project/truthound-dashboard/)
+[Documentation](https://truthound.netlify.app) | [PyPI](https://pypi.org/project/truthound-dashboard/) | [Live Demo](https://truthound-dashboard.vercel.app)
+
+> **Demo Note**: The live demo uses a free-tier backend ([Render](https://render.com)), which enters sleep mode after 15 minutes of inactivity. The first request may take 30–60 seconds to wake up the server.
 
 ## Design Principles
 

{truthound_dashboard-1.5.0 → truthound_dashboard-1.5.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "truthound-dashboard"
-version = "1.5.0"
+version = "1.5.2"
 description = "Open-source data quality dashboard - GX Cloud alternative"
 readme = "README.md"
 license = "Apache-2.0"

{truthound_dashboard-1.5.0 → truthound_dashboard-1.5.2}/src/truthound_dashboard/core/connections.py

@@ -187,7 +187,7 @@ class FileConnectionBuilder(ConnectionBuilder):
     """Connection builder for file-based sources."""
 
     source_type = SourceType.FILE
-    SUPPORTED_EXTENSIONS = {".csv", ".parquet", ".json", ".xlsx", ".xls"}
+    SUPPORTED_EXTENSIONS = {".csv", ".parquet", ".json", ".ndjson", ".jsonl"}
 
     def build(self, config: dict[str, Any]) -> str:
         """Build file path from config."""
@@ -216,7 +216,7 @@ class FileConnectionBuilder(ConnectionBuilder):
         return SourceTypeDefinition(
             type=SourceType.FILE.value,
             name="File",
-            description="Local file (CSV, Parquet, JSON, Excel)",
+            description="Local file (CSV, Parquet, JSON, NDJSON, JSONL)",
             icon="file",
             category="file",
             fields=[
@@ -237,7 +237,8 @@ class FileConnectionBuilder(ConnectionBuilder):
                         {"value": "csv", "label": "CSV"},
                         {"value": "parquet", "label": "Parquet"},
                         {"value": "json", "label": "JSON"},
-                        {"value": "excel", "label": "Excel"},
+                        {"value": "ndjson", "label": "NDJSON"},
+                        {"value": "jsonl", "label": "JSONL"},
                     ],
                     default="auto",
                     description="File format (auto-detected from extension if not specified)",
@@ -271,13 +272,195 @@ class FileConnectionBuilder(ConnectionBuilder):
                     default=True,
                     description="First row contains column names",
                 ),
+            ],
+        )
+
+
+class CSVConnectionBuilder(FileConnectionBuilder):
+    """Connection builder for CSV files."""
+
+    source_type = SourceType.CSV
+
+    @classmethod
+    def get_definition(cls) -> SourceTypeDefinition:
+        return SourceTypeDefinition(
+            type=SourceType.CSV.value,
+            name="CSV",
+            description="Comma-separated values file",
+            icon="file",
+            category="file",
+            fields=[
                 FieldDefinition(
-                    name="sheet",
-                    label="Sheet Name",
-                    placeholder="Sheet1",
-                    description="Excel sheet name (for Excel files)",
-                    depends_on="format",
-                    depends_value="excel",
+                    name="path",
+                    label="File Path",
+                    type=FieldType.FILE_PATH,
+                    required=True,
+                    placeholder="/path/to/data.csv",
+                    description="Path to the CSV file",
+                ),
+                FieldDefinition(
+                    name="delimiter",
+                    label="Delimiter",
+                    placeholder=",",
+                    default=",",
+                    description="CSV delimiter character",
+                ),
+                FieldDefinition(
+                    name="encoding",
+                    label="Encoding",
+                    type=FieldType.SELECT,
+                    options=[
+                        {"value": "utf-8", "label": "UTF-8"},
+                        {"value": "utf-16", "label": "UTF-16"},
+                        {"value": "iso-8859-1", "label": "ISO-8859-1 (Latin-1)"},
+                        {"value": "cp1252", "label": "Windows-1252"},
+                    ],
+                    default="utf-8",
+                    description="File encoding",
+                ),
+                FieldDefinition(
+                    name="has_header",
+                    label="Has Header Row",
+                    type=FieldType.BOOLEAN,
+                    default=True,
+                    description="First row contains column names",
+                ),
+            ],
+        )
+
+
+class ParquetConnectionBuilder(FileConnectionBuilder):
+    """Connection builder for Parquet files."""
+
+    source_type = SourceType.PARQUET
+
+    @classmethod
+    def get_definition(cls) -> SourceTypeDefinition:
+        return SourceTypeDefinition(
+            type=SourceType.PARQUET.value,
+            name="Parquet",
+            description="Apache Parquet columnar storage file",
+            icon="file",
+            category="file",
+            fields=[
+                FieldDefinition(
+                    name="path",
+                    label="File Path",
+                    type=FieldType.FILE_PATH,
+                    required=True,
+                    placeholder="/path/to/data.parquet",
+                    description="Path to the Parquet file",
+                ),
+            ],
+        )
+
+
+class JSONConnectionBuilder(FileConnectionBuilder):
+    """Connection builder for JSON files."""
+
+    source_type = SourceType.JSON
+
+    @classmethod
+    def get_definition(cls) -> SourceTypeDefinition:
+        return SourceTypeDefinition(
+            type=SourceType.JSON.value,
+            name="JSON",
+            description="JSON file (array of objects)",
+            icon="file_json",
+            category="file",
+            fields=[
+                FieldDefinition(
+                    name="path",
+                    label="File Path",
+                    type=FieldType.FILE_PATH,
+                    required=True,
+                    placeholder="/path/to/data.json",
+                    description="Path to the JSON file",
+                ),
+                FieldDefinition(
+                    name="encoding",
+                    label="Encoding",
+                    type=FieldType.SELECT,
+                    options=[
+                        {"value": "utf-8", "label": "UTF-8"},
+                        {"value": "utf-16", "label": "UTF-16"},
+                    ],
+                    default="utf-8",
+                    description="File encoding",
+                ),
+            ],
+        )
+
+
+class NDJSONConnectionBuilder(FileConnectionBuilder):
+    """Connection builder for NDJSON files."""
+
+    source_type = SourceType.NDJSON
+
+    @classmethod
+    def get_definition(cls) -> SourceTypeDefinition:
+        return SourceTypeDefinition(
+            type=SourceType.NDJSON.value,
+            name="NDJSON",
+            description="Newline-delimited JSON file",
+            icon="file_json",
+            category="file",
+            fields=[
+                FieldDefinition(
+                    name="path",
+                    label="File Path",
+                    type=FieldType.FILE_PATH,
+                    required=True,
+                    placeholder="/path/to/data.ndjson",
+                    description="Path to the NDJSON file",
+                ),
+                FieldDefinition(
+                    name="encoding",
+                    label="Encoding",
+                    type=FieldType.SELECT,
+                    options=[
+                        {"value": "utf-8", "label": "UTF-8"},
+                        {"value": "utf-16", "label": "UTF-16"},
+                    ],
+                    default="utf-8",
+                    description="File encoding",
+                ),
+            ],
+        )
+
+
+class JSONLConnectionBuilder(FileConnectionBuilder):
+    """Connection builder for JSONL files."""
+
+    source_type = SourceType.JSONL
+
+    @classmethod
+    def get_definition(cls) -> SourceTypeDefinition:
+        return SourceTypeDefinition(
+            type=SourceType.JSONL.value,
+            name="JSONL",
+            description="JSON Lines file (one JSON object per line)",
+            icon="file_json",
+            category="file",
+            fields=[
+                FieldDefinition(
+                    name="path",
+                    label="File Path",
+                    type=FieldType.FILE_PATH,
+                    required=True,
+                    placeholder="/path/to/data.jsonl",
+                    description="Path to the JSONL file",
+                ),
+                FieldDefinition(
+                    name="encoding",
+                    label="Encoding",
+                    type=FieldType.SELECT,
+                    options=[
+                        {"value": "utf-8", "label": "UTF-8"},
+                        {"value": "utf-16", "label": "UTF-16"},
+                    ],
+                    default="utf-8",
+                    description="File encoding",
                 ),
             ],
         )
@@ -1581,11 +1764,11 @@ class KafkaConnectionBuilder(ConnectionBuilder):
 CONNECTION_BUILDERS: dict[str, type[ConnectionBuilder]] = {
     # File-based
     SourceType.FILE.value: FileConnectionBuilder,
-    SourceType.CSV.value: FileConnectionBuilder,
-    SourceType.PARQUET.value: FileConnectionBuilder,
-    SourceType.JSON.value: FileConnectionBuilder,
-    SourceType.NDJSON.value: FileConnectionBuilder,
-    SourceType.JSONL.value: FileConnectionBuilder,
+    SourceType.CSV.value: CSVConnectionBuilder,
+    SourceType.PARQUET.value: ParquetConnectionBuilder,
+    SourceType.JSON.value: JSONConnectionBuilder,
+    SourceType.NDJSON.value: NDJSONConnectionBuilder,
+    SourceType.JSONL.value: JSONLConnectionBuilder,
     # Core SQL
     SourceType.POSTGRESQL.value: PostgreSQLConnectionBuilder,
     SourceType.MYSQL.value: MySQLConnectionBuilder,
@@ -1735,11 +1918,18 @@ def get_supported_source_types() -> list[dict[str, Any]]:
         List of source type definitions.
     """
     result = []
+    seen_types: set[str] = set()
     for source_type in SourceType:
+        # Skip generic FILE type - specific format types (CSV, Parquet, etc.) cover it
+        if source_type == SourceType.FILE:
+            continue
         builder_class = CONNECTION_BUILDERS.get(source_type.value)
         if builder_class:
             definition = builder_class.get_definition()
-            result.append(definition.to_dict())
+            # Deduplicate by type value
+            if definition.type not in seen_types:
+                seen_types.add(definition.type)
+                result.append(definition.to_dict())
     return result
 
 
@@ -1774,12 +1964,17 @@ def get_source_types_by_category() -> dict[str, list[dict[str, Any]]]:
         "streaming": [],
     }
 
+    seen_types: set[str] = set()
     for source_type in SourceType:
+        if source_type == SourceType.FILE:
+            continue
         builder_class = CONNECTION_BUILDERS.get(source_type.value)
         if builder_class:
             definition = builder_class.get_definition()
-            category = definition.category
-            if category in categories:
-                categories[category].append(definition.to_dict())
+            if definition.type not in seen_types:
+                seen_types.add(definition.type)
+                category = definition.category
+                if category in categories:
+                    categories[category].append(definition.to_dict())
 
     return categories

{truthound_dashboard-1.5.0 → truthound_dashboard-1.5.2}/src/truthound_dashboard/main.py

@@ -24,6 +24,7 @@ Example:
 from __future__ import annotations
 
 import logging
+import os
 from collections.abc import AsyncGenerator
 from contextlib import asynccontextmanager
 from pathlib import Path
@@ -244,12 +245,15 @@ def configure_cors(app: FastAPI) -> None:
     """
     settings = get_settings()
 
+    extra_origins = os.environ.get("TRUTHOUND_CORS_ORIGINS", "")
     origins = [
         "http://localhost:5173",  # Vite dev server
         "http://127.0.0.1:5173",
         f"http://localhost:{settings.port}",  # Dashboard server
         f"http://127.0.0.1:{settings.port}",
     ]
+    if extra_origins:
+        origins.extend([o.strip() for o in extra_origins.split(",") if o.strip()])
 
     app.add_middleware(
         CORSMiddleware,

{truthound_dashboard-1.5.0 → truthound_dashboard-1.5.2}/src/truthound_dashboard/schemas/validation.py

@@ -130,7 +130,7 @@ class ValidationRunRequest(BaseSchema):
 class ValidationSummary(BaseSchema):
     """Summary statistics for a validation run."""
 
-    passed: bool = Field(..., description="Whether validation passed")
+    passed: bool | None = Field(default=None, description="Whether validation passed (null when status is error)")
     has_critical: bool = Field(default=False, description="Has critical issues")
     has_high: bool = Field(default=False, description="Has high severity issues")
     total_issues: int = Field(default=0, ge=0, description="Total issue count")
@@ -196,7 +196,7 @@ class ValidationResponse(IDMixin, ValidationSummary):
             id=validation.id,
             source_id=validation.source_id,
             status=validation.status,
-            passed=validation.passed or False,
+            passed=None if validation.status == "error" else (validation.passed or False),
             has_critical=validation.has_critical or False,
             has_high=validation.has_high or False,
             total_issues=validation.total_issues or 0,
@@ -239,7 +239,7 @@ class ValidationListItem(IDMixin, ValidationSummary):
             id=validation.id,
             source_id=validation.source_id,
             status=validation.status,
-            passed=validation.passed or False,
+            passed=None if validation.status == "error" else (validation.passed or False),
             has_critical=validation.has_critical or False,
             has_high=validation.has_high or False,
             total_issues=validation.total_issues or 0,

{truthound_dashboard-1.5.0 → truthound_dashboard-1.5.2}/src/truthound_dashboard/static/index.html

@@ -6,7 +6,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="description" content="Truthound Dashboard - Open-source data quality monitoring" />
     <title>Truthound Dashboard</title>
-    <script type="module" crossorigin src="/assets/index-BnWMZ9K7.js"></script>
+    <script type="module" crossorigin src="/assets/index-Ch94w21P.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-DDRuhd95.css">
   </head>
   <body>