FuncBrows 0.17

FuncBrows is a relatively lightweight abstraction wrapper around various functional web testing utilities. It is intended to allow the creation of single unit tests that will run on multiple testing tools with a minimum of configuration. This will allow functional and system tests to be created in a single api.<br /><br />By necessity, the api will be fairly simple, and will not support the advanced features of certain tools. This is aimed to be a lowest common demoninator, although the selected tool is available, should more complex tests be required (at the cost of tool portability).<br /><br />Currently Supported<br /><br />There are two fully supported testing tools:<br /><br /> * Selenium RC (1.*)<br /> * zc.testbrowser<br /><br />It is intended that more will be added over time, but these are what were required to scratch my own itch.<br /><br />Running the Tests<br /><br />FuncBrows comes with a full test suite to exercise all the available methods. It uses twisted to create a local, known webserver which can be used to output the expected results. To run it, you will need: * twisted * twisted web * trial (twisted testing tool, usually included with a twisted distribution) To run the tests, execute:<br /><br />trial test_funcbrows<br /><br />API<br /><br />One of the main aims of FuncBrows is to have a simple and clean API. There are however one or two warts that cannot easily be worked around in the underlying tools. I will attempt to provide some examples of the API, and then explain any workarounds that have been implemented. For more complete examples of every method of the API, see test_funcbrows.py.<br /><br />Instantiation<br /><br />Instantiating FuncBrows is the main place where the underlying tools show through, as you have to make a selection as to which tool you would like to use.<br /><br />The basic method takes a browser type, and a URL to test:<br /><br />f = FuncBrows('testbrowser', 'http://localhost:80')<br /><br />This will instantiate a zc.testbrowser instance, with the pointing at localhost, on port 80<br /><br />A selenium instance requires extra parameters (the address and port for the selenium server):<br /><br />f = FuncBrows('\*firefox3', 'http://localhost', host = '127.0.0.1', port = 4444)<br /><br />Form Usage<br /><br />FuncBrows requires the name of the form to work on, before anything can be modified in a particular form. Failure to set this will result in a ValueError. This prevents ambiguous form controls. There is however a wart where zc.testbrowser is concerned, and forms without an id on the page. See the note below for how to workaround this.<br /><br />Set the value of a text box on a form:<br /><br />f = FuncBrows('testbrowser', 'http://localhost:80')<br />f.open('/')<br />f.form_name = 'test-form'<br />f.set_form_text_field('q', 'test')<br />f.submit_form()<br /><br />Page Content<br /><br />Currently there are only three available methods for getting meta-data and data from the page that is currently loaded:<br /><br />location<br /> Property for the current location of the page (the URL)<br />page_title<br /> Property for the title of the current page<br />page_content<br /> The HTML content of the page<br /><br />Warts<br /><br />Unfortunately, a completely clean abstraction isn't quite possible, so there are a few places where special care is needed.<br /><br /> 1. Selenium currently struggles with AJAX loaded pages as they don't fire a page load event. An attempt has been made to get round this, you can pass 'internal=True' into the click() method. This will set Selenium to not expect a page load, and to carry straight on.<br /> 2. Forms without an id or name can trip up zc.testbrowser. A workaround for this has been implemented, but is not entirely satisfactory. If you set the form_name = '*', it will use the first form on the page.<br /><br />#md5=780ee9df2c8759b140dedc988c7c6391

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Attempt,  Current,  Examples,  Funcbrows,  Method,  Methods,  Required,  Selenium,  Testing,  Tests,  Tools,  Twisted,  Underlying,  Workaround,  Zctestbrowser
Users rating:	0/10