``test`` command ======================================== This section is auto-generated from the help text for the planemo command ``test``. This help message can be generated with ``planemo test --help``. **Usage**:: planemo test [OPTIONS] TOOL_PATH **Help** Run specified tool or workflow tests within Galaxy. All referenced tools (by default all the tools in the current working directory) will be tested and the results quickly summarized. To run these tests planemo needs a Galaxy instance to utilize, planemo will search parent directories to see if any is a Galaxy instance - but one can pick the Galaxy instance to use with the --galaxy_root option or force planemo to download a disposable instance with the ``--install_galaxy`` flag. In addition to to quick summary printed to the console - various detailed output summaries can be configured. ``tool_test_output.html`` (settable via ``--test_output``) will contain a human consumable HTML report describing the test run. A JSON file (settable via ``--test_output_json`` and defaulting to ``tool_test_output.json``) will also be created. These files can can be disabled by passing in empty arguments or globally by setting the values ``default_test_output`` and/or ``default_test_output_json`` in ``~/.planemo.yml`` to ``null``. For continuous integration testing a xUnit-style report can be configured using the ``--test_output_xunit``. planemo uses temporarily generated config files and environment variables to attempt to shield this execution of Galaxy from manually launched runs against that same Galaxy root - but this may not be bullet proof yet so please careful and do not try this against production Galaxy instances. **Options**:: --failed Re-run only failed tests. This command will read tool_test_output.json to determine which tests failed so this file must have been produced with the same set of tool ids previously. --test_index INTEGER Index(es) of specific test(s) to run (1-based). Can be specified multiple times (e.g., --test_index 1 --test_index 3) to run specific tests. If not specified, all tests are run. --polling_backoff INTEGER Poll resources with an increasing interval between requests. Useful when testing against remote and/or production instances to limit generated traffic. --galaxy_root DIRECTORY Root of development galaxy directory to execute command with. --galaxy_python_version [3|3.8|3.9|3.10|3.11|3.12] Python version to start Galaxy under --extra_tools PATH Extra tool sources to include in Galaxy's tool panel (file or directory). These will not be linted/tested/etc... but they will be available to workflows and for interactive use. --install_galaxy Download and configure a disposable copy of Galaxy from github. --galaxy_branch TEXT Branch of Galaxy to target (defaults to master) if a Galaxy root isn't specified. --galaxy_source TEXT Git source of Galaxy to target (defaults to the official galaxyproject github source if a Galaxy root isn't specified. --skip_venv Do not create or source a virtualenv environment for Galaxy, this should be used to preserve an externally configured virtual environment or conda environment. --no_cache_galaxy Skip caching of Galaxy source and dependencies obtained with --install_galaxy. Not caching this results in faster downloads (no git) - so is better on throw away instances such with TravisCI. --no_cleanup Do not cleanup temp files created for and by Galaxy. --galaxy_email TEXT E-mail address to use when launching single- user Galaxy server. --docker / --no_docker Run Galaxy tools in Docker if enabled. --docker_cmd TEXT Command used to launch docker (defaults to docker). --docker_sudo / --no_docker_sudo Flag to use sudo when running docker. --docker_host TEXT Docker host to target when executing docker commands (defaults to localhost). --docker_sudo_cmd TEXT sudo command to use when --docker_sudo is enabled (defaults to sudo). --docker_run_extra_arguments TEXT Extra arguments to pass to docker run. --mulled_containers, --biocontainers Test tools against mulled containers (forces --docker). Disables conda resolution unless any conda option has been set explicitly. --galaxy_startup_timeout INTEGER RANGE Wait for galaxy to start before assuming Galaxy did not start. [x>=1] --job_config_file FILE Job configuration file for Galaxy to target. --job_workers INTEGER Number of workers for the local job runner (default 1). --tool_dependency_dir DIRECTORY Tool dependency dir for Galaxy to target. --tool_data_path DIRECTORY Directory where data used by tools is located. Required if tests are run in docker and should make use of external reference data. --test_data DIRECTORY test-data directory to for specified tool(s). --tool_data_table PATH tool_data_table_conf.xml file to for specified tool(s). --dependency_resolvers_config_file FILE Dependency resolver configuration for Galaxy to target. --brew_dependency_resolution Configure Galaxy to use plain brew dependency resolution. --shed_dependency_resolution Configure Galaxy to use brewed Tool Shed dependency resolution. --no_dependency_resolution Configure Galaxy with no dependency resolvers. --conda_prefix DIRECTORY Conda prefix to use for conda dependency commands. --conda_exec FILE Location of conda executable. --conda_channels, --conda_ensure_channels TEXT Ensure conda is configured with specified comma separated list of channels. --conda_use_local Use locally built packages while building Conda environments. --conda_dependency_resolution Configure Galaxy to use only conda for dependency resolution. --conda_auto_install / --no_conda_auto_install Conda dependency resolution for Galaxy will attempt to install requested but missing packages. --conda_auto_init / --no_conda_auto_init Conda dependency resolution for Galaxy will auto install conda itself using miniforge if not availabe on conda_prefix. --simultaneous_uploads / --no_simultaneous_uploads When uploading files to Galaxy for tool or workflow tests or runs, upload multiple files simultaneously without waiting for the previous file upload to complete. --check_uploads_ok / --no_check_uploads_ok When uploading files to Galaxy for tool or workflow tests or runs, check that the history is in an 'ok' state before beginning tool or workflow execution. --profile TEXT Name of profile (created with the profile_create command) to use with this command. --database_type [postgres|postgres_docker|postgres_singularity|sqlite|auto] Type of database to use for profile - 'auto', 'sqlite', 'postgres', 'postgres_docker' , and postgres_singularity are available options. Use postgres to use an existing postgres server you user can access without a password via the psql command. Use postgres_docker to have Planemo manage a docker container running postgres. . Use postgres_singularity to have Planemo run postgres using singularity/apptainer. Data with postgres_docker is not yet persisted past when you restart the docker container launched by Planemo so be careful with this option. --postgres_psql_path TEXT Name or or path to postgres client binary (psql). --postgres_database_user TEXT Postgres username for managed development databases. --postgres_database_host TEXT Postgres host name for managed development databases. --postgres_database_port TEXT Postgres port for managed development databases. --file_path DIRECTORY Location for files created by Galaxy (e.g. database/files). --database_connection TEXT Database connection string to use for Galaxy. --postgres-storage-location TEXT storage path for postgres database, used for local singularity postgres. --shed_tool_conf TEXT Location of shed tools conf file for Galaxy. --shed_tool_path TEXT Location of shed tools directory for Galaxy. --galaxy_single_user / --no_galaxy_single_user By default Planemo will configure Galaxy to run in single-user mode where there is just one user and this user is automatically logged it. Use --no_galaxy_single_user to prevent Galaxy from running this way. --paste_test_data_paths / --no_paste_test_data_paths By default Planemo will use or not use Galaxy's path paste option to load test data into a history based on the engine type it is targeting. This can override the logic to explicitly enable or disable path pasting. --update_test_data Update test-data directory with job outputs (normally written to directory --job_output_files if specified.) --test_output PATH Output test report (HTML - for humans) defaults to tool_test_output.html. --test_output_text PATH Output test report (Basic text - for display in CI) --test_output_markdown PATH Output test report (Markdown style - for humans & computers) --test_output_markdown_minimal PATH Output test report (Minimal markdown style - jost the table) --test_output_xunit PATH Output test report (xunit style - for CI systems --test_output_junit PATH Output test report (jUnit style - for CI systems --test_output_allure DIRECTORY Output test allure2 framework resutls --test_output_json PATH Output test report (planemo json) defaults to tool_test_output.json. --job_output_files DIRECTORY Write job outputs to specified directory. --summary [none|minimal|compact] Summary style printed to planemo's standard output (see output reports for more complete summary). Set to 'none' to disable completely. --test_timeout INTEGER Maximum runtime of a single test in seconds. --fail_fast Stop on first job failure. --engine [galaxy|docker_galaxy|cwltool|toil|external_galaxy] Select an engine to run or test artifacts such as tools and workflows. Defaults to a local Galaxy, but running Galaxy within a Docker container or the CWL reference implementation 'cwltool' and 'toil' be selected. --non_strict_cwl Disable strict validation of CWL. --no-container, --no_container If cwltool engine is used, disable Docker container usage. --docker_galaxy_image TEXT Docker image identifier for docker-galaxy- flavor used if engine type is specified as ``docker-galaxy``. Defaults to quay.io/bgruening/galaxy. --docker_extra_volume PATH Extra path to mount if --engine docker or `--biocontainers` or `--docker`. --ignore_dependency_problems When installing shed repositories for workflows, ignore dependency issues. These likely indicate a problem but in some cases may not prevent a workflow from successfully executing. --shed_install / --no_shed_install By default Planemo will attempt to install repositories needed for workflow testing. This may not be appropriate for production servers and so this can disabled by calling planemo with --no_shed_install. --install_tool_dependencies / --no_install_tool_dependencies Turn on installation of tool dependencies using classic toolshed packages. --install_resolver_dependencies / --no_install_resolver_dependencies Skip installing tool dependencies through resolver (e.g. conda). --install_repository_dependencies / --no_install_repository_dependencies Skip installing the repository dependencies. --galaxy_url TEXT Remote Galaxy URL to use with external Galaxy engine. --galaxy_admin_key TEXT Admin key to use with external Galaxy engine. --galaxy_user_key TEXT User key to use with external Galaxy engine. --history_name TEXT Name to give a Galaxy history, if one is created. --history_id TEXT Send the results of the run to the history with the provided ID. A history with this ID must exist. --no_wait After invoking a job or workflow, do not wait for completion. --help Show this message and exit.