Development

RapidRows is an open source project by RapidLoop, released under the Apache 2.0 license. The development happens on GitHub at rapidloop/rapidrows.

RapidRows is written in Go. It includes Fabrice Bellard’s QuickJS, which is in C, and therefore uses cgo. Build is officially supported only with the latest and latest-but-one versions of Go. At least v1.18 of Go is required, for generics support.

Once you have a working Go environment and a C compiler, you can do:

go install github.com/rapidloop/rapidrows/cmd/rapidrows@latest

to fetch and build the latest rapidrows source. The binary will be present at $GOPATH/bin/rapidrows.

To work with the source, you can clone the git repo, make changes and build the binary with:

git clone https://github.com/rapidloop/rapidrows
cd rapidrows
go build ./cmd/rapidrows
./rapidrows --help

Testing

The tests can be run with go test. You’ll need a Postgres datasource that can be connected to without any extra parameters (this typically means if you run psql without any arguments, it will connect successfully to a database). The test scripts will create tables in this database.

Contributing

To contribute patches, first fork the project in GitHub, make your changes and send us a pull request. If you’d like to discuss your changes first, please create a new discussion in GitHub.

If you’ve something cool to show or tell the other users of RapidRows, please drop us a line at hello@rapidloop.com, and we’ll work with you to get it into this website.