Jump to >

This documentation covers Review Board 2.5. You can see the latest Review Board documentation or all other versions.

reviewboard.datagrids.columns

class BaseStarColumn(*args, **kwargs)[source]

Bases: djblets.datagrid.grids.Column

Indicates if an item is starred.

This is the base class for all columns that deal with starring items.

The star is interactive, allowing the user to star or unstar the item.

__init__(*args, **kwargs)[source]

Initialize the column.

setup_state(state)[source]

Set up the state for this column.

render_data(state, obj)[source]

Return the rendered contents of the column.

class BaseSubmitterColumn(*args, **kwargs)[source]

Bases: djblets.datagrid.grids.Column

Base class for the Submitter column.

We have two versions of this column: One for review request datagrids, and one for review datagrids. This columns contains all the common rendering logic between the two.

GRAVATAR_SIZE = 24[source]
__init__(*args, **kwargs)[source]

Initialize the column.

render_user(state, user)[source]

Render the user’s name and gravatar as HTML.

class BugsColumn(*args, **kwargs)[source]

Bases: djblets.datagrid.grids.Column

Shows the list of bugs specified on a review request.

The list of bugs will be linked to the bug tracker, if a bug tracker was configured for the repository the review request’s change is on.

__init__(*args, **kwargs)[source]

Initialize the column.

augment_queryset(state, queryset)[source]

Add additional queries to the queryset.

render_data(state, review_request)[source]

Return the rendered contents of the column.

class ReviewRequestCheckboxColumn(checkbox_name=u’select’, shrink=True, show_checkbox_header=True, detailed_label=_(u’Select Rows’), *args, **kwargs)[source]

Bases: djblets.datagrid.grids.CheckboxColumn

A column containing a check-box.

render_data(state, obj)[source]

Return the rendered contents of the column.

class DateTimeSinceColumn(label, format=None, sortable=True, timezone=<UTC>, *args, **kwargs)[source]

Bases: djblets.datagrid.grids.DateTimeColumn

Displays how long it has been since a given date/time.

These columns will dynamically update as the page is shown, so that the number of minutes, hours, days, etc. ago is correct.

render_data(state, obj)[source]

Return the rendered contents of the column.

class DiffUpdatedColumn(*args, **kwargs)[source]

Bases: djblets.datagrid.grids.DateTimeColumn

Shows the date/time that the diff was last updated.

__init__(*args, **kwargs)[source]

Initialize the column.

augment_queryset(state, queryset)[source]

Add additional queries to the queryset.

render_data(state, obj)[source]

Return the rendered contents of the column.

class DiffUpdatedSinceColumn(*args, **kwargs)[source]

Bases: reviewboard.datagrids.columns.DateTimeSinceColumn

Shows the elapsed time since the diff was last updated.

__init__(*args, **kwargs)[source]

Initialize the column.

augment_queryset(state, queryset)[source]

Add additional queries to the queryset.

render_data(state, obj)[source]

Return the rendered contents of the column.

class GroupMemberCountColumn(*args, **kwargs)[source]

Bases: djblets.datagrid.grids.Column

Shows the number of users that are part of a review group.

__init__(*args, **kwargs)[source]

Initialize the column.

render_data(state, group)[source]

Return the rendered contents of the column.

Return the link to the object in the column.

class GroupsColumn(*args, **kwargs)[source]

Bases: djblets.datagrid.grids.Column

Shows the list of groups requested to review the review request.

__init__(*args, **kwargs)[source]

Initialize the column.

augment_queryset(state, queryset)[source]

Add additional queries to the queryset.

render_data(state, review_request)[source]

Return the rendered contents of the column.

class MyCommentsColumn(*args, **kwargs)[source]

Bases: djblets.datagrid.grids.Column

Shows if the current user has reviewed the review request.

__init__(*args, **kwargs)[source]

Initialize the column.

augment_queryset(state, queryset)[source]

Add additional queries to the queryset.

render_data(state, review_request)[source]

Return the rendered contents of the column.

class NewUpdatesColumn(*args, **kwargs)[source]

Bases: djblets.datagrid.grids.Column

Indicates if there are new updates on a review request.

This will show an icon if the review request has had any new updates or reviews since the user last saw it.

__init__(*args, **kwargs)[source]

Initialize the column.

render_data(state, review_request)[source]

Return the rendered contents of the column.

class PendingCountColumn(label=None, id=None, detailed_label=None, detailed_label_html=None, field_name=None, db_field=None, image_url=None, image_class=None, image_width=None, image_height=None, image_alt=u”, shrink=False, expand=False, sortable=False, default_sort_dir=0, link=False, link_func=None, cell_clickable=False, css_class=u”)[source]

Bases: djblets.datagrid.grids.Column

Shows the pending number of review requests for a user or group.

This will show the pending number of review requests for the given review group or user. It only applies to group or user lists.

