Source code for jira.exceptions

from __future__ import annotations

import os
import tempfile
from typing import Any

from requests import Response


[docs]class JIRAError(Exception): """General error raised for all problems in operation of the client."""
[docs] def __init__( self, text: str = None, status_code: int = None, url: str = None, request: Response = None, response: Response = None, **kwargs, ): """Creates a JIRAError. Args: text (Optional[str]): Message for the error. status_code (Optional[int]): Status code for the error. url (Optional[str]): Url related to the error. request (Optional[requests.Response]): Request made related to the error. response (Optional[requests.Response]): Response received related to the error. **kwargs: Will be used to get request headers. """ self.status_code = status_code self.text = text self.url = url self.request = request self.response = response self.headers = kwargs.get("headers", None) self.log_to_tempfile = "PYJIRA_LOG_TO_TEMPFILE" in os.environ self.ci_run = "GITHUB_ACTION" in os.environ
def __str__(self) -> str: t = f"JiraError HTTP {self.status_code}" if self.url: t += f" url: {self.url}" details = "" if self.request is not None: if hasattr(self.request, "headers"): details += f"\n\trequest headers = {self.request.headers}" if hasattr(self.request, "text"): details += f"\n\trequest text = {self.request.text}" if self.response is not None: if hasattr(self.response, "headers"): details += f"\n\tresponse headers = {self.response.headers}" if hasattr(self.response, "text"): details += f"\n\tresponse text = {self.response.text}" if self.log_to_tempfile: # Only log to tempfile if the option is set. _, file_name = tempfile.mkstemp(suffix=".tmp", prefix="jiraerror-") with open(file_name, "w") as f: t += f" details: {file_name}" f.write(details) else: # Otherwise, just return the error as usual if self.text: t += f"\n\ttext: {self.text}" t += f"\n\t{details}" return t
[docs]class NotJIRAInstanceError(Exception): """Raised in the case an object is not a JIRA instance."""
[docs] def __init__(self, instance: Any): msg = ( "The first argument of this function must be an instance of type " f"JIRA. Instance Type: {instance.__class__.__name__}" ) super().__init__(msg)