dashml-lang 0.1.0__py3-none-any.whl

dashml_lang-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,30 @@
+dashml_lang-0.1.0.dist-info/licenses/LICENSE,sha256=6Y50bnWjXSZp7ja2nkrUF2HMx2sWnQdHz_DcgYLRIkY,1090
+dashml_new/__init__.py,sha256=sVTHPGsGYrnmXvfbElp-DdM5CVQ_oEOritfX8GA2Do0,400
+dashml_new/app.py,sha256=2DQBUvFCCINElDtFxR22tHTVaG-XknGhVxt33YHctD8,1065
+dashml_new/cli.py,sha256=FegRzTDajp2JroLcFIyaM_3HfZSamYG3AU4FCxiHYKE,25368
+dashml_new/generate_startup_data.py,sha256=17rurUYYpdcebYI3Ei0OU4Ll344JcqIWMuh4HnxjtCo,4223
+dashml_new/get_chart.py,sha256=EcYjrQ70dSxogucR0oTTIsSJf7TQYqzd9i3Az26yiFg,1261
+dashml_new/inspect_dashboard.py,sha256=Ko5gA8urmEuA5p2Xp2cpjfBkpskygKsGk-r6-Z6fkrM,3769
+dashml_new/core/__init__.py,sha256=rKxOMzE8l-ujH-VI7p9YfG0S1Jzd5pjW6EF-7HwtZ24,587
+dashml_new/core/engine.py,sha256=K3m0si2hZOYb-Pme_xxYY-53APCX1uLLB8VDhSfBprc,1550
+dashml_new/core/normalizer.py,sha256=9OZ3G9kR8hafmS4aty0ccqJ_ApXSqAs75SHskPyPkqI,17267
+dashml_new/core/parser.py,sha256=OJFGr4cCSpluoGGoxozX6x-5UNk3AZKVKVDpAAUOKsc,1170
+dashml_new/core/types.py,sha256=YRF_UTwE3kspaK2M1ZELFSnpwRSWw8PLNL_SbbK0I-0,10630
+dashml_new/core/validator.py,sha256=9ULTTu2MGU90MrpQUZPtaBhzP0zCzcieYjmzjaEWcgo,22298
+dashml_new/core/watcher.py,sha256=vl04Sgo0bkHlN7eOtDNjUn_yOHxcQOAC1e6Z9Q0IQxk,2954
+dashml_new/transformers/__init__.py,sha256=vVbcRfSMS8tICO8im21zGhXAZ6_IMzTLJyOncvihU4s,230
+dashml_new/transformers/base.py,sha256=P5t8k3K7N_soh7NZvPo_5_in7zji1hX3q4Evc8bxTc0,3384
+dashml_new/transformers/constants.py,sha256=ZAfQuf0RRChAUfUXpcKSdGdJGXZeANLF2jvC4spzW1o,17197
+dashml_new/transformers/grafana.py,sha256=LQG-xiTqQ2lPS9OEyj4WsXtov41TZGREoniWevPOIdM,45938
+dashml_new/transformers/observable.py,sha256=Fw-93fu38qvpEe1mDglTKKblB-AVgQt2gev3A8QxIRM,114524
+dashml_new/transformers/plotly.py,sha256=IjlL3IOQDQGoUlnaiz_fkmUL6aJeJVbRET6hWNBBxyQ,113775
+dashml_new/transformers/registry.py,sha256=-xyYPVO4cX-fx4KcouriKc5yS-xPzN2mFSRmwUERyvY,2919
+dashml_new/transformers/secrets.py,sha256=k5qXPEZcbKzzbtz8Q8vpEP5Xwz8x_QnOHvWSzD-UIvU,9769
+dashml_new/transformers/streamlit.py,sha256=vajUKiRL35gT2eq5m6Ps-UG6u-DSwKaTBq9Uv6W8tQo,57170
+dashml_new/transformers/superset.py,sha256=x3enGztLjp95DVmYTpAbufkie3ze-5_rrpQqR_jivUU,76136
+dashml_new/transformers/vegalite.py,sha256=a5H7lyZfBazJZEbPdNeVkn57LCRLc4amQIrDIONGixQ,38921
+dashml_lang-0.1.0.dist-info/METADATA,sha256=AUSULkg5M_yJJucF9OpZUUkPGzg24tAGNPa6WvufcOg,5401
+dashml_lang-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+dashml_lang-0.1.0.dist-info/entry_points.txt,sha256=dkIVlFgh4PWFEzaAWhNGcR4XZ1rm7MsdSesxXMwGN70,47
+dashml_lang-0.1.0.dist-info/top_level.txt,sha256=6WB89MnO1IV87pBYc6NO0teYxR1ICD2Zha9jah0B7cE,11
+dashml_lang-0.1.0.dist-info/RECORD,,

dashml_lang-0.1.0.dist-info/WHEEL

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

dashml_lang-0.1.0.dist-info/entry_points.txt

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

dashml_lang-0.1.0.dist-info/licenses/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.dist-info/top_level.txt

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

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_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()