Files
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

106 lines
3.4 KiB
Python

import base64, json, os, sys, urllib.parse, urllib.request, urllib.error
import re
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 _body_text(comment):
rendered = comment.get("renderedBody")
if rendered:
return re.sub(r"<[^>]+>", "", str(rendered))
raw_body = comment.get("body")
if isinstance(raw_body, str):
return raw_body
return ""
def main():
inputs = json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
raw_ref = str(inputs.get("issue_id") or "") or str(inputs.get("issue_key") or "")
ref = issue_ref(inputs)
limit = inputs.get("limit") or 50
res = request("GET", "/rest/api/" + _api() + "/issue/" + ref + "/comment",
params={"maxResults": limit, "expand": "renderedBody"})
comments = []
for c in res.get("comments", []) or []:
comments.append({
"id": c.get("id", ""),
"body": _body_text(c),
"author": c.get("author", {}).get("displayName", ""),
"created": c.get("created", ""),
"updated": c.get("updated", ""),
"update_author": c.get("updateAuthor", {}).get("displayName", ""),
})
print(json.dumps({"issue": raw_ref, "comments": comments}))
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)