docs: test automation

Author: devmahmud

module-8.5-test-automation-with-selenium.md

@@ -0,0 +1,102 @@
+## 8.5. Test Automation with Selenium
+
+Selenium is a powerful open-source framework for automating web browsers. It provides a way to script interactions with web browsers, making it invaluable for automating repetitive tasks, such as testing web applications or web scraping. In this section, we'll dive into the world of Selenium test automation with examples.
+
+### Why Selenium?
+
+Selenium is widely used for web test automation for the following reasons:
+
+1. **Cross-browser Testing:** Selenium supports various web browsers, including Chrome, Firefox, Safari, and Edge, allowing you to test your web applications across different browsers.
+
+2. **Cross-Platform:** Selenium is platform-independent, making it suitable for Windows, macOS, and Linux environments.
+
+3. **Programming Language Support:** Selenium supports multiple programming languages, including Java, Python, C#, and more. You can choose the language you're most comfortable with.
+
+4. **Ecosystem:** Selenium has a vast ecosystem of tools and libraries for test automation, reporting, and parallel testing.
+
+### Getting Started with Selenium
+
+Before diving into examples, you need to set up a Selenium environment. Here, we'll use the Selenium WebDriver for Python as an example.
+
+#### Step 1: Install Selenium
+You can install Selenium for Python using pip:
+
+```bash
+pip install selenium
+```
+
+#### Step 2: Download Web Drivers
+Selenium requires browser-specific drivers to control web browsers. For example, you'll need the ChromeDriver for Google Chrome or the GeckoDriver for Mozilla Firefox. Download the appropriate driver for your browser and add its location to your system's PATH.
+
+#### Step 3: Write Your First Selenium Script
+
+Let's write a simple Selenium script in Python that opens a web page and interacts with it.
+
+```python
+from selenium import webdriver
+
+# Set the path to your web driver (e.g., chromedriver.exe)
+driver = webdriver.Chrome(executable_path='path/to/chromedriver.exe')
+
+# Open a webpage
+driver.get('https://example.com')
+
+# Find an element by its CSS selector and interact with it
+element = driver.find_element_by_css_selector('input[name="q"]')
+element.send_keys('Selenium automation')
+element.submit()
+
+# Close the browser
+driver.quit()
+```
+
+In this script:
+
+- We import the `webdriver` module from Selenium.
+- We create a driver instance for the Chrome browser (you should use the appropriate driver for your browser).
+- We open a webpage, which, in this case, is 'https://example.com'.
+- We find an HTML input element using its CSS selector, send text to it, and submit a form.
+- Finally, we close the browser.
+
+### Selenium Test Automation Example
+
+Let's look at an example of a Selenium test script for a simple web application. We'll automate a login process on a demo website.
+
+```python
+from selenium import webdriver
+
+# Set the path to your web driver
+driver = webdriver.Chrome(executable_path='path/to/chromedriver.exe')
+
+# Open the login page
+driver.get('https://example.com/login')
+
+# Find username and password fields and submit button
+username = driver.find_element_by_id('username')
+password = driver.find_element_by_id('password')
+login_button = driver.find_element_by_id('login-button')
+
+# Enter credentials and submit
+username.send_keys('your_username')
+password.send_keys('your_password')
+login_button.click()
+
+# Verify the login was successful
+welcome_message = driver.find_element_by_css_selector('.welcome-message')
+assert welcome_message.text == 'Welcome, Your Name!'
+
+# Close the browser
+driver.quit()
+```
+
+In this script, we:
+
+- Open a login page.
+- Locate the username and password input fields and the login button.
+- Enter credentials.
+- Click the login button.
+- Verify that the login was successful by checking for a welcome message.
+
+This is a simple example, but Selenium can be used for complex web application testing, including form submissions, navigation, and data extraction.
+
+Selenium is a powerful tool for web automation, including testing web applications. By combining it with your preferred programming language, you can create robust, automated test suites to ensure the quality of your web applications.