Migrating scenario 12 from the EndoscopyInvestigationDatasetScenarios feature file (#117)

<!-- markdownlint-disable-next-line first-line-heading -->
## Description

<!-- Describe your changes in detail. -->
Migrating scenario 12 from the EndoscopyInvestigationDatasetScenarios
feature file

## Context

<!-- Why is this change required? What problem does it solve? -->
Migrating scenario 12 from the EndoscopyInvestigationDatasetScenarios
feature file

## Type of changes

<!-- What types of changes does your code introduce? Put an `x` in all
the boxes that apply. -->

- [x] Refactoring (non-breaking change)
- [x] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would change existing
functionality)
- [ ] Bug fix (non-breaking change which fixes an issue)

## Checklist

<!-- Go over all the following points, and put an `x` in all the boxes
that apply. -->

- [x] I am familiar with the [contributing
guidelines](https://github.com/nhs-england-tools/playwright-python-blueprint/blob/main/CONTRIBUTING.md)
- [x] I have followed the code style of the project
- [x] I have added tests to cover my changes (where appropriate)
- [x] I have updated the documentation accordingly
- [ ] This PR is a result of pair or mob programming

---

## Sensitive Information Declaration

To ensure the utmost confidentiality and protect your and others
privacy, we kindly ask you to NOT including [PII (Personal Identifiable
Information) / PID (Personal Identifiable
Data)](https://digital.nhs.uk/data-and-information/keeping-data-safe-and-benefitting-the-public)
or any other sensitive data in this PR (Pull Request) and the codebase
changes. We will remove any PR that do contain any sensitive
information. We really appreciate your cooperation in this matter.

- [x] I confirm that neither PII/PID nor sensitive data are included in
this PR and the codebase changes.

Author: adrianoaru-nhs

pages/datasets/investigation_dataset_page.py

@@ -713,33 +713,49 @@ def label_matches(idx: int) -> bool:
 
     def check_visibility_of_drug_type(
         self, drug_type: str, drug_number: int, visible: bool
-    ) -> bool:
+    ) -> None:
         """
         Checks the visibility of the drug type input cell.
         Args:
             drug_type (str): The drug type to check
             drug_number (int): The number of the drug type cell to check.
             expected_text (str): The expected text content of the cell.
-        Returns:
-            bool: True if the visibility matches the expectation, False otherwise.
+        Raises:
+            AssertionError: If the visibility does not match the expectation.
         """
         locator = self.get_drug_type_locator(drug_type, drug_number)
-        return locator.is_visible() == visible
+        actual_visibility = locator.is_visible()
+        assert actual_visibility == visible, (
+            f"The {ordinal(drug_number)} {drug_type} drug type input cell visibility was {actual_visibility}, "
+            f"expected {visible}"
+        )
+        logging.info(
+            f"The {ordinal(drug_number)} {drug_type} drug type input cell is "
+            f"{'visible' if actual_visibility else 'not visible'} as expected"
+        )
 
     def check_visibility_of_drug_dose(
         self, drug_type: str, drug_number: int, visible: bool
-    ) -> bool:
+    ) -> None:
         """
-        Checks the visibility of the drug dose input cell.
+        Asserts the visibility of the drug dose input cell and logs the result.
         Args:
-            drug_type (str): The drug type to check
+            drug_type (str): The drug type to check.
             drug_number (int): The number of the drug dose cell to check.
             visible (bool): True if the field should be visible, False if it should not.
-        Returns:
-            bool: True if the visibility matches the expectation, False otherwise.
+        Raises:
+            AssertionError: If the visibility does not match the expectation.
         """
         locator = self.get_drug_dose_locator(drug_type, drug_number)
-        return locator.is_visible() == visible
+        actual_visibility = locator.is_visible()
+        assert actual_visibility == visible, (
+            f"The {ordinal(drug_number)} {drug_type} drug dose input cell visibility was {actual_visibility}, "
+            f"expected {visible}"
+        )
+        logging.info(
+            f"The {ordinal(drug_number)} {drug_type} drug dose input cell is "
+            f"{'visible' if actual_visibility else 'not visible'} as expected"
+        )
 
     def assert_drug_type_text(
         self, drug_type: str, drug_number: int, expected_text: str
@@ -928,8 +944,23 @@ def assert_all_drug_information(
                         | AntibioticsAdministeredDrugTypeOptions.GENTAMICIN
                         | AntibioticsAdministeredDrugTypeOptions.METRONIDAZOLE
                         | AntibioticsAdministeredDrugTypeOptions.TEICOPLANIN
+                        | OtherDrugsAdministeredDrugTypeOptions.BUSCOPAN
+                        | OtherDrugsAdministeredDrugTypeOptions.DIAZEMULS
+                        | OtherDrugsAdministeredDrugTypeOptions.GLUCAGON
+                        | OtherDrugsAdministeredDrugTypeOptions.HYDROCORTISONE
+                        | OtherDrugsAdministeredDrugTypeOptions.MEPTAZINOL
+                        | OtherDrugsAdministeredDrugTypeOptions.MIDAZOLAM
+                        | OtherDrugsAdministeredDrugTypeOptions.PETHIDINE
+                        | OtherDrugsAdministeredDrugTypeOptions.PROPOFOL
                     ):
                         expected_unit = "mg"
+                    case (
+                        OtherDrugsAdministeredDrugTypeOptions.ALFENTANYL
+                        | OtherDrugsAdministeredDrugTypeOptions.FENTANYL
+                        | OtherDrugsAdministeredDrugTypeOptions.FLUMAZENIL
+                        | OtherDrugsAdministeredDrugTypeOptions.NALOXONE
+                    ):
+                        expected_unit = "mcg"
                     case _:
                         expected_unit = None
 
@@ -1369,6 +1400,23 @@ class AntibioticsAdministeredDrugTypeOptions(StrEnum):
     OTHER_ANTIBIOTIC = "305493"
 
 
+class OtherDrugsAdministeredDrugTypeOptions(StrEnum):
+    """Enum for other drugs administered drug type options"""
+
+    ALFENTANYL = "200252~mcg"
+    BUSCOPAN = "17133~mg"
+    DIAZEMULS = "17959~mg"
+    FENTANYL = "17958~mcg"
+    FLUMAZENIL = "17134~mcg"
+    GLUCAGON = "17940~mg"
+    HYDROCORTISONE = "17527~mg"
+    MEPTAZINOL = "200251~mg"
+    MIDAZOLAM = "17135~mg"
+    NALOXONE = "17136~mcg~204333"
+    PETHIDINE = "17137~mg"
+    PROPOFOL = "17960~mg"
+
+
 # Registry of all known Enums to search when matching string values
 ALL_ENUMS: List[type[Enum]] = [
     obj
@@ -1412,3 +1460,14 @@ def to_enum_name_or_value(val: Any) -> Union[str, Any]:
 
     # Fallback: return unchanged
     return val
+
+
+def ordinal(n: int) -> str:
+    """
+    Converts an integer to its ordinal representation (e.g., 1 -> '1st', 2 -> '2nd').
+    """
+    if 10 <= n % 100 <= 20:
+        suffix = "th"
+    else:
+        suffix = {1: "st", 2: "nd", 3: "rd"}.get(n % 10, "th")
+    return f"{n}{suffix}"