A Golang Matrix client
A Golang Matrix client.
THIS IS UNDER ACTIVE DEVELOPMENT: BREAKING CHANGES ARE FREQUENT.
All contributions are greatly appreciated!
Please check the current open issues for similar reports in order to avoid duplicates.
Some general guidelines:
If you intend to contribute to gomatrix you'll first need Go installed on your machine (version 1.12+ is required). Also, make sure to have golangci-lint properly set up since we use it for pre-commit hooks (for instructions on how to install it, check the official docs).
Clone the main repository (not your fork) to your local machine.
$ git clone https://github.com/matrix-org/gomatrix $ cd gomatrix
Add your fork as a remote to push your contributions.Replace
{username}with your username.
git remote add fork https://github.com/{username}/gomatrix
Create a new branch to identify what feature you are working on.
$ git fetch origin $ git checkout -b your-branch-name origin/master
Make your changes, including tests that cover any code changes you make, and run them as described below.
Execute pre-commit hooks by running
/hooks/pre-commit
Push your changes to your fork and create a pull request describing your changes.
$ git push --set-upstream fork your-branch-name
Finally, create a pull request
You can run the test suite and example code with
$ go test -v
To run coverage, first generate the coverage report using
go test
go test -v -cover -coverprofile=coverage.out
You can now show the generated report as a html page with
go tool
go tool cover -html=coverage.out