Warning

This document is for an in-development version of Galaxy. You can alternatively view this page in the latest release if it exists or view the top of the latest release's documentation.

galaxy.tools package

Classes encapsulating galaxy tools and tool configuration.

class galaxy.tools.safe_update(min_version, current_version)

Bases: tuple

min_version: LegacyVersion | Version

Alias for field number 0

current_version: LegacyVersion | Version

Alias for field number 1

galaxy.tools.get_safe_version(tool: Tool, requested_tool_version: str) → str | None

exception galaxy.tools.ToolNotFoundException

Bases: Exception

galaxy.tools.create_tool_from_source(app, tool_source: ToolSource, config_file: str | PathLike | None = None, **kwds)

galaxy.tools.create_tool_from_representation(app, raw_tool_source: str, tool_dir: str | PathLike | None = None, tool_source_class='XmlToolSource') → Tool

class galaxy.tools.NullToolTagManager

Bases: AbstractToolTagManager

reset_tags()

Starting to load tool panels, reset all tags.

handle_tags(tool_id, tool_definition_source)

Parse out tags and persist them.

class galaxy.tools.PersistentToolTagManager(app)

Bases: AbstractToolTagManager

__init__(app)

reset_tags()

Starting to load tool panels, reset all tags.

handle_tags(tool_id, tool_definition_source)

Parse out tags and persist them.

class galaxy.tools.ToolBox(config_filenames, tool_root_dir, app, save_integrated_tool_panel=True)

Bases: AbstractToolBox

A derivative of AbstractToolBox with Galaxy tooling-specific functionality and knowledge about Tool internals - how to construct them, action types, dependency management, etc.

__init__(config_filenames, tool_root_dir, app, save_integrated_tool_panel=True)

Create a toolbox from the config files named by config_filenames, using tool_root_dir as the base directory for finding individual tool config files.

tool_tag_manager()

Build a tool tag manager according to app’s configuration and return it.

property sa_session

Returns a SQLAlchemy session

reload_dependency_manager()

load_builtin_converters()

persist_cache(register_postfork=False)

Persists any modified tool cache files to disk.

Set register_postfork to stop database thread queue, close database connection and register re-open function that re-opens the database after forking.

can_load_config_file(config_filename)

has_reloaded(other_toolbox)

property all_requirements

property tools_by_id

get_cache_region(tool_cache_data_dir)

create_tool(config_file: str, tool_cache_data_dir=None, **kwds)

get_expanded_tool_source(config_file, **kwargs)

create_dynamic_tool(dynamic_tool, **kwds)

get_tool_components(tool_id, tool_version=None, get_loaded_tools_by_lineage=False, set_selected=False)

Retrieve all loaded versions of a tool from the toolbox and return a select list enabling selection of a different version, the list of the tool’s loaded versions, and the specified tool.

class galaxy.tools.DefaultToolState

Bases: object

Keeps track of the state of a users interaction with a tool between requests.

__init__()

initialize(trans, tool)

Create a new DefaultToolState for this tool. It will be initialized with default values for inputs. Grouping elements are filled in recursively.

encode(tool, app, nested=False)

Convert the data to a string

decode(values, tool, app)

Restore the state from a string

copy()

Shallow copy of the state

class galaxy.tools.Tool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: UsesDictVisibleKeys

Represents a computational tool that can be executed through Galaxy.

job_tool_configurations: list

tool_type = 'default'

requires_setting_metadata = True

produces_entry_points = False

default_tool_action

alias of DefaultToolAction

tool_action: ToolAction

tool_type_local = False

dict_collection_visible_keys = ['id', 'name', 'version', 'description', 'labels']

version: str

