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.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

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)

build_url(url='')

default_timeout

finish()

galaxy.selenium.components module

class galaxy.selenium.components.Target

Bases: object

description

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

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)

static from_dict(raw_value, children=None)

with_class(class_)

descendant(has_selector)

description

selector

element_locator

as_css_class

class galaxy.selenium.components.Label(text)

Bases: galaxy.selenium.components.Target

__init__(text)

description

element_locator

class galaxy.selenium.components.Text(text)

Bases: galaxy.selenium.components.Target

__init__(text)

description

element_locator

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

Bases: object

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

selector

static from_dict(name, raw_value)

galaxy.selenium.data module

galaxy.selenium.driver_factory module

galaxy.selenium.driver_factory.get_local_driver(browser='auto', headless=False)

galaxy.selenium.driver_factory.get_remote_driver(host, port, browser='auto')

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.

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)

galaxy.selenium.has_driver.exception_indicates_not_clickable(exception)

galaxy.selenium.has_driver.exception_indicates_stale_element(exception)

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.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

default_length

Alias for field number 1

name

Alias for field number 0

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 psedu-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 = <galaxy.util.bunch.Bunch object>

get(url='')

navigation

components

wait_length(wait_type)

sleep_for(wait_type)

sleep_for_seconds(duration)

timeout_for(**kwds)

home()

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()

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, ext=None, genome=None, ext_all=None, genome_all=None)

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_rule_start()

upload_rule_build()

upload_rule_set_data_type(type_description)

upload_rule_set_input_type(input_description)

upload_rule_set_dataset(dataset_description='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_user_preferences()

admin_open()

libraries_open()

libraries_open_with_name(name)

libraries_index_table_elements()

libraries_index_click_create_new()

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_from_history()

libraries_dataset_import_from_path()

libraries_dataset_import_from_history_select(to_select_items)

libraries_dataset_import_from_history_click_ok(wait=True)

libraries_table_elements()

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()

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)

galaxy.selenium.sizzle module

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

galaxy.selenium.sizzle.sizzle_selector_clickable(selector)

galaxy.selenium.sizzle.sizzle_presence_of_selector(selector)

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

Finds an element by sizzle selector. :Args:

• sizzle_selector: The sizzle selector to use when finding element.

Usage:driver.find_element_by_sizzle(‘#foo’)

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

Finds elements by sizzle selector. :Args:

• sizzle_selector: The sizzle selector to use when finding elements.

Usage:driver.find_elements_by_sizzle(‘.foo’)

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)

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

Bases: object

Wrap a Target with driver aware methods.

__init__(target, has_driver)

all()

wait_for_and_click(**kwds)

wait_for_visible(**kwds)

wait_for_clickable(**kwds)

wait_for_text(**kwds)

wait_for_value(**kwds)

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)