Warning

This document is for an old release 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.selenium package

Top-level of library designed to ease use of Selenium targetting Galaxy.

galaxy_selenium is purposes being designed to depend on Python selenium, six, pyyaml, and optional pyvirtualdisplay but not galaxy-lib (or any of Galaxy or Galaxy’s test stuff) currently.

Subpackages

• galaxy.selenium.scripts package
  • Submodules
  • galaxy.selenium.scripts.dump_tour module
• galaxy.selenium.toolbox package
  • Submodules
  • galaxy.selenium.toolbox.filters module

Submodules

galaxy.selenium.cli module

galaxy.selenium.cli.add_selenium_arguments(parser)

Add common selenium arguments for argparse driver utility.

class galaxy.selenium.cli.DriverWrapper(args)

Bases: galaxy.selenium.navigates_galaxy.NavigatesGalaxy

Adapt argparse command-line options to a concrete Selenium driver.

__init__(args)

Initialize self. See help(type(self)) for accurate signature.

build_url(url='')

property default_timeout

finish()

galaxy.selenium.components module

class galaxy.selenium.components.Target

Bases: object

abstract property description

Return a plain-text description of the browser target for logging/messages.

abstract property element_locator

Return a (by, selector) Selenium elment locator tuple for this selector.

class galaxy.selenium.components.SelectorTemplate(selector, selector_type, children=None, kwds=None, with_classes=None)

Bases: galaxy.selenium.components.Target

__init__(selector, selector_type, children=None, kwds=None, with_classes=None)

Initialize self. See help(type(self)) for accurate signature.

static from_dict(raw_value, children=None)

with_class(class_)

descendant(has_selector)

property description

Return a plain-text description of the browser target for logging/messages.

property selector

property element_locator

Return a (by, selector) Selenium elment locator tuple for this selector.

property as_css_class

class galaxy.selenium.components.Label(text)

Bases: galaxy.selenium.components.Target

__init__(text)

Initialize self. See help(type(self)) for accurate signature.

property description

Return a plain-text description of the browser target for logging/messages.

property element_locator

Return a (by, selector) Selenium elment locator tuple for this selector.

class galaxy.selenium.components.Text(text)

Bases: galaxy.selenium.components.Target

__init__(text)

Initialize self. See help(type(self)) for accurate signature.

property description

Return a plain-text description of the browser target for logging/messages.

property element_locator

Return a (by, selector) Selenium elment locator tuple for this selector.

class galaxy.selenium.components.Component(name, sub_components, selectors, labels, text)

Bases: object

__init__(name, sub_components, selectors, labels, text)

Initialize self. See help(type(self)) for accurate signature.

property selector

static from_dict(name, raw_value)

galaxy.selenium.context module

class galaxy.selenium.context.GalaxySeleniumContext

Bases: galaxy.selenium.navigates_galaxy.NavigatesGalaxy

url: str

target_url_from_selenium: str

build_url(url: str, for_selenium: bool = True) → str

property driver

screenshot(label: str)

If GALAXY_TEST_SCREENSHOTS_DIRECTORY is set create a screenshot there named <label>.png.

Unlike the above “snapshot” feature, this will be written out regardless and not in a per-test directory. The above method is used for debugging failures within a specific test. This method if more for creating a set of images to augment automated testing with manual human inspection after a test or test suite has executed.

class galaxy.selenium.context.GalaxySeleniumContextImpl(from_dict: Optional[dict] = None)

Bases: galaxy.selenium.context.GalaxySeleniumContext

Minimal, simplified GalaxySeleniumContext useful outside the context of test cases.

A variant of this concept that can also populate content via the API to then interact with via the Selenium is galaxy_test.selenium.framework.GalaxySeleniumContextImpl.

__init__(from_dict: Optional[dict] = None) → None

Initialize self. See help(type(self)) for accurate signature.

url: str

target_url_from_selenium: str

galaxy.selenium.context.init(config=None, clazz=<class 'galaxy.selenium.context.GalaxySeleniumContextImpl'>) → galaxy.selenium.context.GalaxySeleniumContext

galaxy.selenium.data module

galaxy.selenium.data.load_root_component()

galaxy.selenium.driver_factory module

