> ## Documentation Index
> Fetch the complete documentation index at: https://astronomer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# astro dev pytest

> Run unit tests with pytest for dags in a local Airflow environment.

<Info>The behavior and format of this command are the same for both Astro and Astro Private Cloud.</Info>

Run unit tests for your data pipelines on Astro with `pytest`, a testing framework for Python. When you run this command, the Astro CLI creates a local Python environment that includes your dag code, dependencies, and Astro Runtime Docker image. The CLI then runs any pytests in the `tests` directory of your Astro project and shows you the results of those tests in your terminal.

The command runs `pytest` in a container. If your test generates artifacts, such as code coverage reports, you can output the artifacts to the `include` folder of your Astro project so they can be accessed after the test has finished.

For more information on this functionality, see [Test your Astro project locally](/docs/cli/v1.46/test-your-astro-project-locally).

<Info>This command requires Astro Runtime version `3.1.1`+. For more information, see [Astro Runtime Release Notes](/docs/runtime/runtime-release-notes#astro-runtime-3-1-1).</Info>

## Usage

```sh wrap theme={null}
astro dev pytest
```

## Options

| Option | Description | Possible Values |
| - | - | - |
| `<pytest-filepath>` | The filepath to an alternative pytest file or directory. Must be within the `tests` directory | Any valid filepath within the `tests` directory |
| `-a`, `--args` | Arguments to pass to pytest. Surround the args in quotes. | Any set of pytest command arguments surrounded by quotes |
| `--build-secret` | Run `docker build --secret` to mount a secret value to your Docker image. Repeat the flag to mount more than one secret. Replaces the deprecated `--build-secrets` flag. | `id=<your-secret-id>, src=<path-to-secret> .` See [Docker documentation](https://docs.docker.com/build/building/secrets/#secret-mounts). |
| `-e`, `--env` | The filepath to your environment variables. The default is `.env`) | Any valid filepath within your Astro project |
| `-i`, `--image-name` | The name of a pre-built custom Docker image to use with your project. The image must be available on your local machine. | A valid name for a pre-built Docker image based on Astro Runtime |

## Examples

```bash wrap theme={null}
# Specify env file at root of Astro project
astro dev pytest --env=myAlternativeEnvFile.env

# Specify an argument for pytest
astro dev pytest --args "–-cov-config path"

# Generate a coverage report in the include/coverage.xml file
astro dev pytest --args "--cov --cov-report xml:include/coverage.xml"
```

## Related commands

* [`astro dev init`](/docs/cli/v1.46/astro-dev-init)
* [`astro dev start`](/docs/cli/v1.46/astro-dev-start)
* [`astro deploy`](/docs/cli/v1.46/astro-deploy)