dashml-lang 0.1.0__tar.gz

dashml_lang-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dawid Olejniczak, Szymon Nowaczyk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dashml_lang-0.1.0/PKG-INFO

@@ -0,0 +1,140 @@
+Metadata-Version: 2.4
+Name: dashml-lang
+Version: 0.1.0
+Summary: Declarative YAML-based compiler for data visualization dashboards. Write your dashboard once, compile to Streamlit, Plotly, Observable Plot, Apache Superset, Vega-Lite, or Grafana.
+Author: Dawid Olejniczak, Szymon Nowaczyk
+License: MIT
+Project-URL: Homepage, https://github.com/dashml-dev/dashml
+Project-URL: Repository, https://github.com/dashml-dev/dashml
+Project-URL: Issues, https://github.com/dashml-dev/dashml/issues
+Keywords: dashboard,visualization,dsl,declarative,compiler,yaml,streamlit,plotly,observable-plot,vega-lite,grafana,superset,bigquery,business-intelligence
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Compilers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: streamlit
+Requires-Dist: streamlit>=1.40.0; extra == "streamlit"
+Requires-Dist: pandas>=2.0.0; extra == "streamlit"
+Requires-Dist: altair>=5.0.0; extra == "streamlit"
+Requires-Dist: watchdog>=4.0.0; extra == "streamlit"
+Provides-Extra: sql
+Requires-Dist: flask>=3.0.0; extra == "sql"
+Requires-Dist: sqlalchemy>=2.0.0; extra == "sql"
+Requires-Dist: psycopg2-binary>=2.9.0; extra == "sql"
+Provides-Extra: bigquery
+Requires-Dist: flask>=3.0.0; extra == "bigquery"
+Requires-Dist: google-cloud-bigquery>=3.0.0; extra == "bigquery"
+Provides-Extra: superset
+Requires-Dist: requests>=2.32.0; extra == "superset"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Dynamic: license-file
+
+# DashML
+
+A declarative language for data visualization dashboards that compiles to multiple platforms.
+
+Write your dashboard spec once in `.dashml` format, then compile it to **Streamlit**, **Plotly**, **Observable Plot**, **Apache Superset**, **Vega-Lite**, or **Grafana**.
+
+## Quick Start
+
+```bash
+# Generate a Streamlit app
+python -m dashml_new.cli build dashboard.dashml --target streamlit --output app_dir
+streamlit run app_dir/app.py
+
+# Generate a standalone Plotly HTML dashboard
+python -m dashml_new.cli build dashboard.dashml --target plotly --output dashboard.html
+
+# Generate an Observable Plot HTML dashboard
+python -m dashml_new.cli build dashboard.dashml --target observable --output dashboard.html
+
+# Generate a Vega-Lite JSON specification
+python -m dashml_new.cli build dashboard.dashml --target vegalite --output dashboard.json
+
+# Generate a Grafana dashboard JSON
+python -m dashml_new.cli build dashboard.dashml --target grafana --output dashboard.json
+
+# Create a dashboard directly in Apache Superset
+python -m dashml_new.cli build dashboard.dashml --target superset \
+  --superset-user admin --superset-password admin
+```
+
+## Database credentials
+
+For SQL or BigQuery data sources, the generated artifact reads connection
+parameters from environment variables at runtime — never from baked-in literals.
+The generator emits `.env.example`, `.gitignore`, and `SECRETS.md` next to the
+generated `app.py`. Copy `.env.example` to `.env`, fill in the values, and run.
+The same artifact directory is safe to commit to a public repository.
+
+```bash
+python -m dashml_new.cli build dashboard.dashml --target plotly --output app_dir
+cd app_dir
+cp .env.example .env       # edit .env, set DASHML_DB_PASSWORD etc.
+python app.py              # reads from env (or .env via python-dotenv)
+```
+
+See `SECRETS.md` in any generated SQL/BigQuery artifact for the full list of
+environment variables and recommended deployment patterns (Docker, Kubernetes,
+systemd, CI/CD, GCP Workload Identity).
+
+## Example
+
+```yaml
+version: 0.1
+title: "Sales Dashboard"
+style: "styles/dracula.dmls"
+
+data:
+  type: csv
+  path: "data/sales.csv"
+
+charts:
+  - id: "sales_by_country"
+    type: "bar"
+    title: "Sales by Country"
+    x: "country"
+    y: "sales"
+    agg: "sum"
+    sort: "y"
+    sort_order: "desc"
+    limit: 10
+```
+
+## Documentation
+
+- **[User Guide](dashml_new/README.md)** - Full specification reference, chart types, CLI, themes
+- **[Architecture](ARCHITECTURE.md)** - System design, compiler pipeline, type system
+
+## Key Concepts
+
+- **Compiler, not runtime** - DashML generates standalone code; it never loads or touches your data
+- **Credentials never baked** - generated SQL/BigQuery artifacts read database credentials from environment variables at runtime; safe to version-control
+- **12 chart types** - bar, line, scatter, pie, area, histogram, stacked_bar, grouped_bar, bubble, heatmap, box, geo
+- **3 data sources** - CSV, SQL (PostgreSQL/MySQL/SQLite), Google BigQuery
+- **6 backends** - Streamlit, Plotly, Observable Plot, Apache Superset, Vega-Lite, Grafana
+- **6 built-in themes** - Dracula, Nord, Gruvbox, Monokai, One Dark, Solarized Light
+
+## Authors
+
+- Dawid Olejniczak
+- Szymon Nowaczyk
+
+## License
+
+MIT

