Merge branch 'main' into feature/BCSS-20615-regression-test-subject-episodes-diagnosis-date

Signed-off-by: vidhya-chandra1 <[email protected]>

Author: vidhya-chandra1

classes/asa_grade_type.py

@@ -0,0 +1,89 @@
+from enum import Enum
+from typing import Optional, Dict
+
+
+class ASAGradeType(Enum):
+    """
+    Enum representing ASA grades for colonoscopy assessment scenarios,
+    with valid value IDs and descriptions.
+    """
+
+    IFIT = (17009, "I - Fit")
+    II_RELEVANT_DISEASE = (17010, "II - Relevant disease")
+    III_RESTRICTIVE_DISEASE = (17011, "III - Restrictive disease")
+    IV_LIFE_THREATENING_DISEASE = (17012, "IV - Life threatening disease")
+    V_MORIBUND = (17013, "V - Moribund")
+    NOT_APPLICABLE = (17014, "Not Applicable")
+    NOT_KNOWN = (17015, "Not Known")
+    NULL = (None, "")
+
+    def __init__(self, valid_value_id: Optional[int], description: str):
+        self._valid_value_id: Optional[int] = valid_value_id
+        self._description: str = description
+
+    @property
+    def valid_value_id(self) -> Optional[int]:
+        """Returns the valid value ID for the ASA grade."""
+        return self._valid_value_id
+
+    @property
+    def description(self) -> str:
+        """Returns the description for the ASA grade."""
+        return self._description
+
+    @classmethod
+    def _build_maps(cls) -> None:
+        """
+        Initializes internal lookup maps for ASAGradeType enum members.
+
+        It ensures these maps are built only once per class, using `hasattr` to prevent
+        redundant reinitialization.
+        """
+        if not hasattr(cls, "_descriptions"):
+            cls._descriptions: Dict[str, ASAGradeType] = {}
+            cls._lowercase_descriptions: Dict[str, ASAGradeType] = {}
+            cls._valid_value_ids: Dict[Optional[int], ASAGradeType] = {}
+            for item in cls:
+                cls._descriptions[item.description] = item
+                cls._lowercase_descriptions[item.description.lower()] = item
+                cls._valid_value_ids[item.valid_value_id] = item
+
+    @classmethod
+    def by_description(cls, description: str) -> Optional["ASAGradeType"]:
+        """
+        Returns the ASAGradeType matching the given description.
+        """
+        cls._build_maps()
+        return cls._descriptions.get(description)
+
+    @classmethod
+    def by_description_case_insensitive(
+        cls, description: str
+    ) -> Optional["ASAGradeType"]:
+        """
+        Returns the ASAGradeType matching the given description (case-insensitive).
+        """
+        cls._build_maps()
+        return cls._lowercase_descriptions.get(description.lower())
+
+    @classmethod
+    def by_valid_value_id(
+        cls, valid_value_id: Optional[int]
+    ) -> Optional["ASAGradeType"]:
+        """
+        Returns the ASAGradeType matching the given valid value ID.
+        """
+        cls._build_maps()
+        return cls._valid_value_ids.get(valid_value_id)
+
+    def get_valid_value_id(self) -> Optional[int]:
+        """
+        Returns the valid value ID for the ASA grade.
+        """
+        return self._valid_value_id
+
+    def get_description(self) -> str:
+        """
+        Returns the description for the ASA grade.
+        """
+        return self._description

classes/cancer_treatment_intent.py

