Contributing
Dolt is an open-source SQL database that has Git-like functionality, including branch, merge, clone, push and pull. As we attract more and more users with various use cases and ways of integrating Dolt into their existing workflows and systems, it's not rare for Dolt to need a little bit of work to support a new client library or upstream dependency.
Dolt consists of multiple parts:
Known issues with each part:
You should know that:
- 1.
- 2.Dolt's SCM is git and you will need to download and install it to fetch the source code and create pull requests.
- 3.Dolt's source code is hosted on github and you will want to create an account and follow the instructions for authenticating to GitHub with SSH if you don't already have one.
Create a fork of the dolt repo(s) by clicking the fork button at the upper right of each of the respective dolthub github repos.
Create a directory for your dolt workspace.
~ $ mkdir dolt_workspace
~ $ cd ~/dolt_workspace
Clone each of the dolt repos using Git.
~/dolt_workspace $ git clone [email protected]:<your-username>/dolt.git
~/dolt_workspace $ git clone [email protected]:<your-username>/go-mysql-server.git
~/dolt_workspace $ git clone [email protected]:<your-username>/vitess.git
By default, the dolt repository builds and links against pinned versions of go-mysql-server and vitess, so to develop them together we need to add a local dependencies for
dolt and go-mysql-server.~/dolt_workspace $ cd ./dolt/go
~/dolt_workspace/dolt/go $ go mod edit -replace github.com/dolthub/go-mysql-server=../../go-mysql-server
~/dolt_workspace/dolt/go $ go mod edit -replace github.com/dolthub/vitess=../../vitess
~/dolt_workspace $ cd ../../go-mysql-server
~/dolt_workspace/go-mysql-server $ go mod edit -replace github.com/dolthub/vitess=../vitess
~/dolt_workspace/go-mysql-server $ cd ..
Check that everything is working as expected by running dolt's unit tests (this might take a few minutes).
~/dolt_workspace $ cd ./dolt/go
~/dolt_workspace/dolt/go $ go test ./...
? github.com/dolthub/dolt/go/cmd/dolt [no test files]
ok github.com/dolthub/dolt/go/cmd/dolt/cli 0.541s
ok github.com/dolthub/dolt/go/cmd/dolt/commands 4.890s
.
.
.
ok github.com/dolthub/dolt/go/store/util/verbose 0.373s
ok github.com/dolthub/dolt/go/store/util/writers 0.392s
ok github.com/dolthub/dolt/go/store/valuefile 0.786s
You can build dolt from source like so:
~/dolt_workspace $ cd ./dolt/go
~/dolt_workspace/dolt/go $ go install ./cmd/dolt
Refer to these guides to fix bugs specific to each part of dolt:
Remember to remove local dependencies before pushing your changes.
~/dolt_workspace $ cd ./dolt/go
~/dolt_workspace $ go mod edit -dropreplace github.com/dolthub/go-mysql-server
~/dolt_workspace $ go mod edit -dropreplace github.com/dolthub/vitess
~/dolt_workspace $ cd ../../go-mysql-server
~/dolt_workspace $ go mod edit -dropreplace github.com/dolthub/vitess
~/dolt_workspace $ cd ..
There is an auto-dependency bump that takes place to keep the different parts up to date. As a result, if your fix required changes to multiple projects, commit them in this order:
- 1.vitess
- 2.go-mysql-server
- 3.dolt
Navigate to the pull requests section of your repo(s).
Click on "New pull request".
Make sure the base repository is set to dolthub/dolt and click "Create pull request".
Submitting the PR will get some automated tests run against the branch and will notify the project maintainers that someone has some changes. If there are failures in the automated tests, the maintainers will let you know what steps you need to take to fix things up. Otherwise, the maintainers will provide feedback, or, if everything looks good, they will merge the PR.
Last modified 12d ago