dashml_lang-0.1.0/README.md

@@ -0,0 +1,94 @@
+# DashML
+
+A declarative language for data visualization dashboards that compiles to multiple platforms.
+
+Write your dashboard spec once in `.dashml` format, then compile it to **Streamlit**, **Plotly**, **Observable Plot**, **Apache Superset**, **Vega-Lite**, or **Grafana**.
+
+## Quick Start
+
+```bash
+# Generate a Streamlit app
+python -m dashml_new.cli build dashboard.dashml --target streamlit --output app_dir
+streamlit run app_dir/app.py
+
+# Generate a standalone Plotly HTML dashboard
+python -m dashml_new.cli build dashboard.dashml --target plotly --output dashboard.html
+
+# Generate an Observable Plot HTML dashboard
+python -m dashml_new.cli build dashboard.dashml --target observable --output dashboard.html
+
+# Generate a Vega-Lite JSON specification
+python -m dashml_new.cli build dashboard.dashml --target vegalite --output dashboard.json
+
+# Generate a Grafana dashboard JSON
+python -m dashml_new.cli build dashboard.dashml --target grafana --output dashboard.json
+
+# Create a dashboard directly in Apache Superset
+python -m dashml_new.cli build dashboard.dashml --target superset \
+  --superset-user admin --superset-password admin
+```
+
+## Database credentials
+
+For SQL or BigQuery data sources, the generated artifact reads connection
+parameters from environment variables at runtime — never from baked-in literals.
+The generator emits `.env.example`, `.gitignore`, and `SECRETS.md` next to the
+generated `app.py`. Copy `.env.example` to `.env`, fill in the values, and run.
+The same artifact directory is safe to commit to a public repository.
+
+```bash
+python -m dashml_new.cli build dashboard.dashml --target plotly --output app_dir
+cd app_dir
+cp .env.example .env       # edit .env, set DASHML_DB_PASSWORD etc.
+python app.py              # reads from env (or .env via python-dotenv)
+```
+
+See `SECRETS.md` in any generated SQL/BigQuery artifact for the full list of
+environment variables and recommended deployment patterns (Docker, Kubernetes,
+systemd, CI/CD, GCP Workload Identity).
+
+## Example
+
+```yaml
+version: 0.1
+title: "Sales Dashboard"
+style: "styles/dracula.dmls"
+
+data:
+  type: csv
+  path: "data/sales.csv"
+
+charts:
+  - id: "sales_by_country"
+    type: "bar"
+    title: "Sales by Country"
+    x: "country"
+    y: "sales"
+    agg: "sum"
+    sort: "y"
+    sort_order: "desc"
+    limit: 10
+```
+
+## Documentation
+
+- **[User Guide](dashml_new/README.md)** - Full specification reference, chart types, CLI, themes
+- **[Architecture](ARCHITECTURE.md)** - System design, compiler pipeline, type system
+
+## Key Concepts
+
+- **Compiler, not runtime** - DashML generates standalone code; it never loads or touches your data
+- **Credentials never baked** - generated SQL/BigQuery artifacts read database credentials from environment variables at runtime; safe to version-control
+- **12 chart types** - bar, line, scatter, pie, area, histogram, stacked_bar, grouped_bar, bubble, heatmap, box, geo
+- **3 data sources** - CSV, SQL (PostgreSQL/MySQL/SQLite), Google BigQuery
+- **6 backends** - Streamlit, Plotly, Observable Plot, Apache Superset, Vega-Lite, Grafana
+- **6 built-in themes** - Dracula, Nord, Gruvbox, Monokai, One Dark, Solarized Light
+
+## Authors
+
+- Dawid Olejniczak
+- Szymon Nowaczyk
+
+## License
+
+MIT

dashml_lang-0.1.0/dashml_lang.egg-info/PKG-INFO

