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.webapps.reports.framework package

Submodules

galaxy.webapps.reports.framework.grids module

class galaxy.webapps.reports.framework.grids.Grid

Bases: object

Specifies the content and format of a grid (data table).

title = ''

model_class = None

show_item_checkboxes = False

template = 'legacy/grid_base.mako'

async_template = 'legacy/grid_base_async.mako'

use_async = False

use_hide_message = True

global_actions = []

columns = []

operations = []

standard_filters = []

default_filter = {}

default_sort_key = None

use_paging = False

num_rows_per_page = 25

num_page_links = 10

cur_filter_pref_name = '.filter'

cur_sort_key_pref_name = '.sort_key'

legend = None

info_text = None

__init__()

get_ids(**kwargs)

handle_operation(trans, operation, ids, **kwargs)

get_current_item(trans, **kwargs)

build_initial_query(trans, **kwargs)

apply_query_filter(trans, query, **kwargs)

class galaxy.webapps.reports.framework.grids.GridColumn(label, key=None, model_class=None, method=None, format=None, link=None, attach_popup=False, visible=True, nowrap=False, filterable=None, sortable=True, label_id_prefix=None, target=None)

Bases: object

__init__(label, key=None, model_class=None, method=None, format=None, link=None, attach_popup=False, visible=True, nowrap=False, filterable=None, sortable=True, label_id_prefix=None, target=None)

Create a grid column.

get_value(trans, grid, item)

get_link(trans, grid, item)

filter(trans, user, query, column_filter)

Modify query to reflect the column filter.

get_accepted_filters()

Returns a list of accepted filters for this column.

sort(trans, query, ascending, column_name=None)

Sort query using this column.

class galaxy.webapps.reports.framework.grids.ReverseSortColumn(label, key=None, model_class=None, method=None, format=None, link=None, attach_popup=False, visible=True, nowrap=False, filterable=None, sortable=True, label_id_prefix=None, target=None)

Bases: galaxy.webapps.reports.framework.grids.GridColumn

Column that reverses sorting; this is useful when the natural sort is descending.

sort(trans, query, ascending, column_name=None)

class galaxy.webapps.reports.framework.grids.TextColumn(label, key=None, model_class=None, method=None, format=None, link=None, attach_popup=False, visible=True, nowrap=False, filterable=None, sortable=True, label_id_prefix=None, target=None)

Bases: galaxy.webapps.reports.framework.grids.GridColumn

Generic column that employs freetext and, hence, supports freetext, case-independent filtering.

filter(trans, user, query, column_filter)

Modify query to filter using free text, case independence.

get_filter(trans, user, column_filter)

Returns a SQLAlchemy criterion derived from column_filter.

get_single_filter(user, a_filter)

Returns a SQLAlchemy criterion derived for a single filter. Single filter is the most basic filter–usually a string–and cannot be a list.

sort(trans, query, ascending, column_name=None)

Sort column using case-insensitive alphabetical sorting.

class galaxy.webapps.reports.framework.grids.DateTimeColumn(label, key=None, model_class=None, method=None, format=None, link=None, attach_popup=False, visible=True, nowrap=False, filterable=None, sortable=True, label_id_prefix=None, target=None)

Bases: galaxy.webapps.reports.framework.grids.TextColumn

sort(trans, query, ascending, column_name=None)

Sort query using this column.

class galaxy.webapps.reports.framework.grids.BooleanColumn(label, key=None, model_class=None, method=None, format=None, link=None, attach_popup=False, visible=True, nowrap=False, filterable=None, sortable=True, label_id_prefix=None, target=None)

Bases: galaxy.webapps.reports.framework.grids.TextColumn

sort(trans, query, ascending, column_name=None)

Sort query using this column.

get_single_filter(user, a_filter)

class galaxy.webapps.reports.framework.grids.IntegerColumn(label, key=None, model_class=None, method=None, format=None, link=None, attach_popup=False, visible=True, nowrap=False, filterable=None, sortable=True, label_id_prefix=None, target=None)

Bases: galaxy.webapps.reports.framework.grids.TextColumn

Integer column that employs freetext, but checks that the text is an integer, so support filtering on integer values.

IMPORTANT NOTE: grids that use this column type should not include the column in the cols_to_filter list of MulticolFilterColumn ( i.e., searching on this column type should not be performed in the grid’s standard search - it won’t throw exceptions, but it also will not find what you’re looking for ). Grids that search on this column should use ‘filterable=”advanced”’ so that searching is only performed in the advanced search component, restricting the search to the specific column.

This is useful for searching on object ids or other integer columns. See the JobIdColumn column in the SpecifiedDateListGrid class in the jobs controller of the reports webapp for an example.

get_single_filter(user, a_filter)

sort(trans, query, ascending, column_name=None)

Sort query using this column.

class galaxy.webapps.reports.framework.grids.CommunityRatingColumn(label, key=None, model_class=None, method=None, format=None, link=None, attach_popup=False, visible=True, nowrap=False, filterable=None, sortable=True, label_id_prefix=None, target=None)

Bases: galaxy.webapps.reports.framework.grids.GridColumn, galaxy.model.item_attrs.UsesItemRatings

Column that displays community ratings for an item.

get_value(trans, grid, item)

sort(trans, query, ascending, column_name=None)

class galaxy.webapps.reports.framework.grids.OwnerAnnotationColumn(col_name, key, model_class=None, model_annotation_association_class=None, filterable=None)

