Add clickhouse-sql-parser to Database Tools section - #6654
Conversation
clickhouse-sql-parser is a Go library and CLI that parses ClickHouse-dialect SQL into a typed AST, with walk/transform helpers, round-trip formatting and beautification. Assistant By Claude Opus 5
Automated Quality ChecksRequired checks✅ Repo: accessible, has go.mod and SemVer release Additional checks✅ License: MIT
These checks are automated and do not replace maintainer review. See CONTRIBUTING.md for full guidelines. PR Diff ValidationContent checks✅ Files changed: only README.md Automated diff validation — does not replace maintainer review. |
Required links
Coverage: https://coveralls.io/github/AfterShip/clickhouse-sql-parser?branch=master
Pre-submission checklist
Repository requirements
go.modfile and at least one SemVer release (vX.Y.Z) — latest isv0.5.6.Pull Request content
clickhouse-bulkanddatabase-gateway.Category quality
About the package
clickhouse-sql-parseris a Go library and CLI that parses ClickHouse-dialect SQLinto a typed AST and formats it back, used for query linting, static analysis,
rewriting and access-control enforcement. First commit September 2023, SemVer
release roughly every two weeks, MIT licensed. It is used in production by
SigNoz, Unkey,
Akvorado,
Trickster and
Substreams, among others.
Two of the required links deserve a note, in the interest of being upfront:
for any repository. The link is included because the template asks for it. The
project is
gofmt/goimportsclean and runsgolangci-lintin CI on every PR.parserpackage, which isthe library itself;
main.gois a thin CLI wrapper and is untested. That is belowthe 80% guideline. The grammar is exercised by a golden-file suite of ~800 SQL
fixtures that round-trip each statement through parse → AST JSON → formatted SQL,
so the parsing surface is well covered in practice, but I would rather state the
number than have it turn up in review. Happy to raise it if that is a condition
for merging.