Metadata-Version: 1.1
Name: gocept.selenium
Version: 1.0
Summary: Test-friendly Python API for Selenium and integration with web application frameworks.
Home-page: http://pypi.python.org/pypi/gocept.selenium
Author: Zope Foundation and Contributors
Author-email: ws@gocept.com
License: ZPL 2.1
Description: ===============
        gocept.selenium
        ===============
        
        gocept.selenium provides an API for the `Selenium remote control`_ that is
        suited for writing tests and integrates this with your test suite for any WSGI,
        Plone, Zope 2, ZTK, or Grok application.
        
        While the testing API could be used independently, the integration is done
        using `test layers`_, which are a feature of `zope.testrunner`_.
        
        
        .. _`Selenium remote control`: http://seleniumhq.org/projects/remote-control/
        .. _`test layers`: http://pypi.python.org/pypi/plone.testing#layers
        .. _`zope.testrunner`: http://pypi.python.org/pypi/zope.testrunner
        
        
        Developing gocept.selenium
        ==========================
        
        :Author:
            `gocept <http://gocept.com/>`_ <mail@gocept.com>
        
        :Online documentation:
            http://packages.python.org/gocept.selenium/
        
        :PyPI page:
            http://pypi.python.org/pypi/gocept.selenium/
        
        :Issue tracker:
            https://projects.gocept.com/projects/gocept-selenium/
        
        :Source code:
            https://bitbucket.org/gocept/gocept.selenium/
        
        :Current change log:
            https://bitbucket.org/gocept/gocept.selenium/raw/tip/CHANGES.txt
        
        
        buildout configuration
        ----------------------
        
        gocept.selenium integrates with quite a lot of different testing approaches and
        needs to work across a wide spectrum of software versions, e. g. Zope2 before
        and after eggification (2.10/2.12), ZTK-KGS, Grok-KGS, Plone3, Plone4 etc.
        
        This has two consequences, one is that we use different extras_require for the
        different flavours, so clients will need to specify that, e. g.
        gocept.selenium[ztk] or gocept.selenium[grok].
        
        The second is that there is no single buildout configuration for this package,
        but rather quite a lot of them, so we are able to run our tests against all the
        different software versions we integrate with.
        
        The base package itself is tested with ``selenium.cfg``, this has no further
        dependencies except the ``selenium`` package. The various flavours have their
        own cfg file, in some cases in several versions (e.g. Plone3/Plone4, Zope2
        pre/post eggs etc.). This means that in order to set up the buildout, you'll
        need to specify the configuration you want to test, like this::
        
            $ python bootstrap.py -c ztk.cfg
            $ bin/buildout -c ztk.cfg
        
        Note that the zope210 and plone3 configurations require Python-2.4, while the
        others should work at least up to Python-2.6.
        
        
        Changelog
        =========
        
        
        1.0 (2012-11-03)
        ----------------
        
        - Marking the API as stable.
        
        
        0.17 (2012-11-01)
        -----------------
        
        - Added ``gocept.selenium.skipUnlessBrowser`` decorator to skip tests unless
          ceratins browser requirements are met.
        
        - Fix: The static test server did not shutdown in some situations.
        
        
        0.16 (2012-10-10)
        -----------------
        
        - Fixed selenese popup tests.
        
        - Open a random port for the server process by default: When the environment
          variable `GOCEPT_SELENIUM_APP_PORT` is not set, a random free port is bound.
          This allows parallel testing, for instance (#11323).
        
        0.15 (2012-09-14)
        -----------------
        
        - WSGI-Layer is comptabile with Python 2.5.
        - Encoding support in converthtmltests
          (Patch by Tom Gross <tom@toms-projekte.de>).
        - XHTML support for selenium tables
          (Patch by Tom Gross <tom@toms-projekte.de>).
        
        
        0.14 (2012-06-06)
        -----------------
        
        - API expansion: Added ``assertCssCount``. Thus requiring selenium_ >= 2.0.
        - Added Trove classifiers to package metadata.
        - Moved code to Mercurial.
        
        .. _selenium : http://pypi.python.org/pypi/selenium
        
        
        0.13.2 (2012-03-15)
        -------------------
        
        - Fixed WSGI flavor: There was a ``RuntimeError`` in tear down if the WSGI
          server was shut down correctly.
        
        
        0.13.1 (2012-03-15)
        -------------------
        
        - Updated URL of bug tracker.
        
        - `script` extra no longer requires `elementtree` on Python >= 2.5.
        
        
        0.13 (2012-01-30)
        -----------------
        
        - Added a selenese assert type 'list' and added it to the window management
          query methods.
        
        - API expansion: added ``openWindow``.
        
        - API change: filter the result of ``getAllWindowNames`` to ignore 'null'.
        
        - backwards-compatible API change: ``selectWindow`` now selects the main
          window also when passed the window id ``None`` or no argument at all.
        
        - pinned compatible ZTK version to 1.0.1, grok version to 1.2.1, generally
          pinned all software packages used to consistent versions for this package's
          own testing
        
        
        0.12 (2011-11-29)
        -----------------
        
        - API expansion: added ``getAllWindow*`` and ``selectWindow``.
        
        
        0.11 (2011-09-15)
        -----------------
        
        - Added some notes how to test a Zope 2 WSGI application.
        
        - Described how to test a Zope 2/Plone application if using `plone.testing`
          to set up test layers.
        
        
        0.10.1 (2011-02-02)
        -------------------
        
        - Improvements on the README.
        
        - Wrote a quick start section for packages using ZTK but using
          ``zope.app.wsgi.testlayer`` instead of ``zope.app.testing``.
        
        - Allowed to use `regexp` as pattern prefix for regular expressions
          additionally to `regex` to be compatible with the docstring and the
          Selenium documentation.
        
        
        0.10 (2011-01-18)
        -----------------
        
        - Script that generates python tests from Selenium HTML tables.
          Reused from KSS project, courtesy of Jeroen Vloothuis, original author.
        
        - Using a URL of `Selenium RC` in README where version 1.0.3 can be
          downloaded (instead of 1.0.1) which works fine with Firefox on Mac OS X,
          too.
        
        0.9 (2010-12-28)
        ----------------
        
        - Provide integration with the recent testlayer approach
          (zope.app.appsetup/zope.app.wsgi) used by Grok (#8260).
        - Provide integration with plone.testing
        - Make browser and RC server configurable (#6484).
        - Show current test case in command log (#7876).
        - Raise readable error when connection to RC server fails (#6489).
        - Quit browser when the testrunner terminates (#6485).
        
        
        0.8 (2010-10-22)
        ----------------
        
        - Fixed tests for the StaticFilesLayer to pass with Python 2.4 through 2.7.
        - API expansion: ``getSelectOptions``
        
        
        0.7 (2010-08-16)
        ----------------
        
        - API expansion: ``getElementHeight|Width``, ``getCookie*`` and a few others.
        - lots of action methods (``mouse*`` among others)
        
        
        0.6 (2010-08-09)
        ----------------
        
        - assertXpathCount now also takes ints (#7681).
        
        - API expansion: add ``isChecked`` to verify checkboxes, ``runScript``,
          ``clickAt``, ``getLocation``, ``getSelectedValue``, ``getSelectedIndex``.
        
        - The ``pause`` method uses float division now. Pauses where implicitly rounded
          to full seconds before when an int was passed.
        
        - The name of the factored test layer contains the module of the bases now. The
          name is used by zope.testrunner distinguish layers. Before this fix selenium
          layers factored from base layers with the same names but in different modules
          would be considered equal by zope.testrunner.
        
        - The factored ZTK layer cleanly shuts down the http server in tearDown now.
          This allows to run different selenium layers in one go.
        
        
        0.5 (2010-08-03)
        ----------------
        
        - Add a static files test layer for running selenium tests against a set
          of static (HTML) files.
        - Patterns now also work with multiline strings,
          i. e. 'foo*' will match 'foo\nbar' (#7790).
        
        
        0.4.2 (2010-05-20)
        ------------------
        
        - API expansion: ``*keyDown``, ``*keyUp``, ``keyPress``.
        
        
        0.4.1 (2010-04-01)
        ------------------
        
        - API expansion: added ``getSelectedLabel``.
        
        - Ignore the code of a server's response when calling `open`. The default
          behaviour of SeleniumRC changed between 1.0.1 and 1.0.2 but we want the old
          behaviour by default.
        
        
        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
Classifier: Development Status :: 6 - Mature
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Framework :: BFG
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 3.2
Classifier: Framework :: Plone :: 3.3
Classifier: Framework :: Plone :: 4.0
Classifier: Framework :: Plone :: 4.1
Classifier: Framework :: Plone :: 4.2
Classifier: Framework :: Plone :: 4.3
Classifier: Framework :: Pylons
Classifier: Framework :: Pyramid
Classifier: Framework :: Zope2
Classifier: Framework :: Zope3
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved
Classifier: License :: OSI Approved :: Zope Public License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.4
Classifier: Programming Language :: Python :: 2.5
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 2 :: Only
Classifier: Programming Language :: Python :: Implementation
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Zope
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Testing
