ftw.testbrowser 2.1.2

A test browser for Zope and Plone.

ftw.testbrowser

Package documentation

ftw.testbrowser is a browser library for testing Plone web sites and applications. It integrations directly into Plone / Zope and uses lxml for parsing and querying pages. It supports all the basic features such as filling forms.

Links

• Documentation: http://ftwtestbrowser.readthedocs.io/

• Github: https://github.com/4teamwork/ftw.testbrowser

• Issues: https://github.com/4teamwork/ftw.testbrowser/issues

• Pypi: http://pypi.python.org/pypi/ftw.testbrowser

• Continuous integration: https://jenkins.4teamwork.ch/search?q=ftw.testbrowser

Copyright

This package is copyright by 4teamwork.

ftw.testbrowser is licensed under GNU General Public License, version 2.

Changelog

2.1.2 (2020-07-28)

• editbar.menu and editbar.menus can now find workflow contentmenu in Plone5. [djowett-ftw]

2.1.1 (2020-02-19)

• Since the default mode changed in python3 [Portingguide] we should use from io import open to make it compatible with both versions in core.py. This is relevant for e.g. browser.debug() [busykoala]

2.1.0 (2019-12-04)

• Implement webtest driver. [buchi]

2.0.0 (2019-12-04)

• Add support for Plone 5.2. [buchi]

• Make Traversal and Mechanize drivers optional as the underlying libraries are no longer available in Zope 4 (Plone 5.2). [buchi]

• No longer use plone.formwidget.autocomplete and plone.formwidget.contenttree in tests with Plone 5 and later. [buchi]

• Implement AjaxSelectWidget and improve RelatedItemsWidget. [buchi]

• Modernize z3c form used in test by using directives to setup widgets and removing form wrapper. [buchi]

• Plone 5: disable resource registries in order to improve overall performance. [jone]

• Add support for Python 3. [buchi]

1.30.1 (2019-01-25)

• Add an allow_redirects property to browser for being able to block following redirects. [Rotonen]

1.30.0 (2018-08-03)

• Fix encoding problems for HTML documents without encoding declaration by respecting the encoding in the content-type response header. [jone]

1.29.7 (2018-04-30)

• Fix namespacing issues in WebDav Documents generated by Plone. [njohner]

1.29.6 (2018-03-26)

• Fix MIME encoding error when uploading files and using unicode form values. [jone]

1.29.5 (2017-12-04)

• Improve extraction of erroneous fields. [jone, mbaechtold]

1.29.4 (2017-11-30)

• Fix unbound local error. [deiferni]

1.29.3 (2017-11-23)

• Add missing dependency on plone.uuid. [njohner]

1.29.2 (2017-11-10)

• Fix browser.debug to finish writing file before opening. [jone]

1.29.1 (2017-11-08)

• Improve opening relative URLs. [mbaechtold]

1.29.0 (2017-10-13)

• Refactor plone.protect auto CSRF support for compatibility with ftw.testing’s COMPONENT_REGISTRY_ISOLATION isolation layer. [jone]

1.28.1 (2017-10-03)

• Factories menu: fix regression when menu visible but empty. [jone]

1.28.0 (2017-10-03)

• Let traversal driver support plone.protect>=3 auto CSRF protection. [jone]

• Add Plone 5.1 support. [jone, maethu]

1.27.0 (2017-09-15)

• Improve multi browser support in standard page objects. [jone]

1.26.3 (2017-09-11)

• Make plone.protect import optional so that ftw.testbrowser works without plone.protect. [jone]

1.26.2 (2017-08-14)

• Disallow using browser as nested context manager. [jone]

• Fix reset behavior while used in context manager. [jone]

1.26.1 (2017-07-31)

• Datagridfield widget: support cell-filling by other widgets. [jone]

1.26.0 (2017-07-27)

• Feature: raise InsufficientPrivileges when a Plone request causes a insufficient privileges problem. [jone]

1.25.0 (2017-07-04)

• Add editbar page object module. [jone]

