Added pom for colonoscopy dataset (#44)

<!-- markdownlint-disable-next-line first-line-heading -->
## Description
c5 pom for colonoscopy datasets

<!-- Describe your changes in detail. -->

## Context
This covers the creation of a datasets dir within 'pages' and the
addition of a colonoscopy datasets pom. Also, the some functions from
subject_datasets have been moved to colonoscopy datasets.

<!-- Why is this change required? What problem does it solve? -->

## Type of changes
These changes will help us to use and manage functionality on the
colonoscopy dataset pages.

<!-- 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
- [ ] I have added tests to cover my changes (where appropriate)
- [ ] 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: Andyg79

pages/datasets/colonoscopy_dataset_page.py

@@ -0,0 +1,79 @@
+from playwright.sync_api import Page
+from pages.base_page import BasePage
+from enum import Enum
+
+
+class ColonoscopyDatasetsPage(BasePage):
+    """
+    This class contains locators and methods to interact with the Colonoscopy Datasets page.
+    """
+
+    def __init__(self, page: Page):
+        super().__init__(page)
+        self.page = page
+
+        # Colonoscopy datasets page locators
+        self.save_dataset_button = self.page.locator(
+            "#UI_DIV_BUTTON_SAVE1"
+        ).get_by_role("button", name="Save Dataset")
+
+        self.select_asa_grade_dropdown = self.page.get_by_label("ASA Grade")
+
+        self.select_fit_for_colonoscopy_dropdown = self.page.get_by_label(
+            "Fit for Colonoscopy (SSP)"
+        )
+
+        self.dataset_complete_radio_button_yes = self.page.get_by_role(
+            "radio", name="Yes"
+        )
+
+        self.dataset_complete_radio_button_no = self.page.get_by_role(
+            "radio", name="No"
+        )
+
+    def save_dataset(self) -> None:
+        self.click(self.save_dataset_button)
+
+    def select_asa_grade_option(self, option: str) -> None:
+        """
+        This method is designed to select a specific grade option from the colonoscopy dataset page, ASA Grade dropdown menu.
+        Args:
+        option (str): The ASA grade option to be selected. This should be a string that matches one of the available options in the dropdown menu.
+            Valid options are: "FIT", "RELEVANT_DISEASE", "UNABLE_TO_ASSESS", RESTRICTIVE_DISEASE, "LIFE_THREATENING_DISEASE", "MORIBUND", "NOT_APPLICABLE", or "NOT_KNOWN".
+        Returns:
+        None
+        """
+        self.select_asa_grade_dropdown.select_option(option)
+
+    def select_fit_for_colonoscopy_option(self, option: str) -> None:
+        """
+        This method is designed to select a specific option from the colonoscopy dataset page, Fit for Colonoscopy (SSP) dropdown menu.
+        Args:
+        option (str): The option to be selected. This should be a string that matches one of the available options in the dropdown menu.
+            Valid options are: "YES", "NO", or "UNABLE_TO_ASSESS".
+        Returns:
+        None
+        """
+        self.select_fit_for_colonoscopy_dropdown.select_option(option)
+
+    def click_dataset_complete_radio_button_yes(self) -> None:
+        self.dataset_complete_radio_button_yes.check()
+
+    def click_dataset_complete_radio_button_no(self) -> None:
+        self.dataset_complete_radio_button_no.check()
+
+
+class AsaGradeOptions(Enum):
+    FIT = "17009"
+    RELEVANT_DISEASE = "17010"
+    RESTRICTIVE_DISEASE = "17011"
+    LIFE_THREATENING_DISEASE = "17012"
+    MORIBUND = "17013"
+    NOT_APPLICABLE = "17014"
+    NOT_KNOWN = "17015"
+
+
+class FitForColonoscopySspOptions(Enum):
+    YES = "17058"
+    NO = "17059"
+    UNABLE_TO_ASSESS = "17954"

pages/datasets/subject_datasets_page.py

@@ -0,0 +1,39 @@
+from playwright.sync_api import Page
+from pages.base_page import BasePage
+
+
+class SubjectDatasetsPage(BasePage):
+    """
+    This class contains locators and methods to interact with the Subject Datasets page.
+    """
+
+    def __init__(self, page: Page):
+        super().__init__(page)
+        self.page = page
+        # Subject datasets page locators
+        self.colonoscopy_show_dataset_button = (
+            self.page.locator("div")
+            # Note: The "(1 Dataset)" part of the line below may be dynamic and may change based on the actual dataset count.
+            .filter(
+                has_text="Colonoscopy Assessment (1 Dataset) Show Dataset"
+            ).get_by_role("link")
+        )
+        self.investigation_show_dataset_button = (
+            self.page.locator("div")
+            # Note: The "(1 Dataset)" part of the line below may be dynamic and may change based on the actual dataset count.
+            .filter(has_text="Investigation (1 Dataset) Show Dataset").get_by_role(
+                "link"
+            )
+        )
+
+    def click_colonoscopy_show_datasets(self) -> None:
+        """
+        This method clicks on the 'Show Dataset' button for the Colonoscopy Assessment row on the Subject Datasets Page.
+        """
+        self.click(self.colonoscopy_show_dataset_button)
+
+    def click_investigation_show_datasets(self) -> None:
+        """
+        This method clicks on the 'Show Dataset' button for the Investigation row on the Subject Datasets Page.
+        """
+        self.click(self.investigation_show_dataset_button)

pages/screening_practitioner_appointments/subject_datasets.py

@@ -1,12 +1,15 @@
 import pytest
-from playwright.sync_api import Page, expect
+from playwright.sync_api import Page
 from pages.logout.log_out_page import Logout
 from pages.base_page import BasePage
 from pages.screening_practitioner_appointments.screening_practitioner_appointments import (
     ScreeningPractitionerAppointmentsPage,
 )
-from pages.screening_practitioner_appointments.subject_datasets import (
-    SubjectDatasets,
+from pages.datasets.subject_datasets_page import (
+    SubjectDatasetsPage,
+)
+from pages.datasets.colonoscopy_dataset_page import (
+    ColonoscopyDatasetsPage,
     FitForColonoscopySspOptions,
     AsaGradeOptions,
 )
@@ -76,11 +79,11 @@ def test_compartment_5(page: Page, smokescreen_properties: dict) -> None:
 
     AppointmentCalendar(page).click_view_appointments_on_this_day_button()
     ScreeningPractitionerDayView(page).click_calendar_button()
-    date_from_util = datetime(2025, 4, 29)
+    date_from_util = datetime(2025, 4, 30)
     CalendarPicker(page).v1_calender_picker(date_from_util)
 
     # Select subject from inital test data util
-    ScreeningPractitionerDayView(page).click_patient_link("STARLESS BLUSH")
+    ScreeningPractitionerDayView(page).click_patient_link("DIVIDEND MUZZLE")
 
     # Select Attendance radio button, tick Attended checkbox, set Attended Date to yesterday's (system) date and then press Save
     AppointmentDetail(page).check_attendance_radio()
@@ -93,7 +96,7 @@ def test_compartment_5(page: Page, smokescreen_properties: dict) -> None:
     # Repeat for x Abnormal  patients
 
     # Navigate to the 'Subject Screening Summary' screen for the 1st Abnormal patient
-    nhs_no = "9937265193"  # Test NHS NO for Scaliding Cod
+    nhs_no = "9852356488"  # Test NHS NO for DIVIDEND MUZZLE
     verify_subject_event_status_by_nhs_no(
         page, nhs_no, "J10 - Attended Colonoscopy Assessment Appointment"
     )
@@ -102,23 +105,23 @@ def test_compartment_5(page: Page, smokescreen_properties: dict) -> None:
     SubjectScreeningSummary(page).click_datasets_link()
 
     # Click on 'Show Dataset' next to the Colonoscopy Assessment
-    SubjectDatasets(page).click_show_datasets()
+    SubjectDatasetsPage(page).click_colonoscopy_show_datasets()
 
     # Populate Colonoscopy Assessment Details fields
 
     # ASA Grade  - I - Fit
-    SubjectDatasets(page).select_asa_grade_option(AsaGradeOptions.FIT.value)
+    ColonoscopyDatasetsPage(page).select_asa_grade_option(AsaGradeOptions.FIT.value)
 
     # Fit for Colonoscopy (SSP) - Yes
-    SubjectDatasets(page).select_fit_for_colonoscopy_option(
+    ColonoscopyDatasetsPage(page).select_fit_for_colonoscopy_option(
         FitForColonoscopySspOptions.YES.value
     )
 
     # Click 'Yes' for Dataset Complete?
-    SubjectDatasets(page).click_dataset_complete_radio_button_yes()
+    ColonoscopyDatasetsPage(page).click_dataset_complete_radio_button_yes()
 
     # Click Save Dataset button
-    SubjectDatasets(page).save_dataset()
+    ColonoscopyDatasetsPage(page).save_dataset()
 
     # Click Back
     BasePage(page).click_back_button()