class galaxy.selenium.driver_factory.ConfiguredDriver(browser='auto', remote=False, remote_host='127.0.0.1', remote_port='4444', headless=False)

Bases: object

__init__(browser='auto', remote=False, remote_host='127.0.0.1', remote_port='4444', headless=False)

Initialize self. See help(type(self)) for accurate signature.

driver: selenium.webdriver.remote.webdriver.WebDriver

to_dict()

static from_dict(as_dict)

galaxy.selenium.driver_factory.get_local_driver(browser='auto', headless=False) → selenium.webdriver.remote.webdriver.WebDriver

galaxy.selenium.driver_factory.get_remote_driver(host, port, browser='auto') → selenium.webdriver.remote.webdriver.WebDriver

galaxy.selenium.driver_factory.is_virtual_display_available()

galaxy.selenium.driver_factory.virtual_display_if_enabled(enabled)

galaxy.selenium.has_driver module

A mixin to extend a class that has self.driver with higher-level constructs.

This should be mixed into classes with a self.driver and self.default_timeout attribute.

galaxy.selenium.has_driver.exception_indicates_not_clickable(exception)

galaxy.selenium.has_driver.exception_indicates_stale_element(exception)

class galaxy.selenium.has_driver.HasDriver

Bases: object

exception TimeoutException(msg=None, screen=None, stacktrace=None)

Bases: selenium.common.exceptions.WebDriverException

Thrown when a command does not complete in enough time.

assert_xpath(xpath)

assert_selector(selector)

assert_selector_absent_or_hidden(selector)

assert_absent_or_hidden(selector_template)

selector_is_displayed(selector)

is_displayed(selector_template)

assert_selector_absent(selector)

find_elements(selector_template)

assert_absent(selector_template)

wait_for_xpath(xpath, **kwds)

wait_for_xpath_visible(xpath, **kwds)

wait_for_selector(selector, **kwds)

wait_for_present(selector_template, **kwds)

wait_for_visible(selector_template, **kwds)

wait_for_selector_visible(selector, **kwds)

wait_for_selector_clickable(selector, **kwds)

wait_for_clickable(selector_template, **kwds)

wait_for_selector_absent_or_hidden(selector, **kwds)

wait_for_selector_absent(selector, **kwds)

wait_for_absent(selector_template, **kwds)

wait_for_absent_or_hidden(selector_template, **kwds)

wait_for_id(id, **kwds)

click(selector_template)

action_chains()

send_enter(element)

send_escape(element)

send_backspace(element)

wait(timeout=<object object>, **kwds)

click_xpath(xpath)

click_label(text)

click_selector(selector)

fill(form, info)

click_submit(form)

prepend_timeout_message(timeout_exception, message)

exception galaxy.selenium.has_driver.TimeoutException(msg=None, screen=None, stacktrace=None)

Bases: selenium.common.exceptions.WebDriverException

Thrown when a command does not complete in enough time.

galaxy.selenium.jupyter_context module

galaxy.selenium.jupyter_context.init(config=None)

class galaxy.selenium.jupyter_context.JupyterContextImpl(from_dict: Optional[dict] = None)

Bases: galaxy.selenium.context.GalaxySeleniumContextImpl

screenshot(label)

If GALAXY_TEST_SCREENSHOTS_DIRECTORY is set create a screenshot there named <label>.png.

Unlike the above “snapshot” feature, this will be written out regardless and not in a per-test directory. The above method is used for debugging failures within a specific test. This method if more for creating a set of images to augment automated testing with manual human inspection after a test or test suite has executed.

url: str

target_url_from_selenium: str

galaxy.selenium.navigates_galaxy module

A mixing that extends a HasDriver class with Galaxy-specific utilities.

Implementer must provide a self.build_url method to target Galaxy.

class galaxy.selenium.navigates_galaxy.WaitType(name, default_length)

Bases: tuple

property default_length

Alias for field number 1

property name

Alias for field number 0

class galaxy.selenium.navigates_galaxy.WAIT_TYPES

Bases: object

UX_RENDER = WaitType(name='ux_render', default_length=1)

UX_TRANSITION = WaitType(name='ux_transition', default_length=5)

UX_POPUP = WaitType(name='ux_popup', default_length=15)

DATABASE_OPERATION = WaitType(name='database_operation', default_length=10)

