DOT is the core library for operational transformation. This is implemented in Go and is also meant to be the reference implementation for other languages.
The code is mostly idiomatic go. In addition, there is a tendency to write functional code (i.e very low side-effects -- preferring to return new slices instead of mutating input arg, for example). There is a lot of immutable types used.
The core library is quite critical -- the whole DOT system will require upgrades if code here changes in some backwards incomptabile way. So, this code is intentionally likely to grow slowly or only grow in an additive process (where backwards compatiblity is not an issue).
The code is somewhat sparsely documented but please feel free to file issues for even simple questions.
-
The changes directory contains the core changes package which implements the basic transformations that is the basis for everything else.
-
The ops directory implements operations and mainly deals with the network/protocol aspects.
-
The streams and refs packages implement the concept of streams of data for managing changes.
While standard go get -u ./... and go test ./... should work, all
pull requests to this project will be tested against ./x/lint.sh and
./x/coverage.sh.
go test --coverprofile=cover.out
go tool cover --html=cover.out
Linting is done using golangci-lint.
Please run ./x/lint.sh to lint the project.
golangci-lint run -E goimports -E gosec -E maligned -E misspell -E nakedret -E unconvert -E gocritic -E errcheck
# or
./x/lint.sh
Please feel free to file issues whether it is a simple matter of trying understand code or project ideas or if it is an actual bug report.
"There are no stupid questions."
Pull requests are welcome and appreciated.