---
id: gw-dsl-parser
version: "0.1.49.1"
license: unclear
license_treatment: permissive
maintenance: dormant
---

# gw-dsl-parser — gw_dsl_parser: Convert your graphic-walker workflow to sql

License: permissive · Maintenance: dormant · Downloads: 123.1K/mo

## What it is and what it does

gw-dsl-parser converts graphic-walker workflow definitions—JSON payloads describing visual query operations like aggregations and grouping—into SQL statements executable against a database table. It bridges the gap between visual query builders and SQL databases by translating declarative workflow objects into standard SQL.

The package wraps a WebAssembly module (via wasmtime) to perform the DSL parsing. You provide a workflow payload, a table name, and the package returns the corresponding SQL string. It's designed as a backend utility for tools that let users build queries visually and need to execute them as SQL.

Use it for:

- Export visual queries built in graphic-walker as executable SQL for database execution
- Build a backend API that converts user-drawn query workflows into SQL without exposing raw SQL to the frontend
- Generate SQL from workflow definitions stored in JSON for batch processing or audit logging
- Integrate visual query builders into data applications that require SQL-based query execution

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Converts graphic-walker workflow definitions into SQL queries by parsing a DSL payload and generating executable SQL for the specified table.

Yes, if you are building on graphic-walker and need to translate visual workflows to SQL. The package has low install friction and permissive licensing. However, maintenance is dormant (last release 2024-07-31), so verify that the DSL subset and SQL generation match your use case before committing to a dependency on it.

## Install

pip install gw-dsl-parser
uv add gw-dsl-parser
poetry add gw-dsl-parser

## Installing gw-dsl-parser

Before you install: Low install friction with a single runtime dependency (wasmtime). Package is dormant—last release was over a year ago with no recent commits, though the repository remains active and unarchived.

License in practice: Licensed under Apache Software License (permissive), allowing commercial and private use with minimal restrictions beyond attribution and liability disclaimers.

Quickstart:

pip install gw-dsl-parser

from gw_dsl_parser import get_sql_from_payload

payload = {"workflow": [{"type": "view", "query": [{"op": "aggregate", "groupBy": [], "measures": [{"field": "*", "agg": "count", "asFieldKey": "count"}]}]}]}
sql = get_sql_from_payload("test_table", payload)
print(sql)

wasmtime runtime dependency must be available; verify wasm module is downloaded via scripts/download_wasm.py if not automatic

Verify before relying:

- Whether wasmtime must be pre-installed on the system or is automatically provisioned by the package
- Whether the wasm module download (scripts/download_wasm.py) is required before first use or happens automatically
- Scope and limitations of the DSL subset supported—which workflow operations and query types are actually parseable

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 123.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

workflow to sql conversion, graphic walker dsl parser, query payload to sql, dsl to sql generator, workflow query compiler, visual workflow sql, sql export from workflows, sql-generation, dsl-parser, visual-query-builder

[View on SkillFed](https://skillfed.io/packages/gw-dsl-parser) · [View on PyPI](https://pypi.org/project/gw-dsl-parser/)