Add selenium-webdriver-python project

Author: TechWithAlexDuta

.vscode/settings.json

@@ -0,0 +1,7 @@
+{
+    "python.testing.pytestArgs": [
+        "tests"
+    ],
+    "python.testing.unittestEnabled": false,
+    "python.testing.pytestEnabled": true
+}

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Tech With Alex
+Copyright (c) 2023-2024 Tech With Alex / TechWithAlexDuta / Alexandru Duta
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,2 +1,34 @@
-# selenium-webdriver-python
-Selenium WebDriver tutorials with python and pytest
+# python
+Tutorials and sample web automation tests project using Selenium and Python
+
+## Installation
+1. Make sure you have [.Python 3](https://www.python.org/downloads/) or newer installed on your machine (project was developed using python 3.12). Check installation
+    ```PS
+    python -V
+    ```
+2. Clone this repository to your local machine.
+3. Open folder (`python`) in VS Code. 
+4. Using terminal navigate to a project and run `pip install`
+    ```PS
+    pip install -r requirements.txt
+    ```
+
+## Usage
+1. Make sure you have the appropriate browser installed (`https://www.selenium.dev/documentation/webdriver/browsers/`)
+2. Open the project directory in VS Code or your preferred IDE. 
+4. Run the tests using your preferred test runner or IDE or from terminal, e.g. use any of the below:
+    ```PS
+    pytest .\tests\test_selenium_web_form.py
+    pytest -m selenium
+    ```
+
+## Tech
+- python 3.12
+- selenium 4
+- pytest 8
+
+## YT channel
+Please check my YouTube channel for step by step implementation or detailed tutorials on automation and more: https://www.youtube.com/@TechWithAlexDuta
+
+## License
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

pom/__init__.py

@@ -0,0 +1,23 @@
+"""Web form page"""
+
+from selenium import webdriver
+from selenium.webdriver.common.by import By
+
+from pom.web_form_page_target import WebFormTargetPage
+
+
+class WebFormPage:
+    def __init__(self, driver: webdriver) -> None:
+        self.driver = driver
+        self.title = "Web form"
+
+    _my_textarea = By.NAME, "my-textarea"
+    _submit_form = By.CSS_SELECTOR, ".btn"
+
+    def set_textarea(self, text: str):
+        self.driver.find_element(*self._my_textarea).send_keys(text)
+        return self
+
+    def submit_form(self):
+        self.driver.find_element(*self._submit_form).click()
+        return WebFormTargetPage(self.driver)

pom/web_form_page.py

@@ -0,0 +1,15 @@
+"""Web form - parget page"""
+
+from selenium import webdriver
+from selenium.webdriver.common.by import By
+
+
+class WebFormTargetPage:
+    def __init__(self, driver: webdriver):
+        self.driver = driver
+        self.title = "Web form - target page"
+
+    _message = By.ID, "message"
+
+    def get_message(self):
+        return self.driver.find_element(*self._message).text

pom/web_form_page_target.py

@@ -0,0 +1,25 @@
+[project]
+name = "python"
+version = "1.0.0"
+dependencies = [
+  "selenium",
+  "pytest"
+]
+requires-python = ">=3.12"
+authors = [
+  {name = "Alex"}
+]
+maintainers = [
+  {name = "Alex"}
+]
+description = "Learn Selenium with Python"
+readme = "README.md"
+
+[project.urls]
+Repository = "https://github.com/TechWithAlexDuta/vs_code_selenium.git"
+
+[tool.pytest.ini_options]
+markers = [
+    "selenium",
+    "selenium_pom"
+]

pyproject.toml

@@ -0,0 +1,18 @@
+"""Test fixture"""
+
+import pytest
+from selenium import webdriver
+
+
+@pytest.fixture
+def browser():
+    # Setup: Create a browser instance
+    driver = webdriver.Chrome()
+    driver.get("https://www.selenium.dev/selenium/web/web-form.html")
+    driver.maximize_window()
+
+    # Provide the fixture value
+    yield driver
+
+    # Teardown: Quit the browser instance
+    driver.quit()

requirements.txt

@@ -0,0 +1,24 @@
+"""Basic sample test """
+
+import uuid
+import pytest
+from selenium import webdriver
+from selenium.webdriver.common.by import By
+
+
+@pytest.mark.selenium
+def test_write_to_text_area_and_submit():
+    expected_message = "Received!"
+    text = str(uuid.uuid4())
+
+    driver = webdriver.Chrome()
+    driver.get("https://www.selenium.dev/selenium/web/web-form.html")
+    driver.maximize_window()
+
+    driver.find_element(By.NAME, "my-textarea").send_keys(text)
+    driver.find_element(By.CSS_SELECTOR, ".btn").click()
+    message = driver.find_element(By.ID, "message").text
+
+    assert message == expected_message
+
+    driver.quit()

tests/__init__.py

@@ -0,0 +1,17 @@
+"""Sample test with conftest and pytest fixture"""
+
+import uuid
+import pytest
+from selenium.webdriver.common.by import By
+
+
+@pytest.mark.selenium
+def test_write_to_text_area_and_submit_fixture(browser):
+    expected_message = "Received!"
+    text = str(uuid.uuid4())
+
+    browser.find_element(By.NAME, "my-textarea").send_keys(text)
+    browser.find_element(By.CSS_SELECTOR, ".btn").click()
+    message = browser.find_element(By.ID, "message").text
+
+    assert message == expected_message

tests/conftest.py

@@ -0,0 +1,19 @@
+"""Sample test with Page Object Model pattern"""
+
+import uuid
+import pytest
+
+from pom.web_form_page import WebFormPage
+
+@pytest.mark.selenium_pom
+def test_write_to_text_area_and_submit_fixture(browser):
+    expected_message = "Received!"
+    text = str(uuid.uuid4())
+
+    web_form = WebFormPage(browser)
+    message = web_form\
+        .set_textarea(text)\
+        .submit_form()\
+        .get_message()
+
+    assert message == expected_message