assertpy2 2.12.0__tar.gz → 2.14.0__tar.gz

assertpy2-2.14.0/.github/dependabot.yml

@@ -0,0 +1,31 @@
+version: 2
+updates:
+  # Python dependencies via uv: the native `uv` ecosystem updates pyproject.toml
+  # AND keeps uv.lock in sync (the older `pip` ecosystem left the lock untouched).
+  - package-ecosystem: uv
+    directory: /
+    schedule:
+      interval: weekly
+    cooldown:
+      default-days: 7
+      semver-major-days: 7
+    commit-message:
+      prefix: "chore(deps)"
+    groups:
+      # One PR/week for all minor+patch bumps; majors stay individual for review.
+      python-minor-patch:
+        patterns: ["*"]
+        update-types: ["minor", "patch"]
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    cooldown:
+      default-days: 7
+    commit-message:
+      prefix: "ci(deps)"
+    groups:
+      actions-minor-patch:
+        patterns: ["*"]
+        update-types: ["minor", "patch"]

{assertpy2-2.12.0 → assertpy2-2.14.0}/.github/workflows/ci.yml

@@ -21,12 +21,17 @@ jobs:
         os: [ubuntu-latest]
         python-version: ["3.10", "3.11", "3.12", "3.13", "3.14", "3.15"]
         include:
+          # the Codecov cell also installs every optional integration (pandas/polars/numpy extras plus
+          # pydantic/attrs/requests), so the tests the other minimal-env cells skip run here for real
+          - os: ubuntu-latest
+            python-version: "3.14"
+            full-deps: true
           - os: windows-latest
             python-version: "3.14"
           - os: macos-latest
             python-version: "3.14"
     steps:
-      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
 
@@ -34,14 +39,19 @@ jobs:
         uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
         with:
           python-version: ${{ matrix.python-version }}
           allow-prereleases: true
 
       - name: Install dependencies
+        if: '!matrix.full-deps'
         run: uv sync --extra json
 
+      - name: Install dependencies (all integrations)
+        if: matrix.full-deps
+        run: uv sync --extra json --extra data --group integrations
+
       - name: Test with coverage
         run: uv run pytest -v --cov=assertpy2 --cov-report=term-missing --cov-report=xml tests
 
@@ -55,7 +65,7 @@ jobs:
   lint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
 
@@ -63,7 +73,7 @@ jobs:
         uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
 
       - name: Set up Python
-        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
         with:
           python-version: "3.14"
 
@@ -84,3 +94,11 @@ jobs:
 
       - name: Type check (pyright, public typing surface)
         run: uv run pyright tests/test_typing.py
+
+  ci-ok:
+    needs: [test, lint]
+    if: always()
+    runs-on: ubuntu-latest
+    steps:
+      - name: Verify required jobs succeeded
+        run: '[ "${{ needs.test.result }}" = "success" ] && [ "${{ needs.lint.result }}" = "success" ]'

{assertpy2-2.12.0 → assertpy2-2.14.0}/.github/workflows/codeql.yml

@@ -17,7 +17,7 @@ jobs:
     permissions:
       security-events: write
     steps:
-      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
       - uses: github/codeql-action/init@8aad20d150bbac5944a9f9d289da16a4b0d87c1e # v4.36.2

{assertpy2-2.12.0 → assertpy2-2.14.0}/.github/workflows/docs.yml

@@ -17,7 +17,7 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
 
@@ -25,7 +25,7 @@ jobs:
         uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
 
       - name: Set up Python
-        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
         with:
           python-version: "3.14"
 

{assertpy2-2.12.0 → assertpy2-2.14.0}/.github/workflows/mutation.yml

@@ -21,7 +21,7 @@ jobs:
       matrix:
         module: [base, numeric, string, contains, collection, dict, date, matchers, helpers, _compare, dataframe, json_mixin, snapshot, bytes_mixin, dynamic, extracting, warning, exception, async_assertions, file, behave_matchers]
     steps:
-      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
 
@@ -29,7 +29,7 @@ jobs:
         uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
 
       - name: Set up Python
-        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
         with:
           python-version: "3.14"
 

{assertpy2-2.12.0 → assertpy2-2.14.0}/.github/workflows/publish.yml

@@ -16,7 +16,7 @@ jobs:
       contents: write
       attestations: write
     steps:
-      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
 
@@ -26,7 +26,7 @@ jobs:
           enable-cache: false
 
       - name: Set up Python
-        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
         with:
           python-version: "3.15"
           allow-prereleases: true

{assertpy2-2.12.0 → assertpy2-2.14.0}/.github/workflows/scorecard.yml

@@ -16,7 +16,7 @@ jobs:
       security-events: write
       id-token: write
     steps:
-      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
       - uses: ossf/scorecard-action@4eaacf0543bb3f2c246792bd56e8cdeffafb205a # v2.4.3

{assertpy2-2.12.0 → assertpy2-2.14.0}/.github/workflows/zizmor.yml

@@ -19,7 +19,7 @@ jobs:
     permissions:
       security-events: write
     steps:
