# Pytest soft asserts.
[](https://coveralls.io/github/etuzon/pytohn-nrt-pytest-soft-asserts)
[](https://app.deepsource.com/gh/etuzon/python-nrt-pytest-soft-asserts/?ref=repository-badge)
### Supported asserts:
| Assert | Description | Example | Return |
|-------------------------------------------------------------|---------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------|----------------------------------------------------|
| assert_true(condition, message=None) | Verify that condition is True | soft_asserts.assert_true(a == b) | True if assertion passes, False if assertion fails |
| assert_false(condition, message=None) | Verify that condition is False | soft_asserts.assert_false(a == b) | True if assertion passes, False if assertion fails |
| assert_equal(first, second, message=None) | Verify that first is equal to second | soft_asserts.assert_equal(a, b) | True if assertion passes, False if assertion fails |
| assert_not_equal(first, second, message=None) | Verify that first is not equal to second | soft_asserts.assert_not_equal(a, b) | True if assertion passes, False if assertion fails |
| assert_is(first, second, message=None) | Verify that first and second are the same object | soft_asserts.assert_is(a, b) | True if assertion passes, False if assertion fails |
| assert_is_not(first, second, message=None) | Verify that first and second are not the same object | soft_asserts.assert_is_not(a, b) | True if assertion passes, False if assertion fails |
| assert_is_none(obj, message=None) | Verify that obj is None | soft_asserts.assert_is_none(a) | True if assertion passes, False if assertion fails |
| assert_is_not_none(obj, message=None) | Verify that obj is not None | soft_asserts.assert_is_not_none(a) | True if assertion passes, False if assertion fails |
| assert_in(obj, container, message=None) | Verify that obj is in container | soft_asserts.assert_in(a, [a, b, c]) | True if assertion passes, False if assertion fails |
| assert_not_in(obj, container, message=None) | Verify that obj is not in container | soft_asserts.assert_not_in(a, [b, c]) | True if assertion passes, False if assertion fails |
| assert_is_instance(obj, cls, message=None) | Verify that obj is instance of cls | soft_asserts.assert_is_instance(a, A) | True if assertion passes, False if assertion fails |
| assert_is_not_instance(obj, cls, message=None) | Verify that obj is not instance of cls | soft_asserts.assert_is_not_instance(a, B) | True if assertion passes, False if assertion fails |
| assert_almost_equal(first, second, delta, message=None) | Verify that first is almost equal to second<br/>and the different is equal or less to delta | soft_asserts.assert_almost_equal(1.001, 1.002, 0.1) | True if assertion passes, False if assertion fails |
| assert_not_almost_equal(first, second, delta, message=None) | Verify that first is not almost equal to second<br/>and the different is more than delta | soft_asserts.assert_not_almost_equal(1.001, 1.002, 0.00001) | True if assertion passes, False if assertion fails |
| assert_raises(exception, method: Callable, *args, **kwargs) | Verify that method execution raise exception | soft_asserts.assert_raises(TypeError, sum, 'a', 2) | True if assertion passes, False if assertion fails |
| assert_raises_with(exception, message=None) | Verify that execution in 'with' block raise exception | with soft_asserts.assert_raised_with(ValueError):<br/> raise ValueError(ERROR_MESSAGE_1) | |
In the end of each test, the soft asserts will be verified and the test will be marked as failed if any of the asserts failed.<br/>
To verify the soft asserts in the middle of the test, call `soft_asserts.assert_all()`.<br/>
<br/>
assert_all() will raise _AssertionError_ if any of the asserts failed.
<br/>
#### Steps
Each testing section can be divided to steps.<br/>
The meaning of this is that if one of the asserts in a step failed,<br/>
then the step will be entered to list of failure steps and next test can be skipped<br/>
if it is depended on the failed step.<br/>
Example:
To make test be skipped if step failed, a custom marker should be created.
This is an example of such custom marker, but user can create its own custom marker.
In conftest.py file:
```python
import pytest
@pytest.fixture(autouse=True)
def run_before_test(request):
markers = request.node.own_markers
for marker in markers:
if marker.name == 'soft_asserts':
marker_params = marker.kwargs
soft_asserts = marker_params['soft_asserts']
skip_steps = marker_params['skip_steps']
for step in skip_steps:
if soft_asserts.is_step_in_failure_steps(step):
pytest.skip(f'Skipped because [{step}] failed.')
```
```python
import pytest
from nrt_pytest_soft_asserts.soft_asserts import SoftAsserts
soft_asserts = SoftAsserts()
STEP_1 = 'step_1'
STEP_2 = 'step_2'
def test_assert_with_steps():
soft_asserts.set_step(STEP_1)
# result is False
result = soft_asserts.assert_true(False)
# print False
print(result)
soft_asserts.set_step(STEP_2)
soft_asserts.assert_true(False)
# From this code section steps will not be attached to failure asserts
soft_asserts.unset_step()
soft_asserts.assert_true(False)
soft_asserts.assert_all()
@pytest.mark.soft_asserts(soft_asserts=soft_asserts, skip_steps=[STEP_1])
def test_skip_if_step_1_fail():
soft_asserts.assert_true(True)
@pytest.mark.soft_asserts(soft_asserts=soft_asserts, skip_steps=[STEP_2])
def test_skip_if_step_2_fail():
soft_asserts.assert_true(True)
```
#### Print error on each failed assert
Each assertion failure can be printed.<br/>
This can be done by adding logger or by adding a print method.<br/><br/>
In case a logger will be added to soft asserts, then logger.error(message) will be used.<br/>
In case a print method will be added to soft asserts, then print_method(message) will be used.<br/></br>
_logger and print method cannot be added together._<br/><br/>
#### logger example:
```python
import logging
from nrt_pytest_soft_asserts.soft_asserts import SoftAsserts
logger = logging.getLogger('test')
soft_asserts = SoftAsserts()
# logger will be used to print message after each assert fail.
soft_asserts.set_logger(logger)
def test_assert_true_fail():
i = 1
j = 2
# logger.error() will print messages to console for each assert that fails
soft_asserts.assert_true(i + j == 5)
# f'{i} is different from {j}' will be printed by logger.error() after assert will fail
soft_asserts.assert_equal(i, j, f'{i} is different from {j}')
soft_asserts.assert_all()
```
#### print method example:
```python
from nrt_pytest_soft_asserts.soft_asserts import SoftAsserts
def print_method(message):
print(message)
soft_asserts = SoftAsserts()
# print_method will be used to print message after each assert fail.
soft_asserts.set_print_method(print_method)
def test_assert_true_fail():
i = 1
j = 2
# print_method will print messages to console for each assert that fails
soft_asserts.assert_true(i + j == 5)
# f'{i} is different from {j}' will be printed by print_method after assert will fail
soft_asserts.assert_equal(i, j, f'{i} is different from {j}')
soft_asserts.assert_all()
```
Wiki: https://github.com/etuzon/python-nrt-pytest-soft-asserts/wiki
Raw data
{
"_id": null,
"home_page": "https://github.com/etuzon/python-nrt-pytest-soft-asserts",
"name": "nrt-pytest-soft-asserts",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "python,python3,python-3,nrt,pytest,soft,assert,asserts,assertion,assertions,soft-assert,soft-asserts,soft-assertion,soft-assertions,nrt-pytest-soft-asserts",
"author": "Eyal Tuzon",
"author_email": "Eyal Tuzon <eyal.tuzon.dev@gmail.com>",
"download_url": "",
"platform": null,
"description": "# Pytest soft asserts.\r\n\r\n\r\n\r\n\r\n\r\n\r\n[](https://coveralls.io/github/etuzon/pytohn-nrt-pytest-soft-asserts)\r\n\r\n\r\n[](https://app.deepsource.com/gh/etuzon/python-nrt-pytest-soft-asserts/?ref=repository-badge)\r\n\r\n### Supported asserts:\r\n\r\n| Assert | Description | Example | Return |\r\n|-------------------------------------------------------------|---------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------|----------------------------------------------------|\r\n| assert_true(condition, message=None) | Verify that condition is True | soft_asserts.assert_true(a == b) | True if assertion passes, False if assertion fails |\r\n| assert_false(condition, message=None) | Verify that condition is False | soft_asserts.assert_false(a == b) | True if assertion passes, False if assertion fails |\r\n| assert_equal(first, second, message=None) | Verify that first is equal to second | soft_asserts.assert_equal(a, b) | True if assertion passes, False if assertion fails |\r\n| assert_not_equal(first, second, message=None) | Verify that first is not equal to second | soft_asserts.assert_not_equal(a, b) | True if assertion passes, False if assertion fails |\r\n| assert_is(first, second, message=None) | Verify that first and second are the same object | soft_asserts.assert_is(a, b) | True if assertion passes, False if assertion fails |\r\n| assert_is_not(first, second, message=None) | Verify that first and second are not the same object | soft_asserts.assert_is_not(a, b) | True if assertion passes, False if assertion fails |\r\n| assert_is_none(obj, message=None) | Verify that obj is None | soft_asserts.assert_is_none(a) | True if assertion passes, False if assertion fails |\r\n| assert_is_not_none(obj, message=None) | Verify that obj is not None | soft_asserts.assert_is_not_none(a) | True if assertion passes, False if assertion fails |\r\n| assert_in(obj, container, message=None) | Verify that obj is in container | soft_asserts.assert_in(a, [a, b, c]) | True if assertion passes, False if assertion fails |\r\n| assert_not_in(obj, container, message=None) | Verify that obj is not in container | soft_asserts.assert_not_in(a, [b, c]) | True if assertion passes, False if assertion fails |\r\n| assert_is_instance(obj, cls, message=None) | Verify that obj is instance of cls | soft_asserts.assert_is_instance(a, A) | True if assertion passes, False if assertion fails |\r\n| assert_is_not_instance(obj, cls, message=None) | Verify that obj is not instance of cls | soft_asserts.assert_is_not_instance(a, B) | True if assertion passes, False if assertion fails |\r\n| assert_almost_equal(first, second, delta, message=None) | Verify that first is almost equal to second<br/>and the different is equal or less to delta | soft_asserts.assert_almost_equal(1.001, 1.002, 0.1) | True if assertion passes, False if assertion fails |\r\n| assert_not_almost_equal(first, second, delta, message=None) | Verify that first is not almost equal to second<br/>and the different is more than delta | soft_asserts.assert_not_almost_equal(1.001, 1.002, 0.00001) | True if assertion passes, False if assertion fails |\r\n| assert_raises(exception, method: Callable, *args, **kwargs) | Verify that method execution raise exception | soft_asserts.assert_raises(TypeError, sum, 'a', 2) | True if assertion passes, False if assertion fails |\r\n| assert_raises_with(exception, message=None) | Verify that execution in 'with' block raise exception | with soft_asserts.assert_raised_with(ValueError):<br/> raise ValueError(ERROR_MESSAGE_1) | |\r\n \r\n\r\nIn the end of each test, the soft asserts will be verified and the test will be marked as failed if any of the asserts failed.<br/>\r\nTo verify the soft asserts in the middle of the test, call `soft_asserts.assert_all()`.<br/>\r\n<br/>\r\nassert_all() will raise _AssertionError_ if any of the asserts failed.\r\n\r\n<br/>\r\n#### Steps\r\n\r\nEach testing section can be divided to steps.<br/>\r\nThe meaning of this is that if one of the asserts in a step failed,<br/>\r\nthen the step will be entered to list of failure steps and next test can be skipped<br/>\r\nif it is depended on the failed step.<br/> \r\n\r\nExample:\r\n\r\nTo make test be skipped if step failed, a custom marker should be created.\r\n\r\nThis is an example of such custom marker, but user can create its own custom marker.\r\n\r\nIn conftest.py file:\r\n\r\n```python\r\nimport pytest\r\n\r\n\r\n@pytest.fixture(autouse=True)\r\ndef run_before_test(request):\r\n markers = request.node.own_markers\r\n\r\n for marker in markers:\r\n if marker.name == 'soft_asserts':\r\n marker_params = marker.kwargs\r\n soft_asserts = marker_params['soft_asserts']\r\n skip_steps = marker_params['skip_steps']\r\n\r\n for step in skip_steps:\r\n if soft_asserts.is_step_in_failure_steps(step):\r\n pytest.skip(f'Skipped because [{step}] failed.')\r\n```\r\n\r\n```python\r\nimport pytest\r\nfrom nrt_pytest_soft_asserts.soft_asserts import SoftAsserts\r\n\r\nsoft_asserts = SoftAsserts()\r\n\r\nSTEP_1 = 'step_1'\r\nSTEP_2 = 'step_2'\r\n\r\ndef test_assert_with_steps():\r\n soft_asserts.set_step(STEP_1)\r\n # result is False\r\n result = soft_asserts.assert_true(False)\r\n # print False\r\n print(result) \r\n soft_asserts.set_step(STEP_2) \r\n soft_asserts.assert_true(False)\r\n \r\n # From this code section steps will not be attached to failure asserts\r\n soft_asserts.unset_step()\r\n soft_asserts.assert_true(False)\r\n \r\n soft_asserts.assert_all()\r\n\r\n\r\n@pytest.mark.soft_asserts(soft_asserts=soft_asserts, skip_steps=[STEP_1])\r\ndef test_skip_if_step_1_fail():\r\n soft_asserts.assert_true(True)\r\n\r\n@pytest.mark.soft_asserts(soft_asserts=soft_asserts, skip_steps=[STEP_2])\r\ndef test_skip_if_step_2_fail():\r\n soft_asserts.assert_true(True)\r\n```\r\n\r\n#### Print error on each failed assert\r\n\r\nEach assertion failure can be printed.<br/>\r\nThis can be done by adding logger or by adding a print method.<br/><br/>\r\n\r\nIn case a logger will be added to soft asserts, then logger.error(message) will be used.<br/>\r\n\r\nIn case a print method will be added to soft asserts, then print_method(message) will be used.<br/></br>\r\n\r\n_logger and print method cannot be added together._<br/><br/>\r\n\r\n#### logger example:\r\n\r\n```python\r\nimport logging\r\nfrom nrt_pytest_soft_asserts.soft_asserts import SoftAsserts\r\n\r\n\r\nlogger = logging.getLogger('test')\r\n\r\nsoft_asserts = SoftAsserts()\r\n\r\n# logger will be used to print message after each assert fail.\r\nsoft_asserts.set_logger(logger)\r\n\r\n\r\ndef test_assert_true_fail():\r\n i = 1\r\n j = 2\r\n # logger.error() will print messages to console for each assert that fails\r\n soft_asserts.assert_true(i + j == 5)\r\n # f'{i} is different from {j}' will be printed by logger.error() after assert will fail\r\n soft_asserts.assert_equal(i, j, f'{i} is different from {j}')\r\n soft_asserts.assert_all()\r\n```\r\n\r\n#### print method example:\r\n\r\n```python\r\nfrom nrt_pytest_soft_asserts.soft_asserts import SoftAsserts\r\n\r\ndef print_method(message):\r\n print(message)\r\n\r\nsoft_asserts = SoftAsserts()\r\n\r\n# print_method will be used to print message after each assert fail.\r\nsoft_asserts.set_print_method(print_method)\r\n\r\n\r\ndef test_assert_true_fail():\r\n i = 1\r\n j = 2\r\n # print_method will print messages to console for each assert that fails\r\n soft_asserts.assert_true(i + j == 5)\r\n # f'{i} is different from {j}' will be printed by print_method after assert will fail\r\n soft_asserts.assert_equal(i, j, f'{i} is different from {j}')\r\n soft_asserts.assert_all()\r\n```\r\n\r\nWiki: https://github.com/etuzon/python-nrt-pytest-soft-asserts/wiki\r\n",
"bugtrack_url": null,
"license": "",
"summary": "Soft asserts for pytest",
"version": "1.0.7",
"project_urls": {
"Bug Tracker": "https://github.com/etuzon/python-nrt-pytest-soft-asserts/issues",
"Homepage": "https://github.com/etuzon/python-nrt-pytest-soft-asserts",
"documentation": "https://github.com/etuzon/python-nrt-pytest-soft-asserts/wiki"
},
"split_keywords": [
"python",
"python3",
"python-3",
"nrt",
"pytest",
"soft",
"assert",
"asserts",
"assertion",
"assertions",
"soft-assert",
"soft-asserts",
"soft-assertion",
"soft-assertions",
"nrt-pytest-soft-asserts"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f4c65279e2a6a9321763aa8c0cdb7d3b27936c0d812640a86c675568c56e83b4",
"md5": "5d74fd89fc06320a73701cd099d9e2ad",
"sha256": "61a4214b3dd0b1ad6e1bae4ecac27f96d8d425f22d33eb9f5a123834fc6d6360"
},
"downloads": -1,
"filename": "nrt_pytest_soft_asserts-1.0.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5d74fd89fc06320a73701cd099d9e2ad",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 6509,
"upload_time": "2023-10-16T05:30:20",
"upload_time_iso_8601": "2023-10-16T05:30:20.977655Z",
"url": "https://files.pythonhosted.org/packages/f4/c6/5279e2a6a9321763aa8c0cdb7d3b27936c0d812640a86c675568c56e83b4/nrt_pytest_soft_asserts-1.0.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-16 05:30:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "etuzon",
"github_project": "python-nrt-pytest-soft-asserts",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [],
"lcname": "nrt-pytest-soft-asserts"
}
JSON
