astro dev pytest

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

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.

This command requires Astro Runtime version 4.1.0+. For more information, see Astro Runtime Release Notes.

Usage

1 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-secrets`	Run `docker build --secret` to mount a secret value to your Docker image.	`id=<your-secret-id>, src=<path-to-secret> .` See Docker documentation.
`-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

$ # 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"

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

For more information on this functionality, see Test your Astro project locally.

This command requires Astro Runtime version 4.1.0+. For more information, see Astro Runtime Release Notes.

Usage

1 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-secrets`	Run `docker build --secret` to mount a secret value to your Docker image.	`id=<your-secret-id>, src=<path-to-secret> .` See Docker documentation.
`-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

$ # 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"

$	# 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"

Usage

Options

Examples

Related Commands

Usage

Options

Examples

Related Commands