CRAVEX-integration: Integration with Issue tracker: Sourcehut

[pombredanne]

Integrate with Sourcehut issues

[tdruez]

Implementation

PR: #377

Notes

SourceHut does not provide a REST API like the other integration platforms.
Instead, it uses a GraphQL API for all interactions.
Because of this, the integration works a bit differently behind the scenes,
but this difference should be transparent to both admins and end users relying on it.

See https://docs.sourcehut.org/todo.sr.ht/ for SourceHut API Documentation.

Documentation

https://dejacode.readthedocs.io/en/latest/integrations-sourcehut.html

Changes

• Add a sourcehut_token field on the Dataspace configuration model.
• The integration code exists as the SourceHutIntegration class.

Quickstart

Prerequisites

• A SourceHut tracker that you want to integrate with DejaCode.
• A SourceHut user account with sufficient permissions to create and manage tickets in the target tracker.

DejaCode configuration

1. Set your sourcehut_token on your Dataspace configuration.
2. Create a new RequestTemplate in your Dataspace and use your SourceHut tracker URL as the Issue Tracker ID, e.g.: https://todo.sr.ht/~USERNAME/PROJECT_NAME
3. From now on, any new DejaCode Request using this template will be pushed to the SourceHut-provided tracker. Edits such as field updates, comments, and closing the Request are also propagated to the SourceHut ticket.

Refer to https://dejacode.readthedocs.io/en/latest/integrations-sourcehut.html
for detailed instructions.