306581e70b
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>
160 lines
5.3 KiB
Python
160 lines
5.3 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 build_fields(inputs):
|
|
fields = {}
|
|
|
|
summary = str(inputs.get("summary") or "").strip()
|
|
if summary:
|
|
fields["summary"] = summary
|
|
|
|
description = str(inputs.get("description") or "").strip()
|
|
if description:
|
|
fields["description"] = adf(description)
|
|
|
|
priority = str(inputs.get("priority") or "").strip()
|
|
if priority:
|
|
fields["priority"] = {"name": priority}
|
|
|
|
labels = str(inputs.get("labels") or "").strip()
|
|
if labels:
|
|
fields["labels"] = [x.strip() for x in labels.split(",") if x.strip()]
|
|
|
|
components = str(inputs.get("components") or "").strip()
|
|
if components:
|
|
fields["components"] = [{"name": c.strip()} for c in components.split(",") if c.strip()]
|
|
|
|
due_date = str(inputs.get("due_date") or "").strip()
|
|
if due_date:
|
|
fields["duedate"] = due_date
|
|
|
|
assignee_id = str(inputs.get("assignee_id") or "").strip()
|
|
assignee = str(inputs.get("assignee") or "").strip()
|
|
if assignee_id:
|
|
fields["assignee"] = {"accountId": assignee_id}
|
|
elif assignee:
|
|
fields["assignee"] = {"name": assignee}
|
|
|
|
fields_json = str(inputs.get("fields_json") or "").strip()
|
|
if fields_json:
|
|
extra = json.loads(fields_json)
|
|
if not isinstance(extra, dict):
|
|
raise Exception("fields_json must be a JSON object")
|
|
fields.update(extra)
|
|
|
|
return fields
|
|
|
|
|
|
def find_transition(ref, status, transition):
|
|
res = request("GET", "/rest/api/" + _api() + "/issue/" + ref + "/transitions")
|
|
transitions = res.get("transitions") or []
|
|
if transition:
|
|
wanted = transition.lower()
|
|
for t in transitions:
|
|
if str(t.get("name") or "").lower() == wanted:
|
|
return t.get("id")
|
|
names = [str(t.get("name") or "") for t in transitions]
|
|
raise Exception("transition not found: " + transition + " — valid transitions: " + ", ".join(names))
|
|
wanted = status.lower()
|
|
for t in transitions:
|
|
if str((t.get("to") or {}).get("name") or "").lower() == wanted:
|
|
return t.get("id")
|
|
names = [str((t.get("to") or {}).get("name") or "") for t in transitions]
|
|
raise Exception("status not reachable: " + status + " — valid statuses: " + ", ".join(names))
|
|
|
|
|
|
def main():
|
|
inputs = json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
|
|
ref = issue_ref(inputs)
|
|
|
|
status = str(inputs.get("status") or "").strip()
|
|
transition = str(inputs.get("transition") or "").strip()
|
|
if status and transition:
|
|
raise Exception("provide only one of status or transition")
|
|
|
|
fields = build_fields(inputs)
|
|
|
|
if status or transition:
|
|
tid = find_transition(ref, status, transition)
|
|
body = {"transition": {"id": str(tid)}}
|
|
if fields:
|
|
body["fields"] = fields
|
|
request("POST", "/rest/api/" + _api() + "/issue/" + ref + "/transitions", body=body)
|
|
elif fields:
|
|
request("PUT", "/rest/api/" + _api() + "/issue/" + ref, body={"fields": fields})
|
|
else:
|
|
raise Exception("nothing to update")
|
|
|
|
res = request("GET", "/rest/api/" + _api() + "/issue/" + ref)
|
|
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)
|