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_test.selenium package

Subpackages

• galaxy_test.selenium.jupyter package
  • Example Notebooks
  • Developing Galaxy Test Cases Interactively with Jupyter
    • The Setup
    • Filling out Tests

Submodules

galaxy_test.selenium.conftest module

galaxy_test.selenium.conftest.real_driver()

galaxy_test.selenium.conftest.embedded_driver(real_driver, request)

galaxy_test.selenium.framework module

Basis for Selenium test framework.

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

galaxy_test.selenium.jupyter_context module

Variant of JuypterContextImpl that can also use populators.

This provides an environment separate from test cases that can leaverage both Selenium for testing Galaxy with a browser and API populators for filling in fixture data rapidly in the target Galaxy.

class galaxy_test.selenium.jupyter_context.JupyterTestContextImpl(from_dict: dict | None = None)

Bases: JupyterContextImpl, GalaxyTestSeleniumContext

__init__(from_dict: dict | None = None) → None

test_login()

url: str

target_url_from_selenium: str

configured_driver: ConfiguredDriver

timeout_multiplier: float

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

galaxy_test.selenium.test_admin_app module

class galaxy_test.selenium.test_admin_app.TestAdminApp

Bases: SeleniumTestCase

run_as_admin = True

test_html_allowlist()

test_admin_toolshed()

This tests installing a repository, checking for upgrades, and uninstalling.

A repository named a_selenium_test_repo has been created for this test, owned by devteam@galaxyproject.org. The repository contains a tool with two versions, and the oldest version gets installed so that there will be an upgrade available on the ‘Installed Only’ view. Unfortunately, since this test relies on the presence of the toolshed server, in some cases it will fail even if the galaxy code is correct, necessitating the use of the @flakey decorator.

test_admin_dependencies_display()

test_admin_jobs_display()

test_admin_server_display()

test_admin_user_display()

test_admin_data_manager()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_anon_history module

class galaxy_test.selenium.test_anon_history.TestAnonymousHistories

Bases: SeleniumTestCase

test_anon_history_landing()

test_anon_history_upload()

test_anon_history_after_registration()

test_clean_anon_history_after_logout()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_change_password module

class galaxy_test.selenium.test_change_password.TestChangePassword

Bases: SeleniumTestCase

test_change_password()

test_new_password_password()

test_no_password_confirmation()

test_currect_password_incorrect()

test_new_password_short()

test_new_password_same_password()

register_and_change_password()

fill_input_fields(current, password, confirm)

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_collection_builders module

class galaxy_test.selenium.test_collection_builders.TestCollectionBuilders

Bases: SeleniumTestCase

ensure_registered = True

test_build_list_simple_hidden()

test_build_list_and_show_items()

test_build_paired_list_simple()

test_build_paired_list_show_original()

test_build_simple_list_via_rules_hidden()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_collection_edit module

class galaxy_test.selenium.test_collection_edit.TestCollectionEdit

Bases: SeleniumTestCase

ensure_registered = True

test_change_dbkey_simple_list()

test_change_datatype_simple_list()

open_collection_edit_view()

navigate_to_database_tab()

navigate_to_datatype_tab()

check_current_data_value(dataValue)

change_dbkey_value_and_click_submit(dataValue, dataNew)

change_datatype_value_and_click_submit(dataValue, dataNew)

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_custom_builds module

class galaxy_test.selenium.test_custom_builds.TestCustomBuilds

Bases: SharedStateSeleniumTestCase

user_email: str

build_name1: str

build_name2: str

build_key1: str

build_key2: str

test_build_add()

test_build_delete()

assert_custom_builds_in_grid(expected_builds, present=True)

add_custom_build(build_name, build_key)

delete_custom_build(build_name)

get_custom_builds()

navigate_to_custom_builds_page()

setup_shared_state()

Override this to setup shared data for tests that gets initialized only once.

galaxy_test.selenium.test_data_source_tools module

class galaxy_test.selenium.test_data_source_tools.TestDataSource

Bases: SeleniumTestCase, UsesHistoryItemAssertions

ensure_registered = True

test_ucsc_table_direct1_data_source()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_dataset_metadata_download module

class galaxy_test.selenium.test_dataset_metadata_download.TestHistoryDatasetState

Bases: SeleniumTestCase, UsesHistoryItemAssertions

ensure_registered = True

test_dataset_metadata_download()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_histories_list module

class galaxy_test.selenium.test_histories_list.TestSavedHistories

Bases: SharedStateSeleniumTestCase

test_histories_list()

test_history_switch()

test_history_view()

test_history_publish()

test_rename_history()

test_delete_and_undelete_history()

test_permanently_delete_history()

test_delete_and_undelete_multiple_histories()

test_sort_by_name()

test_standard_search()

test_advanced_search()

assert_histories_present(expected_histories, sort_by_matters=False)