JOB_COMPLETION = WaitType(name='job_completion', default_length=30)

GIE_SPAWN = WaitType(name='gie_spawn', default_length=30)

SHED_SEARCH = WaitType(name='shed_search', default_length=30)

REPO_INSTALL = WaitType(name='repo_install', default_length=60)

class galaxy.selenium.navigates_galaxy.NullTourCallback

Bases: object

handle_step(step, step_index)

galaxy.selenium.navigates_galaxy.exception_seems_to_indicate_transition(e)

True if exception seems to indicate the page state is transitioning.

Galaxy features many different transition effects that change the page state over time. These transitions make it slightly more difficult to test Galaxy because atomic input actions take an indeterminate amount of time to be reflected on the screen. This method takes a Selenium assertion and tries to infer if such a transition could be the root cause of the exception. The methods that follow use it to allow retrying actions during transitions.

Currently the two kinds of exceptions that we say may indicate a transition are StaleElement exceptions (a DOM element grabbed at one step is no longer available) and “not clickable” exceptions (so perhaps a popup modal is blocking a click).

galaxy.selenium.navigates_galaxy.retry_call_during_transitions(f, attempts=10, sleep=0.1, exception_check=<function exception_seems_to_indicate_transition>)

galaxy.selenium.navigates_galaxy.retry_during_transitions(f, attempts=10, sleep=0.1, exception_check=<function exception_seems_to_indicate_transition>)

class galaxy.selenium.navigates_galaxy.NavigatesGalaxy

Bases: galaxy.selenium.has_driver.HasDriver

Class with helpers methods for driving components of the Galaxy interface.

In most cases, methods for interacting with Galaxy components that appear in multiple tests or applications should be refactored into this class for now. Keep in mind that this class is used outside the context of TestCase s as well - so some methods more explicitly related to test data or assertion checking may make more sense in SeleniumTestCase for instance.

Some day this class will likely be split up into smaller mixins for particular components of Galaxy, but until that day the best practice is to prefix methods for driving or querying the interface with the name of the component or page the method operates on. These serve as pseudo-namespaces until we decompose this class. For instance, the method for clicking an option in the workflow editor is workflow_editor_click_option instead of click_workflow_editor_option.

default_password = '123456'

wait_types

alias of galaxy.selenium.navigates_galaxy.WAIT_TYPES

get(url='')

property navigation

property components

wait_length(wait_type)

sleep_for(wait_type)

sleep_for_seconds(duration)

timeout_for(**kwds)

home()

trs_search()

trs_by_id()

switch_to_main_panel()

local_storage(key, value)

main_panel()

api_get(endpoint, data=None, raw=False)

api_post(endpoint, data=None)

api_delete(endpoint, raw=False)

get_galaxy_session()

selenium_to_requests_cookies()

history_panel_name_element()

history_panel_name()

make_accessible_and_publishable()

history_contents(history_id=None, view='summary', datasets_only=True)

current_history()

current_history_id()

latest_history_item()

wait_for_history(assert_ok=True)

history_panel_create_new_with_name(name)

history_panel_create_new()

Click create new and pause a bit for the history to begin to refresh.

history_panel_wait_for_hid_ok(hid, allowed_force_refreshes=0)

history_panel_item_component(history_item=None, hid=None)

history_panel_wait_for_hid_visible(hid, allowed_force_refreshes=0)

hid_to_history_item(hid, current_history_id=None)

history_item_wait_for(history_item_selector, allowed_force_refreshes)

history_panel_wait_for_history_loaded()

history_panel_wait_for_hid_hidden(hid)

history_panel_wait_for_hid_state(hid, state, allowed_force_refreshes=0)

click_grid_popup_option(item_name, option_label)

published_grid_search_for(search_term=None)

get_logged_in_user()

get_api_key(force=False)

get_user_id()

is_logged_in()

submit_login(email, password=None, assert_valid=True, retries=0)

register(email=None, password=None, username=None, confirm=None, assert_valid=True)

wait_for_logged_in()

click_center()

perform_upload(test_path, **kwd)

perform_upload_of_pasted_content(paste_data, **kwd)

upload_list(test_paths, name='test', ext=None, genome=None, hide_source_items=True)

upload_pair(test_paths, name='test', ext=None, genome=None, hide_source_items=True)

