Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/chatgthb/testngcurrent

Current TestNG Training
https://github.com/chatgthb/testngcurrent

java selenium-webdriver test-automation testing-tools testng ui-testing

Last synced: about 1 month ago
JSON representation

Current TestNG Training

Awesome Lists containing this project

README 

        

# TestNGCurrent



![Java](https://img.shields.io/badge/Java-ED8B00?style=for-the-badge&logo=java&logoColor=white)

![TestNG](https://img.shields.io/badge/TestNG-FF9E2C?style=for-the-badge&logo=testng&logoColor=white)

![Selenium](https://img.shields.io/badge/Selenium-43B02A?style=for-the-badge&logo=selenium&logoColor=white)

![Log4j2](https://img.shields.io/badge/Log4j2-ff1100?style=for-the-badge&logo=apache&logoColor=white)

![Maven](https://img.shields.io/badge/Maven-C71A36?style=for-the-badge&logo=apachemaven&logoColor=white)



## 📝 Introduction

Welcome to the **TestNGCurrent** repository! This project is a comprehensive training repository designed to master TestNG and Selenium WebDriver, essential tools for Java applications. This repository provides in-depth guidance on writing robust and maintainable test suites, leveraging a broad spectrum of TestNG and Selenium features. Whether you're new to testing or looking to enhance your skills, TestNGCurrent offers practical examples, detailed documentation, and a structured learning path to help you effectively automate and manage your tests.



## Table of Contents

- [💡 Introduction](#introduction)

- [📥 Installation](#installation)

- [⚙️ Usage](#usage)

- [✨ Features](#features)

- [📦 Dependencies](#dependencies)

- [🔧 Configuration](#configuration)

- [📚 Documentation](#documentation)

- [💡 Examples](#examples)

- [🛠️ Troubleshooting](#troubleshooting)

- [👥 Contributors](#contributors)

- [🤝 Contributing](#contributing)

- [📜 License](#license)



## 💻 Installation

### Cloning the Repository

To install TestNGCurrent, clone the repository to your local machine:

```bash

git clone https://github.com/ChatGTHB/TestNGCurrent.git

```



### Importing into IntelliJ IDEA from VCS

1. Open IntelliJ IDEA.

2. Go to `File` > `New` > `Project from Version Control`.

3. In the dialog, select `Git` and enter the repository URL: `https://github.com/ChatGTHB/TestNGCurrent.git`.

4. Click `Clone`.



### Adding Dependencies from Maven

1. Open IntelliJ IDEA.

2. Navigate to `File` > `Project Structure` > `Libraries`.

3. Click on the `+` icon and select `From Maven`.

4. In the dialog, search for the necessary libraries using the Maven coordinates:

    - `org.apache.logging.log4j:log4j-api:2.20.0`

    - `org.apache.logging.log4j:log4j-core:2.20.0`

    - `commons-io:commons-io:2.11.0`

    - `org.seleniumhq.selenium:selenium-java:4.25.0`

    - `org.slf4j:slf4j-nop:1.7.30`

    - `org.testng:testng:7.9.0`

5. Click `OK` to add the selected libraries.



For each library, you can also use a higher version if available.



## ⚙️ Usage

Ensure that you have the necessary dependencies installed and navigate to the `src` directory to set up and execute the test cases.



### 1. Running from XML File

Run your tests from the `testng.xml` file by following these steps:



```bash

# From IntelliJ IDEA or Eclipse

Right-click and select 'Run testng.xml'.



# To run from command line with Maven

mvn test -DsuiteXmlFile=testng.xml

```



### 2. Running Test Classes Directly

You can directly run test classes annotated with TestNG:



```bash

# Right-click on the class in IntelliJ IDEA and select 'Run ClassName'.



# To run all test classes with Maven

mvn test

```



## ✨ Features

- **Sorting**: Organize tests in a specific order.

- **Annotations**: Use TestNG's rich set of annotations to define test methods.

- **Enable/Disable**: Enable or disable tests dynamically.

- **Assertions**: Utilize TestNG assertions to validate test outcomes.

- **Dependency Management**: Manage test method dependencies.

- **Groups**: Group tests for selective execution.

- **Cross Browser Testing**: Execute tests across multiple browsers.

- **Parallel Testing**: Run tests in parallel to save time.

- **XML Configuration**: Configure test suites using `testng.xml`.

- **Data Providers**: Supply data to test methods.

- **Parameterized Tests**: Run the same test with different parameters.

- **Page Object Model (POM)**: Implement POM for cleaner code.

- **HTML Reporting**: Generate HTML reports for test results.

- **Logging**: Integrated logging using Log4j2 for tracking and debugging test execution.



## 📦 Dependencies

| Dependency          | Version | Link                                                                                                                                                                                     |

|---------------------|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|

| Java                | 11+     | [Java](https://www.oracle.com/java/technologies/javase-jdk11-downloads.html)                                                                                                             |

| TestNG              | 7.9.0   | [TestNG](https://mvnrepository.com/artifact/org.testng/testng/7.9.0)                                                                                                                     |

| Selenium WebDriver  | 4.25.0  | [Selenium](https://mvnrepository.com/artifact/org.seleniumhq.selenium/selenium-java/4.25.0)                                                                                              |

| Log4j2              | 2.20.0  | [Log4j2 API](https://mvnrepository.com/artifact/org.apache.logging.log4j/log4j-api/2.20.0), [Log4j2 Core](https://mvnrepository.com/artifact/org.apache.logging.log4j/log4j-core/2.20.0) |

| Commons IO          | 2.11.0  | [Commons IO](https://mvnrepository.com/artifact/commons-io/commons-io/2.11.0)                                                                                                            |



## 🔧 Configuration

Configuration details can be found in the `testng.xml` file and other relevant configuration files within the project. Log4j2 configuration is set up in the `log4j2.xml` file to provide detailed logging.



### Log4j2 Integration

The project uses Log4j2 for logging purposes. Ensure the necessary dependencies are included in your project and the `log4j2.xml` file is correctly configured for detailed logging. Logging is crucial for tracking and debugging test execution; `BaseDriver` utilizes Log4j2 to log test methods' start, end, and results.



## 📚 Documentation

Detailed documentation is available in the repository's `README.md` file and inline comments within the codebase. Here are some tools and programs used:

- [Java](https://www.oracle.com/java/technologies/javase-jdk11-downloads.html)

- [Selenium WebDriver](https://www.selenium.dev/downloads/)

- [TestNG](https://testng.org/doc/download.html)

- [IntelliJ IDEA](https://www.jetbrains.com/idea/)

- [Maven](https://maven.apache.org/)

- [Git](https://git-scm.com/)



## 💡 Examples

The `src` directory contains various examples demonstrating different TestNG features, including cross-browser tests, parallel execution, and data-driven tests. The project is structured into different days, with each day focusing on specific features and test scenarios:



- **Day 01**: Introduction, Sorting, Annotations, Enable, Assertions, etc.

- **Day 02**: Dependency, EditAccount, Introduction to more advanced features.

- **Day 03**: Groups, ContactUs, Search functionality, Cross browser testing.

- **Day 04**: Data Providers, Parameterized tests, General questions.

- **Day 05**: SoftAssert vs HardAssert, PlaceOrder tests.

- **Day 06**: Page Object Model (POM), Wishlist tests.

- **Day 07**: HTML Reporting, Logging.



### Utility Classes

- **BaseDriverParameter**: Manages WebDriver setup and teardown, handles browser initialization based on parameters, and includes a login test method.

- **Tools**: Provides utility methods such as wait, success message validation, JavaScript click, random number generation, and list search.

- **BaseDriver**: Includes methods for setting up WebDriver, performing login tests, and logging test methods' start and end.



### Reports

The `test-output` directory contains the results of the test executions:

- **Default Suite**: Includes `testng-results.xml` for standard TestNG results.

- **JUnit Reports**: Contains detailed test reports, including `emailable-report.html` for an easy-to-read summary of test results.



## 🛠️ Troubleshooting

If you encounter any issues, please refer to the following common troubleshooting steps:



1. **Verify Dependencies**: Ensure all necessary Maven dependencies are correctly added to your project.

2. **Check Configuration Files**: Make sure `testng.xml` and `log4j2.xml` are properly configured.

3. **Review Logs**: Use the Log4j2 logs to identify and troubleshoot errors.



If problems persist, you may seek help from the community or consult the official documentation for TestNG, Selenium, and Log4j2.



## 👥 Contributors

- **ChatGTHB**: [GitHub Profile](https://github.com/ChatGTHB)



## 🤝 Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository.

2. Create a new branch (`git checkout -b feature-branch`).

3. Commit your changes (`git commit -m 'Add new feature'`).

4. Push to the branch (`git push origin feature-branch`).

5. Create a Pull Request.



## 📜 License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.



For more information, visit the [TestNGCurrent repository](https://github.com/ChatGTHB/TestNGCurrent) on GitHub.