__init__(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Load a tool from the config named by config_file

job_search: JobSearch

remove_from_cache()

property history_manager

property version_object

property sa_session

Returns a SQLAlchemy session

property lineage

Return ToolLineage for this tool.

property tool_versions

property is_latest_version

property latest_version

property is_datatype_converter

property tool_shed_repository

property produces_collections_with_unknown_structure

property valid_input_states

property requires_galaxy_python_environment

Indicates this tool’s runtime requires Galaxy’s Python environment.

get_configured_job_handler(job_params=None)

Get the configured job handler for this Tool given the provided job_params.

Unlike the former get_job_handler() method, this does not perform “preassignment” (random selection of a configured handler ID from a tag).

Parameters:

job_params (dict or None) – Any params specific to this job (e.g. the job source)

Returns:

str or None – The configured handler for a job run of this Tool

get_job_destination(job_params=None)

Returns:

galaxy.jobs.JobDestination – The destination definition and runner parameters.

get_panel_section()

allow_user_access(user, attempting_access=True)

Returns:

bool – Whether the user is allowed to access the tool.

parse(tool_source: ToolSource, guid: str | None = None, dynamic: bool = False) → None

Read tool configuration from the element root and fill in self.

parse_tests()

property tests

test_data_path(filename)

tool_provided_metadata(job_wrapper)

parse_command(tool_source)

parse_environment_variables(tool_source)

parse_inputs(tool_source: ToolSource)

Parse the “<inputs>” element and create appropriate ToolParameter s. This implementation supports multiple pages and grouping constructs.

parse_outputs(tool_source)

Parse <outputs> elements and fill in self.outputs (keyed by name)

parse_stdio(tool_source: ToolSource)

Parse <stdio> element(s) and fill in self.return_codes, self.stderr_rules, and self.stdout_rules. Return codes have a range and an error type (fault or warning). Stderr and stdout rules have a regular expression and an error level (fault or warning).

parse_input_elem(page_source: PageSource, enctypes, context=None) → Dict[str, Group | ToolParameter]

Parse a parent element whose children are inputs – these could be groups (repeat, conditional) or param elements. Groups will be parsed recursively.

parse_param_elem(input_source: InputSource, enctypes, context) → ToolParameter

Parse a single “<param>” element and return a ToolParameter instance. Also, if the parameter has a ‘required_enctype’ add it to the set enctypes.

populate_resource_parameters(tool_source)

populate_tool_shed_info(tool_shed_repository)

property help: Template

property biotools_reference: str | None

Return a bio.tools ID if external reference to it is found.

If multiple bio.tools references are found, return just the first one.

find_output_def(name)

property is_workflow_compatible

check_workflow_compatible(tool_source)

Determine if a tool can be used in workflows. External tools and the upload tool are currently not supported by workflows.

new_state(trans)

Create a new DefaultToolState for this tool. It will be initialized with default values for inputs. Grouping elements are filled in recursively.

get_param(key)

Returns the parameter named key or None if there is no such parameter.

get_hook(name)

Returns an object from the code file referenced by code_namespace (this will normally be a callable object)

visit_inputs(values, callback)

Call the function callback on each parameter of this tool. Visits grouping parameters recursively and constructs unique prefixes for each nested set of The callback method is then called as:

callback( level_prefix, parameter, parameter_value )

expand_incoming(request_context: WorkRequestContext, incoming: Dict[str, Any], input_format: typing_extensions.Literal[legacy, 21.01] = 'legacy') → Tuple[List[Dict[str, Any]], List[Dict[str, Any]], int | None, MatchingCollections | None]

completed_jobs(trans, use_cached_job: bool, all_params: List[Dict[str, Any]]) → Dict[int, Job | None]

handle_input(trans, incoming: Dict[str, Any], history: History | None = None, use_cached_job: bool = False, preferred_object_store_id: str | None = None, input_format: typing_extensions.Literal[legacy, 21.01] = 'legacy')

Process incoming parameters for this tool from the dict incoming, update the tool state (or create if none existed), and either return to the form or execute the tool (only if ‘execute’ was clicked and there were no errors).

handle_incoming_errors(all_errors: List[Dict[str, Dict[str, ParameterValidationErrorsT | str | Exception] | str | Exception]]) → None

handle_single_execution(trans, rerun_remap_job_id: int | None, execution_slice: ExecutionSlice, history: History, execution_cache: ToolExecutionCache, completed_job: Job | None, collection_info: MatchingCollections | None, job_callback: Callable | None, preferred_object_store_id: str | None, flush_job: bool, skip: bool)

Return a pair with whether execution is successful as well as either resulting output data or an error message indicating the problem.

property params_with_missing_data_table_entry

Return all parameters that are dynamically generated select lists whose options require an entry not currently in the tool_data_table_conf.xml file.

property params_with_missing_index_file

Return all parameters that are dynamically generated select lists whose options refer to a missing .loc file.

get_static_param_values(trans)

Returns a map of parameter names and values if the tool does not require any user input. Will raise an exception if any parameter does require input.

execute(trans, incoming: Dict[str, Any] | None = None, history: History | None = None, set_output_hid: bool = True, flush_job: bool = True)

Execute the tool using parameter values in incoming. This just dispatches to the ToolAction instance specified by self.tool_action. In general this will create a Job that when run will build the tool’s outputs, e.g. DefaultToolAction.

_execute has many more options but should be accessed through handle_single_execution. The public interface to execute should be rarely used and in more specific ways.

params_to_strings(params: Dict[str, Any], app, nested=False)

params_from_strings(params, app, ignore_errors=False)

check_and_update_param_values(values, trans, update_values=True, workflow_building_mode=False)

Check that all parameters have values, and fill in with default values where necessary. This could be called after loading values from a database in case new parameters have been added.

build_dependency_cache(**kwds)

build_dependency_shell_commands(job_directory=None, metadata=False)

Return a list of commands to be run to populate the current environment to include this tools requirements.

property installed_tool_dependencies

property tool_requirements

Return all requiremens of type package

property tool_requirements_status

Return a list of dictionaries for all tool dependencies with their associated status

property output_discover_patterns

build_redirect_url_params(param_dict)

Substitute parameter values into self.redirect_url_params

parse_redirect_url(data, param_dict)

Parse the REDIRECT_URL tool param. Tools that send data to an external application via a redirect must include the following 3 tool params:

1. REDIRECT_URL - the url to which the data is being sent

2. DATA_URL - the url to which the receiving application will send an http post to retrieve the Galaxy data

3. GALAXY_URL - the url to which the external application may post data as a response

call_hook(hook_name, *args, **kwargs)

Call the custom code hook function identified by ‘hook_name’ if any, and return the results

exec_before_job(app, inp_data, out_data, param_dict=None)

exec_after_process(app, inp_data, out_data, param_dict, job, final_job_state: str | None = None)

job_failed(job_wrapper, message, exception=False)

Called when a job has failed

discover_outputs(out_data, out_collections, tool_provided_metadata, tool_working_directory, job, input_ext, input_dbkey, inp_data=None, final_job_state='ok')

Find any additional datasets generated by a tool and attach (for cases where number of outputs is not known in advance).

to_archive()

to_dict(trans, link_details=False, io_details=False, tool_help=False)

Returns dict of tool.

to_json(trans, kwd=None, job=None, workflow_building_mode=False, history=None)

Recursively creates a tool dictionary containing repeats, dynamic options and updated states.

populate_model(request_context, inputs, state_inputs, group_inputs, other_values=None)

Populates the tool model consumed by the client form builder.

get_default_history_by_trans(trans, create=False)

classmethod get_externally_referenced_paths(path)

Return relative paths to externally referenced files by the tool described by file at path. External components should not assume things about the structure of tool xml files (this is the tool’s responsibility).

class galaxy.tools.OutputParameterJSONTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: Tool

Alternate implementation of Tool that provides parameters and other values JSONified within the contents of an output dataset

tool_type = 'output_parameter_json'

exec_before_job(app, inp_data, out_data, param_dict=None)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.ExpressionTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: Tool

requires_js_runtime = True

tool_type = 'expression'

tool_type_local = True

EXPRESSION_INPUTS_NAME = '_expression_inputs_.json'

parse_command(tool_source)

parse_outputs(tool_source)

Parse <outputs> elements and fill in self.outputs (keyed by name)

exec_before_job(app, inp_data, out_data, param_dict=None)

exec_after_process(app, inp_data, out_data, param_dict, job, final_job_state=None)

parse_environment_variables(tool_source)

Setup environment variable for inputs file.

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.DataSourceTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: OutputParameterJSONTool

Alternate implementation of Tool for data_source tools – those that allow the user to query and extract data from another web site.

tool_type = 'data_source'

default_tool_action

alias of DataSourceToolAction

property wants_params_cleaned

Indicates whether received, but undeclared request params should be cleaned.

parse_inputs(tool_source)

Parse the “<inputs>” element and create appropriate ToolParameter s. This implementation supports multiple pages and grouping constructs.

exec_before_job(app, inp_data, out_data, param_dict=None)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.AsyncDataSourceTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: DataSourceTool

tool_type = 'data_source_async'

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.DataDestinationTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: Tool

tool_type = 'data_destination'

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.SetMetadataTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: Tool

Tool implementation for special tool that sets metadata on an existing dataset.

tool_type = 'set_metadata'

requires_setting_metadata = False

tool_action: SetMetadataToolAction

regenerate_imported_metadata_if_needed(hda: HistoryDatasetAssociation, history: History, user: User, session_id: int)

exec_after_process(app, inp_data, out_data, param_dict, job, final_job_state=None)

job_failed(job_wrapper, message, exception=False)

Called when a job has failed

class galaxy.tools.ExportHistoryTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: Tool

tool_type = 'export_history'

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.ImportHistoryTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: Tool

tool_type = 'import_history'

exec_after_process(app, inp_data, out_data, param_dict, job, final_job_state=None)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.InteractiveTool(config_file, tool_source, app, **kwd)

Bases: Tool

tool_type = 'interactive'

produces_entry_points = True

__init__(config_file, tool_source, app, **kwd)

Load a tool from the config named by config_file

exec_after_process(app, inp_data, out_data, param_dict, job, final_job_state=None)

job_failed(job_wrapper, message, exception=False)

Called when a job has failed

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.DataManagerTool(config_file, root, app, guid=None, data_manager_id=None, **kwds)

Bases: OutputParameterJSONTool

tool_type = 'manage_data'

default_tool_action

alias of DataManagerToolAction

__init__(config_file, root, app, guid=None, data_manager_id=None, **kwds)

Load a tool from the config named by config_file

exec_after_process(app, inp_data, out_data, param_dict, job, final_job_state=None)

get_default_history_by_trans(trans, create=False)

allow_user_access(user, attempting_access=True) → bool

Check user access to this tool.

Parameters:

• user (galaxy.model.User) – model object representing user.

• attempting_access (bool) – is the user attempting to do something with the the tool (set false for incidental checks like toolbox listing)

Returns:

Whether the user is allowed to access the tool. Data Manager tools are only accessible to admins.

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.DatabaseOperationTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: Tool

default_tool_action

alias of ModelOperationToolAction

require_terminal_states = True

require_dataset_ok = True

tool_type_local = True

require_terminal_or_paused_states = False

property valid_input_states

property allow_errored_inputs

check_inputs_ready(input_datasets, input_dataset_collections)

produce_outputs(trans: ProvidesUserContext, out_data, output_collections, incoming, history, **kwds)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.UnzipCollectionTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: DatabaseOperationTool

tool_type = 'unzip_collection'

require_terminal_states = False

require_dataset_ok = False

produce_outputs(trans, out_data, output_collections, incoming, history, **kwds)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.ZipCollectionTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: DatabaseOperationTool

tool_type = 'zip_collection'

require_terminal_states = False

require_dataset_ok = False

produce_outputs(trans, out_data, output_collections, incoming, history, **kwds)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.CrossProductFlatCollectionTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: DatabaseOperationTool

tool_type = 'cross_product_flat'

require_terminal_states = False

require_dataset_ok = False

produce_outputs(trans, out_data, output_collections, incoming, history, **kwds)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.CrossProductNestedCollectionTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: DatabaseOperationTool

tool_type = 'cross_product_nested'

require_terminal_states = False

require_dataset_ok = False

produce_outputs(trans, out_data, output_collections, incoming, history, **kwds)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.BuildListCollectionTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: DatabaseOperationTool

tool_type = 'build_list'

require_terminal_states = False

require_dataset_ok = False

produce_outputs(trans, out_data, output_collections, incoming, history, **kwds)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.ExtractDatasetCollectionTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: DatabaseOperationTool

tool_type = 'extract_dataset'

require_terminal_states = False

require_dataset_ok = False

produce_outputs(trans, out_data, output_collections, incoming, history, **kwds)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.MergeCollectionTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: DatabaseOperationTool

tool_type = 'merge_collection'

require_terminal_states = False

require_dataset_ok = False

produce_outputs(trans, out_data, output_collections, incoming, history, **kwds)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.FilterDatasetsTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: DatabaseOperationTool

require_terminal_states = True

require_dataset_ok = False

static element_is_valid(element: DatasetCollectionElement)

produce_outputs(trans, out_data, output_collections, incoming, history, **kwds)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.FilterFailedDatasetsTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: FilterDatasetsTool

tool_type = 'filter_failed_datasets_collection'

require_dataset_ok = False

static element_is_valid(element: DatasetCollectionElement)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.KeepSuccessDatasetsTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: FilterDatasetsTool

tool_type = 'keep_success_datasets_collection'

require_terminal_states = False

require_dataset_ok = False

require_terminal_or_paused_states = True

static element_is_valid(element: DatasetCollectionElement)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.FilterEmptyDatasetsTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: FilterDatasetsTool

tool_type = 'filter_empty_datasets_collection'

require_dataset_ok = False

static element_is_valid(element: DatasetCollectionElement)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.FilterNullTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: FilterDatasetsTool

tool_type = 'filter_null'

require_dataset_ok = True

static element_is_valid(element: DatasetCollectionElement)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.FlattenTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: DatabaseOperationTool

tool_type = 'flatten_collection'

require_terminal_states = False

require_dataset_ok = False

produce_outputs(trans, out_data, output_collections, incoming, history, **kwds)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.SortTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: DatabaseOperationTool

tool_type = 'sort_collection'

require_terminal_states = True

require_dataset_ok = False

produce_outputs(trans, out_data, output_collections, incoming, history, **kwds)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.HarmonizeTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: DatabaseOperationTool

tool_type = 'harmonize_list'

require_terminal_states = False

require_dataset_ok = False

produce_outputs(trans, out_data, output_collections, incoming, history, **kwds)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.RelabelFromFileTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: DatabaseOperationTool

tool_type = 'relabel_from_file'

produce_outputs(trans, out_data, output_collections, incoming, history, **kwds)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.ApplyRulesTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: DatabaseOperationTool

tool_type = 'apply_rules'

produce_outputs(trans, out_data, output_collections, incoming, history, **kwds)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.TagFromFileTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: DatabaseOperationTool

tool_type = 'tag_from_file'

produce_outputs(trans, out_data, output_collections, incoming, history, **kwds)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.FilterFromFileTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: DatabaseOperationTool

tool_type = 'filter_from_file'

produce_outputs(trans, out_data, output_collections, incoming, history, **kwds)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.DuplicateFileToCollectionTool(config_file: str | PathLike | None, tool_source: ToolSource, app: UniverseApplication, guid: str | None = None, repository_id=None, tool_shed_repository=None, allow_code_files: bool = True, dynamic: bool = False, tool_dir: str | PathLike | None = None)

Bases: DatabaseOperationTool

tool_type = 'duplicate_file_to_collection'

require_terminal_states = False

require_dataset_ok = False

produce_outputs(trans, out_data, output_collections, incoming, history, **kwds)

job_tool_configurations: list

tool_action: ToolAction

job_search: JobSearch

version: str

stdio_exit_codes: List

stdio_regexes: List

inputs_by_page: List[Dict]

display_by_page: List

action: str | Tuple[str, str]

labels: List

input_params: List[ToolParameter]

tool_shed: str | None

old_id: str | None

python_template_version: Version | None

dependencies: List

class galaxy.tools.TracksterConfig(actions)

Bases: object

Trackster configuration encapsulation.

__init__(actions)

static parse(root)

class galaxy.tools.SetParamAction(name, output_name)

Bases: object

Set parameter action.

__init__(name, output_name)

static parse(elt)

Parse action from element.

class galaxy.tools.BadValue(value)

Bases: object

__init__(value)

exception galaxy.tools.InterruptedUpload

Bases: Exception

Subpackages

• galaxy.tools.actions package
  • ToolAction
    • ToolAction.execute()
    • ToolAction.get_output_name()
  • DefaultToolAction
    • DefaultToolAction.produces_real_jobs
    • DefaultToolAction.collect_input_dataset_collections()
    • DefaultToolAction.execute()
    • DefaultToolAction.get_output_name()
  • OutputCollections
    • OutputCollections.__init__()
    • OutputCollections.create_collection()
  • get_ext_or_implicit_ext()
  • determine_output_format()
  • Submodules
  • galaxy.tools.actions.data_manager module
    • DataManagerToolAction
      • DataManagerToolAction.execute()
  • galaxy.tools.actions.data_source module
    • DataSourceToolAction
  • galaxy.tools.actions.history_imp_exp module
    • ImportHistoryToolAction
      • ImportHistoryToolAction.produces_real_jobs
      • ImportHistoryToolAction.execute()
    • ExportHistoryToolAction
      • ExportHistoryToolAction.produces_real_jobs
      • ExportHistoryToolAction.execute()
  • galaxy.tools.actions.metadata module
    • SetMetadataToolAction
      • SetMetadataToolAction.produces_real_jobs
      • SetMetadataToolAction.set_output_hid
      • SetMetadataToolAction.execute()
      • SetMetadataToolAction.execute_via_trans()
      • SetMetadataToolAction.execute_via_app()
  • galaxy.tools.actions.model_operations module
    • ModelOperationToolAction
      • ModelOperationToolAction.produces_real_jobs
      • ModelOperationToolAction.check_inputs_ready()
      • ModelOperationToolAction.execute()
  • galaxy.tools.actions.upload module
    • BaseUploadToolAction
      • BaseUploadToolAction.produces_real_jobs
      • BaseUploadToolAction.execute()
    • UploadToolAction
    • FetchUploadToolAction
  • galaxy.tools.actions.upload_common module
    • validate_datatype_extension()
    • persist_uploads()
    • LibraryParams
      • LibraryParams.roles
      • LibraryParams.tags
      • LibraryParams.template
      • LibraryParams.template_field_contents
      • LibraryParams.folder
      • LibraryParams.message
      • LibraryParams.replace_dataset
      • LibraryParams.__init__()
    • handle_library_params()
    • new_upload()
    • get_uploaded_datasets()
    • create_paramfile()
    • create_job()
    • active_folders()
• galaxy.tools.data package
  • RefgenieToolDataTable
    • RefgenieToolDataTable.dict_collection_visible_keys
    • RefgenieToolDataTable.dict_element_visible_keys
    • RefgenieToolDataTable.dict_export_visible_keys
    • RefgenieToolDataTable.type_key
    • RefgenieToolDataTable.__init__()
    • RefgenieToolDataTable.data
    • RefgenieToolDataTable.configure_and_load()
    • RefgenieToolDataTable.parse_column_spec()
    • RefgenieToolDataTable.parse_file_fields()
    • RefgenieToolDataTable.empty_field_value
    • RefgenieToolDataTable.empty_field_values
    • RefgenieToolDataTable.filenames
  • TabularToolDataField
    • TabularToolDataField.dict_collection_visible_keys
    • TabularToolDataField.__init__()
    • TabularToolDataField.get_base_path()
    • TabularToolDataField.get_base_dir()
    • TabularToolDataField.clean_base_dir()
    • TabularToolDataField.get_files()
    • TabularToolDataField.get_filesize_map()
    • TabularToolDataField.get_fingerprint()
    • TabularToolDataField.to_dict()
  • TabularToolDataTable
    • TabularToolDataTable.dict_collection_visible_keys
    • TabularToolDataTable.dict_element_visible_keys
    • TabularToolDataTable.dict_export_visible_keys
    • TabularToolDataTable.type_key
    • TabularToolDataTable.__init__()
    • TabularToolDataTable.data
    • TabularToolDataTable.configure_and_load()
    • TabularToolDataTable.merge_tool_data_table()
    • TabularToolDataTable.handle_found_index_file()
    • TabularToolDataTable.get_fields()
    • TabularToolDataTable.get_field()
    • TabularToolDataTable.get_named_fields_list()
    • TabularToolDataTable.get_version_fields()
    • TabularToolDataTable.parse_column_spec()
    • TabularToolDataTable.extend_data_with()
    • TabularToolDataTable.parse_file_fields()
    • TabularToolDataTable.get_column_name_list()
    • TabularToolDataTable.get_entry()
    • TabularToolDataTable.get_entries()
    • TabularToolDataTable.get_filename_for_source()
    • TabularToolDataTable.filter_file_fields()
    • TabularToolDataTable.xml_string
    • TabularToolDataTable.to_dict()
    • TabularToolDataTable.empty_field_value
    • TabularToolDataTable.empty_field_values
    • TabularToolDataTable.filenames
  • ToolDataTable
    • ToolDataTable.type_key
    • ToolDataTable.data
    • ToolDataTable.from_dict()
    • ToolDataTable.__init__()
    • ToolDataTable.empty_field_value
    • ToolDataTable.empty_field_values
    • ToolDataTable.filenames
    • ToolDataTable.get_empty_field_by_name()
    • ToolDataTable.add_entry()
    • ToolDataTable.add_entries()
    • ToolDataTable.remove_entry()
    • ToolDataTable.is_current_version()
    • ToolDataTable.merge_tool_data_table()
    • ToolDataTable.reload_from_files()
  • ToolDataTableManager
    • ToolDataTableManager.tool_data_table_types
    • ToolDataTableManager.data_tables
• galaxy.tools.data_manager package
  • Submodules
  • galaxy.tools.data_manager.manager module
    • DataManagers
      • DataManagers.__init__()
      • DataManagers.data_managers
      • DataManagers.managed_data_tables
      • DataManagers.load_from_xml()
      • DataManagers.load_manager_from_elem()
      • DataManagers.add_manager()
      • DataManagers.get_manager()
      • DataManagers.remove_manager()
    • Tool
      • Tool.name
      • Tool.description
      • Tool.version
      • Tool.__init__()
    • DataManager
      • DataManager.GUID_TYPE
      • DataManager.DEFAULT_VERSION
      • DataManager.__init__()
      • DataManager.tool
      • DataManager.id
      • DataManager.data_table_names
      • DataManager.process_result()
      • DataManager.write_bundle()
      • DataManager.repo_info
      • DataManager.get_tool_shed_repository_info_dict()
• galaxy.tools.error_reports package
  • ErrorReports
    • ErrorReports.__init__()
  • NullErrorPlugin
    • NullErrorPlugin.submit_report()
  • ErrorPlugin
    • ErrorPlugin.__init__()
    • ErrorPlugin.submit_report()
    • ErrorPlugin.from_file()
  • Subpackages
    • galaxy.tools.error_reports.plugins package
      • ErrorPlugin
      • Submodules
      • galaxy.tools.error_reports.plugins.base_git module
      • galaxy.tools.error_reports.plugins.email module
      • galaxy.tools.error_reports.plugins.github module
      • galaxy.tools.error_reports.plugins.gitlab module
      • galaxy.tools.error_reports.plugins.influxdb module
      • galaxy.tools.error_reports.plugins.json module
      • galaxy.tools.error_reports.plugins.sentry module
• galaxy.tools.expressions package
  • do_eval()
  • evaluate()
  • find_engine()
  • write_evalute_script()
  • Submodules
  • galaxy.tools.expressions.evaluation module
    • do_eval()
    • evaluate()
  • galaxy.tools.expressions.script module
    • write_evalute_script()
  • galaxy.tools.expressions.util module
    • find_engine()
• galaxy.tools.filters package
• galaxy.tools.imp_exp package
  • JobImportHistoryArchiveWrapper
    • JobImportHistoryArchiveWrapper.__init__()
    • JobImportHistoryArchiveWrapper.setup_job()
    • JobImportHistoryArchiveWrapper.cleanup_after_job()
  • JobExportHistoryArchiveWrapper
    • JobExportHistoryArchiveWrapper.__init__()
    • JobExportHistoryArchiveWrapper.setup_job()
  • Submodules
  • galaxy.tools.imp_exp.export_history module
    • create_archive()
    • main()
    • get_file_sources()
  • galaxy.tools.imp_exp.unpack_tar_gz_archive module
    • get_file_sources()
    • check_archive()
    • unpack_archive()
    • main()
• galaxy.tools.parameters package
  • DataCollectionToolParameter
    • DataCollectionToolParameter.__init__()
    • DataCollectionToolParameter.multiple
    • DataCollectionToolParameter.collection_types
    • DataCollectionToolParameter.match_collections()
    • DataCollectionToolParameter.match_multirun_collections()
    • DataCollectionToolParameter.from_json()
    • DataCollectionToolParameter.to_text()
    • DataCollectionToolParameter.to_dict()
  • DataToolParameter
    • DataToolParameter.__init__()
    • DataToolParameter.multiple
    • DataToolParameter.from_json()
    • DataToolParameter.to_param_dict_string()
    • DataToolParameter.to_text()
    • DataToolParameter.get_dependencies()
    • DataToolParameter.converter_safe()
    • DataToolParameter.get_options_filter_attribute()
    • DataToolParameter.to_dict()
  • SelectToolParameter
    • SelectToolParameter.value_label
    • SelectToolParameter.__init__()
    • SelectToolParameter.get_options()
    • SelectToolParameter.get_legal_values()
    • SelectToolParameter.get_legal_names()
    • SelectToolParameter.from_json()
    • SelectToolParameter.to_param_dict_string()
    • SelectToolParameter.to_json()
    • SelectToolParameter.to_python()
    • SelectToolParameter.get_initial_value()
    • SelectToolParameter.to_text()
    • SelectToolParameter.get_dependencies()
    • SelectToolParameter.to_dict()
    • SelectToolParameter.validate()
  • Submodules
  • galaxy.tools.parameters.basic module
    • ImplicitConversionRequired
    • contains_workflow_parameter()
    • is_runtime_context()
    • parse_dynamic_options()
    • assert_throws_param_value_error()
    • ParameterValueError
      • ParameterValueError.__init__()
      • ParameterValueError.to_dict()
    • ToolParameter
      • ToolParameter.dict_collection_visible_keys
      • ToolParameter.__init__()
      • ToolParameter.name
      • ToolParameter.visible
      • ToolParameter.get_label()
      • ToolParameter.from_json()
      • ToolParameter.get_initial_value()
      • ToolParameter.get_required_enctype()
      • ToolParameter.get_dependencies()
      • ToolParameter.to_json()
      • ToolParameter.to_python()
      • ToolParameter.value_to_basic()
      • ToolParameter.value_from_basic()
      • ToolParameter.value_to_display_text()
      • ToolParameter.to_text()
      • ToolParameter.to_param_dict_string()
      • ToolParameter.validate()
      • ToolParameter.to_dict()
      • ToolParameter.build()
      • ToolParameter.parse_name()
    • SimpleTextToolParameter
      • SimpleTextToolParameter.__init__()
      • SimpleTextToolParameter.to_json()
      • SimpleTextToolParameter.get_initial_value()
      • SimpleTextToolParameter.name
    • TextToolParameter
      • TextToolParameter.__init__()
      • TextToolParameter.validate()
      • TextToolParameter.wrapper_default
      • TextToolParameter.to_dict()
      • TextToolParameter.name
    • IntegerToolParameter
      • IntegerToolParameter.dict_collection_visible_keys
      • IntegerToolParameter.__init__()
      • IntegerToolParameter.from_json()
      • IntegerToolParameter.to_python()
      • IntegerToolParameter.get_initial_value()
      • IntegerToolParameter.name
    • FloatToolParameter
      • FloatToolParameter.dict_collection_visible_keys
      • FloatToolParameter.__init__()
      • FloatToolParameter.from_json()
      • FloatToolParameter.to_python()
      • FloatToolParameter.get_initial_value()
      • FloatToolParameter.name
    • BooleanToolParameter
      • BooleanToolParameter.__init__()
      • BooleanToolParameter.from_json()
      • BooleanToolParameter.to_python()
      • BooleanToolParameter.to_json()
      • BooleanToolParameter.get_initial_value()
      • BooleanToolParameter.to_param_dict_string()
      • BooleanToolParameter.to_dict()
      • BooleanToolParameter.legal_values
      • BooleanToolParameter.name
    • FileToolParameter
      • FileToolParameter.__init__()
      • FileToolParameter.from_json()
      • FileToolParameter.get_required_enctype()
      • FileToolParameter.to_json()
      • FileToolParameter.to_python()
      • FileToolParameter.name
    • FTPFileToolParameter
      • FTPFileToolParameter.__init__()
      • FTPFileToolParameter.get_initial_value()
      • FTPFileToolParameter.visible
      • FTPFileToolParameter.to_param_dict_string()
      • FTPFileToolParameter.from_json()
      • FTPFileToolParameter.to_json()
      • FTPFileToolParameter.to_python()
      • FTPFileToolParameter.to_dict()
      • FTPFileToolParameter.name
    • HiddenToolParameter
      • HiddenToolParameter.__init__()
      • HiddenToolParameter.get_initial_value()
      • HiddenToolParameter.get_label()
      • HiddenToolParameter.name
    • ColorToolParameter
      • ColorToolParameter.__init__()
      • ColorToolParameter.get_initial_value()
      • ColorToolParameter.to_param_dict_string()
      • ColorToolParameter.name
    • BaseURLToolParameter
      • BaseURLToolParameter.__init__()
      • BaseURLToolParameter.get_initial_value()
      • BaseURLToolParameter.from_json()
      • BaseURLToolParameter.to_dict()
      • BaseURLToolParameter.name
    • iter_to_string()
    • SelectToolParameter
      • SelectToolParameter.value_label
      • SelectToolParameter.__init__()
      • SelectToolParameter.get_options()
      • SelectToolParameter.get_legal_values()
      • SelectToolParameter.get_legal_names()
      • SelectToolParameter.from_json()
      • SelectToolParameter.to_param_dict_string()
      • SelectToolParameter.to_json()
      • SelectToolParameter.to_python()
      • SelectToolParameter.get_initial_value()
      • SelectToolParameter.to_text()
      • SelectToolParameter.get_dependencies()
      • SelectToolParameter.to_dict()
      • SelectToolParameter.validate()
      • SelectToolParameter.name
    • GenomeBuildParameter
      • GenomeBuildParameter.__init__()
      • GenomeBuildParameter.get_options()
      • GenomeBuildParameter.get_legal_values()
      • GenomeBuildParameter.to_dict()
      • GenomeBuildParameter.value_label
      • GenomeBuildParameter.name
    • SelectTagParameter
      • SelectTagParameter.__init__()
      • SelectTagParameter.from_json()
      • SelectTagParameter.get_tag_list()
      • SelectTagParameter.get_options()
      • SelectTagParameter.get_initial_value()
      • SelectTagParameter.get_legal_values()
      • SelectTagParameter.get_dependencies()
      • SelectTagParameter.to_dict()
      • SelectTagParameter.value_label
      • SelectTagParameter.name
    • ColumnListParameter
      • ColumnListParameter.__init__()
      • ColumnListParameter.to_json()
      • ColumnListParameter.from_json()
      • ColumnListParameter.get_column_list()
      • ColumnListParameter.get_options()
      • ColumnListParameter.get_initial_value()
      • ColumnListParameter.get_legal_values()
      • ColumnListParameter.is_file_empty()
      • ColumnListParameter.get_dependencies()
      • ColumnListParameter.to_dict()
      • ColumnListParameter.value_label
      • ColumnListParameter.name
    • DrillDownSelectToolParameter
      • DrillDownSelectToolParameter.__init__()
      • DrillDownSelectToolParameter.get_options()
      • DrillDownSelectToolParameter.get_legal_values()
      • DrillDownSelectToolParameter.from_json()
      • DrillDownSelectToolParameter.to_param_dict_string()
      • DrillDownSelectToolParameter.get_initial_value()
      • DrillDownSelectToolParameter.to_text()
      • DrillDownSelectToolParameter.get_dependencies()
      • DrillDownSelectToolParameter.to_dict()
      • DrillDownSelectToolParameter.value_label
      • DrillDownSelectToolParameter.name
    • BaseDataToolParameter
      • BaseDataToolParameter.multiple
      • BaseDataToolParameter.__init__()
      • BaseDataToolParameter.get_initial_value()
      • BaseDataToolParameter.to_json()
      • BaseDataToolParameter.to_python()
      • BaseDataToolParameter.validate()
    • src_id_to_item()
    • DataToolParameter
      • DataToolParameter.__init__()
      • DataToolParameter.multiple
      • DataToolParameter.from_json()
      • DataToolParameter.to_param_dict_string()
      • DataToolParameter.to_text()
      • DataToolParameter.get_dependencies()
      • DataToolParameter.converter_safe()
      • DataToolParameter.get_options_filter_attribute()
      • DataToolParameter.to_dict()
      • DataToolParameter.name
    • DataCollectionToolParameter
      • DataCollectionToolParameter.__init__()
      • DataCollectionToolParameter.multiple
      • DataCollectionToolParameter.collection_types
      • DataCollectionToolParameter.match_collections()
      • DataCollectionToolParameter.match_multirun_collections()
      • DataCollectionToolParameter.from_json()
      • DataCollectionToolParameter.to_text()
      • DataCollectionToolParameter.to_dict()
      • DataCollectionToolParameter.name
    • HiddenDataToolParameter
      • HiddenDataToolParameter.__init__()
      • HiddenDataToolParameter.name
    • BaseJsonToolParameter
      • BaseJsonToolParameter.name
      • BaseJsonToolParameter.value_to_basic()
      • BaseJsonToolParameter.to_json()
      • BaseJsonToolParameter.to_python()
    • DirectoryUriToolParameter
      • DirectoryUriToolParameter.name
      • DirectoryUriToolParameter.__init__()
      • DirectoryUriToolParameter.validate()
    • RulesListToolParameter
      • RulesListToolParameter.name
      • RulesListToolParameter.__init__()
      • RulesListToolParameter.to_dict()
      • RulesListToolParameter.validate()
      • RulesListToolParameter.to_text()
    • raw_to_galaxy()
    • history_item_dict_to_python()
    • history_item_to_json()
  • galaxy.tools.parameters.dataset_matcher module
    • get_dataset_matcher_factory()
    • set_dataset_matcher_factory()
    • unset_dataset_matcher_factory()
  • galaxy.tools.parameters.dynamic_options module
    • Filter
      • Filter.from_element()
      • Filter.__init__()
      • Filter.get_dependency_name()
      • Filter.filter_options()
    • StaticValueFilter
      • StaticValueFilter.__init__()
      • StaticValueFilter.filter_options()
    • RegexpFilter
      • RegexpFilter.__init__()
      • RegexpFilter.filter_options()
    • DataMetaFilter
      • DataMetaFilter.__init__()
      • DataMetaFilter.get_dependency_name()
      • DataMetaFilter.filter_options()
    • ParamValueFilter
      • ParamValueFilter.__init__()
      • ParamValueFilter.get_dependency_name()
      • ParamValueFilter.filter_options()
    • UniqueValueFilter
      • UniqueValueFilter.__init__()
      • UniqueValueFilter.get_dependency_name()
      • UniqueValueFilter.filter_options()
    • MultipleSplitterFilter
      • MultipleSplitterFilter.__init__()
      • MultipleSplitterFilter.filter_options()
    • AttributeValueSplitterFilter
      • AttributeValueSplitterFilter.__init__()
      • AttributeValueSplitterFilter.filter_options()
    • AdditionalValueFilter
      • AdditionalValueFilter.__init__()
      • AdditionalValueFilter.filter_options()
    • RemoveValueFilter
      • RemoveValueFilter.__init__()
      • RemoveValueFilter.filter_options()
    • SortByColumnFilter
      • SortByColumnFilter.__init__()
      • SortByColumnFilter.filter_options()
    • DataTableFilter
      • DataTableFilter.__init__()
      • DataTableFilter.filter_options()
    • DynamicOptions
      • DynamicOptions.__init__()
      • DynamicOptions.tool_data_table
      • DynamicOptions.missing_tool_data_table_name
      • DynamicOptions.parse_column_definitions()
      • DynamicOptions.parse_file_fields()
      • DynamicOptions.get_dependency_names()
      • DynamicOptions.get_fields()
      • DynamicOptions.get_user_options()
      • DynamicOptions.hda_to_table_entries()
      • DynamicOptions.get_option_from_dataset()
      • DynamicOptions.get_fields_by_value()
      • DynamicOptions.get_field_by_name_for_value()
      • DynamicOptions.get_options()
      • DynamicOptions.column_spec_to_index()
    • FromUrlOptions
      • FromUrlOptions.__init__()
      • FromUrlOptions.from_url
      • FromUrlOptions.request_method
      • FromUrlOptions.request_body
      • FromUrlOptions.request_headers
      • FromUrlOptions.postprocess_expression
    • strip_or_none()
    • parse_from_url_options()
    • template_or_none()
  • galaxy.tools.parameters.grouping module
    • Group
      • Group.dict_collection_visible_keys
      • Group.type
      • Group.__init__()
      • Group.name
      • Group.visible
      • Group.value_to_basic()
      • Group.value_from_basic()
      • Group.get_initial_value()
      • Group.to_dict()
    • Repeat
      • Repeat.dict_collection_visible_keys
      • Repeat.type
      • Repeat.__init__()
      • Repeat.inputs
      • Repeat.min
      • Repeat.max
      • Repeat.title
      • Repeat.title_plural
      • Repeat.label
      • Repeat.value_to_basic()
      • Repeat.value_from_basic()
      • Repeat.get_initial_value()
      • Repeat.to_dict()
    • Section
      • Section.dict_collection_visible_keys
      • Section.type
      • Section.__init__()
      • Section.inputs
      • Section.title_plural
      • Section.label
      • Section.value_to_basic()
      • Section.value_from_basic()
      • Section.get_initial_value()
      • Section.to_dict()
    • Dataset
      • Dataset.type
      • Dataset.file_type
      • Dataset.dbkey
      • Dataset.datatype
      • Dataset.warnings
      • Dataset.metadata
      • Dataset.composite_files
      • Dataset.uuid
      • Dataset.tag_using_filenames
      • Dataset.tags
      • Dataset.name
      • Dataset.primary_file
      • Dataset.to_posix_lines
      • Dataset.auto_decompress
      • Dataset.ext
      • Dataset.space_to_tab
    • UploadDataset
      • UploadDataset.type
      • UploadDataset.__init__()
      • UploadDataset.inputs
      • UploadDataset.get_composite_dataset_name()
      • UploadDataset.get_file_base_name()
      • UploadDataset.get_file_type()
      • UploadDataset.get_dbkey()
      • UploadDataset.get_datatype_ext()
      • UploadDataset.get_datatype()
      • UploadDataset.title_plural
      • UploadDataset.group_title()
      • UploadDataset.title_by_index()
      • UploadDataset.value_to_basic()
      • UploadDataset.value_from_basic()
      • UploadDataset.get_file_count()
      • UploadDataset.get_initial_value()
      • UploadDataset.get_uploaded_datasets()
    • Conditional
      • Conditional.type
      • Conditional.value_from
      • Conditional.__init__()
      • Conditional.cases
      • Conditional.label
      • Conditional.get_current_case()
      • Conditional.value_to_basic()
      • Conditional.value_from_basic()
      • Conditional.get_initial_value()
      • Conditional.to_dict()
    • ConditionalWhen
      • ConditionalWhen.dict_collection_visible_keys
      • ConditionalWhen.__init__()
      • ConditionalWhen.to_dict()
  • galaxy.tools.parameters.history_query module
    • HistoryQuery
      • HistoryQuery.__init__()
      • HistoryQuery.from_collection_type()
      • HistoryQuery.from_collection_types()
      • HistoryQuery.from_parameter()
      • HistoryQuery.direct_match()
      • HistoryQuery.can_map_over()
  • galaxy.tools.parameters.input_translation module
    • ToolInputTranslator
      • ToolInputTranslator.from_element()
      • ToolInputTranslator.__init__()
      • ToolInputTranslator.translate()
  • galaxy.tools.parameters.meta module
    • WorkflowParameterExpansion
      • WorkflowParameterExpansion.input_combinations
      • WorkflowParameterExpansion.param_combinations
      • WorkflowParameterExpansion.param_keys
    • ParamKey
      • ParamKey.__init__()
    • InputKey
      • InputKey.__init__()
    • expand_workflow_inputs()
    • expand_flat_parameters_to_nested()
    • expand_meta_parameters()
    • reorder_parameters()
    • split_inputs_flat()
    • split_inputs_nested()
  • galaxy.tools.parameters.sanitize module
    • ToolParameterSanitizer
      • ToolParameterSanitizer.VALID_PRESET
      • ToolParameterSanitizer.MAPPING_PRESET
      • ToolParameterSanitizer.DEFAULT_INVALID_CHAR
      • ToolParameterSanitizer.from_element()
      • ToolParameterSanitizer.get_valid_by_name()
      • ToolParameterSanitizer.get_mapping_by_name()
      • ToolParameterSanitizer.__init__()
      • ToolParameterSanitizer.restore_text()
      • ToolParameterSanitizer.sanitize_text()
      • ToolParameterSanitizer.sanitize_param()
  • galaxy.tools.parameters.validation module
    • Validator
      • Validator.requires_dataset_metadata
      • Validator.__init__()
      • Validator.validate()
    • RegexValidator
      • RegexValidator.__init__()
      • RegexValidator.validate()
    • ExpressionValidator
      • ExpressionValidator.__init__()
      • ExpressionValidator.validate()
    • InRangeValidator
      • InRangeValidator.__init__()
      • InRangeValidator.simple_range_validator()
    • LengthValidator
      • LengthValidator.__init__()
      • LengthValidator.validate()
    • DatasetOkValidator
      • DatasetOkValidator.__init__()
      • DatasetOkValidator.validate()
    • DatasetEmptyValidator
      • DatasetEmptyValidator.__init__()
      • DatasetEmptyValidator.validate()
    • DatasetExtraFilesPathEmptyValidator
      • DatasetExtraFilesPathEmptyValidator.__init__()
      • DatasetExtraFilesPathEmptyValidator.validate()
    • MetadataValidator
      • MetadataValidator.requires_dataset_metadata
      • MetadataValidator.__init__()
      • MetadataValidator.default_metadata_validator()
      • MetadataValidator.validate()
    • MetadataEqualValidator
      • MetadataEqualValidator.requires_dataset_metadata
      • MetadataEqualValidator.__init__()
      • MetadataEqualValidator.validate()
    • UnspecifiedBuildValidator
      • UnspecifiedBuildValidator.requires_dataset_metadata
      • UnspecifiedBuildValidator.__init__()
      • UnspecifiedBuildValidator.validate()
    • NoOptionsValidator
      • NoOptionsValidator.__init__()
      • NoOptionsValidator.validate()
    • EmptyTextfieldValidator
      • EmptyTextfieldValidator.__init__()
      • EmptyTextfieldValidator.validate()
    • MetadataInFileColumnValidator
      • MetadataInFileColumnValidator.requires_dataset_metadata
      • MetadataInFileColumnValidator.__init__()
      • MetadataInFileColumnValidator.validate()
    • ValueInDataTableColumnValidator
      • ValueInDataTableColumnValidator.__init__()
      • ValueInDataTableColumnValidator.validate()
    • ValueNotInDataTableColumnValidator
      • ValueNotInDataTableColumnValidator.__init__()
      • ValueNotInDataTableColumnValidator.validate()
    • MetadataInDataTableColumnValidator
      • MetadataInDataTableColumnValidator.requires_dataset_metadata
      • MetadataInDataTableColumnValidator.__init__()
      • MetadataInDataTableColumnValidator.validate()
    • MetadataNotInDataTableColumnValidator
      • MetadataNotInDataTableColumnValidator.requires_dataset_metadata
      • MetadataNotInDataTableColumnValidator.__init__()
      • MetadataNotInDataTableColumnValidator.validate()
      • MetadataNotInDataTableColumnValidator.valid_values
    • MetadataInRangeValidator
      • MetadataInRangeValidator.requires_dataset_metadata
      • MetadataInRangeValidator.__init__()
      • MetadataInRangeValidator.validate()
    • parse_xml_validators()
    • to_validators()
  • galaxy.tools.parameters.wrapped module
    • LegacyUnprefixedDict
      • LegacyUnprefixedDict.__init__()
      • LegacyUnprefixedDict.set_legacy_alias()
    • WrappedParameters
      • WrappedParameters.__init__()
      • WrappedParameters.params
      • WrappedParameters.wrap_values()
    • make_dict_copy()
    • process_key()
    • flat_to_nested_state()
    • nested_key_to_path()
  • galaxy.tools.parameters.wrapped_json module
    • json_wrap()
• galaxy.tools.search package
  • get_or_create_index()
  • ToolBoxSearch
    • ToolBoxSearch.__init__()
    • ToolBoxSearch.build_index()
    • ToolBoxSearch.search()
  • ToolPanelViewSearch
    • ToolPanelViewSearch.__init__()
    • ToolPanelViewSearch.build_index()
    • ToolPanelViewSearch.search()
• galaxy.tools.util package
  • Subpackages
    • galaxy.tools.util.galaxyops package
      • warn()
      • fail()
      • parse_cols_arg()
      • default_printer()
      • skipped()
  • Submodules
  • galaxy.tools.util.maf_utilities module
    • maketrans()
    • src_split()
    • src_merge()
    • get_species_in_block()
    • tool_fail()
    • TempFileHandler
      • TempFileHandler.DEFAULT_MAX_OPEN_FILES
      • TempFileHandler.__init__()
      • TempFileHandler.get_open_tempfile()
      • TempFileHandler.close()
      • TempFileHandler.flush()
    • RegionAlignment
      • RegionAlignment.DNA_COMPLEMENT
      • RegionAlignment.MAX_SEQUENCE_SIZE
      • RegionAlignment.__init__()
      • RegionAlignment.add_species()
      • RegionAlignment.get_species_names()
      • RegionAlignment.get_sequence()
      • RegionAlignment.get_sequence_reverse_complement()
      • RegionAlignment.set_position()
      • RegionAlignment.set_range()
      • RegionAlignment.flush()
    • GenomicRegionAlignment
      • GenomicRegionAlignment.__init__()
      • GenomicRegionAlignment.sequences
    • SplicedAlignment
      • SplicedAlignment.DNA_COMPLEMENT
      • SplicedAlignment.__init__()
      • SplicedAlignment.get_species_names()
      • SplicedAlignment.get_sequence()
      • SplicedAlignment.get_sequence_reverse_complement()
      • SplicedAlignment.start
      • SplicedAlignment.end
    • maf_index_by_uid()
    • open_or_build_maf_index()
    • build_maf_index_species_chromosomes()
    • build_maf_index()
    • component_overlaps_region()
    • chop_block_by_region()
    • orient_block_by_region()
    • get_oriented_chopped_blocks_for_region()
    • get_oriented_chopped_blocks_with_index_offset_for_region()
    • iter_blocks_split_by_src()
    • iter_blocks_split_by_species()
    • get_chopped_blocks_for_region()
    • get_chopped_blocks_with_index_offset_for_region()
    • get_region_alignment()
    • reduce_block_by_primary_genome()
    • fill_region_alignment()
    • get_spliced_region_alignment()
    • line_enumerator()
    • get_starts_ends_fields_from_gene_bed()
    • iter_components_by_src()
    • get_components_by_src()
    • iter_components_by_src_start()
    • get_components_by_src_start()
    • sort_block_components_by_block()
    • get_species_in_maf()
    • parse_species_option()
    • remove_temp_index_file()
    • get_fasta_header()
    • get_attributes_from_fasta_header()
    • iter_fasta_alignment()

Submodules

galaxy.tools.biotools module

Adapt Galaxy-agnostic abstraction galaxy.tool_util.biotools to Galaxy config and dependencies.

galaxy.tools.biotools.get_galaxy_biotools_metadata_source(config) → BiotoolsMetadataSource

Build a BiotoolsMetadataSource from a Galaxy configuration object.

galaxy.tools.cache module

galaxy.tools.cache.encoder(obj)

galaxy.tools.cache.decoder(obj)

class galaxy.tools.cache.ToolDocumentCache(cache_dir)

Bases: object

__init__(cache_dir)

close()

property cache_file_is_writeable

reopen_ro()

get(config_file)

persist()

set(config_file, tool_source)

delete(config_file)

class galaxy.tools.cache.ToolCache

Bases: object

Cache tool definitions to allow quickly reloading the whole toolbox.

__init__()

assert_hashes_initialized()

cleanup()

Remove uninstalled tools from tool cache if they are not on disk anymore or if their content has changed.

Returns list of tool_ids that have been removed.

get_tool(config_filename)

Get the tool at config_filename from the cache if the tool is up to date.

get_removed_tool(config_filename)

get_tool_by_id(tool_id)

Get the tool with the id tool_id from the cache if the tool is up to date.

expire_tool(tool_id)

cache_tool(config_filename, tool)

reset_status()

Reset tracking of new and newly disabled tools.

class galaxy.tools.cache.ToolHash(path: str, modtime: float | None = None, lazy_hash: bool = False)

Bases: object

__init__(path: str, modtime: float | None = None, lazy_hash: bool = False)

modtime_less_than(other_modtime: float)

hash_equals(other_hash: str | None)

property modtime: float

property hash

galaxy.tools.data_fetch module

galaxy.tools.data_fetch.main(argv=None)

galaxy.tools.data_fetch.do_fetch(request_path: str, working_directory: str, registry: Registry, file_sources_dict: Dict | None = None)

galaxy.tools.data_fetch.elements_tree_map(f, items)

galaxy.tools.data_fetch.get_file_sources(working_directory, file_sources_as_dict=None)

class galaxy.tools.data_fetch.UploadConfig(request: Dict[str, Any], registry: Registry, working_directory: str, allow_failed_collections: bool, file_sources_dict: Dict | None = None)

Bases: object

__init__(request: Dict[str, Any], registry: Registry, working_directory: str, allow_failed_collections: bool, file_sources_dict: Dict | None = None)

property file_sources

get_option(item, key)

Return item[key] if specified otherwise use default from UploadConfig.

This default represents the default for the whole request instead item which is the option for individual files.

ensure_in_working_directory(path: str, purge_source, in_place) → str

galaxy.tools.errors module

Functionality for dealing with tool errors.

class galaxy.tools.errors.ErrorReporter(hda, app)

Bases: object

__init__(hda, app)

create_report(user, email='', message='', redact_user_details_in_bugreport=False, **kwd)

send_report(user, email=None, message=None, **kwd)

class galaxy.tools.errors.EmailErrorReporter(hda, app)

Bases: ErrorReporter

galaxy.tools.evaluation module

class galaxy.tools.evaluation.ToolErrorLog

Bases: object

__init__()

add_error(file, phase, exception)

exception galaxy.tools.evaluation.ToolTemplatingException(*args: object, tool_id: str | None, tool_version: str, is_latest: bool)

Bases: Exception

__init__(*args: object, tool_id: str | None, tool_version: str, is_latest: bool) → None

galaxy.tools.evaluation.global_tool_logs(func, config_file: str, action_str: str, tool: Tool)

class galaxy.tools.evaluation.ToolEvaluator(app: MinimalToolApp, tool, job, local_working_directory)

Bases: object

An abstraction linking together a tool and a job runtime to evaluate tool inputs in an isolated, testable manner.

materialize_datasets: bool = True

__init__(app: MinimalToolApp, tool, job, local_working_directory)

app: MinimalToolApp

job: Job

set_compute_environment(compute_environment: ComputeEnvironment, get_special: Callable | None = None)

Setup the compute environment and established the outline of the param_dict for evaluating command and config cheetah templates.

execute_tool_hooks(inp_data, out_data, incoming)

build_param_dict(incoming, input_datasets, output_datasets, output_collections)

Build the dictionary of parameters for substituting into the command line. Each value is wrapped in a InputValueWrapper, which allows all the attributes of the value to be used in the template, but when the __str__ method is called it actually calls the to_param_dict_string method of the associated input.

build()

Build runtime description of job to execute, evaluate command and config templates corresponding to this tool with these inputs on this compute environment.

get_oidc_token(inject)

class galaxy.tools.evaluation.PartialToolEvaluator(app: MinimalToolApp, tool, job, local_working_directory)

Bases: ToolEvaluator

ToolEvaluator that only builds Environment Variables.

materialize_datasets: bool = False

build()

Build runtime description of job to execute, evaluate command and config templates corresponding to this tool with these inputs on this compute environment.

app: MinimalToolApp

job: Job

file_sources_dict: Dict[str, Any]

param_dict: Dict[str, Any]

extra_filenames: List[str]

environment_variables: List[Dict[str, str]]

version_command_line: str | None

command_line: str | None

interactivetools: List[Dict[str, Any]]

class galaxy.tools.evaluation.RemoteToolEvaluator(app: MinimalToolApp, tool, job, local_working_directory)

Bases: ToolEvaluator

ToolEvaluator that skips unnecessary steps already executed during job setup.

materialize_datasets: bool = True

execute_tool_hooks(inp_data, out_data, incoming)

app: MinimalToolApp

job: Job

file_sources_dict: Dict[str, Any]

param_dict: Dict[str, Any]

extra_filenames: List[str]

environment_variables: List[Dict[str, str]]

version_command_line: str | None

command_line: str | None

interactivetools: List[Dict[str, Any]]

build()

Build runtime description of job to execute, evaluate command and config templates corresponding to this tool with these inputs on this compute environment.

galaxy.tools.exception_handling module

class galaxy.tools.exception_handling.UCSCOutWrapper(other)

Bases: object

File-like object that throws an exception if it encounters the UCSC limit error lines

__init__(other)

next()

readline()

exception galaxy.tools.exception_handling.UCSCLimitException

Bases: Exception

galaxy.tools.execute module

Once state information has been calculated, handle actually executing tools from various states, tracking results, and building implicit dataset collections from matched collections.

galaxy.tools.execute.execute(trans, tool: Tool, mapping_params: MappingParameters, history: History, rerun_remap_job_id: int | None = None, preferred_object_store_id: str | None = None, collection_info: MatchingCollections | None = None, workflow_invocation_uuid: str | None = None, invocation_step: WorkflowInvocationStep | None = None, max_num_jobs: int | None = None, job_callback: Callable | None = None, completed_jobs: Dict[int, Job | None] | None = None, workflow_resource_parameters: Dict[str, Any] | None = None, validate_outputs: bool = False)

Execute a tool and return object containing summary (output data, number of failures, etc…).

galaxy.tools.recommendations module

Compute tool recommendations

class galaxy.tools.recommendations.ToolRecommendations

Bases: object

max_seq_len = 25

ff_dim = 128

embed_dim = 128

num_heads = 4

dropout = 0.1

__init__()

create_transformer_model(vocab_size)

get_predictions(trans, tool_sequence, remote_model_url)

Compute tool predictions

galaxy.tools.remote_tool_eval module

class galaxy.tools.remote_tool_eval.ToolAppConfig(name, tool_data_path, galaxy_data_manager_data_path, nginx_upload_path, len_file_path, builds_file_path, root, is_admin_user, admin_users)

Bases: tuple

name: str

Alias for field number 0

tool_data_path: str

Alias for field number 1

galaxy_data_manager_data_path: str

Alias for field number 2

nginx_upload_path: str

Alias for field number 3

len_file_path: str

Alias for field number 4

builds_file_path: str

Alias for field number 5

root: str

Alias for field number 6

is_admin_user: Callable

Alias for field number 7

admin_users: list

Alias for field number 8

class galaxy.tools.remote_tool_eval.ToolApp(sa_session: SessionlessContext, tool_app_config: ToolAppConfig, datatypes_registry: Registry, object_store: BaseObjectStore, tool_data_table_manager: ToolDataTableManager, file_sources: ConfiguredFileSources)

Bases: MinimalToolApp

Dummy App that allows loading tools

name: str = 'tool_app'

is_webapp: bool = False

__init__(sa_session: SessionlessContext, tool_app_config: ToolAppConfig, datatypes_registry: Registry, object_store: BaseObjectStore, tool_data_table_manager: ToolDataTableManager, file_sources: ConfiguredFileSources)

config: Any

datatypes_registry: Registry

object_store: BaseObjectStore

tool_data_tables: ToolDataTableManager

file_sources: ConfiguredFileSources

security: IdEncodingHelper

galaxy.tools.remote_tool_eval.main(TMPDIR, WORKING_DIRECTORY, IMPORT_STORE_DIRECTORY) → None

galaxy.tools.repositories module

Provides a subset of app for verifying tools.

class galaxy.tools.repositories.ValidationContextConfig

Bases: object

tool_data_path: str | None

shed_tool_data_path: str | None

tool_data_table_config: str

shed_tool_data_table_config: str

interactivetools_enable: bool

len_file_path: str

builds_file_path: str | None

class galaxy.tools.repositories.ValidationContext(app_name: str, model, security, tool_data_path, shed_tool_data_path, tool_data_tables=None, registry=None, hgweb_config_manager=None, biotools_metadata_source=None)

Bases: object

Minimal App object for tool validation.

is_webapp = True

__init__(app_name: str, model, security, tool_data_path, shed_tool_data_path, tool_data_tables=None, registry=None, hgweb_config_manager=None, biotools_metadata_source=None)

config: ValidationContextConfig

static from_app(app, work_dir=None)

galaxy.tools.special_tools module

galaxy.tools.special_tools.load_lib_tools(toolbox)

galaxy.tools.test module

galaxy.tools.wrappers module

class galaxy.tools.wrappers.ToolParameterValueWrapper

Bases: object

Base class for object that Wraps a Tool Parameter and Value.

value: str | List[str] | None

input: ToolParameter

get_display_text(quote: bool = True) → str

Returns a string containing the value that would be displayed to the user in the tool interface. When quote is True (default), the string is escaped for e.g. command-line usage.

class galaxy.tools.wrappers.RawObjectWrapper(obj: Any)

Bases: ToolParameterValueWrapper

Wraps an object so that __str__ returns module_name:class_name.

__init__(obj: Any)

value: str | List[str] | None

input: ToolParameter

class galaxy.tools.wrappers.InputValueWrapper(input: ToolParameter, value: str | None, other_values: Dict[str, str] | None = None, profile: float | None = None)

Bases: ToolParameterValueWrapper

Wraps an input so that __str__ gives the “param_dict” representation.

__init__(input: ToolParameter, value: str | None, other_values: Dict[str, str] | None = None, profile: float | None = None) → None

input: ToolParameter

value: str | List[str] | None

class galaxy.tools.wrappers.SelectToolParameterWrapper(input: SelectToolParameter, value: str | List[str], other_values: Dict[str, str] | None = None, compute_environment: ComputeEnvironment | None = None)

Bases: ToolParameterValueWrapper

Wraps a SelectTooParameter so that __str__ returns the selected value, but all other attributes are accessible.

class SelectToolParameterFieldWrapper(input: SelectToolParameter, value: str | List[str], other_values: Dict[str, str] | None, compute_environment: ComputeEnvironment | None)

Bases: object

Provide access to any field by name or index for this particular value. Only applicable for dynamic_options selects, which have more than simple ‘options’ defined (name, value, selected).

__init__(input: SelectToolParameter, value: str | List[str], other_values: Dict[str, str] | None, compute_environment: ComputeEnvironment | None) → None

__init__(input: SelectToolParameter, value: str | List[str], other_values: Dict[str, str] | None = None, compute_environment: ComputeEnvironment | None = None)

input: SelectToolParameter

class galaxy.tools.wrappers.DatasetFilenameWrapper(dataset: DatasetInstance | DatasetCollectionElement | None, datatypes_registry: Registry | None = None, tool: Tool | None = None, name: str | None = None, compute_environment: ComputeEnvironment | None = None, identifier: str | None = None, io_type: str = 'input', formats: List[str] | None = None)

Bases: ToolParameterValueWrapper

Wraps a dataset so that __str__ returns the filename, but all other attributes are accessible.

class MetadataWrapper(dataset: DatasetInstance, compute_environment: ComputeEnvironment | None = None)

Bases: object

Wraps a Metadata Collection to return MetadataParameters wrapped according to the metadata spec. Methods implemented to match behavior of a Metadata Collection.

__init__(dataset: DatasetInstance, compute_environment: ComputeEnvironment | None = None) → None

element_is_set(name: str) → bool

get(key: str, default: Any | None = None) → Any

items() → Iterator[Tuple[str, Any]]

__init__(dataset: DatasetInstance | DatasetCollectionElement | None, datatypes_registry: Registry | None = None, tool: Tool | None = None, name: str | None = None, compute_environment: ComputeEnvironment | None = None, identifier: str | None = None, io_type: str = 'input', formats: List[str] | None = None) → None

false_path: str | None

property element_identifier: str

property file_ext: str

property name_and_ext: str

get_staging_path(invalid_chars: Sequence[str] = ('/',)) → str

Strip leading dots, unicode null chars, replace / with _, truncate at 255 characters.

Not safe for commandline use, would need additional sanitization.

property all_metadata_files: List[Tuple[str, str]]

serialize(invalid_chars: Sequence[str] = ('/',)) → Dict[str, Any]

property is_collection: bool

property is_deferred: bool

is_of_type(*exts: str) → bool

property file_name: str

class galaxy.tools.wrappers.HasDatasets

Bases: object

job_working_directory: str | None

paths_as_file(sep: str = '\n') → str

class galaxy.tools.wrappers.DatasetListWrapper(job_working_directory: str | None, datasets: Sequence[None | DatasetInstance | DatasetCollectionInstance | DatasetCollectionElement] | DatasetInstance, **kwargs: Any)

Bases: List[DatasetFilenameWrapper], ToolParameterValueWrapper, HasDatasets

__init__(job_working_directory: str | None, datasets: Sequence[None | DatasetInstance | DatasetCollectionInstance | DatasetCollectionElement] | DatasetInstance, **kwargs: Any) → None

static to_dataset_instances(dataset_instance_sources: Any) → List[None | DatasetInstance]

get_datasets_for_group(group: str) → List[DatasetFilenameWrapper]

serialize(invalid_chars: Sequence[str] = ('/',)) → List[Dict[str, Any]]

value: str | List[str] | None

input: ToolParameter

class galaxy.tools.wrappers.DatasetCollectionWrapper(job_working_directory: str | None, has_collection: None | DatasetCollectionElement | HistoryDatasetCollectionAssociation, datatypes_registry: Registry, **kwargs: Any)

Bases: ToolParameterValueWrapper, HasDatasets

__init__(job_working_directory: str | None, has_collection: None | DatasetCollectionElement | HistoryDatasetCollectionAssociation, datatypes_registry: Registry, **kwargs: Any) → None

name: str | None

collection: DatasetCollection

get_datasets_for_group(group: str) → List[DatasetFilenameWrapper]

keys() → List[str] | KeysView[Any]

property is_collection: bool

property element_identifier: str | None

property all_paths: List[str]

property all_metadata_files: List[List[str]]

property element_identifiers_extensions_paths_and_metadata_files: List[List[Any]]

get_all_staging_paths(invalid_chars: Sequence[str] = ('/',), include_collection_name: bool = False) → List[str]

serialize(invalid_chars: Sequence[str] = ('/',), include_collection_name: bool = False) → List[Dict[str, Any]]

property is_input_supplied: bool

class galaxy.tools.wrappers.ElementIdentifierMapper(input_datasets: Dict[str, Any] | None = None)

Bases: object

Track mapping of dataset collection elements datasets to element identifiers.

__init__(input_datasets: Dict[str, Any] | None = None) → None

identifier(dataset_value: str, input_values: Dict[str, str]) → str | None