upload_paired_list(test_paths, name='test', ext=None, genome=None, hide_source_items=True)

upload_tab_click(tab)

upload_start_click()

upload_set_footer_extension(ext, tab_id='regular')

upload_set_footer_genome(genome, tab_id='regular')

upload_set_collection_type(collection_type)

upload_start(tab_id='regular')

upload_build(tab='collection')

upload_queue_local_file(test_path, tab_id='regular')

upload_paste_data(pasted_content, tab_id='regular')

upload_rule_start()

upload_rule_build()

upload_rule_set_data_type(type_description)

upload_rule_set_input_type(input_description)

upload_rule_set_dataset(row=1)

rule_builder_set_collection_name(name)

rule_builder_set_extension(extension)

rule_builder_filter_count(count=1)

rule_builder_sort(column_label, screenshot_name=None)

rule_builder_add_regex_groups(column_label, group_count, regex, screenshot_name)

rule_builder_add_regex_replacement(column_label, regex, replacement, screenshot_name=None)

rule_builder_add_value(value, screenshot_name=None)

rule_builder_remove_columns(column_labels, screenshot_name=None)

rule_builder_concatenate_columns(column_label_1, column_label_2, screenshot_name=None)

rule_builder_split_columns(column_labels_1, column_labels_2, screenshot_name=None)

rule_builder_swap_columns(column_label_1, column_label_2, screenshot_name)

rule_builder_rule_editor(rule_type)

rule_builder_set_mapping(mapping_type, column_label, screenshot_name=None)

rule_builder_set_source(json)

rule_builder_enter_source_text(json)

workflow_editor_click_option(option_label)

workflow_editor_click_options()

workflow_editor_options_menu_element()

workflow_editor_click_run()

workflow_editor_click_save()

navigate_to_histories_page()

navigate_to_user_preferences()

navigate_to_invocations()

admin_open()

select_dataset_from_lib_import_modal(filenames)

create_new_library(login=True)

libraries_open()

libraries_open_with_name(name)

libraries_index_table_elements()

libraries_index_create(name)

libraries_index_click_search()

libraries_index_sort_selector()

libraries_index_sort_click()

libraries_index_search_for(text)

libraries_folder_create(name)

libraries_click_dataset_import()

libraries_dataset_import(btn)

libraries_dataset_import_from_history_select(to_select_items)

libraries_dataset_import_from_history_click_ok(wait=True)

libraries_table_elements()

populate_library_folder_from_import_dir(library_name, filenames)

navigate_to_new_library(login=True)

wait_for_overlays_cleared()

Wait for modals and Toast notifications to disappear.

clear_tooltips()

workflow_index_open()

workflow_index_table_elements()

workflow_index_table_row(workflow_index=0)

workflow_index_column_text(column_index, workflow_index=0)

workflow_index_click_search()

workflow_index_search_for(search_term=None)

workflow_index_click_import()

workflow_index_rename(new_name, workflow_index=0)

workflow_index_name(workflow_index=0)

Get workflow name for workflow_index’th row.

workflow_click_option(workflow_selector, workflow_index=0)

select_dropdown_item(option_title)

workflow_index_click_option(option_title, workflow_index=0)

workflow_index_click_tag_display(workflow_index=0)

workflow_index_tags(workflow_index=0)

workflow_import_submit_url(url)

workflow_sharing_click_publish()

tagging_add(tags, auto_closes=True, parent_selector='')

workflow_run_submit()

tool_open(tool_id, outer=False)

tool_parameter_div(expanded_parameter_id)

tool_parameter_edit_rules(expanded_parameter_id='rules')

tool_set_value(expanded_parameter_id, value, expected_type=None, test_data_resolver=None)

tool_form_generate_tour()

tool_form_execute()

click_masthead_user()

click_masthead_shared_data()

click_masthead_workflow()

click_button_new_workflow()

wait_for_sizzle_selector_clickable(selector)

click_history_options()

click_history_option(option_label)

history_click_create_new()

history_panel_click_copy_elements()

histories_click_advanced_search()

histories_get_history_names()

history_panel_add_tags(tags)

history_panel_rename(new_name)

history_panel_click_to_rename()

history_panel_refresh_click()

history_panel_multi_operations_show()

history_panel_muli_operation_select_hid(hid)

