Selenium Automation Suite 🌐

---

📖 About

Five browser-automation scenarios targeting Northeastern University web portals — transcript downloads, Canvas to-do creation, classroom-guide retrieval, dataset downloads, and academic-calendar updates. Built with Selenium 4 + TestNG using a data-driven approach with CSV inputs, screenshot capture, and Allure reporting.

Course: INFO 6255 · Northeastern University

---

🧰 Tech Stack

Layer	Tool
Language	Java
Browser Automation	Selenium WebDriver 4.6.0
Test Framework	TestNG 7.5.1
Build	Maven
Reporting	Allure 2.17.0
Data Input	OpenCSV 4.1
Browser	Firefox (GeckoDriver)

---

📂 Repository Structure

SeleniumAssignment/
├── pom.xml                        # Maven config & dependencies
├── testng.xml                     # Suite definition (5 tests, Allure listener)
├── allure-results/                # Raw Allure JSON results
└── src/test/java/testPackage/
    ├── Test01.java                # Download latest transcript
    ├── Test02.java                # Add two Canvas to-do tasks
    ├── Test03.java                # Download classroom guide PDF
    ├── Test04.java                # Download library dataset
    ├── Test05.java                # Update academic calendar
    ├── ReadCSVHelper.java         # CSV data-provider utility
    ├── ScreenshotHelper.java      # Screenshot capture utility
    └── Experiment.java            # Scratch / exploratory tests

---

✅ Test Scenarios

#	Class	Scenario	Data Source
1	Test01	Log in to NEU portal → navigate to My Transcript → download PDF	login_credentials.csv
2	Test02	Open Canvas Calendar → create two To-Do tasks with details	to-do.csv
3	Test03	Navigate to NEU service portal → select classroom → download Quick Guide PDF	—
4	Test04	Navigate to NEU Library → Digital Repository → download dataset	—
5	Test05	Open Student Hub → Academic Calendar → uncheck graduate cal → verify "Add to Calendar"	—

---

🔑 Key Techniques

• Data-Driven Testing — Login credentials and to-do data loaded from CSV via ReadCSVHelper
• Screenshot Capture — ScreenshotHelper saves visual evidence at key steps
• Allure Integration — TestNG listener (AllureTestNg) generates rich HTML reports from allure-results/
• Multi-Tab Navigation — Tests open new browser tabs and switch between them
• iframe Handling — Test05 switches into calendar iframe for element verification

---

🚀 Getting Started

Prerequisites

• Java JDK 11+
• Maven
• Firefox + GeckoDriver
• Allure CLI (for reports)

Run

# Clone
git clone https://github.com/SahilGothoskar/SeleniumAssignment.git
cd SeleniumAssignment

# Install dependencies
mvn clean install -DskipTests

# Execute suite
mvn test -DsuiteXmlFile=testng.xml

# View Allure report
allure serve allure-results

---

📊 TestNG Suite Config

<suite name="Suite">
  <listeners>
    <listener class-name="io.qameta.allure.testng.AllureTestNg"/>
  </listeners>
  <test thread-count="5" name="Test">
    <classes>
      <class name="testPackage.Test01"/>
      <class name="testPackage.Test02"/>
      <class name="testPackage.Test03"/>
      <class name="testPackage.Test04"/>
      <class name="testPackage.Test05"/>
    </classes>
  </test>
</suite>

---

👥 Team

Name	GitHub
Sahil Gothoskar	@SahilGothoskar
Xinyi Hu	@ElemiaHu
Sonal Gurav	@12sonal