CodeScene Integration with Gerrit
=================================

You can integrate with Gerrit using the following options:

1. **Webhooks**: Enable the webhooks for Gerrit in your CodeScene project configuration. This adds automated review comments to Gerrit's patch sets.
2. **Build Bot**: Use CodeScene's Jenkins plugin as a code review bot (`+1`).

One important note on the Gerrit integration: Gerrit provides a staging area for code to be reviewed.
This staging area is kept separate from the main, authorative
Git repository. As a consequence, the commits for a delta analysis aren't available in the main
Git repository, but in Gerrit's mirror of the repository.

CodeScene lets you resolve this by specifying a different `origin_url` and a specific `change_ref` to fetch before the delta analysis is run.
Here's an example:

.. code-block:: bash

    curl -X POST -d '{"commits": ["149f9e6"], "repository": "PhpSpreadsheet", "origin_url": "gerrit.mycompany.com:39429/dev/wopr", "change_ref": "refs/changes/82/577659/7"}' http://localhost:3003/projects/64/delta-analysis -u 'CodeReview:MyPassword' -H "content-type: application/json"

That is, CodeScene will fetch a specific change set from Gerrit and then run the delta analysis as indicated by the other parameters you provide.
