Skip to content

docs: credit Polyglot and SQLGlot for the parser SQLQuack forked - #171

Merged
kvlonge merged 1 commit into
mainfrom
docs/credit-polyglot-sqlglot
Nov 11, 2026
Merged

kvlonge merged 1 commit into
mainfrom
docs/credit-polyglot-sqlglot

Conversation

@kvlonge

@kvlonge kvlonge commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

Why

SQLQuack's tokenizer, parser and syntax tree are a modified fork of Polyglot, which is a Rust port of SQLGlot. This PR says so plainly and credits both projects.

Changes

  • README: a paragraph under "Why SQLQuack?" and a new Credits section.
  • Credits page (/docs/credits/): rewritten to match the README. It keeps the note that SQLGlot's Snowflake test suite supplies case inputs.
  • THIRD_PARTY_NOTICES, polyglot section, with the copies in python/ and crates/sqlquack/:
    • The parser is described as a modified fork, in crates/sqlquack-syntax-snowflake (most of the derived code), crates/sqlquack-syntax and crates/sqlquack-derive. A line-overlap check against Polyglot's source finds derived code only in those three crates; the other sqlquack-syntax-* crates are SQLQuack's own parsers.
    • The stale paths now point to the DuckDB result-type rules in crates/sqlquack-semantics/src/duckdb/profile/_helpers/typing.rs and to the fixture's current location.
    • It lists the semantic checks ported from Polyglot's validation: families.rs, signatures.rs, scope_rules.rs, node_checks.rs, relational.rs and sets.rs in crates/sqlquack-semantics/src/lineage/_helpers/checks.
    • The licence texts are unchanged.

Verification

Checks run locally: site build and link check (22 pages, 0 broken links), the diagnostics and known-differences generators with --check, make distribution-notices, and a script confirming that every path the polyglot section names exists.

The README says where SQLQuack's parser comes from and adds a Credits
section for Polyglot and SQLGlot. The credits page says the same.

THIRD_PARTY_NOTICES now names the parser as a modified fork of polyglot,
in sqlquack-syntax-snowflake, sqlquack-syntax and sqlquack-derive. It gives
the current paths of the ported DuckDB result-type rules and their fixture,
and lists the semantic checks ported from polyglot's validation. The
licence texts are unchanged, and the distribution copies match the root.
@kvlonge
kvlonge merged commit 321f2a6 into main Nov 11, 2026
14 of 16 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant