summary refs log tree commit diff
diff options
context:
space:
mode:
authorreivilibre <oliverw@matrix.org>2022-06-16 10:31:10 +0100
committerGitHub <noreply@github.com>2022-06-16 09:31:10 +0000
commitffe2464836dec7bbce2659b2b4e62eb956bf2a90 (patch)
tree75022b9c2c90e046527b912702f06e6b943deac5
parentMove some event auth checks out to a different method (#13065) (diff)
downloadsynapse-ffe2464836dec7bbce2659b2b4e62eb956bf2a90.tar.xz
Add instructions for running Complement with `gotestfmt`-formatted output locally. (#13073)
Diffstat (limited to '')
-rw-r--r--changelog.d/13073.doc1
-rw-r--r--docs/development/contributing_guide.md14
2 files changed, 15 insertions, 0 deletions
diff --git a/changelog.d/13073.doc b/changelog.d/13073.doc
new file mode 100644
index 0000000000..e162a8404e
--- /dev/null
+++ b/changelog.d/13073.doc
@@ -0,0 +1 @@
+Add instructions for running Complement with `gotestfmt`-formatted output locally.
\ No newline at end of file
diff --git a/docs/development/contributing_guide.md b/docs/development/contributing_guide.md
index c2f04a3905..4738f8a6b6 100644
--- a/docs/development/contributing_guide.md
+++ b/docs/development/contributing_guide.md
@@ -310,6 +310,20 @@ The above will run a monolithic (single-process) Synapse with SQLite as the data
 - Passing `WORKERS=1` as an environment variable to use a workerised setup instead. This option implies the use of Postgres.
 
 
+### Prettier formatting with `gotestfmt`
+
+If you want to format the output of the tests the same way as it looks in CI,
+install [gotestfmt](https://github.com/haveyoudebuggedit/gotestfmt).
+
+You can then use this incantation to format the tests appropriately:
+
+```sh
+COMPLEMENT_DIR=../complement ./scripts-dev/complement.sh -json | gotestfmt -hide successful-tests
+```
+
+(Remove `-hide successful-tests` if you don't want to hide successful tests.)
+
+
 ### Access database for homeserver after Complement test runs.
 
 If you're curious what the database looks like after you run some tests, here are some steps to get you going in Synapse: