Asserto:
Asserto is a clean, fluent and powerful assertion library for python. We recommend using pytest as a test
runner but asserto will work well with any test runner.
Asserto was developed using pytest as it's test runner and has a
pytest-assertoplugin that exposes asserto through a fixture. Asserto will work on any runner or even without one. Note: It is common practice for a test runner to apply assertion rewriting to change the behaviour of theassertkeyword under the hood.
The main features of asserto are (and will be):
- Chainable and Fluent API.
- Ability for both
HardandSoftassertions. - Rich diffs to highlight problems, reduce churn and improve efficiency and debug-ability.
- Dynamic assertions; check any obj attribute or invoke any of its function types.
- Robust set of methods out of the box for common types.
- Extensibility. Bolt on your own assertions at runtime.
- Human error detection, elaborate warnings when something is amiss.
- Much more to come.
Feature Set:
Fluent API:
Asserto exposes a fully fluent API for chaining assertions against a value.
from asserto import asserto
def test_multiple_assert_fluency() -> None:
asserto("Hello").has_length(5).match(r"\w{5}$").ends_with("lo").starts_with("Hel")
Soft Assertions:
Asserto Has soft capabilities; allowing multiple assertions to be performed before failing with a
summary of the failures.
from asserto import asserto
def test_baz() -> None:
with asserto("Baz") as context:
# asserto when used in a python context is run in 'soft' mode;
# upon exiting the context; congregated errors are subsequently raised (if any)
context.starts_with("B").ends_with("z").is_equal_to("Baz").has_length(2) # Ends in a failure.
Will result in the following:
def test_foo(asserto) -> None:
> with asserto("Bar") as context:
E AssertionError: 1 Soft Assertion Failures
E [AssertionError("Length of: 'Bar' was not equal to: 2")]
Exception Handling:
Asserto has the ability to assert exceptions are raised on callables using a simple API.
from asserto import asserto
import typing
def simple_callable(x: int) -> typing.NoReturn:
raise ValueError(x)
def test_exc_handling():
asserto(simple_callable).should_raise(ValueError).when_called_with(25)
Dynamic Lookups:
Asserto has the ability to dynamically lookup attributes on any object type. This is
handled using the attr_is(expected) syntax.
from asserto import asserto
class Foo:
def __init__(self, x) -> None:
self.x = x
def double_x(self) -> int:
return self.x * 2
def test_foo_dynamically() -> None:
# dynamically looking up `x` (attr) or `double_x` bound method & invoking it!
asserto(Foo(10)).x_is(10).double_x_is(20)
Dynamic assert registration
Asserto allows users to easily bolt on their assertion functions.
from asserto import asserto
from asserto import register_assert
@register_assert # Option 1.
def custom_assert(self):
if self.actual != 5:
self.check_should_raise(f"{self.actual} did not equal five!")
register_assert(custom_assert) # Option 2
def test_user_defined_callables() -> None:
asserto(6).custom_assert()
yields the following:
E AssertionError: 6 did not equal five!
Metadata
Release files for asserto 0.1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| asserto-0.1.4.tar.gz | 19.0 kB | Without provenance | Details for asserto-0.1.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| asserto-0.1.4-py3-none-any.whl | Python 3 | none | any | Details for asserto-0.1.4-py3-none-any.whl |
Total release size: 43.9 kB
Release files / asserto-0.1.4.tar.gz
| Download URL | asserto-0.1.4.tar.gz |
|---|---|
| Size | 19.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
242ace5bd0192bd6471de100ce600bf7ce76dbfade3609845338acd9d61bb4a2
|
|
BLAKE2b-256 checksum How to use checksums |
00f0145a8680165271b1087540d31dd517ac080379aa24ba5c08e2696e26d7d9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.5.1 CPython/3.11.4 Linux/5.15.0-1041-azure
|
Release files / asserto-0.1.4-py3-none-any.whl
| Download URL | asserto-0.1.4-py3-none-any.whl |
|---|---|
| Size | 24.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
42931e63dc3104509a0fbfb0a7320d0bf1f9e18d6f708a1b58dbf027ec6e74d5
|
|
BLAKE2b-256 checksum How to use checksums |
cd89d31c36a2624b29ca7056455b7ab3244e582cf5c4b6757448aa9fd658a703
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.5.1 CPython/3.11.4 Linux/5.15.0-1041-azure
|
Security for asserto 0.1.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.