Common commands

A list of common Viash commands to develop and test components.

Below is a list of common Viash commands to develop and test components. Check out this Cheat sheet to get a printable version of the same information. Please visit the Viash guide or reference documentation for more in-depth information.

Download test data

This command will download the all of the test resources from the S3 bucket and store them under resources_test/.

scripts/create_datasets/test_resources.sh

Build all components

Build all components in a namespace.

scripts/project/build_all_components.sh

Build all docker containers

Build all docker containers.

scripts/project/build_all_docker_containers.sh

Test a component

Test one component:

viash test path/to/config.vsh.yaml

Run all tests in a task:

scripts/project/test_all_components.sh

Edit script

This command will auto-generate the VIASH STARTVIASH END codeblock in your script:

viash config inject path/to/config.vsh.yaml

Run a component

Display the help text of a component.

viash run path/to/config.vsh.yaml -- --help

Run a component with arguments:

viash run path/to/config.vsh.yaml -- --input dataset.h5ad --output output.h5ad

View Dockerfile

Use this command to view the component’s Dockerfile.

viash run path/to/config.vsh.yaml -engine docker -- ---dockerfile