@@ -0,0 +1,140 @@
+Metadata-Version: 2.4
+Name: dashml-lang
+Version: 0.1.0
+Summary: Declarative YAML-based compiler for data visualization dashboards. Write your dashboard once, compile to Streamlit, Plotly, Observable Plot, Apache Superset, Vega-Lite, or Grafana.
+Author: Dawid Olejniczak, Szymon Nowaczyk
+License: MIT
+Project-URL: Homepage, https://github.com/dashml-dev/dashml
+Project-URL: Repository, https://github.com/dashml-dev/dashml
+Project-URL: Issues, https://github.com/dashml-dev/dashml/issues
+Keywords: dashboard,visualization,dsl,declarative,compiler,yaml,streamlit,plotly,observable-plot,vega-lite,grafana,superset,bigquery,business-intelligence
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Compilers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: streamlit
+Requires-Dist: streamlit>=1.40.0; extra == "streamlit"
+Requires-Dist: pandas>=2.0.0; extra == "streamlit"
+Requires-Dist: altair>=5.0.0; extra == "streamlit"
+Requires-Dist: watchdog>=4.0.0; extra == "streamlit"
+Provides-Extra: sql
+Requires-Dist: flask>=3.0.0; extra == "sql"
+Requires-Dist: sqlalchemy>=2.0.0; extra == "sql"
+Requires-Dist: psycopg2-binary>=2.9.0; extra == "sql"
+Provides-Extra: bigquery
+Requires-Dist: flask>=3.0.0; extra == "bigquery"
+Requires-Dist: google-cloud-bigquery>=3.0.0; extra == "bigquery"
+Provides-Extra: superset
+Requires-Dist: requests>=2.32.0; extra == "superset"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Dynamic: license-file
+
+# DashML
+
+A declarative language for data visualization dashboards that compiles to multiple platforms.
+
+Write your dashboard spec once in `.dashml` format, then compile it to **Streamlit**, **Plotly**, **Observable Plot**, **Apache Superset**, **Vega-Lite**, or **Grafana**.
+
+## Quick Start
+
+```bash
+# Generate a Streamlit app
+python -m dashml_new.cli build dashboard.dashml --target streamlit --output app_dir
+streamlit run app_dir/app.py
+
+# Generate a standalone Plotly HTML dashboard
+python -m dashml_new.cli build dashboard.dashml --target plotly --output dashboard.html
+
+# Generate an Observable Plot HTML dashboard
+python -m dashml_new.cli build dashboard.dashml --target observable --output dashboard.html
+
+# Generate a Vega-Lite JSON specification
+python -m dashml_new.cli build dashboard.dashml --target vegalite --output dashboard.json
+
+# Generate a Grafana dashboard JSON
+python -m dashml_new.cli build dashboard.dashml --target grafana --output dashboard.json
+
+# Create a dashboard directly in Apache Superset
+python -m dashml_new.cli build dashboard.dashml --target superset \
+  --superset-user admin --superset-password admin
+```
+
+## Database credentials
+
+For SQL or BigQuery data sources, the generated artifact reads connection
+parameters from environment variables at runtime — never from baked-in literals.
+The generator emits `.env.example`, `.gitignore`, and `SECRETS.md` next to the
+generated `app.py`. Copy `.env.example` to `.env`, fill in the values, and run.
+The same artifact directory is safe to commit to a public repository.
+
+```bash
+python -m dashml_new.cli build dashboard.dashml --target plotly --output app_dir
+cd app_dir
+cp .env.example .env       # edit .env, set DASHML_DB_PASSWORD etc.
+python app.py              # reads from env (or .env via python-dotenv)
+```
+
+See `SECRETS.md` in any generated SQL/BigQuery artifact for the full list of
+environment variables and recommended deployment patterns (Docker, Kubernetes,
+systemd, CI/CD, GCP Workload Identity).
+
+## Example
+
+```yaml
+version: 0.1
+title: "Sales Dashboard"
+style: "styles/dracula.dmls"
+
+data:
+  type: csv
+  path: "data/sales.csv"
+
+charts:
+  - id: "sales_by_country"
+    type: "bar"
+    title: "Sales by Country"
+    x: "country"
+    y: "sales"
+    agg: "sum"
+    sort: "y"
+    sort_order: "desc"
+    limit: 10
+```
+
+## Documentation
+
+- **[User Guide](dashml_new/README.md)** - Full specification reference, chart types, CLI, themes
+- **[Architecture](ARCHITECTURE.md)** - System design, compiler pipeline, type system
+
+## Key Concepts
+
+- **Compiler, not runtime** - DashML generates standalone code; it never loads or touches your data
+- **Credentials never baked** - generated SQL/BigQuery artifacts read database credentials from environment variables at runtime; safe to version-control
+- **12 chart types** - bar, line, scatter, pie, area, histogram, stacked_bar, grouped_bar, bubble, heatmap, box, geo
+- **3 data sources** - CSV, SQL (PostgreSQL/MySQL/SQLite), Google BigQuery
+- **6 backends** - Streamlit, Plotly, Observable Plot, Apache Superset, Vega-Lite, Grafana
+- **6 built-in themes** - Dracula, Nord, Gruvbox, Monokai, One Dark, Solarized Light
+
+## Authors
+
+- Dawid Olejniczak
+- Szymon Nowaczyk
+
+## License
+
+MIT

