zope-testbrowser

library8.0pypypi✓ verified 82d ago

Programmable web browser for functional black-box testing of WSGI and HTTP applications. Current version 8.0, supports Python >=3.9. Released under Zope Foundation, follows a rolling release cadence.

testing web-framework http-networking

pip install zope.testbrowser

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · ZOPE-TESTBROWSER

zope-testbrowser

testingpythonv8.0

Install

3.2s avg

Import

—

Disk

29MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v8.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 27.1MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 3.2s · import 0.000s · 28MB

29MB installed

● package 29MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Browser

✓ from zope.testbrowser.browser import Browser

✗ from zope.testbrowser import Browser

Create a Browser instance, open a URL, interact with forms.

import os from zope.testbrowser import Browser browser = Browser() browser.open('http://example.com') print(browser.title) browser.getControl('search').value = 'zope' browser.getControl('Go').click()

Debug

Known issues

breakingIn version 8.0, dropped support for Python <3.9. Also removed the old zope.testbrowser.browser module; use zope.testbrowser or zope.testbrowser.wsgi.

fix

Update imports: from zope.testbrowser import Browser for HTTP, from zope.testbrowser.wsgi import Browser for WSGI.

affects: >=8.0

gotchaBrowser is stateful. Multiple requests share cookies and history. Clear state with browser.clear() or create a new Browser instance.

fix

Use browser = Browser(); browser.clear() before a new test scenario.

affects: all

deprecatedThe mechanize backend is deprecated. Future versions may rely on requests or similar. Use WSGI browser if possible.

fix

Switch to from zope.testbrowser.wsgi import Browser for faster, more reliable tests.

affects: <9.0 (future)

Upgrade

Version history

8.0latest on PyPI · released Sep 12, 2025

Audit

Dependencies

zope.interfacerequiredCore dependency for browser interfaces

lxmlrequiredHTML/XML parsing and form handling

mechanizeoptionalHTTP cookie handling and browser mechanics (deprecated in newer versions, still used for some features)

Agent activity

54 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/zopefoundation/zope.testbrowser ↗

packagehttps://pypi.org/project/zope-testbrowser/ ↗

docshttps://zopetestbrowser.readthedocs.io/ ↗