get_present_histories()

test_tags()

assert_grid_histories_are(expected_histories, sort_matters=True)

assert_histories_in_grid(expected_histories, present=True)

get_histories()

add_tag(tags_cell, tag)

setup_shared_state()

Override this to setup shared data for tests that gets initialized only once.

create_history(name)

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_history_copy_elements module

class galaxy_test.selenium.test_history_copy_elements.TestHistoryCopyElements

Bases: SeleniumTestCase

ensure_registered = True

test_copy_hdca()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_history_dataset_state module

class galaxy_test.selenium.test_history_dataset_state.TestHistoryDatasetState

Bases: SeleniumTestCase, UsesHistoryItemAssertions

ensure_registered = True

test_dataset_state()

test_dataset_change_dbkey()

test_dataset_state_discarded()

test_dataset_state_deferred()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_history_export module

galaxy_test.selenium.test_history_multi_view module

class galaxy_test.selenium.test_history_multi_view.TestHistoryMultiView

Bases: SeleniumTestCase

ensure_registered = True

test_display()

test_list_list_display()

prepare_multi_history_view(collection_populator_method)

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_history_options module

class galaxy_test.selenium.test_history_options.TestHistoryOptions

Bases: SeleniumTestCase

test_options()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_history_panel module

class galaxy_test.selenium.test_history_panel.TestHistoryPanel

Bases: SeleniumTestCase

ensure_registered = True

test_history_panel_landing_state()

test_history_panel_rename()

test_history_rename_cancel_with_escape()

test_history_tags_and_annotations_buttons()

test_history_panel_annotations_change()

test_history_panel_tags_change()

open_tags()

clear_tags(expected_tags_size)

test_refresh_preserves_state()

assert_name_changed()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_history_panel_collections module

class galaxy_test.selenium.test_history_panel_collections.TestHistoryPanelCollections

Bases: SeleniumTestCase

ensure_registered = True

test_mapping_collection_states_terminal()

test_mapping_collection_states_running()

test_output_collection_states_terminal()

test_output_collection_states_running()

test_collection_job_details()

test_back_to_history_button()

test_rename_collection()

test_name_tags_display()

test_paired_display()

test_list_display()

test_list_paired_display()

test_list_list_display()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_history_panel_pagination module

galaxy_test.selenium.test_history_sharing module

class galaxy_test.selenium.test_history_sharing.TestHistorySharing

Bases: SeleniumTestCase

test_sharing_valid()

test_sharing_valid_by_id()

test_unsharing()

test_unshared_history_inaccessible()

test_sharing_with_invalid_user()

test_sharing_with_self()

test_shared_with_me()

setup_two_users_with_one_shared_history(share_by_id=False)

share_history_with_user(user_id=None, user_email=None, assert_valid=False, screenshot=False)

Share the current history with a target user by ID or email.

user_email will be used to enter in the share form unless user_id is also specified. The user_email however is always used to check the result if assert_valid is True.

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

class galaxy_test.selenium.test_history_sharing.TestHistoryRequiresLoginSelenium

Bases: SeleniumTestCase

ensure_registered = True

test_share_history_login_redirect()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_history_structure module

galaxy_test.selenium.test_invocation_grid module

class galaxy_test.selenium.test_invocation_grid.TestInvocationGridSelenium

Bases: SeleniumTestCase, TestsGalaxyPagers

ensure_registered = True

test_grid()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_jupyter module

galaxy_test.selenium.test_library_contents module

class galaxy_test.selenium.test_library_contents.TestLibraryContents

Bases: SeleniumTestCase, UsesLibraryAssertions

run_as_admin = True

test_sub_folder()

test_import_dataset_from_history()

download_dataset_from_library()

test_delete_dataset()

test_import_dataset_from_path()

test_import_dataset_from_import_dir()

test_show_details()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_library_landing module

class galaxy_test.selenium.test_library_landing.TestLibraryLanding

Bases: SeleniumTestCase

run_as_admin = True

setup_with_driver()

Override point that allows setting up data using self.driver and Selenium connection.

Overriding this instead of setUp will ensure debug data such as screenshots and stack traces are dumped if there are problems with the setup and it will be re-ran on test retries.

test_create_new_close()

test_create_new()

test_rename()

test_sorting()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_library_to_collections module

class galaxy_test.selenium.test_library_to_collections.TestLibraryToCollections

Bases: SeleniumTestCase, UsesLibraryAssertions

requires_admin = True

test_library_collection_export_new_history()

test_library_collection_export()

test_library_pair_export_new_history()

test_library_pair_export()

test_export_pairs_list_new_history()

test_export_pairs_list()

prepare_library_for_data_export(files_to_import, history_name=None)

build_collection_and_assert()

collection_export(is_new_history=False, collection_option=None)

list_of_pairs_export(is_new_history=False)

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_login module