dashml_lang-0.1.0/dashml_lang.egg-info/SOURCES.txt

@@ -0,0 +1,35 @@
+LICENSE
+README.md
+pyproject.toml
+dashml_lang.egg-info/PKG-INFO
+dashml_lang.egg-info/SOURCES.txt
+dashml_lang.egg-info/dependency_links.txt
+dashml_lang.egg-info/entry_points.txt
+dashml_lang.egg-info/requires.txt
+dashml_lang.egg-info/top_level.txt
+dashml_new/__init__.py
+dashml_new/app.py
+dashml_new/cli.py
+dashml_new/generate_startup_data.py
+dashml_new/get_chart.py
+dashml_new/inspect_dashboard.py
+dashml_new/core/__init__.py
+dashml_new/core/engine.py
+dashml_new/core/normalizer.py
+dashml_new/core/parser.py
+dashml_new/core/types.py
+dashml_new/core/validator.py
+dashml_new/core/watcher.py
+dashml_new/transformers/__init__.py
+dashml_new/transformers/base.py
+dashml_new/transformers/constants.py
+dashml_new/transformers/grafana.py
+dashml_new/transformers/observable.py
+dashml_new/transformers/plotly.py
+dashml_new/transformers/registry.py
+dashml_new/transformers/secrets.py
+dashml_new/transformers/streamlit.py
+dashml_new/transformers/superset.py
+dashml_new/transformers/vegalite.py
+tests/test_normalizer.py
+tests/test_validator.py

dashml_lang-0.1.0/dashml_lang.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dashml_lang-0.1.0/dashml_lang.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dashml = dashml_new.cli:main

dashml_lang-0.1.0/dashml_lang.egg-info/requires.txt

@@ -0,0 +1,23 @@
+pyyaml>=6.0
+
+[bigquery]
+flask>=3.0.0
+google-cloud-bigquery>=3.0.0
+
+[dev]
+pytest>=7.0.0
+build>=1.0.0
+
+[sql]
+flask>=3.0.0
+sqlalchemy>=2.0.0
+psycopg2-binary>=2.9.0
+
+[streamlit]
+streamlit>=1.40.0
+pandas>=2.0.0
+altair>=5.0.0
+watchdog>=4.0.0
+
+[superset]
+requests>=2.32.0

dashml_lang-0.1.0/dashml_lang.egg-info/top_level.txt

@@ -0,0 +1 @@
+dashml_new

dashml_lang-0.1.0/dashml_new/__init__.py

@@ -0,0 +1,11 @@
+"""
+DashML - Declarative Dashboard Language
+
+A domain-specific language for building data visualization dashboards.
+Write once in DashML, generate code for multiple platforms.
+"""
+from .core import DashMLEngine, ValidationError
+from .transformers import Transformer, TransformerRegistry
+
+__version__ = "0.000000001"
+__all__ = ["DashMLEngine", "ValidationError", "Transformer", "TransformerRegistry"]

dashml_lang-0.1.0/dashml_new/app.py

@@ -0,0 +1,39 @@
+import streamlit as st
+import pandas as pd
+
+def main():
+    st.set_page_config(
+        page_title="DashML Example Dashboard",
+        page_icon="📊",
+        layout="wide"
+    )
+    st.title("DashML Example Dashboard")
+
+    # Load data
+    try:
+        df = pd.read_csv("data/example.csv")
+    except FileNotFoundError:
+        st.error("Data file not found: data/example.csv")
+        return
+    except Exception as e:
+        st.error(f"Error loading data: {e}")
+        return
+
+    # Chart: sales_by_country
+    st.subheader("Sales by country")
+    # Aggregate: sum(sales) group by country
+    chart_data = df.groupby("country")["sales"].sum().reset_index()
+    chart_data = chart_data.set_index("country")["sales"]
+    st.bar_chart(chart_data)
+    st.divider()
+
+    # Chart: sales_over_time
+    st.subheader("Sales over time")
+    # Aggregate: sum(sales) group by date
+    chart_data = df.groupby("date")["sales"].sum().reset_index()
+    chart_data = chart_data.set_index("date")["sales"]
+    st.line_chart(chart_data)
+
+
+if __name__ == "__main__":
+    main()