viash ns list
List a namespace containing many viash config files.
Usage:
viash ns list [-n nmspc] [-s src] [-p docker]
Arguments
-c, --config_mod …
Modify a viash config at runtime using a custom DSL.
-f, --format
Which output format to use. Choices: yaml, json
-l, --parallel
Whether or not to run the process in parallel.
-p, --platform
Acts as a regular expression to filter the platform ids specified in the found config files. If this is not provided, all platforms will be used. If no platforms are defined in a config, the native platform will be used. In addition, the path to a platform yaml file can also be specified.
-q, --query
Filter which components get selected by name and namespace. Can be a regex. Example: “^mynamespace/component1$”.
--query_name
Filter which components get selected by name. Can be a regex. Example: “^component1”.
-n, --query_namespace
Filter which namespaces get selected by namespace. Can be a regex. Example: “^mynamespace$”.
-s, --src
A source directory containing viash config files, possibly structured in a hierarchical folder structure. Default: src/.
-h, --help
Show help message
Examples
List a namespace without arguments
When no arguments are given, the ns list command prints a parsed
version of all config files in a
subdirectory named src to the terminal. This includes all fields,
even those that were not given values in the config file itself.
See Namespaces for an overview of how you
should structure your components for this to work correctly.
viash ns list
After running this command, you’ll see a list similar to this:
- functionality:
name: "download_files"
namespace: "my_namespace"
authors: []
arguments:
- type: "string"
name: "url"
alternatives: []
required: false
direction: "Input"
multiple: true
multiple_sep: " "
- type: "string"
name: "--filter"
alternatives: []
required: false
direction: "Input"
multiple: false
multiple_sep: ":"
resources:
- type: "bash_script"
path: "script.sh"
is_executable: true
...
Specifying a source folder and a namespace
In order for namespace querying to work, make sure your config files include a namespace field. The command below searches the my_components_dir directory for all Viash components in the my_namespace namespace and prints out the config information to the terminal.
viash ns list --src 'my_components_dir' -n 'my_namespace'
Filter a specific component to list
This lists any Viash components where the name contains “parse”:
viash ns list --query_name "parse"
Override a namespace with config mods
List a Viash namespace and use a config mod to override the config files.
viash ns list -p docker \
-c '.platforms[.type == "docker"].setup_strategy := "pull"' \
-c '.platforms[.type == "docker"].image := "bash:latest"'