# Validate.assert_passing()

Raise an `AssertionError` if all tests are not passing.

Usage

[Source](https://github.com/posit-dev/pointblank/blob/main/pointblank/validate.py#L18930-L19001)

``` python
Validate.assert_passing()
```

The [assert_passing()](../reference/Validate.assert_passing.md#pointblank.Validate.assert_passing) method will raise an `AssertionError` if a test does not pass. This method simply wraps [`all_passed()`](../reference/Validate.all_passed.md#pointblank.Validate.all_passed) for more ready use in test suites. The step number and assertion made is printed in the `AssertionError` message if a failure occurs, ensuring some details are preserved.

If the validation has not yet been interrogated, this method will automatically call [`interrogate()`](../reference/Validate.interrogate.md#pointblank.Validate.interrogate) with default parameters before checking for passing tests.

## Raises

`AssertionError`  
If any validation step has failing test units.

## Examples

In the example below, we'll use a simple Polars DataFrame with three columns (`a`, `b`, and `c`). There will be three validation steps, and the second step will have a failing test unit (the value `10` isn't less than `9`). The [assert_passing()](../reference/Validate.assert_passing.md#pointblank.Validate.assert_passing) method is used to assert that all validation steps passed perfectly, automatically performing the interrogation if needed.

``` python
import pointblank as pb
import polars as pl

tbl = pl.DataFrame(
    {
    "a": [1, 2, 9, 5],
    "b": [5, 6, 10, 3],
    "c": ["a", "b", "a", "a"],
    }
)

validation = (
    pb.Validate(data=tbl)
    .col_vals_gt(columns="a", value=0)
    .col_vals_lt(columns="b", value=9) # this assertion is false
    .col_vals_in_set(columns="c", set=["a", "b"])
)

# No need to call `interrogate()` explicitly
validation.assert_passing()
```

    ---------------------------------------------------------------------------
    AssertionError                            Traceback (most recent call last)
    Cell In[1], line 20
         16     .col_vals_in_set(columns="c", set=["a", "b"])
         17 )
         18 
         19 # No need to call `interrogate()` explicitly
    ---> 20 validation.assert_passing()

    File ~/work/pointblank/pointblank/pointblank/validate.py:19001, in Validate.assert_passing(self)
      18997             ]
      18998             msg = "The following assertions failed:\n" + "\n".join(
      18999                 [f"- Step {i + 1}: {autobrief}" for i, autobrief in failed_steps]
      19000             )
    > 19001             raise AssertionError(msg)

    AssertionError: The following assertions failed:
    - Step 2: Expect that values in `b` should be < `9`.

The `AssertionError` lists each step that had failing test units, here only step 2, with a description of what it expected. In a test suite (with pytest, for instance) or a CI job, that error fails the run, which is the point: the data can't move on until it passes every check. When a few failures are acceptable, set thresholds on the plan and use [`assert_below_threshold()`](../reference/Validate.assert_below_threshold.md#pointblank.Validate.assert_below_threshold) instead.