-      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
-      - uses: zizmorcore/zizmor-action@5f14fd08f7cf1cb1609c1e344975f152c7ee938d # v0.5.6
+      - uses: zizmorcore/zizmor-action@192e21d79ab29983730a13d1382995c2307fbcaa # v0.5.7

{assertpy2-2.12.0 → assertpy2-2.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: assertpy2
-Version: 2.12.0
+Version: 2.14.0
 Summary: Fluent assertion library for Python with composable matchers, structural matching, and full type safety
 Project-URL: Homepage, https://github.com/Solganis/assertpy2
 Project-URL: Repository, https://github.com/Solganis/assertpy2
@@ -9,7 +9,7 @@ Author-email: Justin Shacklette <justin@saturnboy.com>
 Maintainer-email: Solganis <solganis.dev@gmail.com>
 License-Expression: BSD-3-Clause
 License-File: LICENSE
-Keywords: assert,assert_that,assertion,assertthat,pytest,test,testing,unittest
+Keywords: assert,assert_that,assertion,assertpy,assertthat,fluent,matchers,pytest,test,testing,type-safe,unittest
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: BSD License
@@ -188,7 +188,6 @@ See the [**Type Safety**](https://solganis.github.io/assertpy2/type-safety/) gui
 - [**Structured errors**](https://solganis.github.io/assertpy2/errors/#structured-errors): `AssertionFailure` with `.actual`, `.expected`, `.diff` attributes.
 - [**Rich pytest diffs**](https://solganis.github.io/assertpy2/errors/#rich-pytest-diffs): recursive structural diffs for lists, sets, strings, dicts, dataclasses, namedtuples, Pydantic models, and matcher-based assertions (`matches_structure()`, `satisfies()`, `each()`). Circular reference protection.
 - [**Snapshot testing**](https://solganis.github.io/assertpy2/testing/#snapshot-testing): store and compare data structures in JSON format.
-- **Property-based tested**: comparison, selective-diff, matcher algebra, and collection logic are checked with [Hypothesis](https://hypothesis.readthedocs.io) against reference semantics, on top of 100% branch coverage.
 
 **Type safety**
 

{assertpy2-2.12.0 → assertpy2-2.14.0}/README.md

@@ -140,7 +140,6 @@ See the [**Type Safety**](https://solganis.github.io/assertpy2/type-safety/) gui
 - [**Structured errors**](https://solganis.github.io/assertpy2/errors/#structured-errors): `AssertionFailure` with `.actual`, `.expected`, `.diff` attributes.
 - [**Rich pytest diffs**](https://solganis.github.io/assertpy2/errors/#rich-pytest-diffs): recursive structural diffs for lists, sets, strings, dicts, dataclasses, namedtuples, Pydantic models, and matcher-based assertions (`matches_structure()`, `satisfies()`, `each()`). Circular reference protection.
 - [**Snapshot testing**](https://solganis.github.io/assertpy2/testing/#snapshot-testing): store and compare data structures in JSON format.
-- **Property-based tested**: comparison, selective-diff, matcher algebra, and collection logic are checked with [Hypothesis](https://hypothesis.readthedocs.io) against reference semantics, on top of 100% branch coverage.
 
 **Type safety**
 

{assertpy2-2.12.0 → assertpy2-2.14.0}/assertpy2/__init__.py

@@ -13,9 +13,10 @@ from .assertpy import (
     soft_fail,
 )
 from .async_assertions import AsyncAssertionBuilder
-from .errors import AssertionFailure, DiffEntry, DiffResult
+from .errors import AssertionFailure, DiffEntry, DiffResult, PollSample, PollTrace
 from .file import contents_of
 from .matchers import Matcher, clear_custom_matchers, match, register_matcher, unregister_matcher
+from .snapshot import SnapshotCreatedWarning
 
 __all__ = [
     "AssertionFailure",
@@ -24,6 +25,9 @@ __all__ = [
     "DiffResult",
     "Matcher",
     "NegatedBuilder",
+    "PollSample",
+    "PollTrace",
+    "SnapshotCreatedWarning",
     "SoftAssertionCollector",
     "WarningLoggingAdapter",
     "__version__",

{assertpy2-2.12.0 → assertpy2-2.14.0}/assertpy2/_compare.py

@@ -2,7 +2,7 @@
 
 ``is_equal_to`` builds a `_CompareConfig` from its ``tolerance``/``comparators`` kwargs and threads it
 through both the boolean comparison (`HelpersMixin._dict_not_equal()`) and the diff/message rendering
-(`BaseMixin._sub_diff_entries()`, `HelpersMixin._dict_err()`).  `_node_decision()` is the single
+(`assertpy2._diff._sub_diff_entries()`, `HelpersMixin._dict_err()`).  `_node_decision()` is the single
 switch both sides consult, so a tolerated or comparator-equal leaf is reported in neither.  With ``config is
 None`` every helper reproduces the engine's historical ``actual != expected`` behavior exactly.
 
@@ -13,12 +13,15 @@ express to the type checker.
 
 from __future__ import annotations
 
+import dataclasses
 import math
 import numbers
 import re
 from dataclasses import dataclass
 from typing import TYPE_CHECKING
 
+from ._introspection import is_mapping_like, is_model_dump_object
+
 if TYPE_CHECKING:
     from collections.abc import Callable
 
@@ -59,6 +62,100 @@ def _build_compare_config(tolerance, comparators) -> _CompareConfig | None:
     return _CompareConfig(tolerance=tolerance, comparators=comparators)
 
 
+def _ambiguous_array_operand(value: object, other: object) -> object | None:
+    """Return the array/frame-like operand whose ``==`` has no single truth value, else ``None``.
+
+    numpy/pandas/polars containers expose ``__array__`` and compare element-wise, so ``bool(a == b)``
+    raises rather than yielding one bool (and a ``DataFrame`` also quacks dict-like, which would otherwise
+    mis-dispatch the comparison).  The ``__array__`` gate keeps the extra comparison off the hot path; the
+    truth test is actually attempted, so 0-d / scalar array values (which *are* truth-testable) pass
+    through unchanged.
+    """
+    for candidate, counterpart in ((value, other), (other, value)):
+        if hasattr(candidate, "__array__"):
+            try:
+                bool(candidate == counterpart)
+            except (ValueError, TypeError):
+                return candidate
+    return None
+
+
+def _array_equality_error(method: str, operand: object) -> TypeError:
+    """Build the actionable error raised when ``method`` is given an element-wise array/frame-like."""
+    return TypeError(
+        f"{method}() cannot directly compare <{type(operand).__name__}>: its '==' is element-wise and has"
+        " no single truth value. Compare the value's own equality (e.g."
+        " assert_that(actual.equals(expected)).is_true()), assert on extracted scalars (columns, shape,"
+        " length), or use satisfies(...) with an explicit predicate."
+    )
+
+
+def _find_ambiguous_operand(actual, expected, _seen=None):
+    """Locate the array/frame-like member that broke a comparison, walking the diff engine's containers.
+
+    Cold error-path only; ``None`` means the error was not array-caused and must be re-raised unchanged.
+    """
+    if _seen is None:
+        _seen = set()
+    pair = (id(actual), id(expected))
+    if pair in _seen:
+        return None
+    _seen = _seen | {pair}
+    operand = _ambiguous_array_operand(actual, expected)
+    if operand is not None:
+        return operand
+    if is_mapping_like(actual) and is_mapping_like(expected):
+        expected_keys = set(expected)
+        for key in actual:
+            if key in expected_keys:
+                found = _find_ambiguous_operand(actual[key], expected[key], _seen)
+                if found is not None:
+                    return found
+        return None
+    if (
+        dataclasses.is_dataclass(actual)
+        and not isinstance(actual, type)
+        and dataclasses.is_dataclass(expected)
+        and not isinstance(expected, type)
+    ):
+        for field in dataclasses.fields(actual):
+            found = _find_ambiguous_operand(getattr(actual, field.name), getattr(expected, field.name, None), _seen)
+            if found is not None:
+                return found
+        return None
+    if is_model_dump_object(actual) and is_model_dump_object(expected):
+        return _find_ambiguous_operand(actual.model_dump(), expected.model_dump(), _seen)
+    if isinstance(actual, (list, tuple)) and isinstance(expected, (list, tuple)):
+        for actual_item, expected_item in zip(actual, expected, strict=False):
+            found = _find_ambiguous_operand(actual_item, expected_item, _seen)
+            if found is not None:
+                return found
+    return None
+
+
+def _guarded_not_equal(actual, expected, *, method="is_equal_to") -> bool:
+    """``bool(actual != expected)``, converting the ambiguity raised from *inside* a container's ``==``
+    (where the top-level operand gate cannot see the array member) into the actionable ``TypeError``."""
+    try:
+        return bool(actual != expected)
+    except (ValueError, TypeError) as error:
+        operand = _find_ambiguous_operand(actual, expected)
+        if operand is None:
+            raise
+        raise _array_equality_error(method, operand) from error
+
+
+def _guarded_equal(actual, expected, *, method) -> bool:
+    """``bool(actual == expected)`` with the same nested array/frame-like guard as `_guarded_not_equal`."""
+    try:
+        return bool(actual == expected)
+    except (ValueError, TypeError) as error:
+        operand = _find_ambiguous_operand(actual, expected)
+        if operand is None:
+            raise
+        raise _array_equality_error(method, operand) from error
+
+
 def _is_real_number(value) -> bool:
     """Return whether ``value`` is a real number eligible for tolerance (excludes ``bool`` and ``complex``).
 
@@ -114,7 +211,7 @@ def _node_decision(actual, expected, config: _CompareConfig | None, *, field=Non
             return "equal" if comparator(actual, expected) else "leaf"
         if config.tolerance is not None and _is_real_number(actual) and _is_real_number(expected):
             return "equal" if _within_tolerance(actual, expected, config.tolerance) else "leaf"
-    return "recurse" if actual != expected else "equal"
+    return "recurse" if _guarded_not_equal(actual, expected) else "equal"
 
 
 def _spec_matches(key, value, specs) -> bool: