Metadata-Version: 1.0
Name: gocept.selenium
Version: 0.4
Summary: zope.testing layer that integrates Selenium-RC
Home-page: UNKNOWN
Author: Zope Foundation and Contributors
Author-email: ws@gocept.com
License: ZPL 2.1
Description: Selenium RC integration with zope.testing
        =========================================
        
        gocept.selenium integrates Selenium RC with your Plone/Zope 2/ZTK test suite.
        
        
        Quick start with ZTK
        --------------------
        
        Assuming that you already have a package that uses zc.buildout and
        zope.testing, you need to do this to enable Selenium tests:
        
        1. Add gocept.selenium to the list of eggs either in your setup.py, or in
        buildout.cfg
        
        2. Install Selenium RC by some means, e.g. by using
        collective.recipe.seleniumrc::
        
        [seleniumrc]
        recipe = collective.recipe.seleniumrc
        url = http://release.seleniumhq.org/selenium-remote-control/1.0.1/selenium-remote-control-1.0.1-dist.zip
        md5sum = 068b1adb26a7450717e6d6d67e261b58
        
        3. Run buildout to install gocept.selenium and selenium (the Python bindings
        for Selenium RC).
        
        4. Create a layer for your tests, like this::
        
        import gocept.selenium.ztk
        import zope.app.testing.functional
        zcml_layer = zope.app.testing.functional.ZCMLLayer(
        'ftesting.zcml',
        __name__, __name__, allow_teardown=True)
        selenium_layer = gocept.selenium.ztk.Layer(zcml_layer)
        
        Essentially, the ``zcml_layer`` is what you would use for typical ZTK
        functional tests, and then you wrap it to create ``selenium_layer``.
        
        5. Start writing tests that inherit ``gocept.selenium.ztk.TestCase``; make
        sure you set the ``layer`` attribute to ``selenium_layer`` on each test
        class.
        
        6. In your tests, use ``self.selenium`` to control Selenium RC, e.g. ::
        
        class MyTest(gocept.selenium.ztk.TestCase):
        
        layer = selenium_layer
        
        def test(self):
        self.selenium.open('http://%s/foo.html' % self.selenium.server)
        self.selenium.assertBodyText('foo')
        
        7. Run seleniumrc.
        
        8. Run bin/test and see it work!
        
        
        Quick start with Zope 2/Plone
        -----------------------------
        
        Essentially the same, only use gocept.selenium.zope2 or gocept.selenium.plone
        instead of gocept.selenium.ztk.
        
        
        Similar packages
        ----------------
        
        zc.selenium -- integrates Selenium Core with zope.testing.
        
        
        Development
        -----------
        
        Report bugs at <https://intra.gocept.com/projects/projects/gocept-selenium/issues>.
        
        Get the latest source with ::
        
        svn co http://svn.gocept.com/repos/gocept/gocept.selenium/trunk gocept.selenium
        
        
        
        Changes
        =======
        
        0.4 (2010-03-30)
        ----------------
        
        - API expansion: add ``getLocation`` to retrieve currently loaded URL in
        browser.
        
        - API expansion: added ``waitForPopUp``, ``selectPopUp``, ``deselectPopUp``
        and ``close``.
        
        - API expansion: added ``verifyAlertPresent``, ``verifyAlertNotPresent`` and
        ``waitForAlertPresent``.
        
        - Usability: raise a better readable exception when an unimplemented selenese
        method is called.
        
        - Usability: raise failure exceptions that convey the name of the failed
        assertion in spite of some lambdas wrapped around it.
        
        
        0.3 (2010-01-12)
        ----------------
        
        - Extracted 'host' and 'port' as class attributes of gocept.selenium.ztk.Layer
        so subclasses can override them; stopped hardcoding 8087 as the server port.
        
        
        0.2.1 (2009-12-18)
        ------------------
        
        - Fix incomplete sdist release on PyPI.
        
        
        0.2 (2009-12-18)
        ----------------
        
        - Make Zope 2 test server reachable from the outside.
        - Implemented getTitle/assertTitle/waitForTitle/etc.
        
        
        0.1 (2009-11-08)
        ----------------
        
        - first release
        
Platform: UNKNOWN