@@ -0,0 +1,81 @@
+from enum import Enum
+from typing import Optional, Dict
+
+
+class CancerTreatmentIntent(Enum):
+    """
+    Enum representing types of cancer treatment intent with associated valid value IDs and descriptions.
+    Provides utility methods to retrieve enum instances by description or ID.
+    """
+
+    CURATIVE = (17370, "Curative")
+    PALLIATIVE = (17371, "Palliative")
+    UNCERTAIN = (17372, "Uncertain")
+    NOT_KNOWN = (17373, "Not Known")
+
+    def __init__(self, valid_value_id: int, description: str):
+        self._valid_value_id = valid_value_id
+        self._description = description
+
+    @property
+    def valid_value_id(self) -> int:
+        """Returns the valid value ID for the treatment given."""
+        return self._valid_value_id
+
+    @property
+    def description(self) -> str:
+        """Returns the description for the treatment given."""
+        return self._description
+
+    @classmethod
+    def _build_maps(cls) -> None:
+        """
+        Initializes internal lookup maps for CanterTreatmentIntent enum members.
+
+        It ensures these maps are built only once per class, using `hasattr` to prevent
+        redundant reinitialization.
+        """
+        if not hasattr(cls, "_descriptions"):
+            cls._descriptions: Dict[str, CancerTreatmentIntent] = {}
+            cls._lowercase_descriptions: Dict[str, CancerTreatmentIntent] = {}
+            cls._valid_value_ids: Dict[int, CancerTreatmentIntent] = {}
+            for item in cls:
+                cls._descriptions[item.description] = item
+                cls._lowercase_descriptions[item.description.lower()] = item
+                cls._valid_value_ids[item.valid_value_id] = item
+
+    @classmethod
+    def by_description(cls, description: str) -> Optional["CancerTreatmentIntent"]:
+        """
+        Returns the CancerTreatmentIntent matching the given description.
+        """
+        cls._build_maps()
+        return cls._descriptions.get(description)
+
+    @classmethod
+    def by_description_case_insensitive(
+        cls, description: str
+    ) -> Optional["CancerTreatmentIntent"]:
+        """
+        Returns the CancerTreatmentIntent matching the given description (case-insensitive).
+        """
+        cls._build_maps()
+        return cls._lowercase_descriptions.get(description.lower())
+
+    @classmethod
+    def by_valid_value_id(
+        cls, valid_value_id: int
+    ) -> Optional["CancerTreatmentIntent"]:
+        """
+        Returns the CancerTreatmentIntent matching the given valid value ID.
+        """
+        cls._build_maps()
+        return cls._valid_value_ids.get(valid_value_id)
+
+    def get_id(self) -> int:
+        """Returns the valid value ID for the CancerTreatmentIntent given."""
+        return self._valid_value_id
+
+    def get_description(self) -> str:
+        """Returns the description for the CancerTreatmentIntent given."""
+        return self._description

classes/diagnosis_date_reason_type.py

@@ -1,7 +1,12 @@
 from enum import Enum
 from typing import Optional, Dict
 
+
 class DiagnosisDateReasonType(Enum):