history_panel_multi_operation_action_click(action)

history_multi_view_display_collection_contents(collection_hid, collection_type='list')

history_panel_item_click_visualization_menu(hid)

history_panel_item_available_visualizations_elements(hid)

history_panel_item_get_nametags(hid)

history_panel_item_available_visualizations(hid)

history_panel_item_click_visualization(hid, visualization_name)

history_panel_item_selector(hid, wait=False)

modal_body_selector()

history_panel_item_body_component(hid, wait=False)

hda_click_primary_action_button(hid, button_key)

history_panel_click_item_title(hid, **kwds)

history_panel_ensure_showing_item_details(hid)

history_panel_item_showing_details(hid)

collection_builder_set_name(name)

collection_builder_hide_originals()

collection_builder_create()

collection_builder_clear_filters()

collection_builder_click_paired_item(forward_or_reverse, item)

logout_if_needed()

logout()

run_tour(path, skip_steps=None, sleep_on_steps=None, tour_callback=None)

tour_wait_for_clickable_element(selector)

tour_wait_for_element_present(selector)

get_tooltip_text(element, sleep=0, click_away=True)

assert_selector_absent_or_hidden_after_transitions(selector)

Variant of assert_selector_absent_or_hidden that retries during transitions.

In the parent method - the element is found and then it is checked to see if it is visible. It may disappear from the page in the middle there and cause a StaleElement error. For checks where we care about the final resting state after transitions - this method can be used to retry during those transitions.

assert_absent_or_hidden_after_transitions(selector)

Variant of assert_absent_or_hidden that retries during transitions.

See details above for more information about this.

assert_tooltip_text(element, expected, sleep=0, click_away=True)

assert_error_message(contains=None)

assert_warning_message(contains=None)

assert_message(element, contains=None)

assert_no_error_message()

run_tour_step(step, step_index, tour_callback)

wait_for_and_click_selector(selector)

wait_for_and_click(selector_template)

set_history_annotation(annotation, clear_text=False)

ensure_history_annotation_area_displayed()

select2_set_value(container_selector_or_elem, value, with_click=True, clear_value=False)

snapshot(description)

Test case subclass overrides this to provide detailed logging.

exception galaxy.selenium.navigates_galaxy.NotLoggedInException(timeout_exception, user_info, dom_message)

Bases: selenium.common.exceptions.TimeoutException

__init__(timeout_exception, user_info, dom_message)

Initialize self. See help(type(self)) for accurate signature.

galaxy.selenium.sizzle module

Utilities for using sizzle (jQuery-style) selectors with Selenium.

galaxy.selenium.sizzle.find_element_by_sizzle(driver, sizzle_selector: str)

Finds an element by sizzle selector.

Parameters

sizzle_selector – The sizzle selector to use when finding element.

galaxy.selenium.sizzle.find_elements_by_sizzle(driver, sizzle_selector: str)

Finds elements by sizzle selector.

Parameters

sizzle_selector – The sizzle selector to use when finding elements.

galaxy.selenium.sizzle.sizzle_selector_clickable(selector)

galaxy.selenium.sizzle.sizzle_presence_of_selector(selector)

galaxy.selenium.smart_components module

class galaxy.selenium.smart_components.SmartComponent(component, has_driver)

Bases: object

Wrap a Component with driver aware methods.

Allows smarter selectors that know how to wait for themselves, test themselves, click themselves, etc…. More “magic”, but much cleaner usage.

__init__(component, has_driver)

Initialize self. See help(type(self)) for accurate signature.

class galaxy.selenium.smart_components.SmartTarget(target, has_driver)

Bases: object

Wrap a Target with driver aware methods.

__init__(target, has_driver)

Initialize self. See help(type(self)) for accurate signature.

all()

wait_for_and_click(**kwds)

wait_for_visible(**kwds)

wait_for_clickable(**kwds)

wait_for_text(**kwds)

wait_for_value(**kwds)

property is_displayed

wait_for_absent_or_hidden(**kwds)

wait_for_absent(**kwds)

wait_for_present(**kwds)

assert_absent(**kwds)

assert_absent_or_hidden(**kwds)

assert_absent_or_hidden_after_transitions(**kwds)

has_class(class_name)

wait_for_and_send_keys(*text)