Automate creating readme and tracking issue (#460)

Note at @fediverse/FEP-Editors - Once this is merged please check it does the right thing. - If you are ok with automating these things, I'll update the description of a facilitators role to just be checking and mergin - finally, can we rename the codeberg group, I just addressed, to FEP-Facilitators Final note: I already configured Woodpecker and the repository. This is to ensure that merging this pull request does not lead to a broken CI, second I might forget the steps ... - [x] Force myself to document the automated process as a FEP Reviewed-on: https://codeberg.org/fediverse/fep/pulls/460 Reviewed-by: silverpill <silverpill@noreply.codeberg.org> Co-authored-by: Helge <helge.krueger@gmail.com> Co-committed-by: Helge <helge.krueger@gmail.com>
2026-08-09 22:15:48 +00:00 · 2025-01-20 10:24:00 +00:00
parent c5d44a7cc5
commit 854ef33092
8 changed files with 281 additions and 54 deletions
@@ -0,0 +1,89 @@
+from datetime import timedelta, date
+from urllib.request import Request, urlopen
+
+import json
+
+from .fep_file import FepFile
+
+DRAFT_FEP_LABEL = 149758
+
+
+def create_body(filename: str, date_received: date):
+    date1 = date_received.isoformat()
+    date2 = (date_received + timedelta(days=365)).isoformat()
+
+    body = f"""
+The [proposal](https://codeberg.org/fediverse/fep/src/branch/main/{filename}) has been received. Thank you!
+
+This issue tracks discussions and updates to the proposal during the `DRAFT` period.
+
+Please post links to relevant discussions as comments to this issue.
+
+`dateReceived`: {date1}
+
+If no further actions are taken, the proposal may be set by the facilitators to `WITHDRAWN` on {date2} (in 1 year).
+    """
+
+    return body
+
+
+def create_codeberg_issue(owner, repo, token, title, body):
+    request = Request(f"https://codeberg.org/api/v1/repos/{owner}/{repo}/issues")
+    request.add_header("Content-Type", "application/json; charset=utf-8")
+    request_body = json.dumps(
+        {"title": title, "body": body, "labels": [DRAFT_FEP_LABEL]}
+    ).encode("utf-8")
+    request.add_header("authorization", f"Bearer {token}")
+    request.add_header("Content-Length", len(request_body))
+    request.data = request_body
+    response = urlopen(request)
+
+    issue_url = json.loads(response.read())["html_url"]
+
+    return issue_url
+
+
+def parse_and_update_date_received(input_date: str) -> date:
+    try:
+        parsed = date.fromisoformat(input_date)
+
+        if parsed < date.today() - timedelta(days=30):
+            return date.today()
+
+        return parsed
+    except Exception:
+        return date.today()
+
+
+def update_fep_file_with_date_received(fep_file: FepFile, date_received: date):
+    fep_file.frontmatter = [
+        x for x in fep_file.frontmatter if not x.startswith("dateReceived")
+    ]
+    fep_file.frontmatter.append(f"dateReceived: {date_received.isoformat()}")
+
+
+def create_issue(owner, repo, token, slug):
+    fep_file = FepFile(slug)
+
+    if "trackingIssue" in fep_file.parsed_frontmatter:
+        print("File already has trackingIssue")
+        exit(1)
+
+    title = f"[TRACKING] FEP-{slug}: {fep_file.title}"
+
+    date_received = parse_and_update_date_received(
+        fep_file.parsed_frontmatter["dateReceived"]
+    )
+    update_fep_file_with_date_received(fep_file, date_received)
+
+    body = create_body(fep_file.filename, date_received)
+
+    issue_url = create_codeberg_issue(owner, repo, token, title, body)
+
+    fep_file.frontmatter.append(f"trackingIssue: {issue_url}")
+    if "discussionsTo" not in fep_file.parsed_frontmatter:
+        fep_file.frontmatter.append(f"discussionsTo: {issue_url}")
+
+    fep_file.write()
+
+    print(f"Issue url: {issue_url} for {title}")