• Reimplement internal query info with a QueryInfo class. [jone]

• Add send_authenticator option for CSRF support. [jone]

1.24.3 (2017-06-23)

• Fix issues with read the docs builds. [jone]

1.24.2 (2017-06-21)

• Traversal driver: decode gzip encoded responses. [jone]

1.24.1 (2017-06-19)

• Declare missing dependencies. [lgraf]

1.24.0 (2017-06-16)

• Log exceptions to stderr when they are not expected. [jone]

• Standardize redirect loop detection: always throw a RedirectLoopException. [jone]

• Add traversal request driver. [jone]

1.23.2 (2017-06-16)

• Fix browser.context when base_url ends with a view name. [phgross]

1.23.1 (2017-05-02)

• Fix browser.debug when body is a bytestring. [jone]

1.23.0 (2017-04-28)

• Introduce browser.expect_unauthorized context manager. [jone]

1.22.2 (2017-04-28)

• HTTPError: include code and reason in exception. [jone]

• Docs: Fix wrong expect_http_error argument names. [jone]

1.22.1 (2017-04-28)

• Docs: swith to RTD, update URLs. [jone]

• Docs: Switch to RTD Sphinx theme. [lgraf]

1.22.0 (2017-04-28)

• Forbid setting of “x-zope-handle-errors” header. [jone]

• Add an option browser.exception_bubbling, disabled by default. [jone]

• Mechanize: no longer disable “x-zope-handle-errors”. [jone]

• Introduce browser.expect_http_error() context manager. [jone]

• Add an option browser.raise_http_errors, enabled by default. [jone]

• Raise HTTPClientError and HTTPServerError by default. [jone]

• Introduce browser.status_reason. [jone]

• Introduce browser.status_code. [jone]

1.21.0 (2017-04-19)

• Make zope.globalrequest support optional. [jone]

• Add testing layers for setting the default driver. [jone]

• Add default_driver option to the driver. [jone]

• Refactoring: introduce request drivers. [jone]

1.20.0 (2017-04-10)

• Add Support for Button tag. [tschanzt]

• No longer test with Archetypes, test only with dexterity. [jone]

• Support latest Plone 4.3.x release. [mathias.leimgruber]

1.19.3 (2016-07-25)

• Declare some previously missing test requirements. [lgraf]

