CRAVEX Forgejo workflow integration

[tdruez]

Issue: #347

Notes

Forgejo is a self-hosted lightweight software forge. Easy to install and low maintenance, it just does the job.

Although Forgejo is meant to be self-hosted, a testing platform is available at https://v12.next.forgejo.org/ ("Try now" link on the https://forgejo.org/ homepage).

The testing Forgero platform is working fine to test and review this integration. Use the "Register" link and create an account.

Documentation

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

Changes

• Add a forgejo_token field on the Dataspace configuration model.
• The integration code exists as the ForgejoIntegration class.
• Add a base_url field on the ExternalIssueLink model to support dynamic domains (Forgejo, Jira, ...)

Quickstart

Prerequisites

• A Forgejo repo that you want to integrate with DejaCode.
• A Forgejo user account with sufficient permissions to create and manage issues in the target repo.

DejaCode configuration

1. Set your forgejo_token on your Dataspace configuration.
2. Create a new RequestTemplate in your Dataspace and use your Forgejo project URL as the Issue Tracker ID, e.g.: https://forgejo.example.org/org/repo_name
3. From now on, any new DejaCode Request using this template will be pushed to the Forgejo-provided repo. Edits such as field updates, comments, and closing the Request are also propagated to the Forgejo Issue.

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

[DennisClark]

Initial testing is good: https://v12.next.forgejo.org/dmclark/aboutcode-dejacode/issues/1

[DennisClark]

Update testing is good also. Closed the Request in DejaCode with a Comment and both the Status update and Comment insert were successful in Forgejo.

@tdruez No problems found! The configuration documentation was clear enough and sufficient for me to do the setup. Let me know if you want me to do any more testing.