diff options
-rw-r--r-- | gerrit-widget/README.md | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/gerrit-widget/README.md b/gerrit-widget/README.md index 5682b9b..fde1fd8 100644 --- a/gerrit-widget/README.md +++ b/gerrit-widget/README.md @@ -20,6 +20,12 @@ It is possible to customize widget by providing a table with all or some of the ## Installation 1. This widget relies on Gerrit [REST API](https://gerrit-review.googlesource.com/Documentation/rest-api.html), so you need to have a permission to access it. You also need to setup [netrc](https://ec.haxx.se/usingcurl-netrc.html), as widget uses curl to communicate with API and you have to be authenticated. +To test if you have access to API and netrc setup is correct run following command, you should have a json response: + +```bash + curl -s --request GET --netrc https://gerrit-host.com/a/changes/\?q\=status:open+AND+NOT+is:wip+AND+is:reviewer | tail -n +2 +``` +Note: `tail -n +2` is needed to skip first line of the response, as gerrit returns some characters there in order to prevent XSS hacks. 1. Download json parser for lua from [github.com/rxi/json.lua](https://github.com/rxi/json.lua) and place it under **~/.config/awesome/** (don't forget to star a repo): |