render_data(state, obj)[source]

Return the rendered contents of the column.

class PeopleColumn(*args, **kwargs)[source]

Bases: djblets.datagrid.grids.Column

Shows the list of people requested to review the review request.

__init__(*args, **kwargs)[source]

Initialize the column.

augment_queryset(state, queryset)[source]

Add additional queries to the queryset.

render_data(state, review_request)[source]

Return the rendered contents of the column.

class RepositoryColumn(*args, **kwargs)[source]

Bases: djblets.datagrid.grids.Column

Shows the name of the repository the review request’s change is on.

__init__(*args, **kwargs)[source]

Initialize the column.

augment_queryset(state, queryset)[source]

Add additional queries to the queryset.

render_data(state, obj)[source]

Return the rendered contents of the column.

class ReviewCountColumn(*args, **kwargs)[source]

Bases: djblets.datagrid.grids.Column

Shows the number of published reviews for a review request.

__init__(*args, **kwargs)[source]

Initialize the column.

render_data(state, review_request)[source]

Return the rendered contents of the column.

augment_queryset(state, queryset)[source]

Add additional queries to the queryset.

Return the link to the object in the column.

class ReviewGroupStarColumn(*args, **kwargs)[source]

Bases: reviewboard.datagrids.columns.BaseStarColumn

Indicates if a review group is starred.

The star is interactive, allowing the user to star or unstar the group.

augment_queryset(state, queryset)[source]

Add additional queries to the queryset.

class ReviewRequestIDColumn(*args, **kwargs)[source]

Bases: djblets.datagrid.grids.Column

Displays the ID of the review request.

__init__(*args, **kwargs)[source]

Initialize the column.

get_sort_field(state)[source]

Return the model field for sorting this column.

render_data(state, review_request)[source]

Return the rendered contents of the column.

class ReviewRequestStarColumn(*args, **kwargs)[source]

Bases: reviewboard.datagrids.columns.BaseStarColumn

Indicates if a review request is starred.

The star is interactive, allowing the user to star or unstar the review request.

augment_queryset(state, queryset)[source]

Add additional queries to the queryset.

class ReviewSubmitterColumn(*args, **kwargs)[source]

Bases: reviewboard.datagrids.columns.BaseSubmitterColumn

Shows the submitter of the review request for a review.

render_data(state, review)[source]

Return the rendered contents of the column.

augment_queryset(state, queryset)[source]

Add additional queries to the queryset.

class ShipItColumn(*args, **kwargs)[source]

Bases: djblets.datagrid.grids.Column

Shows the “Ship It” count for a review request.

__init__(*args, **kwargs)[source]

Initialize the column.

render_data(state, review_request)[source]

Return the rendered contents of the column.

class SubmitterColumn(*args, **kwargs)[source]

Bases: reviewboard.datagrids.columns.BaseSubmitterColumn

Shows the username of the user who submitted the review request.

__init__(*args, **kwargs)[source]

Initialize the column.

render_data(state, review_request)[source]

Return the rendered contents of the column.

augment_queryset(state, queryset)[source]

Add additional queries to the queryset.

class SummaryColumn(*args, **kwargs)[source]

Bases: djblets.datagrid.grids.Column

Shows the summary of a review request.

This will also prepend the draft/submitted/discarded state, if any, to the summary.

__init__(*args, **kwargs)[source]

Initialize the column.

augment_queryset(state, queryset)[source]

Add additional queries to the queryset.

render_data(state, review_request)[source]

Return the rendered contents of the column.

class ReviewSummaryColumn(*args, **kwargs)[source]

Bases: reviewboard.datagrids.columns.SummaryColumn

Shows the summary of the review request of a review.

This does not (yet) prepend the draft/submitted/discarded state, if any, to the summary.

__init__(*args, **kwargs)[source]

Initialize the column.

render_data(state, review)[source]

Return the rendered contents of the column.

augment_queryset(state, queryset)[source]

Add additional queries to the queryset.

class ToMeColumn(*args, **kwargs)[source]

Bases: djblets.datagrid.grids.Column

Indicates if the user is requested to review the change.

This will show an indicator if the user is on the Target People reviewers list.

__init__(*args, **kwargs)[source]

Initialize the column.

augment_queryset(state, queryset)[source]

Add additional queries to the queryset.

render_data(state, review_request)[source]

Return the rendered contents of the column.

class DiffSizeColumn(*args, **kwargs)[source]

Bases: djblets.datagrid.grids.Column

Indicates line add/delete counts for the latest diffset.

__init__(*args, **kwargs)[source]

Initialize the column.

render_data(state, review_request)[source]

Return the rendered contents of the column.

augment_queryset(state, queryset)[source]

Add additional queries to the queryset.

This will prefetch the diffsets and filediffs needed to perform the line calculations.

Parameters:
Returns:

The resulting queryset.

Return type:

django.db.models.query.QuerySet