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

Galaxy data model classes

Naming: try to use class names that have a distinct plural form so that the relationship cardinalities are obvious (e.g. prefer Dataset to Data)

exception galaxy.model.NoConverterException(value)[source]

Bases: exceptions.Exception

__init__(value)[source]
exception galaxy.model.ConverterDependencyException(value)[source]

Bases: exceptions.Exception

__init__(value)[source]
galaxy.model.set_datatypes_registry(d_registry)[source]

Set up datatypes_registry

class galaxy.model.HasTags[source]

Bases: object

dict_collection_visible_keys = ['tags']
dict_element_visible_keys = ['tags']
to_dict(*args, **kwargs)[source]
make_tag_string_list()[source]
copy_tags_from(target_user, source)[source]
class galaxy.model.HasName[source]
get_display_name()[source]

These objects have a name attribute can be either a string or a unicode object. If string, convert to unicode object assuming ‘utf-8’ format.

class galaxy.model.UsesCreateAndUpdateTime[source]
seconds_since_updated
seconds_since_created
class galaxy.model.JobLike[source]
add_metric(plugin, metric_name, metric_value)[source]
metrics
set_streams(stdout, stderr)[source]
log_str()[source]
class galaxy.model.User(email=None, password=None)[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

use_pbkdf2 = True

Data for a Galaxy user or admin and relations to their histories, credentials, and roles.

dict_collection_visible_keys = ['id', 'email', 'username', 'deleted', 'active', 'last_password_change']
dict_element_visible_keys = ['id', 'email', 'username', 'total_disk_usage', 'nice_total_disk_usage', 'deleted', 'active', 'last_password_change']
__init__(email=None, password=None)
extra_preferences
set_password_cleartext(cleartext)[source]

Set user password to the digest of cleartext.

check_password(cleartext)[source]

Check if cleartext matches user password when hashed.

system_user_pwent(real_system_username)[source]

Gives the system user pwent entry based on e-mail or username depending on the value in real_system_username

all_roles()[source]

Return a unique list of Roles associated with this user or any of their groups.

all_roles_exploiting_cache()[source]
get_disk_usage(nice_size=False)[source]

Return byte count of disk space used by user or a human-readable string if nice_size is True.

set_disk_usage(bytes)[source]

Manually set the disk space used by a user to bytes.

total_disk_usage

Return byte count of disk space used by user or a human-readable string if nice_size is True.

adjust_total_disk_usage(amount)[source]
nice_total_disk_usage

Return byte count of disk space used in a human-readable string.

calculate_disk_usage()[source]

Return byte count total of disk space used by all non-purged, non-library HDAs in non-purged histories.

calculate_and_set_disk_usage()[source]

Calculates and sets user disk usage.

static user_template_environment(user)[source]
>>> env = User.user_template_environment(None)
>>> env['__user_email__']
'Anonymous'
>>> env['__user_id__']
'Anonymous'
>>> user = User('foo@example.com')
>>> user.id = 6
>>> user.username = 'foo2'
>>> env = User.user_template_environment(user)
>>> env['__user_id__']
'6'
>>> env['__user_name__']
'foo2'
static expand_user_properties(user, in_string)[source]
class galaxy.model.PasswordResetToken(user, token=None)[source]

Bases: object

__init__(user, token=None)
class galaxy.model.BaseJobMetric(plugin, metric_name, metric_value)[source]

Bases: object

__init__(plugin, metric_name, metric_value)[source]
class galaxy.model.JobMetricText(plugin, metric_name, metric_value)[source]

Bases: galaxy.model.BaseJobMetric

class galaxy.model.JobMetricNumeric(plugin, metric_name, metric_value)[source]

Bases: galaxy.model.BaseJobMetric

class galaxy.model.TaskMetricText(plugin, metric_name, metric_value)[source]

Bases: galaxy.model.BaseJobMetric

class galaxy.model.TaskMetricNumeric(plugin, metric_name, metric_value)[source]

Bases: galaxy.model.BaseJobMetric

class galaxy.model.Job[source]

Bases: object, galaxy.model.JobLike, galaxy.model.UsesCreateAndUpdateTime, galaxy.util.dictifiable.Dictifiable

dict_collection_visible_keys = ['id', 'state', 'exit_code', 'update_time', 'create_time']
dict_element_visible_keys = ['id', 'state', 'exit_code', 'update_time', 'create_time']

A job represents a request to run a tool given input datasets, tool parameters, and output datasets.

states = <galaxy.util.bunch.Bunch object>
terminal_states = ['ok', 'error', 'deleted']
non_ready_states = ['new', 'resubmitted', 'upload', 'waiting', 'queued', 'running']

job states where the job hasn’t finished and the model may still change

__init__()
finished
get_external_output_metadata()[source]

The external_output_metadata is currently a reference from Job to JobExternalOutputMetadata. It exists for a job but not a task.

get_session_id()[source]
get_user_id()[source]
get_tool_id()[source]
get_tool_version()[source]
get_command_line()[source]
get_dependencies()[source]
get_param_filename()[source]
get_parameters()[source]
get_copied_from_job_id()[source]
get_input_datasets()[source]
get_output_datasets()[source]
get_input_library_datasets()[source]
get_output_library_datasets()[source]
get_state()[source]
get_info()[source]
get_job_runner_name()[source]
get_job_runner_external_id()[source]
get_post_job_actions()[source]
get_imported()[source]
get_handler()[source]
get_params()[source]
get_user()[source]
get_id()[source]
get_tasks()[source]
get_id_tag()[source]

Return a tag that can be useful in identifying a Job. This returns the Job’s get_id

set_session_id(session_id)[source]
set_user_id(user_id)[source]
set_tool_id(tool_id)[source]
set_tool_version(tool_version)[source]
set_command_line(command_line)[source]
set_dependencies(dependencies)[source]
set_param_filename(param_filename)[source]
set_parameters(parameters)[source]
set_copied_from_job_id(job_id)[source]
set_input_datasets(input_datasets)[source]
set_output_datasets(output_datasets)[source]
set_input_library_datasets(input_library_datasets)[source]
set_output_library_datasets(output_library_datasets)[source]
set_info(info)[source]
set_runner_name(job_runner_name)[source]
get_job()[source]
set_runner_external_id(job_runner_external_id)[source]
set_post_job_actions(post_job_actions)[source]
set_imported(imported)[source]
set_handler(handler)[source]
set_params(params)[source]
add_parameter(name, value)[source]
add_input_dataset(name, dataset=None, dataset_id=None)[source]
add_output_dataset(name, dataset)[source]
add_input_dataset_collection(name, dataset_collection)[source]
add_output_dataset_collection(name, dataset_collection_instance)[source]
add_implicit_output_dataset_collection(name, dataset_collection)[source]
add_input_library_dataset(name, dataset)[source]
add_output_library_dataset(name, dataset)[source]
add_post_job_action(pja)[source]
set_state(state)[source]

Save state history

get_param_values(app, ignore_errors=False)[source]

Read encoded parameter values from the database and turn back into a dict of tool parameter values.

raw_param_dict()[source]
check_if_output_datasets_deleted()[source]

Return true if all of the output datasets associated with this job are in the deleted state

mark_deleted(track_jobs_in_database=False)[source]

Mark this job as deleted, and mark any output datasets as discarded.

to_dict(view='collection', system_details=False)[source]
set_final_state(final_state)[source]
get_destination_configuration(config, key, default=None)[source]

Get a destination parameter that can be defaulted back in specified config if it needs to be applied globally.

class galaxy.model.Task(job, working_directory, prepare_files_cmd)[source]

Bases: object, galaxy.model.JobLike

A task represents a single component of a job.

states = <galaxy.util.bunch.Bunch object>
__init__(job, working_directory, prepare_files_cmd)
get_param_values(app)[source]

Read encoded parameter values from the database and turn back into a dict of tool parameter values.

get_id()[source]
get_id_tag()[source]

Return an id tag suitable for identifying the task. This combines the task’s job id and the task’s own id.

get_command_line()[source]
get_parameters()[source]
get_state()[source]
get_info()[source]
get_working_directory()[source]
get_task_runner_name()[source]
get_task_runner_external_id()[source]
get_job()[source]
get_stdout()[source]
get_stderr()[source]
get_prepare_input_files_cmd()[source]
get_external_output_metadata()[source]

The external_output_metadata is currently a backref to JobExternalOutputMetadata. It exists for a job but not a task, and when a task is cancelled its corresponding parent Job will be cancelled. So None is returned now, but that could be changed to self.get_job().get_external_output_metadata().

get_job_runner_name()[source]

Since runners currently access Tasks the same way they access Jobs, this method just refers to this instance’s runner.

get_job_runner_external_id()[source]

Runners will use the same methods to get information about the Task class as they will about the Job class, so this method just returns the task’s external id.

get_session_id()[source]
set_id(id)[source]
set_command_line(command_line)[source]
set_parameters(parameters)[source]
set_state(state)[source]
set_info(info)[source]
set_working_directory(working_directory)[source]
set_task_runner_name(task_runner_name)[source]
set_job_runner_external_id(task_runner_external_id)[source]
set_task_runner_external_id(task_runner_external_id)[source]
set_job(job)[source]
set_stdout(stdout)[source]
set_stderr(stderr)[source]
set_prepare_input_files_cmd(prepare_input_files_cmd)[source]
class galaxy.model.JobParameter(name, value)[source]

Bases: object

__init__(name, value)
copy()[source]
class galaxy.model.JobToInputDatasetAssociation(name, dataset)[source]

Bases: object

__init__(name, dataset)
class galaxy.model.JobToOutputDatasetAssociation(name, dataset)[source]

Bases: object

__init__(name, dataset)
class galaxy.model.JobToInputDatasetCollectionAssociation(name, dataset_collection)[source]

Bases: object

__init__(name, dataset_collection)
class galaxy.model.JobToOutputDatasetCollectionAssociation(name, dataset_collection_instance)[source]

Bases: object

__init__(name, dataset_collection_instance)
class galaxy.model.JobToImplicitOutputDatasetCollectionAssociation(name, dataset_collection)[source]

Bases: object

__init__(name, dataset_collection)
class galaxy.model.JobToInputLibraryDatasetAssociation(name, dataset)[source]

Bases: object

__init__(name, dataset)
class galaxy.model.JobToOutputLibraryDatasetAssociation(name, dataset)[source]

Bases: object

__init__(name, dataset)
class galaxy.model.JobStateHistory(job)[source]

Bases: object

__init__(job)
class galaxy.model.ImplicitlyCreatedDatasetCollectionInput(name, input_dataset_collection)[source]

Bases: object

__init__(name, input_dataset_collection)
class galaxy.model.ImplicitCollectionJobs(id=None, populated_state=None)[source]

Bases: object

populated_states = <galaxy.util.bunch.Bunch object>
__init__(id=None, populated_state=None)
job_list
class galaxy.model.ImplicitCollectionJobsJobAssociation[source]

Bases: object

__init__()
class galaxy.model.PostJobAction(action_type, workflow_step, output_name=None, action_arguments=None)[source]

Bases: object

__init__(action_type, workflow_step, output_name=None, action_arguments=None)
class galaxy.model.PostJobActionAssociation(pja, job=None, job_id=None)[source]

Bases: object

__init__(pja, job=None, job_id=None)
class galaxy.model.JobExternalOutputMetadata(job=None, dataset=None)[source]

Bases: object

__init__(job=None, dataset=None)
dataset
class galaxy.model.JobExportHistoryArchive(job=None, history=None, dataset=None, compressed=False, history_attrs_filename=None, datasets_attrs_filename=None, jobs_attrs_filename=None)[source]

Bases: object

__init__(job=None, history=None, dataset=None, compressed=False, history_attrs_filename=None, datasets_attrs_filename=None, jobs_attrs_filename=None)
up_to_date

Return False, if a new export should be generated for corresponding history.

ready
preparing
export_name
class galaxy.model.JobImportHistoryArchive(job=None, history=None, archive_dir=None)[source]

Bases: object

__init__(job=None, history=None, archive_dir=None)
class galaxy.model.GenomeIndexToolData(job=None, params=None, dataset=None, deferred_job=None, transfer_job=None, fasta_path=None, created_time=None, modified_time=None, dbkey=None, user=None, indexer=None)[source]

Bases: object

__init__(job=None, params=None, dataset=None, deferred_job=None, transfer_job=None, fasta_path=None, created_time=None, modified_time=None, dbkey=None, user=None, indexer=None)
class galaxy.model.DeferredJob(state=None, plugin=None, params=None)[source]

Bases: object

states = <galaxy.util.bunch.Bunch object>
__init__(state=None, plugin=None, params=None)
get_check_interval()[source]
set_check_interval(seconds)[source]
check_interval
get_last_check()[source]
set_last_check(seconds)[source]
last_check
is_check_time
class galaxy.model.Group(name=None)[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

dict_collection_visible_keys = ['id', 'name']
dict_element_visible_keys = ['id', 'name']
__init__(name=None)
class galaxy.model.UserGroupAssociation(user, group)[source]

Bases: object

__init__(user, group)
galaxy.model.is_hda(d)[source]
class galaxy.model.History(id=None, name=None, user=None)[source]

Bases: galaxy.model.HasTags, galaxy.util.dictifiable.Dictifiable, galaxy.model.item_attrs.UsesAnnotations, galaxy.model.HasName

dict_collection_visible_keys = ['id', 'name', 'published', 'deleted']
dict_element_visible_keys = ['id', 'name', 'genome_build', 'deleted', 'purged', 'update_time', 'published', 'importable', 'slug', 'empty']
default_name = 'Unnamed history'
__init__(id=None, name=None, user=None)
empty
add_galaxy_session(galaxy_session, association=None)[source]
add_dataset(dataset, parent_id=None, genome_build=None, set_hid=True, quota=True)[source]
add_datasets(sa_session, datasets, parent_id=None, genome_build=None, set_hid=True, quota=True, flush=False)[source]

Optimized version of add_dataset above that minimizes database interactions when adding many datasets to history at once.

add_dataset_collection(history_dataset_collection, set_hid=True)[source]
copy(name=None, target_user=None, activatable=False, all_datasets=False)[source]

Return a copy of this history using the given name and target_user. If activatable, copy only non-deleted datasets. If all_datasets, copy non-deleted, deleted, and purged datasets.

activatable_datasets
to_dict(view='collection', value_mapper=None)[source]
latest_export
unhide_datasets()[source]
resume_paused_jobs()[source]
disk_size

Return the size in bytes of this history by summing the ‘total_size’s of all non-purged, unique datasets within it.

disk_nice_size

Returns human readable size of history on disk.

active_datasets_and_roles
active_visible_datasets_and_roles
active_visible_dataset_collections
active_contents

Return all active contents ordered by hid.

contents_iter(**kwds)[source]

Fetch filtered list of contents of history.

class galaxy.model.HistoryUserShareAssociation[source]

Bases: object

__init__()
class galaxy.model.UserRoleAssociation(user, role)[source]

Bases: object

__init__(user, role)
class galaxy.model.GroupRoleAssociation(group, role)[source]

Bases: object

__init__(group, role)
class galaxy.model.Role(name='', description='', type='system', deleted=False)[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

dict_collection_visible_keys = ['id', 'name']
dict_element_visible_keys = ['id', 'name', 'description', 'type']
private_id = None
types = <galaxy.util.bunch.Bunch object>
__init__(name='', description='', type='system', deleted=False)
class galaxy.model.UserQuotaAssociation(user, quota)[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

dict_element_visible_keys = ['user']
__init__(user, quota)
class galaxy.model.GroupQuotaAssociation(group, quota)[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

dict_element_visible_keys = ['group']
__init__(group, quota)
class galaxy.model.Quota(name='', description='', amount=0, operation='=')[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

dict_collection_visible_keys = ['id', 'name']
dict_element_visible_keys = ['id', 'name', 'description', 'bytes', 'operation', 'display_amount', 'default', 'users', 'groups']
valid_operations = ('+', '-', '=')
__init__(name='', description='', amount=0, operation='=')
get_amount()[source]
set_amount(amount)[source]
amount
display_amount
class galaxy.model.DefaultQuotaAssociation(type, quota)[source]

Bases: galaxy.model.Quota, galaxy.util.dictifiable.Dictifiable

dict_element_visible_keys = ['type']
types = <galaxy.util.bunch.Bunch object>
__init__(type, quota)
class galaxy.model.DatasetPermissions(action, dataset, role=None, role_id=None)[source]

Bases: object

__init__(action, dataset, role=None, role_id=None)
class galaxy.model.LibraryPermissions(action, library_item, role)[source]

Bases: object

__init__(action, library_item, role)
class galaxy.model.LibraryFolderPermissions(action, library_item, role)[source]

Bases: object

__init__(action, library_item, role)
class galaxy.model.LibraryDatasetPermissions(action, library_item, role)[source]

Bases: object

__init__(action, library_item, role)
class galaxy.model.LibraryDatasetDatasetAssociationPermissions(action, library_item, role)[source]

Bases: object

__init__(action, library_item, role)
class galaxy.model.DefaultUserPermissions(user, action, role)[source]

Bases: object

__init__(user, action, role)
class galaxy.model.DefaultHistoryPermissions(history, action, role)[source]

Bases: object

__init__(history, action, role)
class galaxy.model.StorableObject(id, **kwargs)[source]

Bases: object

__init__(id, **kwargs)[source]
class galaxy.model.Dataset(id=None, state=None, external_filename=None, extra_files_path=None, file_size=None, purgable=True, uuid=None)[source]

Bases: galaxy.model.StorableObject

states = <galaxy.util.bunch.Bunch object>
non_ready_states = ('new', 'upload', 'queued', 'running', 'setting_metadata')
ready_states = ('discarded', 'ok', 'failed_metadata', 'paused', 'error', 'empty')
valid_input_states = ('ok', 'failed_metadata', 'upload', 'paused', 'running', 'setting_metadata', 'new', 'queued', 'empty')
terminal_states = ('ok', 'empty', 'error', 'discarded', 'failed_metadata')
conversion_messages = <galaxy.util.bunch.Bunch object>
permitted_actions = <galaxy.util.bunch.Bunch object>
file_path = '/tmp/'
object_store = None
engine = None
__init__(id=None, state=None, external_filename=None, extra_files_path=None, file_size=None, purgable=True, uuid=None)
in_ready_state()[source]
get_file_name()[source]
set_file_name(filename)[source]
file_name
get_extra_files_path()[source]
set_extra_files_path(extra_files_path)[source]
extra_files_path
get_size(nice_size=False)[source]

Returns the size of the data on disk

set_size()[source]

Sets the size of the data on disk

get_total_size()[source]
set_total_size()[source]
has_data()[source]

Detects whether there is any data

mark_deleted()[source]
user_can_purge
full_delete()[source]

Remove the file and extra files, marks deleted and purged

get_access_roles(trans)[source]
get_manage_permissions_roles(trans)[source]
has_manage_permissions_roles(trans)[source]
galaxy.model.datatype_for_extension(extension, datatypes_registry=None)[source]
class galaxy.model.DatasetInstance(id=None, hid=None, name=None, info=None, blurb=None, peek=None, tool_version=None, extension=None, dbkey=None, metadata=None, history=None, dataset=None, deleted=False, designation=None, parent_id=None, validation_errors=None, visible=True, create_dataset=False, sa_session=None, extended_metadata=None, flush=True)[source]

Bases: object

A base class for all ‘dataset instances’, HDAs, LDAs, etc

states = <galaxy.util.bunch.Bunch object>
conversion_messages = <galaxy.util.bunch.Bunch object>
permitted_actions = <galaxy.util.bunch.Bunch object>
__init__(id=None, hid=None, name=None, info=None, blurb=None, peek=None, tool_version=None, extension=None, dbkey=None, metadata=None, history=None, dataset=None, deleted=False, designation=None, parent_id=None, validation_errors=None, visible=True, create_dataset=False, sa_session=None, extended_metadata=None, flush=True)[source]
update()[source]
ext
get_dataset_state()[source]
raw_set_dataset_state(state)[source]
set_dataset_state(state)[source]
state
get_file_name()[source]
set_file_name(filename)[source]
file_name
extra_files_path
datatype
get_metadata()[source]
set_metadata(bunch)[source]
metadata
get_dbkey()[source]
set_dbkey(value)[source]
dbkey
change_datatype(new_ext)[source]
get_size(nice_size=False)[source]

Returns the size of the data on disk

set_size()[source]

Sets and gets the size of the data on disk

get_total_size()[source]
set_total_size()[source]
has_data()[source]

Detects whether there is any data

get_raw_data()[source]

Returns the full data. To stream it open the file_name and read/write as needed

write_from_stream(stream)[source]

Writes data from a stream

set_raw_data(data)[source]

Saves the data on the disc

get_mime()[source]

Returns the mime type of the data

set_peek()[source]
init_meta(copy_from=None)[source]
set_meta(**kwd)[source]
missing_meta(**kwd)[source]
as_display_type(type, **kwd)[source]
display_peek()[source]
display_name()[source]
display_info()[source]
get_converted_files_by_type(file_type)[source]
get_converted_dataset_deps(trans, target_ext)[source]

Returns dict of { “dependency” => HDA }

get_converted_dataset(trans, target_ext, target_context=None, history=None)[source]

Return converted dataset(s) if they exist, along with a dict of dependencies. If not converted yet, do so and return None (the first time). If unconvertible, raise exception.

copy_attributes(new_dataset)[source]

Copies attributes to a new datasets, used for implicit conversions

get_metadata_dataset(dataset_ext)[source]

Returns an HDA that points to a metadata file which contains a converted data with the requested extension.

clear_associated_files(metadata_safe=False, purge=False)[source]
get_converter_types()[source]
can_convert_to(format)[source]
find_conversion_destination(accepted_formats, **kwd)[source]

Returns ( target_ext, existing converted dataset )

add_validation_error(validation_error)[source]
extend_validation_errors(validation_errors)[source]
mark_deleted()[source]
mark_undeleted()[source]
mark_unhidden()[source]
undeletable()[source]
is_ok
is_pending

Return true if the dataset is neither ready nor in error

source_library_dataset
source_dataset_chain
creating_job
get_display_applications(trans)[source]
get_visualizations()[source]
get_datasources(trans)[source]

Returns datasources for dataset; if datasources are not available due to indexing, indexing is started. Return value is a dictionary with entries of type (<datasource_type> : {<datasource_name>, <indexing_message>}).

convert_dataset(trans, target_type)[source]

Converts a dataset to the target_type and returns a message indicating status of the conversion. None is returned to indicate that dataset was converted successfully.

class galaxy.model.HistoryDatasetAssociation(hid=None, history=None, copied_from_history_dataset_association=None, copied_from_library_dataset_dataset_association=None, sa_session=None, **kwd)[source]

Bases: galaxy.model.DatasetInstance, galaxy.model.HasTags, galaxy.util.dictifiable.Dictifiable, galaxy.model.item_attrs.UsesAnnotations, galaxy.model.HasName

Resource class that creates a relation between a dataset and a user history.

__init__(hid=None, history=None, copied_from_history_dataset_association=None, copied_from_library_dataset_dataset_association=None, sa_session=None, **kwd)

Create a a new HDA and associate it with the given history.

copy(parent_id=None, copy_tags=None)[source]

Create a copy of this HDA.

copy_tags_to(copy_tags=None)[source]
copy_attributes(new_dataset)[source]
to_library_dataset_dataset_association(trans, target_folder, replace_dataset=None, parent_id=None, user=None, roles=None, ldda_message='', element_identifier=None)[source]

Copy this HDA to a library optionally replacing an existing LDDA.

clear_associated_files(metadata_safe=False, purge=False)[source]
get_access_roles(trans)[source]

Return The access roles associated with this HDA’s dataset.

quota_amount(user)[source]

Return the disk space used for this HDA relevant to user quotas.

If the user has multiple instances of this dataset, it will not affect their disk usage statistic.

to_dict(view='collection', expose_dataset_path=False)[source]

Return attributes of this HDA that are exposed using the API.

history_content_type
content_type = u'dataset'
type_id
class galaxy.model.HistoryDatasetAssociationHistory(history_dataset_association_id, name, dbkey, update_time, version, extension, extended_metadata_id, metadata)[source]

Bases: object

__init__(history_dataset_association_id, name, dbkey, update_time, version, extension, extended_metadata_id, metadata)
class galaxy.model.HistoryDatasetAssociationDisplayAtAuthorization(hda=None, user=None, site=None)[source]

Bases: object

__init__(hda=None, user=None, site=None)
class galaxy.model.HistoryDatasetAssociationSubset(hda, subset, location)[source]

Bases: object

__init__(hda, subset, location)
class galaxy.model.Library(name=None, description=None, synopsis=None, root_folder=None)[source]

Bases: object, galaxy.util.dictifiable.Dictifiable, galaxy.model.HasName

permitted_actions = <galaxy.util.bunch.Bunch object>
dict_collection_visible_keys = ['id', 'name']
dict_element_visible_keys = ['id', 'deleted', 'name', 'description', 'synopsis', 'root_folder_id', 'create_time']
__init__(name=None, description=None, synopsis=None, root_folder=None)
to_dict(view='collection', value_mapper=None)[source]

We prepend an F to folders.

get_active_folders(folder, folders=None)[source]
get_access_roles(trans)[source]
class galaxy.model.LibraryFolder(name=None, description=None, item_count=0, order_id=None)[source]

Bases: object, galaxy.util.dictifiable.Dictifiable, galaxy.model.HasName

dict_element_visible_keys = ['id', 'parent_id', 'name', 'description', 'item_count', 'genome_build', 'update_time', 'deleted']
__init__(name=None, description=None, item_count=0, order_id=None)
add_library_dataset(library_dataset, genome_build=None)[source]
add_folder(folder)[source]
activatable_library_datasets
to_dict(view='collection', value_mapper=None)[source]
library_path
parent_library
class galaxy.model.LibraryDataset(folder=None, order_id=None, name=None, info=None, library_dataset_dataset_association=None, **kwd)[source]

Bases: object

upload_options = [('upload_file', 'Upload files'), ('upload_directory', 'Upload directory of files'), ('upload_paths', 'Upload files from filesystem paths'), ('import_from_history', 'Import datasets from your current history')]
__init__(folder=None, order_id=None, name=None, info=None, library_dataset_dataset_association=None, **kwd)
set_library_dataset_dataset_association(ldda)[source]
get_info()[source]
set_info(info)[source]
info
get_name()[source]
set_name(name)[source]
name
display_name()[source]
to_dict(view='collection')[source]
class galaxy.model.LibraryDatasetDatasetAssociation(copied_from_history_dataset_association=None, copied_from_library_dataset_dataset_association=None, library_dataset=None, user=None, sa_session=None, **kwd)[source]

Bases: galaxy.model.DatasetInstance, galaxy.model.HasName

__init__(copied_from_history_dataset_association=None, copied_from_library_dataset_dataset_association=None, library_dataset=None, user=None, sa_session=None, **kwd)
to_history_dataset_association(target_history, parent_id=None, add_to_history=False)[source]
copy(parent_id=None, target_folder=None)[source]
clear_associated_files(metadata_safe=False, purge=False)[source]
get_access_roles(trans)[source]
get_manage_permissions_roles(trans)[source]
has_manage_permissions_roles(trans)[source]
to_dict(view='collection')[source]
class galaxy.model.ExtendedMetadata(data)[source]

Bases: object

__init__(data)
class galaxy.model.ExtendedMetadataIndex(extended_metadata, path, value)[source]

Bases: object

__init__(extended_metadata, path, value)
class galaxy.model.LibraryInfoAssociation(library, form_definition, info, inheritable=False)[source]

Bases: object

__init__(library, form_definition, info, inheritable=False)
class galaxy.model.LibraryFolderInfoAssociation(folder, form_definition, info, inheritable=False)[source]

Bases: object

__init__(folder, form_definition, info, inheritable=False)
class galaxy.model.LibraryDatasetDatasetInfoAssociation(library_dataset_dataset_association, form_definition, info)[source]

Bases: object

__init__(library_dataset_dataset_association, form_definition, info)
inheritable
class galaxy.model.ValidationError(message=None, err_type=None, attributes=None)[source]

Bases: object

__init__(message=None, err_type=None, attributes=None)
class galaxy.model.DatasetToValidationErrorAssociation(dataset, validation_error)[source]

Bases: object

__init__(dataset, validation_error)[source]
class galaxy.model.ImplicitlyConvertedDatasetAssociation(id=None, parent=None, dataset=None, file_type=None, deleted=False, purged=False, metadata_safe=True)[source]

Bases: object

__init__(id=None, parent=None, dataset=None, file_type=None, deleted=False, purged=False, metadata_safe=True)
clear(purge=False, delete_dataset=True)[source]
class galaxy.model.DatasetCollection(id=None, collection_type=None, populated=True, element_count=None)[source]

Bases: object, galaxy.util.dictifiable.Dictifiable, galaxy.model.item_attrs.UsesAnnotations

dict_collection_visible_keys = ['id', 'collection_type']
dict_element_visible_keys = ['id', 'collection_type']
populated_states = <galaxy.util.bunch.Bunch object>
__init__(id=None, collection_type=None, populated=True, element_count=None)
dataset_states_and_extensions_summary
populated_optimized
populated
waiting_for_elements
mark_as_populated()[source]
handle_population_failed(message)[source]
finalize()[source]
dataset_instances
dataset_elements
state
validate()[source]
copy(destination=None, element_destination=None)[source]
replace_failed_elements(replacements)[source]
set_from_dict(new_data)[source]
has_subcollections
class galaxy.model.DatasetCollectionInstance(collection=None, deleted=False)[source]

Bases: object, galaxy.model.HasName

__init__(collection=None, deleted=False)[source]
state
populated
dataset_instances
display_name()[source]
set_from_dict(new_data)[source]

Set object attributes to the values in dictionary new_data limiting to only those keys in dict_element_visible_keys.

Returns a dictionary of the keys, values that have been changed.

class galaxy.model.HistoryDatasetCollectionAssociation(id=None, hid=None, collection=None, history=None, name=None, deleted=False, visible=True, copied_from_history_dataset_collection_association=None, implicit_output_name=None, implicit_input_collections=[])[source]

Bases: galaxy.model.DatasetCollectionInstance, galaxy.model.HasTags, galaxy.util.dictifiable.Dictifiable, galaxy.model.item_attrs.UsesAnnotations

Associates a DatasetCollection with a History.

editable_keys = ('name', 'deleted', 'visible')
__init__(id=None, hid=None, collection=None, history=None, name=None, deleted=False, visible=True, copied_from_history_dataset_collection_association=None, implicit_output_name=None, implicit_input_collections=[])
history_content_type
content_type = u'dataset_collection'
type_id
job_source_type
job_source_id
to_hda_representative(multiple=False)[source]
to_dict(view='collection')[source]
add_implicit_input_collection(name, history_dataset_collection)[source]
find_implicit_input_collection(name)[source]
copy(element_destination=None)[source]

Create a copy of this history dataset collection association. Copy underlying collection.

class galaxy.model.LibraryDatasetCollectionAssociation(id=None, collection=None, name=None, deleted=False, folder=None)[source]

Bases: galaxy.model.DatasetCollectionInstance

Associates a DatasetCollection with a library folder.

editable_keys = ('name', 'deleted')
__init__(id=None, collection=None, name=None, deleted=False, folder=None)
to_dict(view='collection')[source]
class galaxy.model.DatasetCollectionElement(id=None, collection=None, element=None, element_index=None, element_identifier=None)[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

Associates a DatasetInstance (hda or ldda) with a DatasetCollection.

dict_collection_visible_keys = ['id', 'element_type', 'element_index', 'element_identifier']
dict_element_visible_keys = ['id', 'element_type', 'element_index', 'element_identifier']
UNINITIALIZED_ELEMENT = <object object>
__init__(id=None, collection=None, element=None, element_index=None, element_identifier=None)
element_type
is_collection
element_object
dataset_instance
dataset
first_dataset_instance()[source]
dataset_instances
copy_to_collection(collection, destination=None, element_destination=None)[source]
class galaxy.model.Event(message=None, history=None, user=None, galaxy_session=None)[source]

Bases: object

__init__(message=None, history=None, user=None, galaxy_session=None)
class galaxy.model.GalaxySession(id=None, user=None, remote_host=None, remote_addr=None, referer=None, current_history=None, session_key=None, is_valid=False, prev_session_id=None, last_action=None)[source]

Bases: object

__init__(id=None, user=None, remote_host=None, remote_addr=None, referer=None, current_history=None, session_key=None, is_valid=False, prev_session_id=None, last_action=None)
add_history(history, association=None)[source]
get_disk_usage()[source]
set_disk_usage(bytes)[source]
total_disk_usage
class galaxy.model.GalaxySessionToHistoryAssociation(galaxy_session, history)[source]

Bases: object

__init__(galaxy_session, history)
class galaxy.model.UCI[source]

Bases: object

__init__()[source]
class galaxy.model.StoredWorkflow[source]

Bases: galaxy.model.HasTags, galaxy.util.dictifiable.Dictifiable

dict_collection_visible_keys = ['id', 'name', 'published', 'deleted']
dict_element_visible_keys = ['id', 'name', 'published', 'deleted']
__init__()
show_in_tool_panel(user_id)[source]
copy_tags_from(target_user, source_workflow)[source]
to_dict(view='collection', value_mapper=None)[source]
class galaxy.model.Workflow(uuid=None)[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

dict_collection_visible_keys = ['name', 'has_cycles', 'has_errors']
dict_element_visible_keys = ['name', 'has_cycles', 'has_errors']
input_step_types = ['data_input', 'data_collection_input', 'parameter_input']
__init__(uuid=None)
has_outputs_defined()[source]

Returns true or false indicating whether or not a workflow has outputs defined.

to_dict(view='collection', value_mapper=None)[source]
steps_by_id
step_by_index(order_index)[source]
input_steps
workflow_outputs
top_level_workflow

If this workflow is not attached to stored workflow directly, recursively grab its parents until it is the top level workflow which must have a stored workflow associated with it.

top_level_stored_workflow

If this workflow is not attached to stored workflow directly, recursively grab its parents until it is the top level workflow which must have a stored workflow associated with it and then grab that stored workflow.

copy()[source]

Copy a workflow (without user information) for a new StoredWorkflow object.

log_str()[source]
class galaxy.model.WorkflowStep[source]

Bases: object

__init__()
unique_workflow_outputs
content_id
input_connections_by_name
setup_input_connections_by_name()[source]
create_or_update_workflow_output(output_name, label, uuid)[source]
workflow_output_for(output_name)[source]
copy_to(copied_step, step_mapping)[source]
log_str()[source]
class galaxy.model.WorkflowStepConnection[source]

Bases: object

NON_DATA_CONNECTION = '__NO_INPUT_OUTPUT_NAME__'
__init__()
set_non_data_connection()[source]
non_data_connection
copy()[source]
class galaxy.model.WorkflowOutput(workflow_step, output_name=None, label=None, uuid=None)[source]

Bases: object

__init__(workflow_step, output_name=None, label=None, uuid=None)
copy(copied_step)[source]
class galaxy.model.StoredWorkflowUserShareAssociation[source]

Bases: object

__init__()
class galaxy.model.StoredWorkflowMenuEntry[source]

Bases: object

__init__()
class galaxy.model.WorkflowInvocation[source]

Bases: object, galaxy.model.UsesCreateAndUpdateTime, galaxy.util.dictifiable.Dictifiable

dict_collection_visible_keys = ['id', 'update_time', 'workflow_id', 'history_id', 'uuid', 'state']
dict_element_visible_keys = ['id', 'update_time', 'workflow_id', 'history_id', 'uuid', 'state']
states = <galaxy.util.bunch.Bunch object>
__init__()
create_subworkflow_invocation_for_step(step)[source]
attach_subworkflow_invocation_for_step(step, subworkflow_invocation)[source]
get_subworkflow_invocation_for_step(step)[source]
get_subworkflow_invocation_association_for_step(step)[source]
active

Indicates the workflow invocation is somehow active - and in particular valid actions may be performed on its WorkflowInvocationSteps.

cancel()[source]
fail()[source]
step_states_by_step_id()[source]
step_invocations_by_step_id()[source]
step_invocation_for_step_id(step_id)[source]
static poll_active_workflow_ids(sa_session, scheduler=None, handler=None)[source]
add_output(workflow_output, step, output_object)[source]
to_dict(view='collection', value_mapper=None, step_details=False, legacy_job_state=False)[source]
update()
add_input(content, step_id)[source]
has_input_for_step(step_id)[source]
class galaxy.model.WorkflowInvocationToSubworkflowInvocationAssociation[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

dict_collection_visible_keys = ['id', 'workflow_step_id', 'workflow_invocation_id', 'subworkflow_invocation_id']
dict_element_visible_keys = ['id', 'workflow_step_id', 'workflow_invocation_id', 'subworkflow_invocation_id']
class galaxy.model.WorkflowInvocationStep[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

dict_collection_visible_keys = ['id', 'update_time', 'job_id', 'workflow_step_id', 'state', 'action']
dict_element_visible_keys = ['id', 'update_time', 'job_id', 'workflow_step_id', 'state', 'action']
states = <galaxy.util.bunch.Bunch object>
update()[source]
is_new
add_output(output_name, output_object)[source]
jobs
to_dict(view='collection', value_mapper=None)[source]
class galaxy.model.WorkflowInvocationStepJobAssociation[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

dict_collection_visible_keys = ('id', 'job_id', 'workflow_invocation_step_id')
dict_element_visible_keys = ('id', 'job_id', 'workflow_invocation_step_id')
class galaxy.model.WorkflowRequest[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

dict_collection_visible_keys = ['id', 'name', 'type', 'state', 'history_id', 'workflow_id']
dict_element_visible_keys = ['id', 'name', 'type', 'state', 'history_id', 'workflow_id']
to_dict(view='collection', value_mapper=None)[source]
class galaxy.model.WorkflowRequestInputParameter(name=None, value=None, type=None)[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

Workflow-related parameters not tied to steps or inputs.

dict_collection_visible_keys = ['id', 'name', 'value', 'type']
types = <galaxy.util.bunch.Bunch object>
__init__(name=None, value=None, type=None)
class galaxy.model.WorkflowRequestStepState(workflow_step=None, name=None, value=None)[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

Workflow step value parameters.

dict_collection_visible_keys = ['id', 'name', 'value', 'workflow_step_id']
__init__(workflow_step=None, name=None, value=None)
class galaxy.model.WorkflowRequestToInputDatasetAssociation[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

Workflow step input dataset parameters.

dict_collection_visible_keys = ['id', 'workflow_invocation_id', 'workflow_step_id', 'dataset_id', 'name']
class galaxy.model.WorkflowRequestToInputDatasetCollectionAssociation[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

Workflow step input dataset collection parameters.

dict_collection_visible_keys = ['id', 'workflow_invocation_id', 'workflow_step_id', 'dataset_collection_id', 'name']
class galaxy.model.WorkflowRequestInputStepParmeter[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

Workflow step parameter inputs.

dict_collection_visible_keys = ['id', 'workflow_invocation_id', 'workflow_step_id', 'parameter_value']
class galaxy.model.WorkflowInvocationOutputDatasetAssociation[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

Represents links to output datasets for the workflow.

dict_collection_visible_keys = ['id', 'workflow_invocation_id', 'workflow_step_id', 'dataset_id', 'name']
class galaxy.model.WorkflowInvocationOutputDatasetCollectionAssociation[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

Represents links to output dataset collections for the workflow.

dict_collection_visible_keys = ['id', 'workflow_invocation_id', 'workflow_step_id', 'dataset_collection_id', 'name']
class galaxy.model.WorkflowInvocationStepOutputDatasetAssociation[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

Represents links to output datasets for the workflow.

dict_collection_visible_keys = ['id', 'workflow_invocation_step_id', 'dataset_id', 'output_name']
class galaxy.model.WorkflowInvocationStepOutputDatasetCollectionAssociation[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

Represents links to output dataset collections for the workflow.

dict_collection_visible_keys = ['id', 'workflow_invocation_step_id', 'dataset_collection_id', 'output_name']
class galaxy.model.MetadataFile(dataset=None, name=None)[source]

Bases: galaxy.model.StorableObject

__init__(dataset=None, name=None)
file_name
class galaxy.model.FormDefinition(name=None, desc=None, fields=[], form_definition_current=None, form_type=None, layout=None)[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

supported_field_types = [<class 'galaxy.web.form_builder.AddressField'>, <class 'galaxy.web.form_builder.CheckboxField'>, <class 'galaxy.web.form_builder.PasswordField'>, <class 'galaxy.web.form_builder.SelectField'>, <class 'galaxy.web.form_builder.TextArea'>, <class 'galaxy.web.form_builder.TextField'>, <class 'galaxy.web.form_builder.WorkflowField'>, <class 'galaxy.web.form_builder.WorkflowMappingField'>, <class 'galaxy.web.form_builder.HistoryField'>]
types = <galaxy.util.bunch.Bunch object>
dict_collection_visible_keys = ['id', 'name']
dict_element_visible_keys = ['id', 'name', 'desc', 'form_definition_current_id', 'fields', 'layout']
__init__(name=None, desc=None, fields=[], form_definition_current=None, form_type=None, layout=None)
to_dict(user=None, values=None, security=None)[source]
grid_fields(grid_index)[source]
class galaxy.model.FormDefinitionCurrent(form_definition=None)[source]

Bases: object

__init__(form_definition=None)
class galaxy.model.FormValues(form_def=None, content=None)[source]

Bases: object

__init__(form_def=None, content=None)
class galaxy.model.UserAddress(user=None, desc=None, name=None, institution=None, address=None, city=None, state=None, postal_code=None, country=None, phone=None)[source]

Bases: object

__init__(user=None, desc=None, name=None, institution=None, address=None, city=None, state=None, postal_code=None, country=None, phone=None)
to_dict(trans)[source]
class galaxy.model.UserOpenID(user=None, session=None, openid=None)[source]

Bases: object

__init__(user=None, session=None, openid=None)
class galaxy.model.Page[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

dict_element_visible_keys = ['id', 'title', 'latest_revision_id', 'slug', 'published', 'importable', 'deleted']
__init__()
to_dict(view='element')[source]
class galaxy.model.PageRevision[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

dict_element_visible_keys = ['id', 'page_id', 'title', 'content']
__init__()
to_dict(view='element')[source]
class galaxy.model.PageUserShareAssociation[source]

Bases: object

__init__()
class galaxy.model.Visualization(id=None, user=None, type=None, title=None, dbkey=None, slug=None, latest_revision=None)[source]

Bases: object

__init__(id=None, user=None, type=None, title=None, dbkey=None, slug=None, latest_revision=None)
copy(user=None, title=None)[source]

Provide copy of visualization with only its latest revision.

class galaxy.model.VisualizationRevision(visualization=None, title=None, dbkey=None, config=None)[source]

Bases: object

__init__(visualization=None, title=None, dbkey=None, config=None)
copy(visualization=None)[source]

Returns a copy of this object.

class galaxy.model.VisualizationUserShareAssociation[source]

Bases: object

__init__()
class galaxy.model.TransferJob(state=None, path=None, info=None, pid=None, socket=None, params=None)[source]

Bases: object

states = <galaxy.util.bunch.Bunch object>
terminal_states = ['error', 'done']
__init__(state=None, path=None, info=None, pid=None, socket=None, params=None)
class galaxy.model.Tag(id=None, type=None, parent_id=None, name=None)[source]

Bases: object

__init__(id=None, type=None, parent_id=None, name=None)
class galaxy.model.ItemTagAssociation(id=None, user=None, item_id=None, tag_id=None, user_tname=None, value=None)[source]

Bases: object, galaxy.util.dictifiable.Dictifiable

dict_collection_visible_keys = ['id', 'user_tname', 'user_value']
dict_element_visible_keys = ['id', 'user_tname', 'user_value']
__init__(id=None, user=None, item_id=None, tag_id=None, user_tname=None, value=None)[source]
copy(cls=None)[source]
class galaxy.model.HistoryTagAssociation(id=None, user=None, item_id=None, tag_id=None, user_tname=None, value=None)[source]

Bases: galaxy.model.ItemTagAssociation

class galaxy.model.DatasetTagAssociation(id=None, user=None, item_id=None, tag_id=None, user_tname=None, value=None)[source]

Bases: galaxy.model.ItemTagAssociation

class galaxy.model.HistoryDatasetAssociationTagAssociation(id=None, user=None, item_id=None, tag_id=None, user_tname=None, value=None)[source]

Bases: galaxy.model.ItemTagAssociation

class galaxy.model.LibraryDatasetDatasetAssociationTagAssociation(id=None, user=None, item_id=None, tag_id=None, user_tname=None, value=None)[source]

Bases: galaxy.model.ItemTagAssociation

class galaxy.model.PageTagAssociation(id=None, user=None, item_id=None, tag_id=None, user_tname=None, value=None)[source]

Bases: galaxy.model.ItemTagAssociation

class galaxy.model.WorkflowStepTagAssociation(id=None, user=None, item_id=None, tag_id=None, user_tname=None, value=None)[source]

Bases: galaxy.model.ItemTagAssociation

class galaxy.model.StoredWorkflowTagAssociation(id=None, user=None, item_id=None, tag_id=None, user_tname=None, value=None)[source]

Bases: galaxy.model.ItemTagAssociation

class galaxy.model.VisualizationTagAssociation(id=None, user=None, item_id=None, tag_id=None, user_tname=None, value=None)[source]

Bases: galaxy.model.ItemTagAssociation

class galaxy.model.HistoryDatasetCollectionTagAssociation(id=None, user=None, item_id=None, tag_id=None, user_tname=None, value=None)[source]

Bases: galaxy.model.ItemTagAssociation

class galaxy.model.LibraryDatasetCollectionTagAssociation(id=None, user=None, item_id=None, tag_id=None, user_tname=None, value=None)[source]

Bases: galaxy.model.ItemTagAssociation

class galaxy.model.ToolTagAssociation(id=None, user=None, tool_id=None, tag_id=None, user_tname=None, value=None)[source]

Bases: galaxy.model.ItemTagAssociation

__init__(id=None, user=None, tool_id=None, tag_id=None, user_tname=None, value=None)
class galaxy.model.WorkRequestTagAssociation(id=None, user=None, workflow_request_id=None, tag_id=None, user_tname=None, value=None)[source]

Bases: galaxy.model.ItemTagAssociation

__init__(id=None, user=None, workflow_request_id=None, tag_id=None, user_tname=None, value=None)[source]
class galaxy.model.HistoryAnnotationAssociation[source]

Bases: object

class galaxy.model.HistoryDatasetAssociationAnnotationAssociation[source]

Bases: object

class galaxy.model.StoredWorkflowAnnotationAssociation[source]

Bases: object

class galaxy.model.WorkflowStepAnnotationAssociation[source]

Bases: object

class galaxy.model.PageAnnotationAssociation[source]

Bases: object

class galaxy.model.VisualizationAnnotationAssociation[source]

Bases: object

class galaxy.model.HistoryDatasetCollectionAnnotationAssociation[source]

Bases: object

class galaxy.model.LibraryDatasetCollectionAnnotationAssociation[source]

Bases: object

class galaxy.model.ItemRatingAssociation(id=None, user=None, item=None, rating=0)[source]

Bases: object

__init__(id=None, user=None, item=None, rating=0)[source]
set_item(item)[source]

Set association’s item.

class galaxy.model.HistoryRatingAssociation(id=None, user=None, item=None, rating=0)[source]

Bases: galaxy.model.ItemRatingAssociation

set_item(history)[source]
class galaxy.model.HistoryDatasetAssociationRatingAssociation(id=None, user=None, item=None, rating=0)[source]

Bases: galaxy.model.ItemRatingAssociation

set_item(history_dataset_association)[source]
class galaxy.model.StoredWorkflowRatingAssociation(id=None, user=None, item=None, rating=0)[source]

Bases: galaxy.model.ItemRatingAssociation

set_item(stored_workflow)[source]
class galaxy.model.PageRatingAssociation(id=None, user=None, item=None, rating=0)[source]

Bases: galaxy.model.ItemRatingAssociation

set_item(page)[source]
class galaxy.model.VisualizationRatingAssociation(id=None, user=None, item=None, rating=0)[source]

Bases: galaxy.model.ItemRatingAssociation

set_item(visualization)[source]
class galaxy.model.HistoryDatasetCollectionRatingAssociation(id=None, user=None, item=None, rating=0)[source]

Bases: galaxy.model.ItemRatingAssociation

set_item(dataset_collection)[source]
class galaxy.model.LibraryDatasetCollectionRatingAssociation(id=None, user=None, item=None, rating=0)[source]

Bases: galaxy.model.ItemRatingAssociation

set_item(dataset_collection)[source]
class galaxy.model.DataManagerHistoryAssociation(id=None, history=None, user=None)[source]

Bases: object

__init__(id=None, history=None, user=None)
class galaxy.model.DataManagerJobAssociation(id=None, job=None, data_manager_id=None)[source]

Bases: object

__init__(id=None, job=None, data_manager_id=None)
class galaxy.model.UserPreference(name=None, value=None)[source]

Bases: object

__init__(name=None, value=None)
class galaxy.model.UserAction(id=None, create_time=None, user_id=None, session_id=None, action=None, params=None, context=None)[source]

Bases: object

__init__(id=None, create_time=None, user_id=None, session_id=None, action=None, params=None, context=None)
class galaxy.model.APIKeys(id=None, user_id=None, key=None)[source]

Bases: object

__init__(id=None, user_id=None, key=None)
galaxy.model.copy_list(lst, *args, **kwds)[source]

Submodules

galaxy.model.base module

Shared model and mapping code between Galaxy and Tool Shed, trying to generalize to generic database connections.

class galaxy.model.base.ModelMapping(model_modules, engine)[source]

Bases: galaxy.util.bunch.Bunch

__init__(model_modules, engine)[source]
Session

For backward compat., deprecated.

galaxy.model.base.versioned_objects(iter)[source]
galaxy.model.base.versioned_session(session)[source]

galaxy.model.custom_types module

class galaxy.model.custom_types.JSONType(*args, **kwargs)[source]

Bases: sqlalchemy.sql.type_api.TypeDecorator

Represents an immutable structure as a json-encoded string.

If default is, for example, a dict, then a NULL value in the database will be exposed as an empty dict.

impl

alias of LargeBinary

process_bind_param(value, dialect)[source]
process_result_value(value, dialect)[source]
load_dialect_impl(dialect)[source]
copy_value(value)[source]
compare_values(x, y)[source]
class galaxy.model.custom_types.MutationObj[source]

Bases: sqlalchemy.ext.mutable.Mutable

Mutable JSONType for SQLAlchemy from original gist: https://gist.github.com/dbarnett/1730610

Using minor changes from this fork of the gist: https://gist.github.com/miracle2k/52a031cced285ba9b8cd

And other minor changes to make it work for us.

classmethod coerce(key, value)[source]
class galaxy.model.custom_types.MutationDict[source]

Bases: galaxy.model.custom_types.MutationObj, dict

classmethod coerce(key, value)[source]

Convert plain dictionary to MutationDict

class galaxy.model.custom_types.MutationList[source]

Bases: galaxy.model.custom_types.MutationObj, list

classmethod coerce(key, value)[source]

Convert plain list to MutationList

append(value)[source]
insert(idx, value)[source]
extend(values)[source]
pop(*args, **kw)[source]
remove(value)[source]
galaxy.model.custom_types.total_size(o, handlers={}, verbose=False)[source]

Returns the approximate memory footprint an object and all of its contents.

Automatically finds the contents of the following builtin containers and their subclasses: tuple, list, deque, dict, set and frozenset. To search other containers, add handlers to iterate over their contents:

handlers = {SomeContainerClass: iter,
OtherContainerClass: OtherContainerClass.get_elements}

Recipe from: https://code.activestate.com/recipes/577504-compute-memory-footprint-of-an-object-and-its-cont/

class galaxy.model.custom_types.MetadataType(*args, **kwargs)[source]

Bases: galaxy.model.custom_types.JSONType

Backward compatible metadata type. Can read pickles or JSON, but always writes in JSON.

process_bind_param(value, dialect)[source]
process_result_value(value, dialect)[source]
class galaxy.model.custom_types.UUIDType(*args, **kwargs)[source]

Bases: sqlalchemy.sql.type_api.TypeDecorator

Platform-independent UUID type.

Based on http://docs.sqlalchemy.org/en/rel_0_8/core/types.html#backend-agnostic-guid-type Changed to remove sqlalchemy 0.8 specific code

CHAR(32), storing as stringified hex values.

impl

alias of CHAR

load_dialect_impl(dialect)[source]
process_bind_param(value, dialect)[source]
process_result_value(value, dialect)[source]
class galaxy.model.custom_types.TrimmedString(*args, **kwargs)[source]

Bases: sqlalchemy.sql.type_api.TypeDecorator

impl

alias of String

process_bind_param(value, dialect)[source]

Automatically truncate string values

galaxy.model.item_attrs module

exception galaxy.model.item_attrs.RuntimeException[source]

Bases: exceptions.Exception

class galaxy.model.item_attrs.UsesItemRatings[source]

Mixin for getting and setting item ratings.

Class makes two assumptions: (1) item-rating association table is named <item_class>RatingAssocation (2) item-rating association table has a column with a foreign key referencing item table that contains the item’s id.

get_ave_item_rating_data(db_session, item, webapp_model=None)[source]

Returns the average rating for an item.

rate_item(db_session, user, item, rating, webapp_model=None)[source]

Rate an item. Return type is <item_class>RatingAssociation.

get_user_item_rating(db_session, user, item, webapp_model=None)[source]

Returns user’s rating for an item. Return type is <item_class>RatingAssociation.

class galaxy.model.item_attrs.UsesAnnotations[source]

Mixin for getting and setting item annotations.

get_item_annotation_str(db_session, user, item)[source]

Returns a user’s annotation string for an item.

get_item_annotation_obj(db_session, user, item)[source]

Returns a user’s annotation object for an item.

add_item_annotation(db_session, user, item, annotation)[source]

Add or update an item’s annotation; a user can only have a single annotation for an item.

delete_item_annotation(db_session, user, item)[source]
copy_item_annotation(db_session, source_user, source_item, target_user, target_item)[source]

Copy an annotation from a user/item source to a user/item target.

galaxy.model.mapping module

Details of how the data model objects are mapped onto the relational database are encapsulated here.

galaxy.model.mapping.simple_mapping(model, **kwds)[source]
galaxy.model.mapping.tag_mapping(tag_association_class, backref_name)[source]
galaxy.model.mapping.annotation_mapping(annotation_class, **kwds)[source]
galaxy.model.mapping.rating_mapping(rating_class, **kwds)[source]
galaxy.model.mapping.db_next_hid(self)[source]

Override __next_hid to generate from the database in a concurrency safe way. Loads the next history ID from the DB and returns it. It also saves the future next_id into the DB.

Return type:int
Returns:the next history id
galaxy.model.mapping.init(file_path, url, engine_options=None, create_tables=False, map_install_models=False, database_query_profiling_proxy=False, object_store=None, trace_logger=None, use_pbkdf2=True, slow_query_log_threshold=0)[source]

Connect mappings to the database

galaxy.model.mapping.now()

Return a new datetime representing UTC day and time.

galaxy.model.metadata module

Galaxy Metadata

class galaxy.model.metadata.Statement(target)[source]

Bases: object

This class inserts its target into a list in the surrounding class. the data.Data class has a metaclass which executes these statements. This is how we shove the metadata element spec into the class.

__init__(target)[source]
classmethod process(element)[source]
class galaxy.model.metadata.MetadataCollection(parent)[source]

Bases: object

MetadataCollection is not a collection at all, but rather a proxy to the real metadata which is stored as a Dictionary. This class handles processing the metadata elements when they are set and retrieved, returning default values in cases when metadata is not set.

__init__(parent)[source]
get_parent()[source]
set_parent(parent)[source]
parent
spec
get(key, default=None)[source]
items()[source]
remove_key(name)[source]
element_is_set(name)[source]
get_metadata_parameter(name, **kwd)[source]
make_dict_copy(to_copy)[source]

Makes a deep copy of input iterable to_copy according to self.spec

from_JSON_dict(filename=None, path_rewriter=None, json_dict=None)[source]
to_JSON_dict(filename=None)[source]
class galaxy.model.metadata.MetadataSpecCollection(dict=None)[source]

Bases: galaxy.util.odict.odict

A simple extension of dict which allows cleaner access to items and allows the values to be iterated over directly as if it were a list. append() is also implemented for simplicity and does not “append”.

__init__(dict=None)[source]
append(item)[source]
iter()[source]
class galaxy.model.metadata.MetadataParameter(spec)[source]

Bases: object

__init__(spec)[source]
get_field(value=None, context=None, other_values=None, **kwd)[source]
to_string(value)[source]
to_safe_string(value)[source]
make_copy(value, target_context=None, source_context=None)[source]
classmethod marshal(value)[source]

This method should/can be overridden to convert the incoming value to whatever type it is supposed to be.

validate(value)[source]

Throw an exception if the value is invalid.

unwrap(form_value)[source]

Turns a value into its storable form.

wrap(value, session)[source]

Turns a value into its usable form.

from_external_value(value, parent)[source]

Turns a value read from an external dict into its value to be pushed directly into the metadata dict.

to_external_value(value)[source]

Turns a value read from a metadata into its value to be pushed directly into the external dict.

class galaxy.model.metadata.MetadataElementSpec(datatype, name=None, desc=None, param=<class 'galaxy.model.metadata.MetadataParameter'>, default=None, no_value=None, visible=True, set_in_upload=False, **kwargs)[source]

Bases: object

Defines a metadata element and adds it to the metadata_spec (which is a MetadataSpecCollection) of datatype.

__init__(datatype, name=None, desc=None, param=<class 'galaxy.model.metadata.MetadataParameter'>, default=None, no_value=None, visible=True, set_in_upload=False, **kwargs)[source]
get(name, default=None)[source]
wrap(value, session)[source]

Turns a stored value into its usable form.

unwrap(value)[source]

Turns an incoming value into its storable form.

galaxy.model.metadata.MetadataElement = <galaxy.model.metadata.Statement object>

MetadataParameter sub-classes.

class galaxy.model.metadata.SelectParameter(spec)[source]

Bases: galaxy.model.metadata.MetadataParameter

__init__(spec)[source]
to_string(value)[source]
get_field(value=None, context=None, other_values=None, values=None, **kwd)[source]
wrap(value, session)[source]
classmethod marshal(value)[source]
class galaxy.model.metadata.DBKeyParameter(spec)[source]

Bases: galaxy.model.metadata.SelectParameter

get_field(value=None, context=None, other_values=None, values=None, **kwd)[source]
class galaxy.model.metadata.RangeParameter(spec)[source]

Bases: galaxy.model.metadata.SelectParameter

__init__(spec)[source]
get_field(value=None, context=None, other_values=None, values=None, **kwd)[source]
classmethod marshal(value)[source]
class galaxy.model.metadata.ColumnParameter(spec)[source]

Bases: galaxy.model.metadata.RangeParameter

get_field(value=None, context=None, other_values=None, values=None, **kwd)[source]
class galaxy.model.metadata.ColumnTypesParameter(spec)[source]

Bases: galaxy.model.metadata.MetadataParameter

to_string(value)[source]
class galaxy.model.metadata.ListParameter(spec)[source]

Bases: galaxy.model.metadata.MetadataParameter

to_string(value)[source]
class galaxy.model.metadata.DictParameter(spec)[source]

Bases: galaxy.model.metadata.MetadataParameter

to_string(value)[source]
to_safe_string(value)[source]
class galaxy.model.metadata.PythonObjectParameter(spec)[source]

Bases: galaxy.model.metadata.MetadataParameter

to_string(value)[source]
get_field(value=None, context=None, other_values=None, **kwd)[source]
classmethod marshal(value)[source]
class galaxy.model.metadata.FileParameter(spec)[source]

Bases: galaxy.model.metadata.MetadataParameter

to_string(value)[source]
to_safe_string(value)[source]
get_field(value=None, context=None, other_values=None, **kwd)[source]
wrap(value, session)[source]
make_copy(value, target_context, source_context)[source]
classmethod marshal(value)[source]
from_external_value(value, parent, path_rewriter=None)[source]

Turns a value read from a external dict into its value to be pushed directly into the metadata dict.

to_external_value(value)[source]

Turns a value read from a metadata into its value to be pushed directly into the external dict.

new_file(dataset=None, **kwds)[source]
class galaxy.model.metadata.MetadataTempFile(**kwds)[source]

Bases: object

tmp_dir = 'database/tmp'
__init__(**kwds)[source]
file_name
to_JSON()[source]
classmethod from_JSON(json_dict)[source]
classmethod is_JSONified_value(value)[source]
classmethod cleanup_from_JSON_dict_filename(filename)[source]
class galaxy.model.metadata.JobExternalOutputMetadataWrapper(job)[source]

Bases: object

Class with methods allowing set_meta() to be called externally to the Galaxy head. This class allows access to external metadata filenames for all outputs associated with a job. We will use JSON as the medium of exchange of information, except for the DatasetInstance object which will use pickle (in the future this could be JSONified as well)

__init__(job)[source]
get_output_filenames_by_dataset(dataset, sa_session)[source]
get_dataset_metadata_key(dataset)[source]
invalidate_external_metadata(datasets, sa_session)[source]
setup_external_metadata(datasets, sa_session, exec_dir=None, tmp_dir=None, dataset_files_path=None, output_fnames=None, config_root=None, config_file=None, datatypes_config=None, job_metadata=None, compute_tmp_dir=None, include_command=True, max_metadata_value_size=0, kwds=None)[source]
external_metadata_set_successfully(dataset, sa_session)[source]
cleanup_external_metadata(sa_session)[source]
set_job_runner_external_pid(pid, sa_session)[source]

galaxy.model.search module

The GQL (Galaxy Query Language) search engine parsers a simple ‘SQL-Like’ query syntax to obtain items from the Galaxy installations. Rather then allow/force the user to do queries on the Galaxy schema, it uses a small set of ‘Views’ which are simple table representations of complex galaxy ideas. So while a history and its tags may exist in seperate tables in the real schema, in GQL they exist in the same view

Example Queries:

select name, id, file_size from hda

select name from hda

select name, model_class from ldda

select * from history

select * from workflow

select id, name from history where name=’Unnamed history’

select * from history where name=’Unnamed history’

class galaxy.model.search.ViewField(name, sqlalchemy_field=None, handler=None, post_filter=None, id_decode=False)[source]

Bases: object

A ViewField defines a field in a view that filter operations can be applied to These filter operations are either handled with standard sqlalchemy filter calls, or passed to specialized handlers (such as when a table join would be needed to do the filtering)

Parameters:

sqlalchemy_field - Simple filtering using existing table columns, the argument is an sqlalchemy column
that the right hand value will be compared against
handler - Requires more specialized code to do filtering, usually requires a table join in order to
process the conditional
post_filter - Unable to do simple sqlalchemy based table filtering, filter is applied to loaded object
Thus methods avalible to the object can be used for filtering. example: a library folder must climb its chain of parents to find out which library it belongs to
__init__(name, sqlalchemy_field=None, handler=None, post_filter=None, id_decode=False)[source]
class galaxy.model.search.ViewQueryBaseClass[source]

Bases: object

FIELDS = {}
VIEW_NAME = 'undefined'
__init__()[source]
decode_query_ids(trans, conditional)[source]
filter(left, operator, right)[source]
search(trans)[source]
get_results(force_query=False)[source]
galaxy.model.search.library_extended_metadata_filter(view, left, operator, right)[source]
galaxy.model.search.ldda_parent_library_filter(item, left, operator, right)[source]
class galaxy.model.search.LibraryDatasetDatasetView[source]

Bases: galaxy.model.search.ViewQueryBaseClass

VIEW_NAME = 'library_dataset_dataset'
FIELDS = {'parent_library_id': <galaxy.model.search.ViewField object>, 'extended_metadata': <galaxy.model.search.ViewField object>, 'name': <galaxy.model.search.ViewField object>, 'data_type': <galaxy.model.search.ViewField object>, 'deleted': <galaxy.model.search.ViewField object>, 'id': <galaxy.model.search.ViewField object>}
search(trans)[source]
class galaxy.model.search.LibraryView[source]

Bases: galaxy.model.search.ViewQueryBaseClass

VIEW_NAME = 'library'
FIELDS = {'deleted': <galaxy.model.search.ViewField object>, 'name': <galaxy.model.search.ViewField object>, 'id': <galaxy.model.search.ViewField object>}
search(trans)[source]
galaxy.model.search.library_folder_parent_library_id_filter(item, left, operator, right)[source]
galaxy.model.search.library_path_filter(item, left, operator, right)[source]
class galaxy.model.search.LibraryFolderView[source]

Bases: galaxy.model.search.ViewQueryBaseClass

VIEW_NAME = 'library_folder'
FIELDS = {'parent_id': <galaxy.model.search.ViewField object>, 'library_path': <galaxy.model.search.ViewField object>, 'name': <galaxy.model.search.ViewField object>, 'parent_library_id': <galaxy.model.search.ViewField object>, 'id': <galaxy.model.search.ViewField object>}
search(trans)[source]
galaxy.model.search.library_dataset_name_filter(item, left, operator, right)[source]
class galaxy.model.search.LibraryDatasetView[source]

Bases: galaxy.model.search.ViewQueryBaseClass

VIEW_NAME = 'library_dataset'
FIELDS = {'folder_id': <galaxy.model.search.ViewField object>, 'name': <galaxy.model.search.ViewField object>, 'id': <galaxy.model.search.ViewField object>}
search(trans)[source]
class galaxy.model.search.ToolView[source]

Bases: galaxy.model.search.ViewQueryBaseClass

VIEW_NAME = 'tool'
FIELDS = {'tool_id': <galaxy.model.search.ViewField object>, 'id': <galaxy.model.search.ViewField object>}
search(trans)[source]
galaxy.model.search.history_dataset_handle_tag(view, left, operator, right)[source]
galaxy.model.search.history_dataset_extended_metadata_filter(view, left, operator, right)[source]
class galaxy.model.search.HistoryDatasetView[source]

Bases: galaxy.model.search.ViewQueryBaseClass

DOMAIN = 'history_dataset'
FIELDS = {'tag': <galaxy.model.search.ViewField object>, 'extended_metadata': <galaxy.model.search.ViewField object>, 'name': <galaxy.model.search.ViewField object>, 'deleted': <galaxy.model.search.ViewField object>, 'history_id': <galaxy.model.search.ViewField object>, 'copied_from_hda_id': <galaxy.model.search.ViewField object>, 'id': <galaxy.model.search.ViewField object>, 'copied_from_ldda_id': <galaxy.model.search.ViewField object>}
search(trans)[source]
galaxy.model.search.history_handle_tag(view, left, operator, right)[source]
galaxy.model.search.history_handle_annotation(view, left, operator, right)[source]
class galaxy.model.search.HistoryView[source]

Bases: galaxy.model.search.ViewQueryBaseClass

DOMAIN = 'history'
FIELDS = {'deleted': <galaxy.model.search.ViewField object>, 'annotation': <galaxy.model.search.ViewField object>, 'tag': <galaxy.model.search.ViewField object>, 'name': <galaxy.model.search.ViewField object>, 'id': <galaxy.model.search.ViewField object>}
search(trans)[source]
galaxy.model.search.workflow_tag_handler(view, left, operator, right)[source]
class galaxy.model.search.WorkflowView[source]

Bases: galaxy.model.search.ViewQueryBaseClass

DOMAIN = 'workflow'
FIELDS = {'deleted': <galaxy.model.search.ViewField object>, 'tag': <galaxy.model.search.ViewField object>, 'name': <galaxy.model.search.ViewField object>, 'id': <galaxy.model.search.ViewField object>}
search(trans)[source]
galaxy.model.search.job_param_filter(view, left, operator, right)[source]
galaxy.model.search.job_input_hda_filter(view, left, operator, right)[source]
galaxy.model.search.job_input_ldda_filter(view, left, operator, right)[source]
galaxy.model.search.job_output_hda_filter(view, left, operator, right)[source]
class galaxy.model.search.JobView[source]

Bases: galaxy.model.search.ViewQueryBaseClass

DOMAIN = 'job'
FIELDS = {'output_hda': <galaxy.model.search.ViewField object>, 'input_ldda': <galaxy.model.search.ViewField object>, 'param': <galaxy.model.search.ViewField object>, 'state': <galaxy.model.search.ViewField object>, 'input_hda': <galaxy.model.search.ViewField object>, 'tool_name': <galaxy.model.search.ViewField object>}
search(trans)[source]
class galaxy.model.search.PageView[source]

Bases: galaxy.model.search.ViewQueryBaseClass

DOMAIN = 'page'
FIELDS = {'deleted': <galaxy.model.search.ViewField object>, 'title': <galaxy.model.search.ViewField object>, 'id': <galaxy.model.search.ViewField object>, 'slug': <galaxy.model.search.ViewField object>}
search(trans)[source]
class galaxy.model.search.PageRevisionView[source]

Bases: galaxy.model.search.ViewQueryBaseClass

DOMAIN = 'page_revision'
FIELDS = {'page_id': <galaxy.model.search.ViewField object>, 'id': <galaxy.model.search.ViewField object>, 'title': <galaxy.model.search.ViewField object>}
search(trans)[source]
class galaxy.model.search.GalaxyQuery(field_list, table_name, conditional)[source]

Bases: object

This class represents a data structure of a compiled GQL query

__init__(field_list, table_name, conditional)[source]
class galaxy.model.search.GalaxyQueryComparison(left, operator, right)[source]

Bases: object

This class represents the data structure of the comparison arguments of a compiled GQL query (ie where name=’Untitled History’)

__init__(left, operator, right)[source]
class galaxy.model.search.GalaxyQueryAnd(left, right)[source]

Bases: object

This class represents the data structure of the comparison arguments of a compiled GQL query (ie where name=’Untitled History’)

__init__(left, right)[source]
exception galaxy.model.search.GalaxyParseError[source]

Bases: exceptions.Exception

class galaxy.model.search.SearchQuery(view, query)[source]

Bases: object

__init__(view, query)[source]
decode_query_ids(trans)[source]
process(trans)[source]
item_to_api_value(item)[source]
class galaxy.model.search.GalaxySearchEngine[source]

Bases: object

Primary class for searching. Parses GQL (Galaxy Query Language) queries and returns a ‘SearchQuery’ class

__init__()[source]
query(query_text)[source]

galaxy.model.util module

Utility helpers related to the model

galaxy.model.util.pgcalc(sa_session, id, dryrun=False)[source]

Utility method for quickly recalculating user disk usage in postgres.

TODO: Check against the recently updated versions of sqlalchemy if this ‘special’ postgresql version is even necessary.