Test Client Command Reference
Using Help
The test client itself offers help at any stage of the program. Just include --help
where it's needed.
Help from the Root
ayx-sdk-cli.exe --help
Help from Sub-Commands
ayx-sdk-cli.exe extension --help # help for extension ayx-sdk-cli.exe plugin --help # help for plugin ayx-sdk-cli.exe plugin run --help # help for plugin/run ayx-sdk-cli.exe self --help # help for self
Global Settings
assume-yes
Specify this to answer yes to all prompts and run non-interactively.
thread-pool-size
Specify the number of threads to be used by the test client. The default is the number of CPU/cores on the machine. You might want to adjust this if important tasks are being run in the background.
Logging
This configures the logging options. You can specify log output to stdout or file. The default format is Human but you can specify other formats, such as Bunyan or JSON, as well.
The default logging level is INFO, which is what should be used most of the time. Other logging levels are more verbose, such as TRACE, DEBUG, and WARN ERROR.
log-facility
Log to stdout or file (default is stdout).
log-file
Output location of a file log. If the file already exists, the test client appends to it.
log-format
The test client supports human-readable (default), Bunyan, and JSON.
log-level
Set the log level for the test client. By default this is INFO. Some levels might be extremely verbose.
ayx-sdk-cli.exe plugin run BaseTools\::Passthrough --input input.csv --output test.csv 2022-10-17T19:34:50.144008Z INFO ayx_sdk_cli::cli: User invocation command="ayx-sdk-cli.exe plugin run BaseTools\\::Passthrough --input input.csv --output test.csv" ... 2022-10-17T19:34:50.151119Z INFO ayx_sdk_cli::commands::plugin::run: Extension loaded extension="Passthrough v2.0.0 (runtime target: ayx-sdk-extension-python-3_8_5)" 2022-10-17T19:34:50.153458Z INFO ayx_sdk_cli::commands::plugin::run: Async threadpool threadpool_size=16 2022-10-17T19:34:50.164368Z INFO plugin_execution: ayx_sdk_cli::plugin::tool_process: Extension runtime spawned runtime_pid=11592
/ayx-sdk-cli.exe plugin run BaseTools\::Passthrough --input input.csv --output output.csv --log-level debug 2022-10-17T18:57:02.814839Z INFO ayx_sdk_cli::cli: User invocation command="ayx-sdk-cli.exe plugin run BaseTools\\::Passthrough --input input.csv --output test.csv --log-level debug" ... 2022-10-17T18:57:02.822777Z DEBUG plugin_execution: ayx_sdk_cli::plugin::tool_process: Spawning extention runtime... command="python" ... 2022-10-17T18:57:02.826512Z DEBUG plugin_execution: ayx_sdk_cli::commands::plugin::run::tool_service: Attempting to acquire extension runtime tool service port assignment... 2022-10-17T18:57:03.602284Z INFO plugin_execution: ayx_sdk_cli::commands::plugin::run::tool_service: Acquired port from runtime tool service tool_service_port=53241 2022-10-17T18:57:03.602301Z INFO plugin_execution: tool_client: Connecting to extension runtime tool service tool_service_address="http://localhost:53241"
Commands
Completion
list
Show the available list of shells for which the test client can provide an auto-completion script.
ayx-sdk-cli.exe completion list Bash Zsh PowerShell Elvish ...
show
Provide the auto-completion script for a given shell.
Step 1: Create a new completion file.
ayx-sdk-cli.exe completion show powershell > $profile/ayx-sdk-cli-completions.ps1
Step 2: Add the following to the end of $profile
.
. $PSScriptRoot\ayx-sdk-cli-completions.ps1
Extension
list
List extensions found in the current workspace.
ayx-sdk-cli.exe extension list ... Found 9 extension(s): - ConversionPassthrough v1.0.0 (runtime target: ayx-sdk-extension-python-3_8_5) - Input v2.0.0 (runtime target: ayx-sdk-extension-python-3_8_5) - Optional v2.0.0 (runtime target: ayx-sdk-extension-python-3_8_5) - Passthrough v2.0.0 (runtime target: ayx-sdk-extension-python-3_8_5) - MultipleInputs v2.0.0 (runtime target: ayx-sdk-extension-python-3_8_5) - DcmInput v1.0.0 (runtime target: ayx-sdk-extension-python-3_8_5) - MultiConnection v2.0.0 (runtime target: ayx-sdk-extension-python-3_8_5) - MultipleOutputs v2.0.0 (runtime target: ayx-sdk-extension-python-3_8_5) - Output v2.0.0 (runtime target: ayx-sdk-extension-python-3_8_5)
extension
Provide information about a specific extension.
ayx-sdk-cli.exe extension info Passthrough ... Name : Passthrough Package Name : N/A Description : An example single-input-single-output tool. This tool takes data from the input anchor and, without changing it, writes it to the output anchor. Kind : com.alteryx.sdk.tool Version : 2.0.0 Runtime Target : ayx-sdk-extension-python-3_8_5 Category : Python SDK Examples Copyright : 2022
Plugin
run
Runs a given set of inputs against an SDK plugin. Shows any messages from the plugin in stdout, including responses. Writes any outputs to the specified outputs given.
ayx-sdk-cli.exe plugin run [WORKSPACE_PATH]::[PLUGIN_NAME] --input <[SOURCE][:TYPE[:OPTIONS]][@ANCHOR]> --output <[DESTINATION][:TYPE[:OPTIONS]][@ANCHOR]> --runtime-command
For more information, go to Test Client.
Self
update
Updates the test client to the latest version.
ayx-sdk-cli.exe self update ... Checking target-arch... x86_64-pc-windows-msvc Checking current version... v2022.7.1 Checking latest released version... ...
Version
Displays the test client version.
ayx-sdk-cli.exe version ayx-sdk-cli 2022.7.1 ...