Getting Started

Promethee-Selenium is a robust, Page Object Model (POM) based library for automated UI testing using Selenium and Pytest. It is designed to streamline your end-to-end testing workflow by providing a structured architecture, ensuring your tests are maintainable, scalable, and easy to read.

Features

• Page Object Model (POM): Enforces a clean separation between page interactions (locators, actions) and test logic (assertions, workflows).
• Interactive CLI: A user-friendly command-line interface to guide you through project initialization and documentation.
• Scaffolding: Quickly generate a production-ready project structure with promethee-selenium init.
• Built-in Utilities: A rich set of helper functions for common Selenium actions (clicking, typing, waiting).
• Environment Management: Native support for managing test environments and credentials securely.
• Bilingual Support: The CLI and documentation are available in both English and French.

Installation

Install the package easily via pip:

Quick Start

1. Launch the CLI

After installation, run the following command to access the interactive menu:

You will be prompted to select your language (English/French) and then choose an action.

2. Initialize a Project

Select the Init option from the menu or run:

This creates a standard directory layout:

• scenarios/: For your Page Object classes.
• tests/: For your Pytest test scripts.
• data/: For configuration files and test data.
• utils/: For project-specific utilities.
• conftest.py: Pytest configuration with pre-configured fixtures.

3. Run Your Tests

Execute your tests using pytest: