Skip to content

Latest commit

 

History

History
143 lines (103 loc) · 5.11 KB

README.md

File metadata and controls

143 lines (103 loc) · 5.11 KB

Selenium Cucumber Framework

This repository provides a hybrid framework designed for both API testing (using Rest Assured) and UI testing (using Selenium). It leverages Cucumber for BDD, TestNG for test management, and integrates seamlessly with CI/CD pipelines for scalable, maintainable, and robust test automation.

Features

1. Testing Support

  • API Testing: With services and request/response models.
  • UI Testing: Driven by Selenium with Page Object Model (POM).
  • BDD Support: Cucumber for behavior-driven testing.
  • Test Management: TestNG ensures structured and organized execution.

2. Reporting

  • Extent Reports and Cucumber Reports for detailed test insights.
  • Logs available in logs/automation.log for debugging.

3. Data Handling

  • Supports Data-Driven Testing using:
    • JSON files (testData/logindata.json).
    • Excel files (testData/LoginData.xlsx).

4. Configurations

  • Environment-specific properties files (config/DEV.properties, QA.properties, UAT.properties).
  • Dynamic test configurations through config/config.json.

5. CI/CD Ready

  • Integrated with GitHub Actions for continuous testing (.github/workflows/maven.yml).

6. Utilities

  • LoggingFilter: Captures API request and response logs.
  • FakeAddressUtility: Generates dynamic test data.
  • ExtentReportUtility: Generates rich HTML test reports.

Framework Structure

1. API Testing

  • Base: Common functionality for API services (api/base).
  • Services: Specific API logic, e.g., AuthService, UserProfileManagementService.
  • Models: Request and response models for structured payloads (models/requests, models/response).

2. UI Testing

  • Pages: Implements POM design (ui/pages).
    • Pages include LoginPage, MyAccountPage, etc.
  • Step Definitions: Cucumber step implementations (ui/stepDefinitions).
  • Runners: Test execution using TestNG (ui/runner).

3. Utilities

  • BrowserUtility: Handles browser interactions.
  • ExcelReaderUtility: Reads data from Excel files.
  • LoggerUtility: Configures and manages logging.

File and Folder Details

Folder/File Description
.github/workflows CI/CD workflows for GitHub Actions.
config Configuration files for environments (DEV, QA, UAT).
logs Logs generated during test execution.
Reports Extent Reports and Cucumber HTML reports.
resources/features Gherkin feature files for BDD tests.
src/main/test/java Source code for API and UI automation.
testData Test data files in JSON and Excel formats.
pom.xml Maven configuration file for dependencies and project setup.
testng.xml TestNG configuration file for parallel execution and suites.

Execution

1. Prerequisites

  • Java (version 8 or above).
  • Maven (for dependency management).

2. Setup

  1. Clone the repository: 
    git clone https://github.com/your-repo/SeleniumCucumberFramework.git
cd SeleniumCucumberFramework

Setup

  1. Configure

    • Update the config.json file and environment property files (DEV.properties, QA.properties, UAT.properties) as per your test requirements.
    • Add your test data files in the testData folder (e.g., logindata.json, LoginData.xlsx).

  2. Run Tests

    • UI Tests:

      mvn test -Dtest=RunCucumberTest
mvn test -DBrowser=chrome -DisLambdaTest=true -DisHeadless=true

    • API Tests:

      mvn test -Dtest=RunCucumberTestApi
mvn test -DSuite=testng

Dependencies

The project relies on the following major dependencies:

  • Selenium: For browser automation.
  • Cucumber: For behavior-driven testing.
  • TestNG: For test management and parallel execution.
  • Rest Assured: For API testing.
  • ExtentReports: For generating HTML test reports.
  • Faker: For generating random test data.
  • Log4j: For logging framework and debugging.

Contributing

Contributions are welcome! Here's how you can contribute:

  1. Fork the repository.
  2. Create a feature branch for your changes.
  3. Submit a pull request with detailed comments explaining your updates.

License

This project is licensed under the MIT License.

Contact

For any questions or issues, feel free to reach out:
📧 [email protected]

Happy Testing! 🎉