Open a bug report. Include:
- GoSQLX version (
gosqlx --versionorconst Versioninpkg/gosqlx/gosqlx.go) - Go version (
go version) - Minimal reproducing SQL and Go snippet
- Expected vs actual behavior
Open a feature request. Describe the SQL pattern you need parsed and the use case.
For usage questions, design discussions, and "how do I…" questions, use GitHub Discussions:
| Category | Use for |
|---|---|
| Q&A | Usage questions, API help |
| Ideas | Feature proposals before filing an issue |
| Show and Tell | Projects built with GoSQLX |
| General | Anything else |
Open a performance issue with benchmark output (go test -bench=. -benchmem ./...).
Do not open a public issue. See SECURITY.md for responsible disclosure instructions.
| Resource | What it covers |
|---|---|
| Getting Started | Install and first parse in 5 minutes |
| Usage Guide | All API patterns with examples |
| CLI Guide | Every CLI command and flag |
| API Reference | Complete function/type reference |
| Troubleshooting | Common errors and solutions |
| Error Codes | E1xxx / E2xxx / E3xxx reference |
| SQL Compatibility | What SQL is supported per dialect |
| Migration Guide | Upgrading between versions |
| pkg.go.dev | Generated Go API docs |
This is an open source project maintained in spare time. Typical response times:
| Channel | Expected response |
|---|---|
| Bug reports (with reproduction) | 1–3 business days |
| Feature requests | 1–2 weeks (discussion first) |
| Security vulnerabilities | 48 hours |
| GitHub Discussions | best-effort |
| Version | Status | Go requirement |
|---|---|---|
| v1.9.x | ✅ Active (current) | Go 1.21+ |
| v1.8.x | Go 1.21+ | |
| < v1.8 | ❌ End of life | - |
Upgrade with: go get github.com/ajitpratap0/GoSQLX@latest