Files
riposte-marketplace/integrations/jira/scripts/link_issues.py
T
Guillaume BOURGEOIS 306581e70b feat(jira): new Atlassian Jira integration
Jira Cloud and On-Prem/Data Center (27 commands): JQL ingestion with an
OCSF mapper and JQL query, full issue lifecycle (create/get/edit/delete,
transitions, assign), comments, remote web links and issue links,
attachments (upload/download/delete), field and user lookups, and agile
boards/sprints/epics. Basic (email + API token) or Personal Access Token
authentication; API v3 + ADF bodies on Cloud, v2 on On-Prem.
Stdlib-only, no extra Python dependencies.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-11 21:56:52 +02:00

111 lines
3.5 KiB
Python

import base64, json, os, sys, urllib.parse, urllib.request, urllib.error
def _cfg():
return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
def _is_cloud():
return bool(str(_cfg().get("cloud_id") or "").strip())
def _api():
return "3" if _is_cloud() else "2"
def _base():
cfg = _cfg()
root = str(cfg.get("server_url") or "https://api.atlassian.com/ex/jira").rstrip("/")
cloud_id = str(cfg.get("cloud_id") or "").strip()
return root + "/" + cloud_id if cloud_id else root
def _auth():
cfg = _cfg()
pat = str(cfg.get("pat") or "")
if pat:
return "Bearer " + pat
cred = (str(cfg.get("username") or "") + ":" + str(cfg.get("api_key") or "")).encode("utf-8")
return "Basic " + base64.b64encode(cred).decode("ascii")
def request(method, path, params=None, body=None, full_url=None, raw=False):
url = full_url or (_base() + path)
q = {k: str(x) for k, x in (params or {}).items() if x not in (None, "")}
if q:
url += ("&" if "?" in url else "?") + urllib.parse.urlencode(q)
data = json.dumps(body).encode("utf-8") if body is not None else None
headers = {"Accept": "application/json", "Authorization": _auth()}
if data is not None:
headers["Content-Type"] = "application/json"
req = urllib.request.Request(url, data=data, headers=headers, method=method)
with urllib.request.urlopen(req, timeout=90) as r:
content = r.read()
if raw:
return content
return json.loads(content) if content else {}
def issue_ref(inputs):
ref = str(inputs.get("issue_id") or "") or str(inputs.get("issue_key") or "")
if not ref:
raise Exception("issue_id or issue_key is required")
return urllib.parse.quote(ref, safe="")
def adf(text):
# Jira Cloud (API v3) expects Atlassian Document Format for rich text; On-Prem (v2) takes plain text.
if not _is_cloud():
return text
return {"type": "doc", "version": 1,
"content": [{"type": "paragraph", "content": [{"type": "text", "text": text}]}]}
def _issue_selector(value):
# A numeric value is an issue id; anything else is an issue key.
if str(value).isdigit():
return {"id": str(value)}
return {"key": str(value)}
def main():
inputs = json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
inward_issue = str(inputs.get("inward_issue") or "")
if not inward_issue:
raise Exception("inward_issue is required")
outward_issue = str(inputs.get("outward_issue") or "")
if not outward_issue:
raise Exception("outward_issue is required")
link_type = str(inputs.get("link_type") or "")
if not link_type:
raise Exception("link_type is required")
comment = str(inputs.get("comment") or "")
body = {
"type": {"name": link_type},
"inwardIssue": _issue_selector(inward_issue),
"outwardIssue": _issue_selector(outward_issue),
}
if comment:
body["comment"] = {"body": adf(comment)}
res = request("POST", "/rest/api/" + _api() + "/issueLink", body=body)
if not res:
res = {
"ok": True,
"inward_issue": inward_issue,
"outward_issue": outward_issue,
"link_type": link_type,
}
print(json.dumps(res))
try:
main()
except urllib.error.HTTPError as e:
print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
sys.exit(1)
except Exception as e:
print(json.dumps({"error": str(e)}))
sys.exit(1)