+    """
+    Enum representing diagnosis date reasons with valid value IDs and descriptions.
+    """
+
     TWO_DNAS_OF_COLONOSCOPY_ASSESSMENT_APPT = (
         305521,
         "2 DNAs of colonoscopy assessment appt",
@@ -14,7 +19,7 @@ class DiagnosisDateReasonType(Enum):
     PATIENT_CHOICE = (305522, "Patient choice")
     PATIENT_COULD_NOT_BE_CONTACTED = (305505, "Patient could not be contacted")
     PATIENT_DECEASED = (305503, "Patient deceased")
-    PATIENT_DECLINIED_ALL_APPOINTMENTS = (305520, "Patient declined all appointments")
+    PATIENT_DECLINED_ALL_APPOINTMENTS = (305520, "Patient declined all appointments")
     PATIENT_EMIGRATED = (305504, "Patient emigrated")
     REOPENED_OLD_EPISODE_DATE_UNKNOWN = (305502, "Reopened old episode, date unknown")
     SSPI_UPDATE_PATIENT_DECEASED = (305525, "SSPI update - patient deceased")
@@ -27,21 +32,27 @@ class DiagnosisDateReasonType(Enum):
     NOT_NULL = (None, "NOT NULL")
 
     def __init__(self, valid_value_id: Optional[int], description: str):
-        self._valid_value_id = valid_value_id
-        self._description = description
+        self._valid_value_id: Optional[int] = valid_value_id
+        self._description: str = description
 
     @property
     def valid_value_id(self) -> Optional[int]:
-        """Returns the valid value ID for the reason for diagnosis date."""
+        """Returns the valid value ID for the diagnosis date reason."""
         return self._valid_value_id
 
     @property
     def description(self) -> str:
-        """Returns the description for the reason for diagnosis date."""
+        """Returns the description for the diagnosis date reason."""
         return self._description
 
     @classmethod
-    def _build_maps(cls):
+    def _build_maps(cls) -> None:
+        """
+        Initializes internal lookup maps for DiagnosisDateReasonType enum members.
+
+        It ensures these maps are built only once per class, using `hasattr` to prevent
+        redundant reinitialization.
+        """
         if not hasattr(cls, "_descriptions"):
             cls._descriptions: Dict[str, DiagnosisDateReasonType] = {}
             cls._lowercase_descriptions: Dict[str, DiagnosisDateReasonType] = {}
@@ -53,30 +64,40 @@ def _build_maps(cls):
 
     @classmethod
     def by_description(cls, description: str) -> Optional["DiagnosisDateReasonType"]:
-        """Returns the DiagnosisDateReasonType matching the given description."""
+        """
+        Returns the DiagnosisDateReasonType matching the given description.
+        """
         cls._build_maps()
         return cls._descriptions.get(description)
 
     @classmethod
     def by_description_case_insensitive(
         cls, description: str
     ) -> Optional["DiagnosisDateReasonType"]:
-        """Returns the DiagnosisDateReasonType matching the given description. (case-insensitive)."""
+        """
+        Returns the DiagnosisDateReasonType matching the given description (case-insensitive).
+        """
         cls._build_maps()
         return cls._lowercase_descriptions.get(description.lower())
 
     @classmethod
     def by_valid_value_id(
         cls, valid_value_id: Optional[int]
     ) -> Optional["DiagnosisDateReasonType"]:
-        """Returns the DiagnosisDateReasonType matching the given valid value ID."""
+        """
+        Returns the DiagnosisDateReasonType matching the given valid value ID.
+        """
         cls._build_maps()
         return cls._valid_value_ids.get(valid_value_id)
 
     def get_valid_value_id(self) -> Optional[int]:
-        """Returns the valid value ID for the reason for diagnosis date reason."""
+        """
+        Returns the valid value ID for the diagnosis date reason.
+        """
         return self._valid_value_id
 
     def get_description(self) -> str:
-        """Returns the description for the reason for diagnosis date reason"""
-        return self._description
+        """
+        Returns the description for the diagnosis date reason.
+        """
+        return self._description

classes/diagnostic_test_referral_type.py

@@ -0,0 +1,82 @@
+from enum import Enum
+from typing import Optional, Dict
+
+
+class DiagnosticTestReferralType(Enum):
+    """
+    Enum representing diagnostic test referral types with valid value IDs and descriptions.
+    """
+
+    ENDOSCOPIC = (20356, "Endoscopic")
+    RADIOLOGICAL = (20357, "Radiological")
+
+    def __init__(self, valid_value_id: int, description: str):
+        self._valid_value_id: int = valid_value_id
+        self._description: str = description
+
+    @property
+    def valid_value_id(self) -> int:
+        """Returns the valid value ID for the diagnostic test referral type."""
+        return self._valid_value_id
+
+    @property
+    def description(self) -> str:
+        """Returns the description for the diagnostic test referral type."""
+        return self._description
+
+    @classmethod
+    def _build_maps(cls) -> None:
+        """
+        Initializes internal lookup maps for DiagnosticTestReferralType enum members.
+
+        It ensures these maps are built only once per class, using `hasattr` to prevent
+        redundant reinitialization.
+        """
+        if not hasattr(cls, "_descriptions"):
+            cls._descriptions: Dict[str, DiagnosticTestReferralType] = {}
+            cls._lowercase_descriptions: Dict[str, DiagnosticTestReferralType] = {}
+            cls._valid_value_ids: Dict[int, DiagnosticTestReferralType] = {}
+            for item in cls:
+                cls._descriptions[item.description] = item
+                cls._lowercase_descriptions[item.description.lower()] = item
+                cls._valid_value_ids[item.valid_value_id] = item
+
+    @classmethod
+    def by_description(cls, description: str) -> Optional["DiagnosticTestReferralType"]:
+        """
+        Returns the DiagnosticTestReferralType matching the given description.
+        """
+        cls._build_maps()
+        return cls._descriptions.get(description)
+
+    @classmethod
+    def by_description_case_insensitive(
+        cls, description: str
+    ) -> Optional["DiagnosticTestReferralType"]:
+        """
+        Returns the DiagnosticTestReferralType matching the given description (case-insensitive).
+        """
+        cls._build_maps()
+        return cls._lowercase_descriptions.get(description.lower())
+
+    @classmethod
+    def by_valid_value_id(
+        cls, valid_value_id: int
+    ) -> Optional["DiagnosticTestReferralType"]:
+        """
+        Returns the DiagnosticTestReferralType matching the given valid value ID.
+        """
+        cls._build_maps()
+        return cls._valid_value_ids.get(valid_value_id)
+
+    def get_id(self) -> int:
+        """
+        Returns the valid value ID for the diagnostic test referral type.
+        """
+        return self._valid_value_id
+
+    def get_description(self) -> str:
+        """
+        Returns the description for the diagnostic test referral type.
+        """
+        return self._description