Bases: galaxy.webapps.reports.framework.grids.TextColumn, galaxy.model.item_attrs.UsesAnnotations

Column that displays and filters item owner’s annotations.

__init__(col_name, key, model_class=None, model_annotation_association_class=None, filterable=None)

get_value(trans, grid, item)

Returns first 150 characters of annotation.

get_single_filter(user, a_filter)

Filter by annotation and annotation owner.

class galaxy.webapps.reports.framework.grids.CommunityTagsColumn(col_name, key, model_class=None, model_tag_association_class=None, filterable=None, grid_name=None)

Bases: galaxy.webapps.reports.framework.grids.TextColumn

Column that supports community tags.

__init__(col_name, key, model_class=None, model_tag_association_class=None, filterable=None, grid_name=None)

get_value(trans, grid, item)

filter(trans, user, query, column_filter)

Modify query to filter model_class by tag. Multiple filters are ANDed.

get_filter(trans, user, column_filter)

class galaxy.webapps.reports.framework.grids.IndividualTagsColumn(col_name, key, model_class=None, model_tag_association_class=None, filterable=None, grid_name=None)

Bases: galaxy.webapps.reports.framework.grids.CommunityTagsColumn

Column that supports individual tags.

get_value(trans, grid, item)

get_filter(trans, user, column_filter)

class galaxy.webapps.reports.framework.grids.MulticolFilterColumn(col_name, cols_to_filter, key, visible, filterable='default')

Bases: galaxy.webapps.reports.framework.grids.TextColumn

Column that performs multicolumn filtering.

__init__(col_name, cols_to_filter, key, visible, filterable='default')

filter(trans, user, query, column_filter)

Modify query to filter model_class by tag. Multiple filters are ANDed.

class galaxy.webapps.reports.framework.grids.OwnerColumn(label, key=None, model_class=None, method=None, format=None, link=None, attach_popup=False, visible=True, nowrap=False, filterable=None, sortable=True, label_id_prefix=None, target=None)

Bases: galaxy.webapps.reports.framework.grids.TextColumn

Column that lists item’s owner.

get_value(trans, grid, item)

sort(trans, query, ascending, column_name=None)

Sort column using case-insensitive alphabetical sorting on item’s username.

class galaxy.webapps.reports.framework.grids.PublicURLColumn(label, key=None, model_class=None, method=None, format=None, link=None, attach_popup=False, visible=True, nowrap=False, filterable=None, sortable=True, label_id_prefix=None, target=None)

Bases: galaxy.webapps.reports.framework.grids.TextColumn

Column displays item’s public URL based on username and slug.

get_link(trans, grid, item)

class galaxy.webapps.reports.framework.grids.DeletedColumn(label, key=None, model_class=None, method=None, format=None, link=None, attach_popup=False, visible=True, nowrap=False, filterable=None, sortable=True, label_id_prefix=None, target=None)

Bases: galaxy.webapps.reports.framework.grids.GridColumn

Column that tracks and filters for items with deleted attribute.

get_accepted_filters()

Returns a list of accepted filters for this column.

filter(trans, user, query, column_filter)

Modify query to filter self.model_class by state.

class galaxy.webapps.reports.framework.grids.StateColumn(label, key=None, model_class=None, method=None, format=None, link=None, attach_popup=False, visible=True, nowrap=False, filterable=None, sortable=True, label_id_prefix=None, target=None)

Bases: galaxy.webapps.reports.framework.grids.GridColumn

Column that tracks and filters for items with state attribute.

IMPORTANT NOTE: self.model_class must have a states Bunch or dict if this column type is used in the grid.

get_value(trans, grid, item)

filter(trans, user, query, column_filter)

Modify query to filter self.model_class by state.

get_accepted_filters()

Returns a list of accepted filters for this column.

class galaxy.webapps.reports.framework.grids.SharingStatusColumn(label, key=None, model_class=None, method=None, format=None, link=None, attach_popup=False, visible=True, nowrap=False, filterable=None, sortable=True, label_id_prefix=None, target=None)

Bases: galaxy.webapps.reports.framework.grids.GridColumn

Grid column to indicate sharing status.

get_value(trans, grid, item)

get_link(trans, grid, item)

filter(trans, user, query, column_filter)

Modify query to filter histories by sharing status.

get_accepted_filters()

Returns a list of accepted filters for this column.

class galaxy.webapps.reports.framework.grids.GridOperation(label, key=None, condition=None, allow_multiple=True, allow_popup=True, target=None, url_args=None, async_compatible=False, confirm=None, global_operation=None)

Bases: object

__init__(label, key=None, condition=None, allow_multiple=True, allow_popup=True, target=None, url_args=None, async_compatible=False, confirm=None, global_operation=None)

get_url_args(item)

allowed(item)

class galaxy.webapps.reports.framework.grids.DisplayByUsernameAndSlugGridOperation(label, key=None, condition=None, allow_multiple=True, allow_popup=True, target=None, url_args=None, async_compatible=False, confirm=None, global_operation=None)

Bases: galaxy.webapps.reports.framework.grids.GridOperation

Operation to display an item by username and slug.

get_url_args(item)

class galaxy.webapps.reports.framework.grids.GridAction(label=None, url_args=None, target=None)

Bases: object

__init__(label=None, url_args=None, target=None)

class galaxy.webapps.reports.framework.grids.GridColumnFilter(label, args=None)

Bases: object

__init__(label, args=None)

get_url_args()