Adjust the sourcehut_token field and documentation #348

Signed-off-by: tdruez <tdruez@nexb.com>

Author: tdruez

dje/migrations/0012_alter_dataspaceconfiguration_sourcehut_token.py

@@ -0,0 +1,18 @@
+# Generated by Django 5.2.4 on 2025-08-11 14:51
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('dje', '0011_dataspaceconfiguration_forgejo_token_and_more'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='dataspaceconfiguration',
+            name='sourcehut_token',
+            field=models.CharField(blank=True, help_text='Access token used to authenticate API requests for the SourceHut integration. This token must have permissions to create and update tickets. Keep this token secure.', max_length=2048, verbose_name='SourceHut token'),
+        ),
+    ]

dje/models.py

@@ -572,7 +572,7 @@ class DataspaceConfiguration(models.Model):
 
     sourcehut_token = models.CharField(
         _("SourceHut token"),
-        max_length=255,
+        max_length=2048,  # The length of this token depends on the selected permissions
         blank=True,
         help_text=_(
             "Access token used to authenticate API requests for the SourceHut integration. "

docs/integrations-sourcehut.rst

@@ -24,8 +24,8 @@ To enable integration, you need a SourceHut **API token**.
    - Go to https://meta.sr.ht/oauth2
    - Under **Personal Access Tokens**, click **"Generate new token"**
    - Set a clear description like ``DejaCode Integration`` in the "Comment" field
-   - Select only the ``todo.sr.ht`` > ``TICKETS`` scope
-   - **Generate token** and copy the token
+   - Select **both** the ``todo.sr.ht`` > ``TRACKERS`` AND ``TICKETS`` scopes
+   - **Generate token** and copy the **entire token string**
 
 .. note::