Changelog

0.24.1 (2026-04-28)

• Fixed links in https://web-poet.readthedocs.io/llms.txt.

0.24.0 (2026-04-21)

Backward-incompatible changes:

• The tutorial-only web_poet.example module has been removed.

• Fixture got some backward-incompatible changes:

  • The type_name and short_name properties have been removed.

  • The following methods got a new page_cls parameter:

    assert_field_correct()

    assert_full_item_correct()

    assert_no_extra_fields()

    assert_no_toitem_exceptions()

    assert_toitem_exception()

    get_output()

    get_page()

Improvements:

• Added a built-in framework for simple use cases.

• Fixture instances are no longer tied to a single page object class.

  While pytest discovery still requires the parent folder name to be named after a page object class, a new --page-object option of python -m web_poet.testing allows specifying a different page object class.

• Retry now accepts an optional max_retries parameter.

• Added DictStatCollector.

0.23.3 (2026-04-07)

• Added AI-assisted code generation to the docs.

• Made the documentation more LLM-friendly, with markdown versions of every page and llms.txt and llms-full.txt files.

0.23.2 (2026-03-10)

• JSON files in test fixtures are now saved using UTF-8 instead of the system encoding.

0.23.1 (2026-01-27)

• @field no longer strips docstrings from decorated methods.

0.23.0 (2026-01-22)

• Dropped Python 3.9 support.

• Added annotation_encode() (see Input annotations) and annotation_decode().

• Implemented type hint improvements.

0.22.0 (2025-12-15)

• Tests now put expected and actual values into pytest user properties.

0.21.0 (2025-11-24)

• Added BrowserPage page object class to work with BrowserResponse.

• Added BrowserResponse.text attribute.

0.20.0 (2025-10-28)

• Added support for Python 3.14.

• Added support for BrowserResponse, AnyResponse and BrowserHtml dependencies to the testing framework.

• Explicitly re-export public names.

0.19.2 (2025-08-22)

• Fixed runtime resolving of type annotations for some types.

0.19.1 (2025-08-13)

• Improved type annotations.

0.19.0 (2025-06-06)

• Removed some deprecated code:

  • The web_poet.overrides module is removed.

  • The ItemWebPage, OverrideRule and PageObjectRegistry classes are removed.

  • The from_override_rules() class method and the get_overrides() and search_overrides() methods of RulesRegistry are removed.

  • The overrides parameter of handle_urls() is removed.

  • The RequestUrl and ResponseUrl classes can no longer be imported from web_poet.page_inputs.http.

• Tests now support items with RequestUrl and ResponseUrl objects.

• Improved the pytest plugin:

  • Pytest ≥ 7.0.0 is now required.

  • Tests within a test case can now be run individually.

  • Tests are now compatible with vscode-python.

• Fixed an error of is_injectable() with GenericAlias on Python ≤ 3.10.

0.18.0 (2025-01-30)

• Removed support for Python 3.8, added support for Python 3.13.

• The minimum required version of url-matcher changed from 0.2.0 to 0.4.0.

• type(None) is no longer considered injectable.

• Added RulesRegistry.top_rules_for_item().

0.17.1 (2024-10-11)

• web_poet.mixins.SelectableMixin.selector is now created with the base_url value set to self.url if this attribute exists.

• Added a mention of the form2request library to the HttpRequest documentation.

• CI improvements.

0.17.0 (2024-03-04)

• Now requires andi >= 0.5.0.

• Package requirements that were unversioned now have minimum versions specified.

• Added support for Python 3.12.

• Added support for typing.Annotated dependencies to the serialization and testing code.

• Documentation improvements.

• CI improvements.

0.16.0 (2024-01-23)

• Added new AnyResponse which holds either BrowserResponse, or HttpResponse.

• Documentation improvements.

0.15.1 (2023-11-21)

• HttpRequestHeaders now has a from_bytes_dict class method, like HttpResponseHeaders.

0.15.0 (2023-09-11)

• A new dependency, Stats, has been added. It allows storing key-value data pairs for different purposes. See Stats.

0.14.0 (2023-08-03)

• Dropped Python 3.7 support.

• Now requires packaging >= 20.0.

• Fixed detection of the Returns base class.

• Improved docs.

• Updated type hints.

• Updated CI tools.

0.13.1 (2023-05-30)

• Fixed an issue with HttpClient which happens when a response with a non-standard status code is received.

0.13.0 (2023-05-30)

• A new dependency BrowserResponse has been added. It contains a browser-rendered page URL, status code and HTML.

