fugue-sql-antlr

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 on this page — 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

fugue-sql-antlr on PyPI

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

Evidence: fugue_sql_antlr-0.2.4.tar.gz

Keywords: distributed, spark, dask, sql, dsl, domain, specific, language

Tags

More Python Modules packages