class galaxy_test.selenium.test_login.TestLogin

Bases: SeleniumTestCase

test_login_accessibility()

test_logging_in()

test_invalid_logins()

test_invalid_passwords()

test_wrong_password()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_navigates_galaxy module

class galaxy_test.selenium.test_navigates_galaxy.TestNavigatesGalaxySelenium

Bases: SeleniumTestCase

Test the Selenium test framework itself.

Unlike the others test cases in this module, this test case tests the test framework itself (for when that makes sense, mostly corner cases).

test_click_error()

Verify exception handling stuff by attempting to click on a disabled element in the UI.

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_pages module

class galaxy_test.selenium.test_pages.TestPages

Bases: SeleniumTestCase

ensure_registered = True

test_simple_page_creation_edit_and_view()

test_workflow_problem_display()

test_history_links()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_personal_information module

class galaxy_test.selenium.test_personal_information.TestManageInformation

Bases: SeleniumTestCase

test_api_key()

This test views and resets the API key. In automated testing scenarios, this means the initial API key will be None, which renders as ‘Not available.’

test_change_email()

test_public_name()

test_user_address()

navigate_to_manage_information()

clear_input_field_and_write(element, new_input_text)

get_address_input_field(address_form, input_field_label)

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

class galaxy_test.selenium.test_personal_information.TestDeleteCurrentAccount

Bases: SeleniumTestCase

test_delete_account()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_published_histories_grid module

galaxy_test.selenium.test_registration module

class galaxy_test.selenium.test_registration.TestRegistration

Bases: SeleniumTestCase

test_landing()

test_registration()

test_registration_accessibility()

test_logout()

test_reregister_email_fails()

test_reregister_username_fails()

test_bad_emails()

test_short_password()

test_password_confirmation()

test_bad_usernames()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_sign_out module

class galaxy_test.selenium.test_sign_out.TestSignOut

Bases: SeleniumTestCase

test_sign_out()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_sizzle_loading module

class galaxy_test.selenium.test_sizzle_loading.TestSizzleLoading

Bases: SeleniumTestCase

test_sizzle_loads()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_stock_tours module

class galaxy_test.selenium.test_stock_tours.TestStockToursTestCase

Bases: SeleniumTestCase

test_core_galaxy_ui()

test_core_windows()

test_core_history()

test_core_deferred()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

class galaxy_test.selenium.test_stock_tours.TourCallback(test_case: TestStockToursTestCase)

Bases: object

__init__(test_case: TestStockToursTestCase)

handle_step(step, step_index)

galaxy_test.selenium.test_tool_describing_tours module

class galaxy_test.selenium.test_tool_describing_tours.TestToolDescribingTours

Bases: SeleniumTestCase

setUp()

test_generate_tour_no_data()

Ensure a tour without data is generated and pops up.

test_generate_tour_with_data()

Ensure a tour with data populates history.

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_tool_form module

class galaxy_test.selenium.test_tool_form.TestToolForm

Bases: SeleniumTestCase, UsesHistoryItemAssertions

test_run_tool_verify_contents_by_peek()

test_run_tool_verify_dataset_details()

test_verify_dataset_details_tables()

test_drilldown_tool()

static click_menu_item(menu, text)

test_repeat_reordering()

test_rerun()

test_rerun_deleted_dataset()

test_rerun_dataset_collection_element()

test_run_data()

test_bibtex_rendering()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

class galaxy_test.selenium.test_tool_form.TestLoggedInToolForm

Bases: SeleniumTestCase

ensure_registered = True

test_dataset_state_filtering()

test_run_apply_rules_1()

test_run_apply_rules_2()

test_run_apply_rules_3()

test_run_apply_rules_4()

test_run_apply_rules_tutorial()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_uploads module

class galaxy_test.selenium.test_uploads.TestUploads

Bases: SeleniumTestCase, UsesHistoryItemAssertions

test_upload_file()

test_upload_pasted_content()

test_upload_pasted_url_content()

test_upload_composite_dataset_pasted_data()

test_upload_simplest()

test_upload_specify_ext()

test_upload_specify_genome()

test_upload_specify_ext_all()

test_upload_specify_genome_all()

test_upload_deferred()

test_upload_list()

test_upload_pair()

test_upload_pair_specify_extension()

test_upload_paired_list()

test_upload_modal_retains_content()

test_rules_example_1_datasets()

test_rules_example_2_list()

test_rules_example_3_list_pairs()

test_rules_example_4_accessions()

test_rules_example_5_matching_collections()

test_rules_example_6_nested_lists()

test_rules_deferred_datasets()

test_rules_deferred_list()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_workflow_editor module

class galaxy_test.selenium.test_workflow_editor.TestWorkflowEditor

Bases: SeleniumTestCase, RunsWorkflows

ensure_registered = True

