assertpy2 2.1.4__tar.gz → 2.3.0__tar.gz

{assertpy2-2.1.4 → assertpy2-2.3.0}/.github/workflows/ci.yml

@@ -16,10 +16,10 @@ jobs:
       matrix:
         python-version: ["3.10", "3.11", "3.12", "3.13", "3.14", "3.15"]
     steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
 
       - name: Install uv
-        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
 
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
@@ -38,7 +38,7 @@ jobs:
 
       - name: Upload coverage to Codecov
         if: matrix.python-version == '3.14'
-        uses: codecov/codecov-action@cddd853df119a48c5be31a973f8cd97e12e35e16 # v6.0.1
+        uses: codecov/codecov-action@e79a6962e0d4c0c17b229090214935d2e33f8354 # v6.0.1
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           files: coverage.xml
@@ -46,10 +46,10 @@ jobs:
   lint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
 
       - name: Install uv
-        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
 
       - name: Set up Python
         uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0

{assertpy2-2.1.4 → assertpy2-2.3.0}/.github/workflows/codeql.yml

@@ -17,7 +17,7 @@ jobs:
     permissions:
       security-events: write
     steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
       - uses: github/codeql-action/init@f52b05f4acaaa234e44466e66d29050e135ea9ef # v4.36.0
         with:
           languages: python

{assertpy2-2.1.4 → assertpy2-2.3.0}/.github/workflows/publish.yml

@@ -16,10 +16,10 @@ jobs:
       contents: write
       attestations: write
     steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
 
       - name: Install uv
-        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
 
       - name: Set up Python
         uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0

{assertpy2-2.1.4 → assertpy2-2.3.0}/.github/workflows/scorecard.yml

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

