manager.md

WebDriver management

Request a WebDriver session

This configures a default WebDriver

import inject
import paf.config
from paf.manager import WebDriverManager
from paf.request import WebDriverRequest
from selenium.webdriver import ChromeOptions
from paf.common import Size

inject.configure(paf.config.inject)

request = WebDriverRequest()
request.browser = "chrome"
request.browser_version = "90"
request.options = ChromeOptions()
request.window_size = Size(1920, 1080)

manager = inject.instance(WebDriverManager)
webdriver = manager.get_webdriver(request)

Reuse a WebDriver session

When no WebDriverRequest is passed, the default WebDriver will be returned.

webdriver = manager.get_webdriver()

Request multiple WebDriver sessions

Request a WebDriver with another request name

request = WebDriverRequest("another")
webdriver = manager.get_webdriver(request)

Connect to Selenium

request = WebDriverRequest()
request.server_url = "http://remote.server:4444"
webdriver = manager.get_webdriver(request)

Introduce a preconfigured WebDriver

If you need fine-tuned WebDrivers, you can pass them as default.

from selenium.webdriver import Chrome
from selenium.webdriver.chrome.service import Service

webdriver = Chrome(Service(executable_path="/opt/chromedriver"))
request = WebDriverRequest()
manager.introduce_webdriver(webdriver, request)

Shutdown WebDriver sessions

request = WebDriverRequest()
webdriver = manager.get_webdriver()

manager.shutdown(webdriver)
manager.shutdown_session(request.session_name)
manager.shutdown_all()

Take screenshot

try:
    path = manager.take_screenshot()
    assert path is not None
except Exception as e:
    logger.error(f"Unable to take screenshot because of: {e}")