• The Rules documentation section has been rewritten.

0.12.0 (2023-05-05)

• The testing framework now allows defining a custom item adapter.

• We have made a backward-incompatible change on test fixture serialization: the type_name field of exceptions has been renamed to import_path.

• Fixed built-in Python types, e.g. int, not working as field processors.

0.11.0 (2023-04-24)

• JMESPath support is now available: you can use WebPage.jmespath() and HttpResponse.jmespath() to run queries on JSON responses.

• The testing framework now supports page objects that raise exceptions from the to_item method.

0.10.0 (2023-04-19)

• New class Extractor can be used for easier extraction of nested fields (see Processors for nested fields).

• Exceptions raised while getting a response for an additional request are now saved in test fixtures.

• Multiple documentation improvements and fixes.

• Add a twine check CI check.

0.9.0 (2023-03-30)

• Standardized input validation.

• Field processors can now also be defined through a nested Processors class, so that field redefinitions in subclasses can inherit them. See Default processors.

• Field processors can now opt in to receive the page object whose field is being read.

• web_poet.fields.FieldsMixin now keeps fields from all base classes when using multiple inheritance.

• Fixed the documentation build.

0.8.1 (2023-03-03)

• Fix the error when calling .to_item(), item_from_fields_sync(), or item_from_fields() on page objects defined as slotted attrs classes, while setting skip_nonitem_fields=True.

0.8.0 (2023-02-23)

This release contains many improvements to the web-poet testing framework, as well as some other improvements and bug fixes.

Backward-incompatible changes:

• cached_method() no longer caches exceptions for async def methods. This makes the behavior the same for sync and async methods, and also makes it consistent with Python’s stdlib caching (i.e. functools.lru_cache(), functools.cached_property()).

• The testing framework now uses the HttpResponse-info.json file name instead of HttpResponse-other.json to store information about HttpResponse instances. To make tests generated with older web-poet work, rename these files on disk.

Testing framework improvements:

• Improved test reporting: better diffs and error messages.

• By default, the pytest plugin now generates a test per item attribute (see Running tests). There is also an option (--web-poet-test-per-item) to run a test per item instead.

• Page objects with the HttpClient dependency are now supported (see Additional requests support).

• Page objects with the PageParams dependency are now supported.

• Added a new python -m web_poet.testing rerun command (see Test-Driven Development).

• Fixed support for nested (indirect) dependencies in page objects. Previously they were not handled properly by the testing framework.

• Non-ASCII output is now stored without escaping in the test fixtures, for better readability.

Other changes:

• Testing and CI fixes.

• Fixed a packaging issue: tests and tests_extra packages were installed, not just web_poet.

0.7.2 (2023-02-01)

• Restore the minimum version of itemadapter from 0.7.1 to 0.7.0, and prevent a similar issue from happening again in the future.

0.7.1 (2023-02-01)

• Updated the tutorial to cover recent features and focus on best practices. Also, a new module was added, web_poet.example, that allows using page objects while following the tutorial.

• Tests for page objects now covers Git LFS and scrapy-poet, and recommends python -m pytest instead of pytest.

• Improved the warning message when duplicate ApplyRule objects are found.

• HttpResponse-other.json content is now indented for better readability.

• Improved test coverage for fields.

0.7.0 (2023-01-18)

• Add a framework for creating tests and running them with pytest.

• Support implementing fields in mixin classes.

• Introduce new methods for web_poet.rules.RulesRegistry:

  • web_poet.rules.RulesRegistry.add_rule()

  • web_poet.rules.RulesRegistry.overrides_for()

  • web_poet.rules.RulesRegistry.page_cls_for_item()

• Improved the performance of web_poet.rules.RulesRegistry.search() where passing a single parameter of either instead_of or to_return results in O(1) look-up time instead of O(N). Additionally, having either instead_of or to_return present in multi-parameter search calls would filter the initial candidate results resulting in a faster search.

• Support page object dependency serialization.

• Add new dependencies used in testing and serialization code: andi, python-dateutil, and time-machine. Also backports.zoneinfo on non-Windows platforms when the Python version is older than 3.9.

0.6.0 (2022-11-08)

In this release, the @handle_urls decorator gets an overhaul; it’s not required anymore to pass another Page Object class to @handle_urls("...", overrides=...).

Also, the @web_poet.field decorator gets support for output processing functions, via the out argument.

Full list of changes:

• Backwards incompatible PageObjectRegistry is no longer supporting dict-like access.

• Official support for Python 3.11.

