assertpy2 2.0.0__tar.gz → 2.1.0__tar.gz

assertpy2-2.1.0/.codecov.yml

@@ -0,0 +1,10 @@
+coverage:
+  status:
+    project:
+      default:
+        target: auto
+        threshold: 1%
+    patch:
+      default:
+        target: auto
+        threshold: 1%

{assertpy2-2.0.0 → assertpy2-2.1.0}/.github/workflows/ci.yml

@@ -31,11 +31,14 @@ jobs:
         run: uv run ruff check .
 
       - name: Test with coverage
-        run: uv run pytest -v --cov=assertpy2 --cov-report=term-missing tests
+        run: uv run pytest -v --cov=assertpy2 --cov-report=term-missing --cov-report=xml tests
 
       - name: Upload coverage to Codecov
         if: matrix.python-version == '3.14'
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@v6
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: coverage.xml
 
   lint:
     runs-on: ubuntu-latest

assertpy2-2.1.0/CLAUDE.md

@@ -0,0 +1,113 @@
+# assertpy2
+
+Fluent assertion library for Python. Fork of assertpy с type safety, soft assertions, snapshot testing.
+Python 3.10+, единственная зависимость: typing_extensions>=4.0.
+
+---
+
+## Project layout
+
+```
+assertpy2/
+├── assertpy.py           # assert_that(), AssertionBuilder, soft_assertions(), fail()
+├── async_assertions.py   # AsyncAssertionBuilder - eventually() polling
+├── base.py               # BaseMixin - is_equal_to, satisfies, each, matches_structure
+├── string.py             # StringMixin - starts_with, ends_with, matches, is_alpha, is_digit
+├── numeric.py            # NumericMixin - is_zero, is_positive, is_between, is_close_to
+├── collection.py         # CollectionMixin - is_iterable, is_subset_of, is_sorted
+├── contains.py           # ContainsMixin - contains, does_not_contain, is_empty
+├── dict.py               # DictMixin - contains_key, contains_value, contains_entry
+├── date.py               # DateMixin - is_before, is_after, is_equal_to_ignoring_time
+├── file.py               # FileMixin + contents_of() - exists, is_file, is_directory
+├── exception.py          # ExceptionMixin - raises, when_called_with
+├── extracting.py         # ExtractingMixin - extracting with filter/sort
+├── dynamic.py            # DynamicMixin - has_<attr>() via __getattr__
+├── snapshot.py           # SnapshotMixin - snapshot testing
+├── helpers.py            # HelpersMixin - _dict_not_equal, _fmt_items, validation
+├── errors.py             # AssertionFailure, DiffResult, DiffEntry - structured errors
+├── matchers.py           # Matcher protocol, composable matchers, match namespace
+├── pytest_plugin.py      # pytest entry point - rich diff output for AssertionFailure
+├── _typing.py            # TYPE_CHECKING-only Protocol classes for @overload return types
+├── __init__.py           # Public API exports
+└── py.typed              # PEP 561 marker
+
+tests/                 # 100% coverage required
+```
+
+---
+
+## Architecture
+
+- AssertionBuilder наследует миксины. Каждый миксин - одна категория assertions.
+- Все assertion-методы возвращают Self для chaining.
+- error() в AssertionBuilder маршрутизирует: raise (default), log (warn), collect (soft).
+- __tracebackhide__ = True во всех миксинах для чистого pytest traceback.
+- Расширения через add_extension(func) - динамическая привязка через types.MethodType.
+
+Правило: новые assertions добавляются в существующий миксин по категории.
+Новый миксин создаётся только для принципиально новой категории (не для 1-2 методов).
+
+---
+
+## Tooling
+
+```
+uv sync
+uv run pytest
+uv run pytest -v --cov=assertpy2 --cov-report=term-missing
+uv run ruff check .
+uv run ruff format .
+uv run ruff format --check .
+```
+
+---
+
+## CI/CD
+
+GitHub Actions, два workflow:
+
+**CI** (.github/workflows/ci.yml):
+- Триггер: push/PR в main
+- Матрица: Python 3.10-3.15
+- Шаги: uv sync, ruff check, pytest с coverage (xml + term-missing)
+- Codecov upload: только с Python 3.14 (token в secrets)
+- Отдельный lint job: ruff check + ruff format --check
+
+**Publish** (.github/workflows/publish.yml):
+- Триггер: GitHub Release (published)
+- Trusted Publisher (id-token: write), без API-ключей
+- uv build, pypa/gh-action-pypi-publish
+
+Правила:
+- Версия только в pyproject.toml (одно место)
+- Релиз: обновить version в pyproject.toml, создать GitHub Release с тегом
+- Не мержить без зелёного CI
+
+---
+
+## Key dependencies
+
+| Package | Version | Role |
+|---|---|---|
+| typing_extensions | >=4.0 | Self type, runtime-free typing |
+| pytest | >=9.0.3 | test runner (dev) |
+| pytest-cov | >=6.1 | coverage (dev) |
+| ruff | >=0.15.14 | linter + formatter (dev) |
+
+---
+
+## Naming
+
+- Assertion-методы: is_*, has_*, does_not_*, contains_*, starts_with, ends_with
+- Новые assertions следуют существующему паттерну: глагол + предикат
+- Тестовые файлы: test_<feature>.py
+- Миксины: <Category>Mixin
+
+---
+
+## Testing
+
+- Coverage 100%. Каждый assertion-метод покрыт: happy path, error path, edge cases.
+- Тесты используют pytest.raises(AssertionError) для проверки сообщений об ошибках.
+- match= в pytest.raises для валидации текста ошибки.
+- Snapshot-тесты хранят данные в tests/__snapshots__/.

