summaryrefslogtreecommitdiffstats
path: root/vendor/github.com/matrix-org/gomatrix/README.md
diff options
context:
space:
mode:
authorWim <wim@42.be>2021-04-03 19:16:46 +0200
committerGitHub <noreply@github.com>2021-04-03 19:16:46 +0200
commit21eb37e471c338a90f2e23c86106f7e49e2d1196 (patch)
treee7d1cfa89f31fcf0578edae7727f2230bba744a2 /vendor/github.com/matrix-org/gomatrix/README.md
parentd3b60cc445e5871971b543fde9483dba3924bf68 (diff)
downloadmatterbridge-msglm-21eb37e471c338a90f2e23c86106f7e49e2d1196.tar.gz
matterbridge-msglm-21eb37e471c338a90f2e23c86106f7e49e2d1196.tar.bz2
matterbridge-msglm-21eb37e471c338a90f2e23c86106f7e49e2d1196.zip
Update vendor (#1446)
* Update vendor * Use upstream emoji lib again
Diffstat (limited to 'vendor/github.com/matrix-org/gomatrix/README.md')
-rw-r--r--vendor/github.com/matrix-org/gomatrix/README.md65
1 files changed, 65 insertions, 0 deletions
diff --git a/vendor/github.com/matrix-org/gomatrix/README.md b/vendor/github.com/matrix-org/gomatrix/README.md
index ea9109ad..a083b46c 100644
--- a/vendor/github.com/matrix-org/gomatrix/README.md
+++ b/vendor/github.com/matrix-org/gomatrix/README.md
@@ -4,3 +4,68 @@
A Golang Matrix client.
**THIS IS UNDER ACTIVE DEVELOPMENT: BREAKING CHANGES ARE FREQUENT.**
+
+# Contributing
+
+All contributions are greatly appreciated!
+
+## How to report issues
+
+Please check the current open issues for similar reports
+in order to avoid duplicates.
+
+Some general guidelines:
+
+- Include a [minimal reproducible example](https://stackoverflow.com/help/minimal-reproducible-example) when possible.
+- Describe the expected behaviour and what actually happened
+ including a full trace-back in case of exceptions.
+- Make sure to list details about your environment
+
+## Setting up your environment
+
+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](https://golangci-lint.run/usage/install/#local-installation)).
+
+- Fork gomatrix to your GitHub account by clicking the [Fork](https://github.com/matrix-org/gomatrix/fork) button.
+- [Clone](https://help.github.com/en/articles/fork-a-repo#step-2-create-a-local-clone-of-your-fork) 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
+
+ <gomatrix dir>/hooks/pre-commit
+
+- Push your changes to your fork and [create a pull request](https://help.github.com/en/articles/creating-a-pull-request) describing your changes.
+
+ $ git push --set-upstream fork your-branch-name
+
+- Finally, create a [pull request](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-requests)
+
+## How to run tests
+
+You can run the test suite and example code with `$ go test -v`
+
+# Running Coverage
+
+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