Nerodia¶
Nerodia is a Python port of the Watir ruby gem. https://github.com/watir/watir
Examples¶
Perform a Google Search¶
from nerodia.browser import Browser
browser = Browser(browser='firefox')
browser.goto('google.com')
search_input = browser.text_field(title='Search')
search_input.value = 'nerodia'
browser.button(value='Google Search').click()
browser.close()
Select a Checkbox¶
from nerodia.browser import Browser
browser = Browser(browser='firefox')
browser.goto('the-internet.herokuapp.com/checkboxes')
checkbox1 = browser.checkbox()
checkbox1.set()
browser.close()
Elements in Frames¶
from nerodia.browser import Browser
browser = Browser(browser='firefox')
browser.goto('the-internet.herokuapp.com/iframe')
print(browser.iframe().p().text)
print(browser.link(css='#page-footer a').text)
browser.close()
Result:
> Your content goes here.
> Elemental Selenium
Differences from Watir¶
The goal of this project is to be as close to Watir as possible. In terms of functionality, it is equivalent; however, there are some syntax differences due to the nature of Python.
Containers¶
The following containers cannot be used because either the singular or plural version is reserved by Python.
Watir Nerodia a link as links del delete dels deletes i ital is itals
Locators¶
The following locators cannot be used because they are reserved by Python.
Watir Nerodia class class_name for N/A* *This locator is only possible via the below options.
Alternatively, if you are only using one locator you can pass them as individual arguments:
browser.div('class', 'spam')
A third option is to use a dictionary and unpack into the container:
locator = {'class': 'spam', 'index': 1}
browser.div(**locator)
Blocks¶
Since Python does not have blocks, alternate methods are required.
Context¶
For cases where we want to perform some actions inside of a different browser context without completely switching to that context, we use the context manager.
Consider the following Window switching Watir code:
browser.window(title: 'Spam and Ham!').use do
browser.button(id: 'close').click
end
In Nerodia, the equivalent would be:
with browser.window(title='Spam and Ham!'):
browser.button(id='close').click()
The same would go for frames.
Waits¶
For waits, we need to use lambdas or closures.
Consider the following wait Watir code:
btn = browser.button(id: 'btn')
btn.wait_until(timeout: 2, interval: 0.5) { btn.enabled }
btn.click
In Nerodia, the equivalent would be:
btn = browser.button(id='btn')
btn.wait_until(timeout=2, interval=0.5 method=lambda e: e.enabled)
btn.click()
Also, while is reserved in Python. Therefore, the Nerodia equivalent of Watir’s Wait.while is Wait.until_not