Bring the best of Selenium, Cypress and Python into one package.
Automatic waiting and synchronization
Quick setup to start writing tests
Easy to use and clean syntax for amazing readability and maintainability
Automatic driver installation so you don't need to manage drivers
Leverage the awesome Python language
Let's use this simple scenario to show the difference between using
Visit the QA at the Point website: https://qap.dev
Hover the About link to reveal a menu
Click the Leadership link in that menu
Assert Carlos Kidman is on the Leadership page
Using Pyleniumdef test_carlos_is_on_leadership(py):py.visit('https://qap.dev')py.get('a[href="/about"]').hover()py.get('a[href="/leadership"][class^="Header-nav"]').click()assert py.contains('Carlos Kidman')
The same test using Selenium# define your setup and teardown email@example.com driver():driver = webdriver.Chrome()yield driverdriver.quit()def test_carlos_is_on_leadership_page_with_selenium(driver_setup):wait = WebDriverWait(driver, timeout=10)driver.get('https://qap.dev')# hover About linkabout_link = driver.find_element(By.CSS_SELECTOR, "a[href='/about']")actions = ActionChains(driver)actions.move_to_element(about_link).perform()# click Leadership link in About menuwait.until(EC.element_visible(By.CSS_SELECTOR, "a[href='/leadership'][class^='Header-nav']")).click()# check if 'Carlos Kidman' is on the pageassert wait.until(lambda _: driver.find_element(By.XPATH, "//*[contains(text(), 'Carlos Kidman')]"))
I teach courses and do trainings for both Selenium and Cypress, but Selenium, out of the box, feels clunky. When you start at a new place, you almost always need to "setup" the framework from scratch all over again. Instead of getting right to creating meaningful tests, you end up spending most of your time building a custom framework, maintaining it, and having to teach others to use it.
Also, many people blame Selenium for bad or flaky tests. This usually tells me that they have yet to experience someone that truly knows how to make Selenium amazing! This also tells me that they are not aware of the usual root causes that make Test Automation fail:
Poor programming skills, test design and practices
What if we tried to get the best from both worlds and combine it with an amazing language?
Selenium has done an amazing job of providing W3C bindings to many languages and makes scaling a breeze.
Cypress has done an amazing job of making the testing experience more enjoyable - especially for beginners.
Pylenium looks to bring more Cypress-like bindings and techniques to Selenium (like automatic waits) and still leverage Selenium's power along with the ease-of-use and power of Python.
You can also watch the Getting Started video with Pylenium's creator, Carlos Kidman!
Terminal $pip install pyleniumio---or---pipenv install pyleniumio
Terminal $pylenium init
This creates three files:
conftest.py - This has the fixtures needed for Pylenium.
pylenium.json - This is the configuration file for Pylenium.
pytest.ini - This is the configuration file for pytest and is used to connect to ReportPortal
By default, Pylenium uses Chrome browser. You have to install Chrome or update the
pylenium.json file to use the browser of your choice.
Create a directory called
tests and then a test file called
Define a new test called
Now we can use Pylenium Commands to interact with the browser.
test_google.pydef test_google_search(py):py.visit('https://google.com')py.get("[name='q']").type('puppies')py.get("[name='btnK']").submit()assert py.should().contain_title('puppies')
This will depend on your IDE, but you can always run tests from the CLI:
Terminal $ (venv)python -m pytest tests/test_google.py
You're all set! You should see the browser open and complete the commands we had in the test :)