Upload initial project files for Selenium-Python-E2E-Testing-Suite

Author: AminaSaoudi

.dockerignore

@@ -0,0 +1,18 @@
+# Python
+__pycache__/
+*.pyc
+
+# Environment
+venv/
+.venv/
+
+# Test Results
+allure-results/
+test_report.html
+
+# Caches
+.pytest_cache/
+
+# IDE
+.idea/
+.vscode/

.gitignore

@@ -0,0 +1,18 @@
+# Python
+__pycache__/
+*.pyc
+
+# Environment
+venv/
+.venv/
+
+# Test Results
+allure-results/
+test_report.html
+
+# Caches
+.pytest_cache/
+
+# IDE
+.idea/
+.vscode/

Dockerfile

@@ -0,0 +1,12 @@
+# Use a slim Python 3.10 image as our base
+FROM python:3.10-slim
+
+# Set the working directory inside the container
+WORKDIR /app
+
+# Copy the requirements file and install dependencies
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy the rest of our project code into the container
+COPY . .

conftest.py

@@ -0,0 +1,68 @@
+import pytest
+import json
+from selenium import webdriver
+from selenium.webdriver.chrome.service import Service
+from webdriver_manager.chrome import ChromeDriverManager
+
+
+def pytest_addoption(parser):
+    """
+    This is the correct hook to add custom INI options.
+    """
+    parser.addini("base_url", help="The base URL for the application under test", default=None)
+
+
+@pytest.fixture(scope="session")
+def base_url(request):
+    """
+    Fixture to get the base_url from the pytest.ini config file.
+    """
+    return request.config.getini("base_url")
+
+@pytest.fixture(scope="session")
+def test_data():
+    """
+    Fixture to load test data from the JSON file.
+    """
+    with open("data/test_data.json") as f:
+        data = json.load(f)
+    return data
+
+
+@pytest.fixture(scope="function")
+def driver():
+    """
+    This fixture creates a new REMOTE Chrome WebDriver instance.
+    It connects to the 'selenium' service defined in docker-compose.yml.
+    """
+
+    # --- Setup Chrome Options ---
+    chrome_options = webdriver.ChromeOptions()
+    chrome_options.add_argument("--incognito")
+    chrome_options.add_argument("--start-maximized")
+    chrome_options.add_argument("--disable-extensions")
+    chrome_options.add_argument("--disable-features=PasswordLeakDetection")
+
+    prefs = {
+        "credentials_enable_service": False,
+        "profile.password_manager_enabled": False,
+        "profile.password_manager_leak_detection_enabled": False
+    }
+    chrome_options.add_experimental_option("prefs", prefs)
+    chrome_options.add_experimental_option("excludeSwitches", ["enable-automation"])
+
+    # --- Driver Initialization ---
+    # The URL now points to our new service name: 'selenium'
+    REMOTE_HUB_URL = "http://selenium:4444/wd/hub"
+
+    # No more try/except. When running in Docker, it MUST
+    # connect to this URL, or we want it to fail.
+    driver_instance = webdriver.Remote(
+        command_executor=REMOTE_HUB_URL,
+        options=chrome_options
+    )
+
+    yield driver_instance
+
+    # --- Teardown ---
+    driver_instance.quit()

data/test_data.json

@@ -0,0 +1,20 @@
+{
+  "users": {
+    "standard": {
+      "username": "standard_user",
+      "password": "secret_sauce"
+    },
+    "locked_out": {
+      "username": "locked_out_user",
+      "password": "secret_sauce"
+    },
+    "invalid": {
+      "username": "invalid_user",
+      "password": "invalid_password"
+    }
+  },
+  "error_messages": {
+    "locked_out": "Epic sadface: Sorry, this user has been locked out.",
+    "invalid": "Epic sadface: Username and password do not match any user in this service"
+  }
+}

docker-compose.yml