{assertpy2-2.1.4 → assertpy2-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: assertpy2
-Version: 2.1.4
+Version: 2.3.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
@@ -27,6 +27,10 @@ Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Testing
 Requires-Python: >=3.10
 Requires-Dist: typing-extensions>=4.0
+Provides-Extra: allure
+Requires-Dist: allure-pytest>=2.13; extra == 'allure'
+Provides-Extra: behave
+Requires-Dist: behave>=1.2.6; extra == 'behave'
 Description-Content-Type: text/markdown
 
 <p align="center">
@@ -126,7 +130,7 @@ FAILED test_example.py::test_comparison
 | **Async assertions** | No | No | No | **eventually() with polling** |
 | **Soft assertions** | No | No | Yes (not thread-safe) | **Yes (thread-safe, async-safe)** |
 | **Structured errors** | Rewrite only | Mismatch string | String only | **.actual .expected .diff** |
-| **Maintained** | N/A | Minimal | 2020 | **Active (2026)** |
+| **Maintained** | N/A | Minimal | 2020 | **Active** |
 
 </div>
 
@@ -167,6 +171,8 @@ assert_that(items).is_type_of(list).is_length(3).contains("admin")
 - **Extracting**: flatten collections on attributes with `filter` and `sort` support.
 - **File assertions**: `exists()`, `is_file()`, `is_readable()`, `is_writable()`, `is_executable()` with `pathlib.Path` support.
 - **Snapshot testing**: store and compare data structures in JSON format, inspired by Jest.
+- **Allure integration**: auto-attach structured diff and actual/expected data to Allure reports.
+- **Behave step matchers**: ready-made parameter types (`PositiveInt`, `BoolLike`, etc.) for Behave step definitions.
 - **Extensions**: add custom assertions via `add_extension()`.
 - Strings, numbers, lists, tuples, sets, dicts, dates, booleans, objects, exceptions.
 
@@ -194,7 +200,7 @@ assert_that("hello").satisfies(~match.equal_to("world"))
 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`.
+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`, `is_zero`, `is_even`, `is_odd`, `is_divisible_by`, `is_callable`, `is_in`, `has_property`, `contains_string`, `matches_regex`, `is_uuid`, `is_non_empty_string`, `ignore`, `each_item`, `structure`.
 
 
 ## Structural matching
@@ -347,19 +353,67 @@ assert_that({"a": 1, "b": 2, "c": 3}).snapshot()
 ```py
 from assertpy2 import add_extension
 
-def is_even(self):
-    if self.val % 2 != 0:
-        return self.error(f'{self.val} is not even!')
+def is_5(self):
+    if self.val != 5:
+        return self.error(f'{self.val} is NOT 5!')
     return self
 
-add_extension(is_even)
+add_extension(is_5)
 
-assert_that(4).is_even()
+assert_that(5).is_5()
 ```
 
 See the [full API reference](docs/api.md) for all assertion methods, examples, and advanced features.
 
 
+## Allure integration
+
+When `allure-pytest` is installed, the pytest plugin auto-attaches structured failure data to Allure reports as JSON attachments.
+
+```bash
+pip install assertpy2[allure]
+```
+
+Three modes controlled via `pytest.ini` (or `pyproject.toml`):
+
+| Mode | What is attached |
+|---|---|
+| `diff` (default) | Structured Diff JSON (path-level breakdown) |
+| `full` | Structured Diff + actual/expected JSON |
+| `off` | Nothing |
+
+```toml
+# pyproject.toml
+[tool.pytest.ini_options]
+assertpy2_allure = "full"
+```
+
+
+## Behave step matchers
+
+Ready-made parameter types for Behave step definitions:
+
+```bash
+pip install assertpy2[behave]
+```
+
+```py
+# in environment.py or steps/conftest.py
+from assertpy2.behave_matchers import register_assertpy_types
+register_assertpy_types()
+```
+
+Then use in step definitions:
+
+```py
+@given('a user aged {age:PositiveInt}')
+def step_impl(context, age):
+    context.age = age  # already validated as int > 0
+```
+
+Available types: `PositiveInt`, `NonNegativeInt`, `PositiveFloat`, `NonEmptyString`, `BoolLike`.
+
+
 ## Migration from assertpy
 
 assertpy2 is a drop-in replacement for Python 3.10+. Change the import, everything else works:

{assertpy2-2.1.4 → assertpy2-2.3.0}/README.md

@@ -95,7 +95,7 @@ FAILED test_example.py::test_comparison
 | **Async assertions** | No | No | No | **eventually() with polling** |
 | **Soft assertions** | No | No | Yes (not thread-safe) | **Yes (thread-safe, async-safe)** |
 | **Structured errors** | Rewrite only | Mismatch string | String only | **.actual .expected .diff** |
-| **Maintained** | N/A | Minimal | 2020 | **Active (2026)** |
+| **Maintained** | N/A | Minimal | 2020 | **Active** |
 
 </div>
 
@@ -136,6 +136,8 @@ assert_that(items).is_type_of(list).is_length(3).contains("admin")
 - **Extracting**: flatten collections on attributes with `filter` and `sort` support.
 - **File assertions**: `exists()`, `is_file()`, `is_readable()`, `is_writable()`, `is_executable()` with `pathlib.Path` support.
 - **Snapshot testing**: store and compare data structures in JSON format, inspired by Jest.
+- **Allure integration**: auto-attach structured diff and actual/expected data to Allure reports.
+- **Behave step matchers**: ready-made parameter types (`PositiveInt`, `BoolLike`, etc.) for Behave step definitions.
 - **Extensions**: add custom assertions via `add_extension()`.
 - Strings, numbers, lists, tuples, sets, dicts, dates, booleans, objects, exceptions.
 
@@ -163,7 +165,7 @@ assert_that("hello").satisfies(~match.equal_to("world"))
 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`.
+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`, `is_zero`, `is_even`, `is_odd`, `is_divisible_by`, `is_callable`, `is_in`, `has_property`, `contains_string`, `matches_regex`, `is_uuid`, `is_non_empty_string`, `ignore`, `each_item`, `structure`.
 
 
 ## Structural matching
@@ -316,19 +318,67 @@ assert_that({"a": 1, "b": 2, "c": 3}).snapshot()
 ```py
 from assertpy2 import add_extension
 
-def is_even(self):
-    if self.val % 2 != 0:
-        return self.error(f'{self.val} is not even!')
+def is_5(self):
+    if self.val != 5:
+        return self.error(f'{self.val} is NOT 5!')
     return self
 
-add_extension(is_even)
+add_extension(is_5)
 
-assert_that(4).is_even()
+assert_that(5).is_5()
 ```
 
 See the [full API reference](docs/api.md) for all assertion methods, examples, and advanced features.
 
 
+## Allure integration
+
+When `allure-pytest` is installed, the pytest plugin auto-attaches structured failure data to Allure reports as JSON attachments.
+
+```bash
+pip install assertpy2[allure]
+```
+
+Three modes controlled via `pytest.ini` (or `pyproject.toml`):
+
+| Mode | What is attached |
+|---|---|
+| `diff` (default) | Structured Diff JSON (path-level breakdown) |
+| `full` | Structured Diff + actual/expected JSON |
+| `off` | Nothing |
+
+```toml
+# pyproject.toml
+[tool.pytest.ini_options]
+assertpy2_allure = "full"
+```
+
+
+## Behave step matchers
+
+Ready-made parameter types for Behave step definitions:
+
+```bash
+pip install assertpy2[behave]
+```
+
+```py
+# in environment.py or steps/conftest.py
+from assertpy2.behave_matchers import register_assertpy_types
+register_assertpy_types()
+```
+
+Then use in step definitions:
+
+```py
+@given('a user aged {age:PositiveInt}')
+def step_impl(context, age):
+    context.age = age  # already validated as int > 0
+```
+
+Available types: `PositiveInt`, `NonNegativeInt`, `PositiveFloat`, `NonEmptyString`, `BoolLike`.
+
+
 ## Migration from assertpy
 
 assertpy2 is a drop-in replacement for Python 3.10+. Change the import, everything else works:

{assertpy2-2.1.4 → assertpy2-2.3.0}/assertpy2/_typing.py

@@ -27,6 +27,8 @@ if TYPE_CHECKING:
         def is_type_of(self, some_type: type) -> Self: ...
         def is_instance_of(self, some_class: type) -> Self: ...
         def is_length(self, length: int) -> Self: ...
+        def is_callable(self) -> Self: ...
+        def is_not_callable(self) -> Self: ...
         def satisfies(self, matcher: Matcher | Callable[..., bool]) -> Self: ...
         # ContainsMixin - universal
         def is_in(self, *items: object) -> Self: ...
@@ -48,6 +50,10 @@ if TYPE_CHECKING:
         def is_digit(self) -> Self: ...
         def is_lower(self) -> Self: ...
         def is_upper(self) -> Self: ...
+        def is_alphanumeric(self) -> Self: ...
+        def is_whitespace(self) -> Self: ...
+        def contains_any_of(self, *items: str) -> Self: ...
+        def contains_none_of(self, *items: str) -> Self: ...
         def is_unicode(self) -> Self: ...
         # ContainsMixin
         def contains(self, *items: object) -> Self: ...
@@ -56,6 +62,8 @@ if TYPE_CHECKING:
         def contains_sequence(self, *items: object) -> Self: ...
         def contains_duplicates(self) -> Self: ...
         def does_not_contain_duplicates(self) -> Self: ...
+        def contains_exactly(self, *items: object) -> Self: ...
+        def contains_in_order(self, *items: object) -> Self: ...
         def is_empty(self) -> Self: ...
         def is_not_empty(self) -> Self: ...
 
@@ -74,6 +82,9 @@ if TYPE_CHECKING:
         def is_less_than_or_equal_to(self, other: object) -> Self: ...
         def is_positive(self) -> Self: ...
         def is_negative(self) -> Self: ...
+        def is_even(self) -> Self: ...
+        def is_odd(self) -> Self: ...
+        def is_divisible_by(self, divisor: int) -> Self: ...
         def is_between(self, low: object, high: object) -> Self: ...
         def is_not_between(self, low: object, high: object) -> Self: ...
         def is_close_to(self, other: object, tolerance: object) -> Self: ...
@@ -89,6 +100,8 @@ if TYPE_CHECKING:
         def contains_sequence(self, *items: object) -> Self: ...
         def contains_duplicates(self) -> Self: ...
         def does_not_contain_duplicates(self) -> Self: ...
+        def contains_exactly(self, *items: object) -> Self: ...
+        def contains_in_order(self, *items: object) -> Self: ...
         def is_empty(self) -> Self: ...
         def is_not_empty(self) -> Self: ...
         # CollectionMixin
@@ -100,6 +113,9 @@ if TYPE_CHECKING:
         def extracting(self, *names: object, **kwargs: object) -> Self: ...
         # BaseMixin
         def each(self, matcher: Matcher | Callable[..., bool]) -> Self: ...
+        def any_satisfy(self, matcher: Matcher | Callable[..., bool]) -> Self: ...
+        def all_satisfy(self, matcher: Matcher | Callable[..., bool]) -> Self: ...
+        def none_satisfy(self, matcher: Matcher | Callable[..., bool]) -> Self: ...
 
     class _DictAssertion(_CoreAssertion, Protocol):
         """Assertions available for ``dict`` values."""
@@ -127,6 +143,8 @@ if TYPE_CHECKING:
 
         def is_before(self, other: object) -> Self: ...
         def is_after(self, other: object) -> Self: ...
+        def is_before_or_equal_to(self, other: object) -> Self: ...
+        def is_after_or_equal_to(self, other: object) -> Self: ...
         def is_equal_to_ignoring_milliseconds(self, other: object) -> Self: ...
         def is_equal_to_ignoring_seconds(self, other: object) -> Self: ...
         def is_equal_to_ignoring_time(self, other: object) -> Self: ...
@@ -148,5 +166,6 @@ if TYPE_CHECKING:
         """Assertions available for callable values."""
 
         def raises(self, ex: type) -> Self: ...
+        def does_not_raise(self, ex: type) -> Self: ...
         def when_called_with(self, *some_args: object, **some_kwargs: object) -> Self: ...
         def eventually(self, *, timeout: float = ..., interval: float = ...) -> AsyncAssertionBuilder: ...

{assertpy2-2.1.4 → assertpy2-2.3.0}/assertpy2/assertpy.py

@@ -160,7 +160,7 @@ def soft_assertions() -> Iterator[None]:
 
     errs = _soft_err.get([])
     if errs and _soft_ctx.get() == 0:
-        out = "soft assertion failures:\n" + "\n".join("%d. %s" % (i + 1, msg) for i, msg in enumerate(errs))
+        out = "soft assertion failures:\n" + "\n".join(f"{i + 1}. {msg}" for i, msg in enumerate(errs))
         _soft_err.set([])
         raise AssertionError(out)
 
@@ -300,7 +300,7 @@ def fail(msg=""):
                 except TypeError as e:
                     assert_that(str(e)).contains('unsupported operand')
     """
-    raise AssertionError("Fail: %s!" % msg if msg else "Fail!")
+    raise AssertionError(f"Fail: {msg}!" if msg else "Fail!")
 
 
 def soft_fail(msg=""):
@@ -332,7 +332,7 @@ def soft_fail(msg=""):
 
     """
     if _soft_ctx.get():
-        _soft_err.get().append("Fail: %s!" % msg if msg else "Fail!")
+        _soft_err.get().append(f"Fail: {msg}!" if msg else "Fail!")
         return
     fail(msg)
 
@@ -427,7 +427,7 @@ class WarningLoggingAdapter(logging.LoggerAdapter):
                 prev = frame
 
         filename, lineno = _unwind(inspect.currentframe())
-        return "[%s:%d]: %s" % (os.path.basename(filename), lineno, msg), kwargs
+        return f"[{os.path.basename(filename)}:{lineno}]: {msg}", kwargs
 
 
 _logger = logging.getLogger("assertpy2")
@@ -512,7 +512,7 @@ class AssertionBuilder(
             AssertionBuilder: returns this instance to chain to the next assertion, but only when
                 ``AssertionError`` is not raised, as is the case when ``kind`` is ``warn`` or ``soft``.
         """
-        out = "%s%s" % ("[%s] " % self.description if len(self.description) > 0 else "", msg)
+        out = f"{f'[{self.description}] ' if len(self.description) > 0 else ''}{msg}"
         if self.kind == "warn":
             self.logger.warning(out)
             return self

{assertpy2-2.1.4 → assertpy2-2.3.0}/assertpy2/async_assertions.py

@@ -73,8 +73,8 @@ class AsyncAssertionBuilder:
                         last_error = exc
                         if loop.time() >= deadline:
                             raise AssertionError(
-                                "Expected condition not met after %.1f seconds. Last failure: %s"
-                                % (self._timeout, last_error)
+                                f"Expected condition not met after {self._timeout:.1f} seconds."
+                                f" Last failure: {last_error}"
                             ) from last_error
                         await asyncio.sleep(self._interval)