test_basics()

test_edit_annotation()

test_edit_name()

test_edit_license()

test_optional_select_data_field()

test_data_input()

test_collection_input()

test_data_column_input_editing()

test_integer_input()

test_non_data_connections()

test_non_data_map_over_carried_through()

test_connecting_display_in_upload_false_connections()

test_existing_connections()

test_reconnecting_nodes()

test_rendering_output_collection_connections()

test_simple_mapping_connections()

test_rendering_simple_nested_workflow()

test_rendering_rules_workflow_1()

test_rendering_rules_workflow_2()

test_save_as()

test_editor_tool_upgrade()

test_editor_tool_upgrade_message()

test_editor_subworkflow_tool_upgrade_message()

static set_text_element(element, value)

test_change_datatype()

test_change_datatype_post_job_action_lost_regression()

test_change_datatype_in_subworkflow()

test_edit_subworkflow()

test_editor_duplicate_node()

test_editor_embed_workflow()

setup_subworkflow()

test_editor_insert_steps()

test_editor_create_conditional_step()

test_conditional_subworkflow_step()

switch_param_type(element, param_type)

test_editor_invalid_tool_state()

test_missing_tools()

test_workflow_bookmarking()

tab_to(accessible_name, direction='forward')

test_aria_connections_menu()

test_insert_input_handling()

test_workflow_output_handling()

test_map_over_output_indicator()

test_editor_place_comments()

test_editor_snapping()

test_editor_selection()

get_node_position(label: str)

get_element_position(element: WebElement)

get_element_size(element: WebElement)

assert_node_output_is(label: str, output_type: str, subcollection_type: str | None = None)

workflow_editor_maximize_center_pane(collapse_left=True, collapse_right=True)

workflow_editor_connect(source, sink, screenshot_partial=None)

assert_connected(source, sink)

assert_connection_invalid(source, sink)

assert_not_connected(source, sink)

open_in_workflow_editor(yaml_content, auto_layout=True)

workflow_editor_source_sink_terminal_ids(source, sink)

workflow_editor_add_input(item_name='data_input')

workflow_editor_destroy_connection(sink)

assert_input_mapped(sink)

assert_input_not_mapped(sink)

workflow_index_open_with_name(name)

assert_wf_name_is(expected_name)

assert_wf_annotation_is(expected_annotation)

assert_modal_has_text(expected_text)

move_center_of_canvas(xoffset=0, yoffset=0)

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_workflow_invocation_details module

class galaxy_test.selenium.test_workflow_invocation_details.TestWorkflowInvocationDetails

Bases: SeleniumTestCase

ensure_registered = True

test_job_details()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_workflow_management module

class galaxy_test.selenium.test_workflow_management.TestWorkflowManagement

Bases: SeleniumTestCase, TestsGalaxyPagers, UsesWorkflowAssertions

ensure_registered = True

test_import_from_url()

test_import_accessibility()

test_view()

test_rename()

test_workflow_index_accessibility()

test_download()

test_tagging()

test_tag_filtering()

test_index_search()

test_index_search_filters()

test_index_advanced_search()

test_workflow_delete()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_workflow_run module

class galaxy_test.selenium.test_workflow_run.TestWorkflowRun

Bases: SeleniumTestCase, UsesHistoryItemAssertions, RunsWorkflows

ensure_registered = True

test_simple_execution()

test_expanded_execution_of_simple_workflow()

test_runtime_parameters_simple()

test_subworkflows_expanded()

test_subworkflow_runtime_parameters()

test_replacement_parameters()

test_step_parameter_inputs()

test_replacement_parameters_on_subworkflows()

test_execution_with_tool_upgrade()

test_run_form_safe_upgrade_handling()

test_execution_with_multiple_inputs()

test_execution_with_text_default_value_connected_to_restricted_select()

test_execution_with_rules()

test_execution_with_custom_invocation_report()

test_execution_with_null_optional_select_from_data()

test_workflow_run_button_disabled_when_required_input_missing()

test_workflow_run_tag_filter()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

galaxy_test.selenium.test_workflow_sharing module

class galaxy_test.selenium.test_workflow_sharing.TestWorkflowSharingRedirect

Bases: SeleniumTestCase

ensure_registered = True

test_share_workflow_with_login_redirect()

test_export_workflow_with_login_redirect()

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver

class galaxy_test.selenium.test_workflow_sharing.TestWorkflowSharing

Bases: SeleniumTestCase, UsesWorkflowAssertions

test_sharing_workflow_by_email()

test_sharing_workflow_by_id()

test_unsharing_workflow()

test_sharing_with_invalid_user()

test_sharing_with_self()

setup_two_users_with_one_shared_workflow(screenshot=False, share_by_id=False)

host: str

port: str | None

url: str

keepOutdir: str

test_data_resolver: TestDataResolver