Install & Compatibility
Where this runs
tested against v0.2.4 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
403MB installed
● package 403MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
FugueSQLParser
✓ from fugue_sql_antlr import FugueSQLParser
✗ from fugue_sql import fsql
FugueSQLVisitor
✓ from fugue_sql_antlr import FugueSQLVisitor
✗ from fugue_sql import fsql
constants
✓ from fugue_sql_antlr import constants
✗ from fugue_sql import fsql
This quickstart demonstrates how Fugue-SQL is used, which in turn utilizes the `fugue-sql-antlr` parser internally. Users typically do not directly import or interact with `fugue-sql-antlr` itself, but rather use the `fsql` function from the main `fugue` project to execute SQL queries on various backends.
import pandas as pd
from fugue_sql import fsql
df = pd.DataFrame({"id": [1, 2, 3], "value": [10, 20, 30]})
# FugueSQL uses the fugue-sql-antlr parser internally
result_df = fsql("SELECT id, value * 2 AS doubled_value FROM df WHERE value > 15").run(df).as_pandas()
print(result_df)
Debug
Known issues
gotchaThe `fugue-sql-antlr` package is an internal component of the Fugue project and is not designed for direct user interaction. Attempting to directly import or use its classes can lead to unexpected behavior or breakage with future updates.fixAlways interact with Fugue SQL functionality through the `fugue` library's public API, such as `from fugue_sql import fsql`.
affects: All versions
breakingPrior to `fugue` version 0.9.0, `fugue-sql-antlr` was included as a core dependency of the main `fugue` package. From `fugue` 0.9.0 onwards, it was moved to the `sql` extra. Users who previously relied on Fugue SQL without specifying the extra might find it missing after upgrading `fugue`.fixEnsure `fugue` is installed with the `sql` extra: `pip install fugue[sql]`.
affects: fugue < 0.9.0 upgrading to fugue >= 0.9.0
gotchaFor performance-critical Fugue SQL parsing, the optional `fugue-sql-antlr-cpp` package is highly recommended as it can be significantly faster. However, its installation may require a C++ compiler on the system.fixInstall with `pip install fugue-sql-antlr-cpp` alongside `fugue[sql]`, or use `pip install fugue[sql,cpp_sql_parser]` to get the C++ parser.
affects: All versions
Upgrade
Version history
0.2.4latest on PyPI · released Feb 19, 2026
Audit
Dependencies
fuguerequiredfugue-sql-antlr is an internal dependency of the Fugue project, providing SQL parsing for FugueSQL.
antlr4-python3-runtimerequiredCore dependency for the ANTLR4-based parser.
fugue-sql-antlr-cppoptionalOptional C++ implementation of the parser for significantly faster parsing (~25x faster). Requires C++ compiler.