Splinter Tutorial¶
Before starting, make sure Splinter is installed
This tutorial provides a simple example, teaching step by step how to:
search for
splinter - python acceptance testing for web applications'
in google.com, andfind if splinter official website is listed among the search results
Create a Browser instance¶
First of all, import Browser
class and instantiate it.
from splinter import Browser
browser = Browser()
Note: if you don’t provide any driver argument to the Browser
function, firefox
will be used (Browser function documentation).
Visit Google website¶
Visit any website using the browser.visit
method. Let’s go to Google search page:
browser.visit('http://google.com')
Input search text¶
After a page is loaded, you can perform actions, such as clicking, filling text input, checking radio and checkbox. Let’s fill Google’s search field with splinter - python acceptance testing for web applications
:
browser.fill('q', 'splinter - python acceptance testing for web applications')
Find out that Splinter official website is in the search results¶
After pressing the button, you can check if Splinter official website is among the search responses. This can be done like this:
if browser.is_text_present('splinter.readthedocs.io'):
print("Yes, found it! :)")
else:
print("No, didn't find it :(")
In this case, we are just printing something. You might use assertions, if you’re writing tests.
Close the browser¶
When you’ve finished testing, close your browser using browser.quit
:
browser.quit()
All together¶
Finally, the source code will be:
from splinter import Browser
browser = Browser() # defaults to firefox
browser.visit('http://google.com')
browser.fill('q', 'splinter - python acceptance testing for web applications')
browser.find_by_name('btnK').click()
if browser.is_text_present('splinter.readthedocs.io'):
print("Yes, the official website was found!")
else:
print("No, it wasn't found... We need to improve our SEO techniques")
browser.quit()