Update documentation to refelct switch to scylladb/gocql (#333)

This commit is contained in:
Sylwia Szunejko
2025-07-14 14:18:43 +02:00
committed by GitHub
parent 58d72b0e05
commit f86897552b

View File

@@ -3,6 +3,19 @@
GocqlX makes working with Scylla easy and less error-prone.
Its inspired by [Sqlx](https://github.com/jmoiron/sqlx), a tool for working with SQL databases, but it goes beyond what Sqlx provides.
## Compatibility
Versions of GocqlX prior to v3.0.0 are compatible with both [Apache Cassandras gocql](https://github.com/apache/cassandra-gocql-driver) and [ScyllaDBs fork](https://github.com/scylladb/gocql).
However, starting with v3.0.0, GocqlX exclusively supports the scylladb/gocql driver.
If you are using GocqlX v3.0.0 or newer, you must ensure your `go.mod` includes a replace directive to point to ScyllaDBs fork:
```go
# Use the latest version of scylladb/gocql; check for updates at https://github.com/scylladb/gocql/releases
replace github.com/gocql/gocql => github.com/scylladb/gocql v1.15.1
```
This is required because GocqlX relies on ScyllaDB-specific extensions and bug fixes introduced in the gocql fork. Attempting to use the standard gocql driver with GocqlX v3.0.0+ may lead to build or runtime issues.
## Features
* Binding query parameters from struct fields, map, or both