@@ -0,0 +1,36 @@
+services:
+  # This is the standalone Selenium container (Hub + Chrome in one)
+  selenium:
+    image: selenium/standalone-chrome:4.20.0
+    container_name: selenium
+    ports:
+      - "4444:4444" # Expose the hub port to our host machine
+    shm_size: '2g'  # Add shared memory to prevent Chrome crashes
+
+    # --- THIS IS THE MAGIC ---
+    # Docker will run this command inside the 'selenium' container
+    # until it returns success (exit code 0).
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:4444/wd/hub/status"]
+      interval: 5s    # Check every 5 seconds
+      timeout: 10s    # Wait 10s for the check to complete
+      retries: 10     # Try 10 times before failing
+      start_period: 5s # Give it 5s to boot before first check
+
+  # This is our Python test container
+  tests:
+    container_name: python-tests
+    build: .  # Build the image from the Dockerfile in this directory
+    volumes:
+      - ./allure-results:/app/allure-results # Map results folder
+
+    # --- THIS IS THE OTHER HALF OF THE MAGIC ---
+    # This tells 'tests' to NOT start until the 'selenium'
+    # service's 'healthcheck' has passed. No more race conditions!
+    depends_on:
+      selenium:
+        condition: service_healthy
+
+    # Now, our command is simple. It just runs pytest.
+    # It will only run AFTER the healthcheck is green.
+    command: pytest

pages/__init__.py

@@ -0,0 +1,50 @@
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+
+class BasePage:
+    """
+    The Base Page class, which all other Page Objects will inherit from.
+    """
+    def __init__(self, driver, base_url):
+        """
+        Initialize the Base Page with the WebDriver instance.
+        """
+        self.driver = driver
+        self.base_url = base_url
+        self.wait = WebDriverWait(driver, 10)  # 10-second explicit wait
+
+    def find(self, locator):
+        """
+        Finds a single element using the specified locator.
+        Waits until the element is present.
+        """
+        return self.wait.until(EC.presence_of_element_located(locator))
+
+    def find_all(self, locator):
+        """
+        Finds all elements using the specified locator.
+        Waits until at least one element is present.
+        """
+        return self.wait.until(EC.presence_of_all_elements_located(locator))
+
+    def click(self, locator):
+        """
+        Waits for an element to be clickable, then clicks it.
+        """
+        element = self.wait.until(EC.element_to_be_clickable(locator))
+        element.click()
+
+    def type_text(self, locator, text):
+        """
+        Finds an element, clears it, and types the given text.
+        """
+        element = self.find(locator)
+        element.clear()
+        element.send_keys(text)
+
+    def get_text(self, locator):
+        """
+        Finds an element and returns its text content.
+        """
+        element = self.find(locator)
+        return element.text

pages/base_page.py

@@ -0,0 +1,27 @@
+from selenium.webdriver.common.by import By
+from .base_page import BasePage
+
+class CartPage(BasePage):
+    """
+    Page Object for the Shopping Cart page.
+    """
+    PATH = "/cart.html"
+
+    # Locators
+    PAGE_TITLE = (By.CLASS_NAME, "title")
+    ITEM_NAME = (By.CLASS_NAME, "inventory_item_name")
+    CHECKOUT_BUTTON = (By.ID, "checkout")
+
+    def get_page_title(self):
+        """Returns the text of the page title."""
+        return self.get_text(self.PAGE_TITLE)
+
+    def get_item_name(self):
+        """Returns the text of the first item in the cart."""
+        # Note: This is a simple implementation that gets the first item.
+        # For a real framework, you'd want to get all items.
+        return self.get_text(self.ITEM_NAME)
+    
+    def go_to_checkout(self):
+        """Clicks the 'Checkout' button."""
+        self.click(self.CHECKOUT_BUTTON)

pages/cart_page.py

@@ -0,0 +1,20 @@
+from selenium.webdriver.common.by import By
+from .base_page import BasePage
+
+class CheckoutCompletePage(BasePage):
+    """
+    Page Object for the final 'Thank You' page.
+    """
+    PATH = "/checkout-complete.html"
+
+    # Locators
+    PAGE_TITLE = (By.CLASS_NAME, "title")
+    COMPLETE_HEADER = (By.CLASS_NAME, "complete-header")
+
+    def get_page_title(self):
+        """Returns the text of the page title."""
+        return self.get_text(self.PAGE_TITLE)
+
+    def get_complete_header_text(self):
+        """Returns the 'Thank You' message text."""
+        return self.get_text(self.COMPLETE_HEADER)