Doobie is a multi-module SBT project. There is some code generation (project/FreeGen2.scala) which generates the free algebra (e.g. kleisliinterpreter.scala) from JDBC driver classes definitions.

Running the tests or building the documentation site requires connection to the example Postgres docker contains, which you can spin up using docker-compose:

docker-compose up -d --force-update

After that, in SBT you can run test to run tests, and makeSite to build the doc site

If you're editing code generation related code, you should reload the SBT project and then run the freeGen2 SBT task before compiling or running tests.

doobie uses sbt-ci-release which means all merges to master are pushed to Sonatype as snapshots and there's nothing to do.

To make a release, make sure you're on the right commit, then tag it using the format here. This will trigger a release build.

git tag -a v1.2.3 -m v1.2.3
git push --tags

To update the doc site, check out the tag first.

git checkout v1.2.3
sbt docs/publishMicrosite