• Declare previously missing dependency on zope.globalrequest (introduced in #35). [lgraf]

1.19.2 (2016-06-27)

• Preserve the request of zope.globalrequest when opening pages with mechanize. [deiferni]

• Also provide advice for available options in exception message. [lgraf]

1.19.1 (2015-08-20)

• Preserve radio-button input when filling forms with radio buttons. [deiferni]

1.19.0 (2015-07-31)

• Implement browser.click_on(tex) short cut for clicking links. [jone]

• Fix encoding error in assertion message when selecting a missing select option. [mbaechtold]

1.18.1 (2015-07-23)

• Fix GET form submission to actually submit it with GET. [jone]

1.18.0 (2015-07-22)

• Table: add new “.column” method for getting all cells of a column. [jone]

1.17.0 (2015-07-22)

• Add support for filling collective.z3cform.datagridfield. [jone, mbaechtold]

1.16.1 (2015-07-13)

• Autocomplete widget: extract URL from javascript. [jone]

1.16.0 (2015-07-08)

• Add image upload widget support (archetypes and dexterity). [jone]

1.15.0 (2015-05-07)

• Parse XML responses with XML parser instead of HTML parser. New methods for parsing the response: parse_as_html, parse_as_xml and parse. [jone]

• Add browser properties contenttype, mimetype and encoding. [jone]

1.14.6 (2015-04-17)

• Use cssselect in favor of lxml.cssselect. This allows us to use lxml >= 3. [jone]

• Added tests for z3c date fields. [phgross]

1.14.5 (2015-01-30)

• AutocompleteWidget: Drop query string from base URL when building query URL. [lgraf]

1.14.4 (2014-10-03)

• Widgets: test for sequence widget after testing for autocomplete widgets. Some widgets match both, autocomplete and sequence widgets. In this case we want to have the autocomplete widget. [jone]

1.14.3 (2014-10-02)

• Fix error with textarea tags without id-attributes. [jone]

1.14.2 (2014-09-29)

• Fix an issue with relative urls. [jone, deiferni]

1.14.1 (2014-09-26)

• Set the HTTP REFERER header correctly. [jone]

1.14.0 (2014-09-26)

• Add folder_contents page object. [jone]

• Update table methods with keyword arguments:

  • head_offset: used for stripping rows from the header

  • as_text: set to False for getting cell nodes

  [jone]

1.13.4 (2014-09-22)

• Filling selects: verbose error message when option not found. The available options are now included in the message. [jone]

1.13.3 (2014-09-02)

• Node.text: remove multiple spaces in a row caused by nesting. [jone]

1.13.2 (2014-08-06)

• Fix problems when filling forms which have checked checkedbox. [phgross]

1.13.1 (2014-07-15)

• Fix encoding problem on binary file uploads. [jone]

1.13.0 (2014-06-12)

• Add a Dexterity namedfile upload widget. [lgraf]

1.12.4 (2014-05-30)

• Fix python 2.6 support. [jone]

1.12.3 (2014-05-30)

• Fix z3cform choice collection widget to support Plone < 4.3. [jone]

1.12.2 (2014-05-29)

• Fix z3cform choice collection widget submit value. The widget creates hidden input fields on submit. [jone]

1.12.1 (2014-05-29)

• Fix error in z3cform choice collection widget when using paths. [jone]

1.12.0 (2014-05-29)

• Add a z3cform choice collection widget. This is used for z3cform List fields with Choice value_type. [jone]

• Add select field node wrapper with methods for getting available options. [jone]

1.11.4 (2014-05-22)

• browser.open(data): support multiple values for the same data name. The values can either be passed as a dict with lists as values or as a sequence of two-element tuples. [jone]

1.11.3 (2014-05-19)

• Fix browser.url regression when the previous request raised an exception. [jone]

1.11.2 (2014-05-17)

• Make NoElementFound exception message more verbose. When a .first on an empty result set raises a NoElementFound exception, the exception message now includes the original query. [jone]

1.11.1 (2014-05-17)

• Fix browser cloning regression in autocomplete widget “query”. The cloned browser did no longer have the same headers / cookies, causing authenticated access to be no longer possible. [jone]

• New browser.clone method for creating browser clones. [jone]

• Update standard page objects to accept browser instace as keyword arguments. This makes it possible to use the page objects with non-standard browsers. [jone]

1.11.0 (2014-05-14)

• New browser.base_url property, respecting the <base> tag. [jone]

• New browser.debug method, opening the current page in your real browser. [jone]

• New browser.on method, a lazy variant of browser.open. [jone]

• New browser.reload method, reloading the current page. [jone]

• Improve requests library support:

  • Support choosing requests library, make Zope app setup optional. When no Zope app is set up, the requests library is set as default, otherwise mechanize.

  • Support form submitting with requests library.

  • Improve login and header support for equests library requests.

  • Add browser.cookies support for requests library requests.

  • Use requests library sessions, so that cookies and headers persist.

  • Automatically use “POST” when data is submitted.

  [jone]

• Login improvements:

  • Support passing member objects to browser.login(). The users / members are still expected to hav TEST_USER_PASSWORD as password.

  • Refactor login to use the new request header methods.

  [jone]

• Add request header methods for managing permanent request headers:

  • browser.append_request_header

  • browser.replace_request_header

  • browser.clear_request_header

  [jone]

• Refactor Form: eliminate class methods and do not use the global browser. This improves form support when running multiple browser instances concurrently.

  • Form.field_labels (class method) is now a instance property and public API.

  • Form.find_widget_in_form (class method) is removed and replaced with Form.find_widget (instance method).

  • Form.find_field_in_form (class method) is removed and replaced Form.get_field (instance method).

  • Form.find_form_element_by_label_or_name (class method) is removed and replaced with browser.find_form_by_field.

  • Form.find_form_by_labels_or_names (class method) is removed and replaced with browser.find_form_by_fields.

  • New Form.action_url property with the full qualified action URL.

  • Fix form action URL bug when using relative paths in combination with document-style base url.

  [jone]

• Fix wrapping input.label - this did only work for a part of field types. [jone]

• Fix UnicodeDecodeError in node string representation. [mathias.leimgruber]

1.10.0 (2014-03-19)

• Add NodeWrapper-properties:

  • innerHTML

  • normalized_innerHTML

  • outerHTML

  • normalized_outerHTML

  [jone, elioschmutz]

1.9.0 (2014-03-18)

• Add support for filling AT MultiSelectionWidget. [jone]

1.8.0 (2014-03-04)

• Add a context property to the browser with the current context (Plone object) of the currently viewed page. [jone]

1.7.3 (2014-02-28)

• Fix encoding problem in factories menu page object. The problem occured when having a “Restrictions…” entry in the menu. [jone]

1.7.2 (2014-02-25)

• Form: Support checking checkboxes without a value. Checkboxes without a value attribute are invalid but common. The default browser behavior is to fallback to the value “on”. [jone]

1.7.0 (2014-02-03)

• ContentTreeWidget: support filling objects as values. [jone]

1.6.1 (2014-01-31)

• Implement logout on browser, logout before each login. [jone]

1.6.0 (2014-01-29)

• Add cookies property to the browser. [jone]

1.5.3 (2014-01-28)

• Fix multiple wrapping on browser.forms. [jone]

1.5.2 (2014-01-17)

• Implement archetypes datetime widget form filling. [jone]

1.5.1 (2014-01-07)

• Fix encoding problems when posting unicode data directly with Browser.open. [jone]

• Support form filling with bytestrings. [jone]

• Fix form filling with umlauts. [jone]

• Fix form fill for single select fields. [jone]

1.5.0 (2014-01-03)

• Implement AT file upload widget, because the label does not work. [jone]

• Implement file uploads. [jone]

• Add “headers” property on the browser. [jone]

1.4.0 (2013-12-27)

• Deprecate normalized_text method, replace it with text property. The text property is more intuitive and easier to remember. The text property has almost the same result as normalized_text, but it represents <br/> and <p> with single and double newlines respectively. text is to be the lxml text property, which contained the raw, non-recursive text of the current node and is now available as raw_text property. [jone]

• open_html: make debugging file contain passed HTML. [jone]

• Sequence widget: implement custom form filling with label support and validation. [jone]

• Sequence widget: add additional properties with inputs and options. [jone]

1.3.0 (2013-12-11)

• Implement “query” method on autocomplete widget. [jone]

• Implement form fill for z3cform datetime widget. [jone]

• Fix setting attributes on nodes when wrapped with NodeWrapper. [jone]

• Implement form fill for z3cform autocomplete widgets. [jone]

• Implement form fill for z3cform sequence widgets. [jone]

• Add webdav method for doing WebDAV requests with a ZServer. [jone]

1.2.0 (2013-11-24)

• Add open_html method to browser object, allowing to pass in HTML directly. [jone]

1.1.0 (2013-11-07)

• Add dexterity page object, refactor z3cform page object. [jone]

• Add table nodes with helpers for table testing. [jone]

• Merging “Nodes” lists returns a new “Nodes” list, not a “list”. [jone]

• Show containing elements in string representation of “Nodes” list. [jone]

• Fix direct child selection with CSS (node.css(“>tag”)). [jone]

• Add a recursive option to normalized_text. [jone]

1.0.2 (2013-10-31)

• When normalizing whitespaces, do also replace non-breaking spaces. [jone]

1.0.1 (2013-10-31)

• Add first_or_none property to Nodes. [jone]

1.0.0 (2013-10-28)

• Initial implementation. [jone]