{assertpy2-2.0.0 → assertpy2-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: assertpy2
-Version: 2.0.0
+Version: 2.1.0
 Summary: Fluent assertion library for Python with full type safety and soft assertions
 Project-URL: Homepage, https://github.com/Solganis/assertpy2
 Project-URL: Repository, https://github.com/Solganis/assertpy2
@@ -30,11 +30,15 @@ Requires-Dist: typing-extensions>=4.0
 Description-Content-Type: text/markdown
 
 <p align="center">
-  <img src="docs/logo.svg" alt="assertpy2" width="280">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/logo-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="docs/logo.svg">
+    <img src="docs/logo.svg" alt="assertpy2" width="280">
+  </picture>
 </p>
 
 <p align="center">
-  <b>Fluent assertion library for Python with full type safety and soft assertions.</b><br>
+  <b>Fluent assertion library for Python with composable matchers, structural matching, and full type safety.</b><br>
   Maintained fork of <a href="https://github.com/assertpy/assertpy">assertpy</a>.
 </p>
 
@@ -45,6 +49,7 @@ Description-Content-Type: text/markdown
   <a href="https://pypi.org/project/assertpy2/"><img src="https://img.shields.io/pypi/pyversions/assertpy2" alt="Python"></a>
   <a href="https://codecov.io/gh/Solganis/assertpy2"><img src="https://codecov.io/gh/Solganis/assertpy2/graph/badge.svg" alt="Coverage"></a>
   <a href="https://github.com/Solganis/assertpy2/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Solganis/assertpy2" alt="License"></a>
+  <a href="https://docs.astral.sh/ruff/"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff"></a>
 </p>
 
 
@@ -66,14 +71,41 @@ def test_user():
     assert_that(user).has_name("Alice")
 ```
 
-When an assertion fails, the error message tells you exactly what went wrong:
+Composable matchers and structural matching:
 
 ```py
-assert_that(user["age"]).is_between(50, 120)
-# AssertionError: Expected <30> to be between <50> and <120>, but was not.
+from assertpy2 import assert_that, match
+
+# matchers with & | ~ operators
+assert_that([3, 7, 12]).contains(match.greater_than(10))
+assert_that(42).satisfies(match.greater_than(0) & match.less_than(100))
+
+# validate dict structure declaratively
+assert_that(api_response).matches_structure({
+    "id": match.is_uuid(),
+    "name": match.equal_to("Alice"),
+    "status": match.is_non_empty_string(),
+})
+```
+
+Structured errors with rich data:
+
+```py
+try:
+    assert_that({"a": 1, "b": 2}).is_equal_to({"a": 1, "b": 99})
+except AssertionError as e:
+    e.actual    # {"a": 1, "b": 2}
+    e.expected  # {"a": 1, "b": 99}
+    e.diff      # DiffResult(kind='dict', entries=[DiffEntry(path='b', actual=2, expected=99)])
+```
+
+The pytest plugin auto-renders this as rich diff sections in failure reports:
 
-assert_that(user["roles"]).contains("admin")
-# AssertionError: Expected <['viewer', 'editor']> to contain <admin>, but did not.
+```
+FAILED test_example.py::test_comparison
+--- AssertionFailure ---
+  actual:   {'a': 1, 'b': 2}
+  expected: {'a': 1, 'b': 99}
 ```
 
 
@@ -100,9 +132,13 @@ assert_that(items).is_type_of(list).is_length(3).contains("admin")
 
 ## Features
 
+- **Composable matchers**: `match.greater_than(5)`, `match.is_uuid()`, combine with `&`, `|`, `~` operators.
+- **Structural matching**: `matches_structure()` for declarative dict/API response validation.
+- **Async assertions**: `eventually()` with polling/retry for async and eventual consistency testing.
+- **Structured errors**: `AssertionFailure` with `.actual`, `.expected`, `.diff` attributes, pytest plugin with rich diff output.
+- **Typed overloads**: `assert_that()` returns type-specific Protocols, IDE shows only relevant methods per type.
 - **Type safety**: `Self` return types, `py.typed` ([PEP 561](https://peps.python.org/pep-0561/)).
-- **IDE support**: full autocomplete and chaining inference out of the box.
-- **Soft assertions**: collect all failures with `soft_assertions()`, plus `soft_fail()` for non-halting explicit failures.
+- **Soft assertions**: thread-safe and async-safe via `contextvars`, collect all failures with `soft_assertions()`.
 - **Fluent chaining**: write assertions as readable one-liners that chain naturally.
 - **Dynamic assertions**: `has_<name>()` for any attribute, property, or zero-argument method on objects and dicts.
 - **Dict comparison**: `is_equal_to()` with `ignore` and `include` for selective key matching.
@@ -113,6 +149,69 @@ assert_that(items).is_type_of(list).is_length(3).contains("admin")
 - Strings, numbers, lists, tuples, sets, dicts, dates, booleans, objects, exceptions.
 
 
+## Composable matchers
+
+Matchers are objects that describe conditions. Combine them with `&` (and), `|` (or), `~` (not):
+
+```py
+from assertpy2 import assert_that, match
+
+# check a value against a composed condition
+assert_that(42).satisfies(match.greater_than(0) & match.less_than(100))
+
+# matchers inside contains - find element by condition
+assert_that([3, 7, 12]).contains(match.greater_than(10))
+
+# check every element in a collection
+assert_that([18, 25, 30]).each(match.between(18, 120))
+
+# invert with ~
+assert_that("hello").satisfies(~match.equal_to("world"))
+
+# combine freely
+assert_that(150).satisfies(match.is_negative() | match.greater_than(100))
+```
+
+Available matchers: `equal_to`, `greater_than`, `greater_than_or_equal_to`, `less_than`, `less_than_or_equal_to`, `between`, `close_to`, `is_none`, `is_not_none`, `is_instance_of`, `has_length`, `is_empty`, `is_not_empty`, `is_positive`, `is_negative`, `contains_string`, `matches_regex`, `is_uuid`, `is_non_empty_string`, `ignore`, `each_item`, `structure`.
+
+
+## Structural matching
+
+Validate dict structure declaratively, even when values are dynamic (UUIDs, timestamps):
+
+```py
+from assertpy2 import assert_that, match
+
+assert_that(api_response).matches_structure({
+    "id": match.is_uuid(),
+    "name": match.equal_to("Alice"),
+    "created_at": match.is_non_empty_string(),
+    "metadata": match.structure({
+        "version": match.greater_than(0),
+        "tags": match.each_item(match.is_instance_of(str)),
+    }),
+    "debug_info": match.ignore(),
+})
+```
+
+
+## Async assertions
+
+Poll a callable until the assertion passes or timeout is reached:
+
+```py
+from assertpy2 import assert_that
+
+async def test_eventual_consistency():
+    await assert_that(get_status).eventually().within(5).every(0.5).is_equal_to("ready")
+
+    # works with async callables
+    await assert_that(async_get_count).eventually().within(10).is_greater_than(100)
+```
+
+Any assertion method is available after `eventually()`. Only `AssertionError` is retried, other exceptions propagate immediately.
+
+
 ## Soft assertions
 
 Collect all failures instead of stopping at the first one:
@@ -138,8 +237,45 @@ AssertionError: soft assertion failures:
 
 Use `soft_fail("message")` inside the block for non-halting explicit failures (unlike `fail()`, which stops immediately).
 
+Soft assertions are thread-safe and async-safe: each thread and each `asyncio` task gets independent state via `contextvars`.
+
+
+## Structured errors
+
+When assertions fail, `AssertionFailure` carries structured data alongside the human-readable message:
+
+```py
+try:
+    assert_that(1).is_equal_to(2)
+except AssertionError as e:
+    e.actual    # 1
+    e.expected  # 2
+```
+
+For dict comparisons, a `DiffResult` with per-key diff entries is available:
+
+```py
+try:
+    assert_that({"a": 1, "b": 2}).is_equal_to({"a": 1, "b": 99})
+except AssertionError as e:
+    e.diff  # DiffResult(kind='dict', entries=[DiffEntry(path='b', actual=2, expected=99)])
+```
+
+`AssertionFailure` is a subclass of `AssertionError`, so all existing `except AssertionError` handlers work unchanged.
 
-## API highlights
+The pytest plugin (auto-registered, no configuration needed) renders structured data as extra sections in failure reports:
+
+```
+FAILED test_example.py::test_comparison
+--- AssertionFailure ---
+  actual:   {'a': 1, 'b': 2}
+  expected: {'a': 1, 'b': 99}
+--- Structured Diff ---
+DiffResult(kind='dict', entries=[DiffEntry(path='b', actual=2, expected=99)])
+```
+
+
+## More features
 
 ### Dict comparison with ignore/include
 
@@ -168,12 +304,37 @@ assert_that(some_func).raises(RuntimeError).when_called_with("bad_arg")\
     .is_length(8).starts_with("some").is_equal_to("some err")
 ```
 
+### Dynamic assertions
+
+```py
+fred = {"first_name": "Fred", "last_name": "Smith", "shoe_size": 12}
+
+assert_that(fred).has_first_name("Fred")
+assert_that(fred).has_last_name("Smith")
+assert_that(fred).has_shoe_size(12)
+```
+
 ### Snapshot testing
 
 ```py
 assert_that({"a": 1, "b": 2, "c": 3}).snapshot()
 ```
 
+### Extensions
+
+```py
+from assertpy2 import add_extension
+
+def is_even(self):
+    if self.val % 2 != 0:
+        return self.error(f'{self.val} is not even!')
+    return self
+
+add_extension(is_even)
+
+assert_that(4).is_even()
+```
+
 See the [full API reference](docs/api.md) for all assertion methods, examples, and advanced features.
 
 
@@ -195,9 +356,14 @@ from assertpy2 import assert_that, soft_assertions
 |---|---|---|
 | Maintained | Last release 2020 | Active |
 | Python | 2.7+ | 3.10-3.15 |
-| Type safety | No annotations | `Self` return types, `py.typed` (PEP 561) |
-| IDE support | No type info | Full autocomplete and chaining inference |
-| Soft assertions | Basic | Stable, with `soft_fail()` support |
+| Type safety | No annotations | `Self` return types, `py.typed`, typed `@overload` on `assert_that()` |
+| IDE support | No type info | Full autocomplete, type-specific method suggestions |
+| Matchers | None | Composable matchers with `&` `\|` `~` operators |
+| Structural matching | None | `matches_structure()` with recursive dict validation |
+| Async | None | `eventually()` with polling/retry |
+| Error reporting | Flat strings | `AssertionFailure` with `.actual`, `.expected`, `.diff` |
+| Pytest integration | None | Rich diff sections in failure reports |
+| Soft assertions | Global state, not thread-safe | `contextvars`, thread-safe and async-safe |
 | Security | [CVE in snapshots](https://github.com/assertpy/assertpy/issues/156) | Fixed |
 | Open bugs | 15+ unresolved | All resolved |
 

{assertpy2-2.0.0 → assertpy2-2.1.0}/README.md

@@ -1,9 +1,13 @@
 <p align="center">
-  <img src="docs/logo.svg" alt="assertpy2" width="280">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/logo-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="docs/logo.svg">
+    <img src="docs/logo.svg" alt="assertpy2" width="280">
+  </picture>
 </p>
 
 <p align="center">
-  <b>Fluent assertion library for Python with full type safety and soft assertions.</b><br>
+  <b>Fluent assertion library for Python with composable matchers, structural matching, and full type safety.</b><br>
   Maintained fork of <a href="https://github.com/assertpy/assertpy">assertpy</a>.
 </p>
 
@@ -14,6 +18,7 @@
   <a href="https://pypi.org/project/assertpy2/"><img src="https://img.shields.io/pypi/pyversions/assertpy2" alt="Python"></a>
   <a href="https://codecov.io/gh/Solganis/assertpy2"><img src="https://codecov.io/gh/Solganis/assertpy2/graph/badge.svg" alt="Coverage"></a>
   <a href="https://github.com/Solganis/assertpy2/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Solganis/assertpy2" alt="License"></a>
+  <a href="https://docs.astral.sh/ruff/"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff"></a>
 </p>
 
 
@@ -35,14 +40,41 @@ def test_user():
     assert_that(user).has_name("Alice")
 ```
 
-When an assertion fails, the error message tells you exactly what went wrong:
+Composable matchers and structural matching:
 
 ```py
-assert_that(user["age"]).is_between(50, 120)
-# AssertionError: Expected <30> to be between <50> and <120>, but was not.
+from assertpy2 import assert_that, match
+
+# matchers with & | ~ operators
+assert_that([3, 7, 12]).contains(match.greater_than(10))
+assert_that(42).satisfies(match.greater_than(0) & match.less_than(100))
+
+# validate dict structure declaratively
+assert_that(api_response).matches_structure({
+    "id": match.is_uuid(),
+    "name": match.equal_to("Alice"),
+    "status": match.is_non_empty_string(),
+})
+```
+
+Structured errors with rich data:
+
+```py
+try:
+    assert_that({"a": 1, "b": 2}).is_equal_to({"a": 1, "b": 99})
+except AssertionError as e:
+    e.actual    # {"a": 1, "b": 2}
+    e.expected  # {"a": 1, "b": 99}
+    e.diff      # DiffResult(kind='dict', entries=[DiffEntry(path='b', actual=2, expected=99)])
+```
+
+The pytest plugin auto-renders this as rich diff sections in failure reports:
 
-assert_that(user["roles"]).contains("admin")
-# AssertionError: Expected <['viewer', 'editor']> to contain <admin>, but did not.
+```
+FAILED test_example.py::test_comparison
+--- AssertionFailure ---
+  actual:   {'a': 1, 'b': 2}
+  expected: {'a': 1, 'b': 99}
 ```
 
 
@@ -69,9 +101,13 @@ assert_that(items).is_type_of(list).is_length(3).contains("admin")
 
 ## Features
 
+- **Composable matchers**: `match.greater_than(5)`, `match.is_uuid()`, combine with `&`, `|`, `~` operators.
+- **Structural matching**: `matches_structure()` for declarative dict/API response validation.
+- **Async assertions**: `eventually()` with polling/retry for async and eventual consistency testing.
+- **Structured errors**: `AssertionFailure` with `.actual`, `.expected`, `.diff` attributes, pytest plugin with rich diff output.
+- **Typed overloads**: `assert_that()` returns type-specific Protocols, IDE shows only relevant methods per type.
 - **Type safety**: `Self` return types, `py.typed` ([PEP 561](https://peps.python.org/pep-0561/)).
-- **IDE support**: full autocomplete and chaining inference out of the box.
-- **Soft assertions**: collect all failures with `soft_assertions()`, plus `soft_fail()` for non-halting explicit failures.
+- **Soft assertions**: thread-safe and async-safe via `contextvars`, collect all failures with `soft_assertions()`.
 - **Fluent chaining**: write assertions as readable one-liners that chain naturally.
 - **Dynamic assertions**: `has_<name>()` for any attribute, property, or zero-argument method on objects and dicts.
 - **Dict comparison**: `is_equal_to()` with `ignore` and `include` for selective key matching.
@@ -82,6 +118,69 @@ assert_that(items).is_type_of(list).is_length(3).contains("admin")
 - Strings, numbers, lists, tuples, sets, dicts, dates, booleans, objects, exceptions.
 
 
+## Composable matchers
+
+Matchers are objects that describe conditions. Combine them with `&` (and), `|` (or), `~` (not):
+
+```py
+from assertpy2 import assert_that, match
+
+# check a value against a composed condition
+assert_that(42).satisfies(match.greater_than(0) & match.less_than(100))
+
+# matchers inside contains - find element by condition
+assert_that([3, 7, 12]).contains(match.greater_than(10))
+
+# check every element in a collection
+assert_that([18, 25, 30]).each(match.between(18, 120))
+
+# invert with ~
+assert_that("hello").satisfies(~match.equal_to("world"))
+
+# combine freely
+assert_that(150).satisfies(match.is_negative() | match.greater_than(100))
+```
+
+Available matchers: `equal_to`, `greater_than`, `greater_than_or_equal_to`, `less_than`, `less_than_or_equal_to`, `between`, `close_to`, `is_none`, `is_not_none`, `is_instance_of`, `has_length`, `is_empty`, `is_not_empty`, `is_positive`, `is_negative`, `contains_string`, `matches_regex`, `is_uuid`, `is_non_empty_string`, `ignore`, `each_item`, `structure`.
+
+
+## Structural matching
+
+Validate dict structure declaratively, even when values are dynamic (UUIDs, timestamps):
+
+```py
+from assertpy2 import assert_that, match
+
+assert_that(api_response).matches_structure({
+    "id": match.is_uuid(),
+    "name": match.equal_to("Alice"),
+    "created_at": match.is_non_empty_string(),
+    "metadata": match.structure({
+        "version": match.greater_than(0),
+        "tags": match.each_item(match.is_instance_of(str)),
+    }),
+    "debug_info": match.ignore(),
+})
+```
+
+
+## Async assertions
+
+Poll a callable until the assertion passes or timeout is reached:
+
+```py
+from assertpy2 import assert_that
+
+async def test_eventual_consistency():
+    await assert_that(get_status).eventually().within(5).every(0.5).is_equal_to("ready")
+
+    # works with async callables
+    await assert_that(async_get_count).eventually().within(10).is_greater_than(100)
+```
+
+Any assertion method is available after `eventually()`. Only `AssertionError` is retried, other exceptions propagate immediately.
+
+
 ## Soft assertions
 
 Collect all failures instead of stopping at the first one:
@@ -107,8 +206,45 @@ AssertionError: soft assertion failures:
 
 Use `soft_fail("message")` inside the block for non-halting explicit failures (unlike `fail()`, which stops immediately).
 
+Soft assertions are thread-safe and async-safe: each thread and each `asyncio` task gets independent state via `contextvars`.
+
+
+## Structured errors
+
+When assertions fail, `AssertionFailure` carries structured data alongside the human-readable message:
+
+```py
+try:
+    assert_that(1).is_equal_to(2)
+except AssertionError as e:
+    e.actual    # 1
+    e.expected  # 2
+```
+
+For dict comparisons, a `DiffResult` with per-key diff entries is available:
+
+```py
+try:
+    assert_that({"a": 1, "b": 2}).is_equal_to({"a": 1, "b": 99})
+except AssertionError as e:
+    e.diff  # DiffResult(kind='dict', entries=[DiffEntry(path='b', actual=2, expected=99)])
+```
+
+`AssertionFailure` is a subclass of `AssertionError`, so all existing `except AssertionError` handlers work unchanged.
 
-## API highlights
+The pytest plugin (auto-registered, no configuration needed) renders structured data as extra sections in failure reports:
+
+```
+FAILED test_example.py::test_comparison
+--- AssertionFailure ---
+  actual:   {'a': 1, 'b': 2}
+  expected: {'a': 1, 'b': 99}
+--- Structured Diff ---
+DiffResult(kind='dict', entries=[DiffEntry(path='b', actual=2, expected=99)])
+```
+
+
+## More features
 
 ### Dict comparison with ignore/include
 
@@ -137,12 +273,37 @@ assert_that(some_func).raises(RuntimeError).when_called_with("bad_arg")\
     .is_length(8).starts_with("some").is_equal_to("some err")
 ```
 
+### Dynamic assertions
+
+```py
+fred = {"first_name": "Fred", "last_name": "Smith", "shoe_size": 12}
+
+assert_that(fred).has_first_name("Fred")
+assert_that(fred).has_last_name("Smith")
+assert_that(fred).has_shoe_size(12)
+```
+
 ### Snapshot testing
 
 ```py
 assert_that({"a": 1, "b": 2, "c": 3}).snapshot()
 ```
 
+### Extensions
+
+```py
+from assertpy2 import add_extension
+
+def is_even(self):
+    if self.val % 2 != 0:
+        return self.error(f'{self.val} is not even!')
+    return self
+
+add_extension(is_even)
+
+assert_that(4).is_even()
+```
+
 See the [full API reference](docs/api.md) for all assertion methods, examples, and advanced features.
 
 
@@ -164,9 +325,14 @@ from assertpy2 import assert_that, soft_assertions
 |---|---|---|
 | Maintained | Last release 2020 | Active |
 | Python | 2.7+ | 3.10-3.15 |
-| Type safety | No annotations | `Self` return types, `py.typed` (PEP 561) |
-| IDE support | No type info | Full autocomplete and chaining inference |
-| Soft assertions | Basic | Stable, with `soft_fail()` support |
+| Type safety | No annotations | `Self` return types, `py.typed`, typed `@overload` on `assert_that()` |
+| IDE support | No type info | Full autocomplete, type-specific method suggestions |
+| Matchers | None | Composable matchers with `&` `\|` `~` operators |
+| Structural matching | None | `matches_structure()` with recursive dict validation |
+| Async | None | `eventually()` with polling/retry |
+| Error reporting | Flat strings | `AssertionFailure` with `.actual`, `.expected`, `.diff` |
+| Pytest integration | None | Rich diff sections in failure reports |
+| Soft assertions | Global state, not thread-safe | `contextvars`, thread-safe and async-safe |
 | Security | [CVE in snapshots](https://github.com/assertpy/assertpy/issues/156) | Fixed |
 | Open bugs | 15+ unresolved | All resolved |