• New @web_poet.field(out=[...]) argument which allows to set output processing functions for web-poet fields.

• The web_poet.overrides module is deprecated and replaced with web_poet.rules.

• The @handle_urls decorator is now creating ApplyRule instances instead of OverrideRule instances; OverrideRule is deprecated. ApplyRule is similar to OverrideRule, but has the following differences:

  • ApplyRule accepts a to_return parameter, which should be the data container (item) class that the Page Object returns.

  • Passing a string to for_patterns would auto-convert it into url_matcher.Patterns.

  • All arguments are now keyword-only except for for_patterns.

• New signature and behavior of handle_urls:

  • The overrides parameter is made optional and renamed to instead_of.

  • If defined, the item class declared in a subclass of web_poet.ItemPage is used as the to_return parameter of ApplyRule.

  • Multiple handle_urls annotations are allowed.

• PageObjectRegistry is replaced with RulesRegistry; its API is changed:

  • backwards incompatible dict-like API is removed;

  • backwards incompatible O(1) lookups using .search(use=PagObject) has become O(N);

  • search_overrides method is renamed to search;

  • get_overrides method is renamed to get_rules;

  • from_override_rules method is deprecated; use RulesRegistry(rules=...) instead.

• Typing improvements.

• Documentation, test, and warning message improvements.

Deprecations:

• The web_poet.overrides module is deprecated. Use web_poet.rules instead.

• The overrides parameter from @handle_urls is now deprecated. Use the instead_of parameter instead.

• The OverrideRule class is now deprecated. Use ApplyRule instead.

• PageObjectRegistry is now deprecated. Use RulesRegistry instead.

• The from_override_rules method of PageObjectRegistry is now deprecated. Use RulesRegistry(rules=...) instead.

• The PageObjectRegistry.get_overrides method is deprecated. Use PageObjectRegistry.get_rules instead.

• The PageObjectRegistry.search_overrides method is deprecated. Use PageObjectRegistry.search instead.

0.5.1 (2022-09-23)

• The BOM encoding from the response body is now read before the response headers when deriving the response encoding.

• Minor typing improvements.

0.5.0 (2022-09-21)

Web-poet now includes a mini-framework for organizing extraction code as Page Object properties:

import attrs
from web_poet import field, ItemPage

@attrs.define
class MyItem:
    foo: str
    bar: list[str]


class MyPage(ItemPage[MyItem]):
    @field
    def foo(self):
        return "..."

    @field
    def bar(self):
        return ["...", "..."]

Backwards incompatible changes:

• web_poet.ItemPage is no longer an abstract base class which requires to_item method to be implemented. Instead, it provides a default async def to_item method implementation which uses fields marked as web_poet.field to create an item. This change shouldn’t affect the user code in a backwards incompatible way, but it might affect typing.

Deprecations:

• web_poet.ItemWebPage is deprecated. Use web_poet.WebPage instead.

Other changes:

• web-poet is declared as PEP 561 package which provides typing information; mypy is going to use it by default.

• Documentation, test, typing and CI improvements.

0.4.0 (2022-07-26)

• New HttpResponse.urljoin method, which take page’s base url in account.

• New HttpRequest.urljoin method.

• standardized web_poet.exceptions.Retry exception, which allows to initiate a retry from the Page Object, e.g. based on page content.

• Documentation improvements.

0.3.0 (2022-06-14)

• Backwards Incompatible Change:

  • web_poet.requests.request_backend_var is renamed to web_poet.requests.request_downloader_var.

• Documentation and CI improvements.

0.2.0 (2022-06-10)

• Backward Incompatible Change:

  • ResponseData is replaced with HttpResponse.

    HttpResponse exposes methods useful for web scraping (such as xpath and css selectors, json loading), and handles web page encoding detection. There are also new types like HttpResponseBody and HttpResponseHeaders.

• Added support for performing additional requests using web_poet.HttpClient.

• Introduced web_poet.BrowserHtml dependency

• Introduced web_poet.PageParams to pass arbitrary information inside a Page Object.

• Added web_poet.handle_urls decorator, which allows to declare which websites should be handled by the page objects. Lower-level PageObjectRegistry class is also available.

• removed support for Python 3.6

• added support for Python 3.10

0.1.1 (2021-06-02)

• base_url and urljoin shortcuts

0.1.0 (2020-07-18)

• Documentation

• WebPage, ItemPage, ItemWebPage, Injectable and ResponseData are available as top-level imports (e.g. web_poet.ItemPage)

0.0.1 (2020-04-27)

Initial release.