---
id: fugue-sql-antlr
version: "0.2.4"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# fugue-sql-antlr — Fugue SQL Antlr Parser

License: permissive · Maintenance: active · Downloads: 919.2K/mo

## What it is and what it does

This package provides an ANTLR4-based parser for Fugue SQL, a domain-specific SQL dialect used within the Fugue distributed computing framework. It parses SQL strings into an abstract syntax tree and exposes a visitor interface for tree traversal and semantic analysis. The package is designed as an internal component of the main Fugue project (>=0.7.0) rather than for direct end-user consumption.

The package has four runtime dependencies: triad, antlr4-python3-runtime, jinja2, and packaging. It supports Python 3.10 through 3.14. An optional C++ implementation (fugue-sql-antlr-cpp) is available as an extra dependency to accelerate parsing, though the pure-Python parser provides identical functionality. The package is actively maintained, in alpha status, and carries no known security vulnerabilities.

Use it for:

- Parse Fugue SQL queries within the Fugue framework to enable distributed SQL execution on Spark, Dask, or other backends.
- Build custom tooling that needs to analyze or transform Fugue SQL syntax trees programmatically.
- Integrate Fugue SQL parsing into domain-specific applications that require SQL dialect support.
- Develop IDE or linting tools that validate Fugue SQL syntax before execution.

## Worth the install?

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

Parses Fugue SQL dialect into an abstract syntax tree using ANTLR4, providing a Python visitor interface for tree traversal and analysis.

Yes, if you are using Fugue >=0.7.0 and need SQL parsing support. The package is actively maintained, has no security vulnerabilities, and carries a permissive Apache-2.0 license. High install friction (four dependencies) is offset by the fact that it is typically installed as a transitive dependency of Fugue rather than directly. Not recommended for direct use outside the Fugue ecosystem.

## Install

pip install fugue-sql-antlr
uv add fugue-sql-antlr
poetry add fugue-sql-antlr

## Installing fugue-sql-antlr

Before you install: High install friction due to four runtime dependencies including antlr4-python3-runtime. Maintenance is active with recent commits and no known vulnerabilities, but the package is in alpha status (Development Status :: 3 - Alpha).

License in practice: Apache-2.0 permissive license allows commercial and private use with attribution; no significant restrictions for most users.

Quickstart:

pip install fugue-sql-antlr

from fugue_sql_antlr import parse

tree = parse("SELECT * FROM table_name")

Requires Python 3.10 or later. Optional C++ compiler needed only if installing the fugue-sql-antlr-cpp extra for performance.

Verify before relying:

- Whether the package is intended for direct use or only as an internal dependency of Fugue (description suggests internal-only, but this is not enforced).
- Specific parsing capabilities and SQL dialect coverage beyond basic SELECT statements.
- Performance characteristics of the pure-Python parser relative to the optional C++ implementation.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: high
- Maintenance: active
- Downloads: 919.2K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

sql parser antlr4, fugue sql parsing, sql ast generation, domain specific language parser, sql dialect parser python, antlr4 sql visitor, parse sql to ast, sql-parser, antlr4, distributed-computing

[View on SkillFed](https://skillfed.io/packages/fugue-sql-antlr) · [View on PyPI](https://pypi.org/project/fugue-sql-antlr/)