# Pipeline Unit Test

## Pipeline Unit Test

### Description

![Test tube icon](/files/RgaFVu7pzReK4Ss61Jpj)

Describes a test for a pipeline. During the test, alternative data sets are used as input from a given transform and testing output against a golden data set.

When the result set produced by the pipeline execution matches the expected result (golden data set), the test succeeds. If the generated results do not match what was expected, the test fails.

Specific transforms in a pipeline can be bypassed or removed for testing for additional flexibility.

Additionally, unit tests can be executed in bulk.

Check [Pipeline Unit Testing](/data-shaper-1.21/knowing-the-data-shaper-designer/pipelines/pipeline-unit-testing.md) for more details.

### Related Plugins

None/All

### Options

| Option                                           | Default     | Description                                                                                                                              |
| ------------------------------------------------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Name                                             |             | the name to use for this unit test                                                                                                       |
| Description                                      |             | the description to use for this unit test                                                                                                |
| Type of test                                     | Development | 'Development' or 'unit test'                                                                                                             |
| The pipeline to test                             |             | the pipeline that will be tested by this unit test                                                                                       |
| Test pipeline filename (Optional)                |             |                                                                                                                                          |
| Base test path (or use HOP\_UNIT\_TESTS\_FOLDER) |             |                                                                                                                                          |
| Select this test automatically                   | false       |                                                                                                                                          |
| Replace a database connection with another       |             | List of database connections in the pipeline to test (Original DB) to replace by database connections in this unit test (Replacement DB) |
| Variables                                        |             | list of variable names and values to use for this test                                                                                   |

### Samples

```
None
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.primeur.com/data-shaper-1.21/knowing-the-data-shaper-designer/index-2/pipeline-unit-test.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.