reviewboard.reviews.actions¶

Actions for the reviews app.

class CloseMenuAction[source]¶

Bases: BaseMenuAction

A menu for closing the review request.

New in version 6.0.

action_id: str = 'close-menu'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

label: StrOrPromise | None = 'Close'[source]¶

The user-visible label.

Type:

str

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

should_render(*, context: Context) → bool[source]¶

Return whether this action should render.

This differs from hidden in that hidden actions still render but are hidden by CSS, whereas if this returns False the action will not be included in the DOM at all.

Parameters:

context (django.template.Context) – The current rendering context.

Returns:

True if the action should render.

Return type:

bool

class CloseCompletedAction[source]¶

Bases: BaseAction

The action to close a review request as completed.

New in version 6.0.

action_id: str = 'close-completed'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

label: StrOrPromise | None = 'Completed'[source]¶

The user-visible label.

Type:

str

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

js_model_class: str = 'RB.CloseCompletedAction'[source]¶

The class to instantiate for the JavaScript model.

Type:

str

placements: Sequence[ActionPlacement] | None = [<reviewboard.actions.base.ActionPlacement object>][source]¶

The placements of this action within the page.

Each entry defines a placement within an attachment point and an action parent/child hierarchy where action should be rendered, along with options controlling the rendering.

New in version 7.1.

should_render(*, context: Context) → bool[source]¶

Return whether this action should render.

This differs from hidden in that hidden actions still render but are hidden by CSS, whereas if this returns False the action will not be included in the DOM at all.

Parameters:

context (django.template.Context) – The current rendering context.

Returns:

True if the action should render.

Return type:

bool

class CloseDiscardedAction[source]¶

Bases: BaseAction

The action to close a review request as discarded.

New in version 6.0.

action_id: str = 'close-discarded'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

label: StrOrPromise | None = 'Discarded'[source]¶

The user-visible label.

Type:

str

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

js_model_class: str = 'RB.CloseDiscardedAction'[source]¶

The class to instantiate for the JavaScript model.

Type:

str

placements: Sequence[ActionPlacement] | None = [<reviewboard.actions.base.ActionPlacement object>][source]¶

The placements of this action within the page.

Each entry defines a placement within an attachment point and an action parent/child hierarchy where action should be rendered, along with options controlling the rendering.

New in version 7.1.

class DeleteAction[source]¶

Bases: BaseAction

The action to permanently delete a review request.

New in version 6.0.

action_id: str = 'delete-review-request'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

label: StrOrPromise | None = 'Delete Permanently'[source]¶

The user-visible label.

Type:

str

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

js_model_class: str = 'RB.DeleteAction'[source]¶

The class to instantiate for the JavaScript model.

Type:

str

placements: Sequence[ActionPlacement] | None = [<reviewboard.actions.base.ActionPlacement object>][source]¶

The placements of this action within the page.

Each entry defines a placement within an attachment point and an action parent/child hierarchy where action should be rendered, along with options controlling the rendering.

New in version 7.1.

should_render(*, context: Context) → bool[source]¶

Return whether this action should render.

This differs from hidden in that hidden actions still render but are hidden by CSS, whereas if this returns False the action will not be included in the DOM at all.

Parameters:

context (django.template.Context) – The current rendering context.

Returns:

True if the action should render.

Return type:

bool

class DownloadDiffAction[source]¶

Bases: BaseAction

The action to download a diff.

New in version 6.0.

action_id: str = 'download-diff'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

label: StrOrPromise | None = 'Download Diff'[source]¶

The user-visible label.

Type:

str

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

get_url(*, context: Context) → str[source]¶

Return this action’s URL.

Parameters:

context (django.template.Context) – The collection of key-value pairs from the template.

Returns:

The URL to invoke if this action is clicked.

Return type:

str

get_visible(*, context: Context) → bool[source]¶

Return whether the action should start visible or not.

Parameters:

context (django.template.Context) – The current rendering context.

Returns:

True if the action should start visible. False, otherwise.

Return type:

bool

should_render(*, context: Context) → bool[source]¶

Return whether this action should render.

This differs from hidden in that hidden actions still render but are hidden by CSS, whereas if this returns False the action will not be included in the DOM at all.

Parameters:

context (django.template.Context) – The current rendering context.

Returns:

True if the action should render.

Return type:

bool

class ReviewMenuActionRenderer(*, action: BaseAction, placement: ActionPlacement)[source]¶

Bases: DetailedMenuActionGroupRenderer

Action renderer for the Review menu.

This renders as a detailed menu, but using a custom JavaScript view for managing the menu.

New in version 7.1.

js_view_class: ClassVar[str] = 'RB.ReviewMenuActionView'[source]¶

The class to instantiate for the JavaScript view.

class ReviewMenuAction[source]¶

Bases: BaseMenuAction

The “Review” menu on the unified banner.

New in version 6.0.

action_id: str = 'review-menu'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

default_renderer_cls[source]¶

alias of ReviewMenuActionRenderer

icon_class: Optional[str] = 'rb-icon rb-icon-compose-review'[source]¶

A class name to use for an icon.

If specified, this should be the entire class to apply to a <span> element to display an icon. For example, ‘fa fa-rss’.

Type:

str

label: StrOrPromise | None = 'Review'[source]¶

The user-visible label.

Type:

str

placements: Sequence[ActionPlacement] | None = [<reviewboard.actions.base.ActionPlacement object>][source]¶

The placements of this action within the page.

Each entry defines a placement within an attachment point and an action parent/child hierarchy where action should be rendered, along with options controlling the rendering.

New in version 7.1.

should_render(*, context: Context) → bool[source]¶

Return whether this action should render.

This menu only renders when the user is logged in and the unified banner feature is enabled.

Parameters:

context (django.template.Context) – The current rendering context.

Returns:

True if the action should render.

Return type:

bool

class CreateReviewAction[source]¶

Bases: BaseAction

Action to create a new, blank review.

New in version 6.0.

action_id: str = 'create-review'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

label: StrOrPromise | None = 'Create Review'[source]¶

The user-visible label.

Type:

str

verbose_label: StrOrPromise | None = 'Create a new review'[source]¶

The user-visible verbose label.

This can be used to provide a longer label for wider UIs that would benefit from a more descriptive label. It’s also intended for ARIA labels.

This is always optional.

New in version 7.1.

description = ['Your review will start off blank, but you can add text and general comments to it.', 'Adding comments to code or file attachments will automatically create a new review for you.'][source]¶

icon_class: Optional[str] = 'rb-icon rb-icon-create-review'[source]¶

A class name to use for an icon.

If specified, this should be the entire class to apply to a <span> element to display an icon. For example, ‘fa fa-rss’.

Type:

str

js_model_class: str = 'RB.CreateReviewAction'[source]¶

The class to instantiate for the JavaScript model.

Type:

str

placements: Sequence[ActionPlacement] | None = [<reviewboard.actions.base.ActionPlacement object>, <reviewboard.actions.base.ActionPlacement object>][source]¶

The placements of this action within the page.

Each entry defines a placement within an attachment point and an action parent/child hierarchy where action should be rendered, along with options controlling the rendering.

New in version 7.1.

should_render(*, context: Context) → bool[source]¶

Return whether this action should render.

This menu only renders when the user is logged in and the unified banner feature is enabled.

Parameters:

context (django.template.Context) – The current rendering context.

Returns:

True if the action should render.

Return type:

bool

class EditReviewAction[source]¶

Bases: BaseAction

Action to edit an existing review.

New in version 6.0.

action_id: str = 'edit-review'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

label: StrOrPromise | None = 'Edit Review'[source]¶

The user-visible label.

Type:

str

verbose_label: StrOrPromise | None = 'Edit your review'[source]¶

The user-visible verbose label.

This can be used to provide a longer label for wider UIs that would benefit from a more descriptive label. It’s also intended for ARIA labels.

This is always optional.

New in version 7.1.

description = ['Edit your comments and publish your review.'][source]¶

icon_class: Optional[str] = 'rb-icon rb-icon-compose-review'[source]¶

A class name to use for an icon.

If specified, this should be the entire class to apply to a <span> element to display an icon. For example, ‘fa fa-rss’.

Type:

str

js_model_class: str = 'RB.EditReviewAction'[source]¶

The class to instantiate for the JavaScript model.

Type:

str

placements: Sequence[ActionPlacement] | None = [<reviewboard.actions.base.ActionPlacement object>, <reviewboard.actions.base.ActionPlacement object>][source]¶

The placements of this action within the page.

Each entry defines a placement within an attachment point and an action parent/child hierarchy where action should be rendered, along with options controlling the rendering.

New in version 7.1.

should_render(*, context: Context) → bool[source]¶

Return whether this action should render.

This menu only renders when the user is logged in and the unified banner feature is enabled.

Parameters:

context (django.template.Context) – The current rendering context.

Returns:

True if the action should render.

Return type:

bool

class AddGeneralCommentAction[source]¶

Bases: BaseAction

Action to add a general comment.

New in version 6.0.

action_id: str = 'add-general-comment'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

label: StrOrPromise | None = 'Add General Comment'[source]¶

The user-visible label.

Type:

str

verbose_label: StrOrPromise | None = 'Add a general comment'[source]¶

The user-visible verbose label.

This can be used to provide a longer label for wider UIs that would benefit from a more descriptive label. It’s also intended for ARIA labels.

This is always optional.

New in version 7.1.

description = ['Add a new general comment about the change, not attached to any code or file attachments.'][source]¶

icon_class: Optional[str] = 'rb-icon rb-icon-edit'[source]¶

A class name to use for an icon.

If specified, this should be the entire class to apply to a <span> element to display an icon. For example, ‘fa fa-rss’.

Type:

str

js_model_class: str = 'RB.AddGeneralCommentAction'[source]¶

The class to instantiate for the JavaScript model.

Type:

str

placements: Sequence[ActionPlacement] | None = [<reviewboard.actions.base.ActionPlacement object>, <reviewboard.actions.base.ActionPlacement object>][source]¶

The placements of this action within the page.

Each entry defines a placement within an attachment point and an action parent/child hierarchy where action should be rendered, along with options controlling the rendering.

New in version 7.1.

should_render(*, context: Context) → bool[source]¶

Return whether this action should render.

New in version 7.1.

Parameters:

context (django.template.Context) – The current rendering context.

Returns:

True if the action should render.

Return type:

bool

class ShipItAction[source]¶

Bases: BaseAction

Action to mark a review request as “Ship It”.

New in version 6.0.

action_id: str = 'ship-it'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

label: StrOrPromise | None = 'Ship It!'[source]¶

The user-visible label.

Type:

str

verbose_label: StrOrPromise | None = 'Ship it!'[source]¶

The user-visible verbose label.

This can be used to provide a longer label for wider UIs that would benefit from a more descriptive label. It’s also intended for ARIA labels.

This is always optional.

New in version 7.1.

description = ["You're happy with what you're seeing, and would like to approve it.", 'If you want to leave a comment with this, choose "Create a new review" above.'][source]¶

icon_class: Optional[str] = 'rb-icon rb-icon-shipit'[source]¶

A class name to use for an icon.

If specified, this should be the entire class to apply to a <span> element to display an icon. For example, ‘fa fa-rss’.

Type:

str

js_model_class: str = 'RB.ShipItAction'[source]¶

The class to instantiate for the JavaScript model.

Type:

str

placements: Sequence[ActionPlacement] | None = [<reviewboard.actions.base.ActionPlacement object>, <reviewboard.actions.base.ActionPlacement object>][source]¶

The placements of this action within the page.

Each entry defines a placement within an attachment point and an action parent/child hierarchy where action should be rendered, along with options controlling the rendering.

New in version 7.1.

should_render(*, context: Context) → bool[source]¶

Return whether this action should render.

New in version 7.1.

Parameters:

context (django.template.Context) – The current rendering context.

Returns:

True if the action should render.

Return type:

bool

class LegacyAddGeneralCommentAction[source]¶

Bases: BaseAction

The action for adding a general comment.

Deprecated since version 7.1: This will be removed in Review Board 9.

New in version 6.0.

action_id: str = 'legacy-add-general-comment'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

label: StrOrPromise | None = 'Add General Comment'[source]¶

The user-visible label.

Type:

str

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

should_render(*, context: Context) → bool[source]¶

Return whether this action should render.

This differs from hidden in that hidden actions still render but are hidden by CSS, whereas if this returns False the action will not be included in the DOM at all.

Parameters:

context (django.template.Context) – The current rendering context.

Returns:

True if the action should render.

Return type:

bool

class LegacyEditReviewAction[source]¶

Bases: BaseAction

The old-style “Edit Review” action.

This exists within the review request actions area, and will be supplanted by the new action in the Review menu in the unified banner.

Deprecated since version 7.1: This will be removed in Review Board 9.

New in version 6.0.

action_id: str = 'legacy-edit-review'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

label: StrOrPromise | None = 'Review'[source]¶

The user-visible label.

Type:

str

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

should_render(*, context: Context) → bool[source]¶

Return whether this action should render.

This differs from hidden in that hidden actions still render but are hidden by CSS, whereas if this returns False the action will not be included in the DOM at all.

Parameters:

context (django.template.Context) – The current rendering context.

Returns:

True if the action should render.

Return type:

bool

class LegacyShipItAction[source]¶

Bases: BaseAction

The old-style “Ship It” action.

This exists within the review request actions area, and will be supplanted by the new action in the Review menu in the unified banner.

Deprecated since version 7.1: This will be removed in Review Board 9.

New in version 6.0.

action_id: str = 'legacy-ship-it'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

label: StrOrPromise | None = 'Ship It!'[source]¶

The user-visible label.

Type:

str

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

should_render(*, context: Context) → bool[source]¶

Return whether this action should render.

This differs from hidden in that hidden actions still render but are hidden by CSS, whereas if this returns False the action will not be included in the DOM at all.

Parameters:

context (django.template.Context) – The current rendering context.

Returns:

True if the action should render.

Return type:

bool

class UpdateMenuAction[source]¶

Bases: BaseMenuAction

A menu for updating the review request.

New in version 6.0.

action_id: str = 'update-menu'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

label: StrOrPromise | None = 'Update'[source]¶

The user-visible label.

Type:

str

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

should_render(*, context: Context) → bool[source]¶

Return whether this action should render.

This differs from hidden in that hidden actions still render but are hidden by CSS, whereas if this returns False the action will not be included in the DOM at all.

Parameters:

context (django.template.Context) – The current rendering context.

Returns:

True if the action should render.

Return type:

bool

class UploadDiffAction[source]¶

Bases: BaseAction

The action to update or upload a diff.

New in version 6.0.

action_id: str = 'upload-diff'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

js_model_class: str = 'RB.UpdateDiffAction'[source]¶

The class to instantiate for the JavaScript model.

Type:

str

placements: Sequence[ActionPlacement] | None = [<reviewboard.actions.base.ActionPlacement object>][source]¶

The placements of this action within the page.

Each entry defines a placement within an attachment point and an action parent/child hierarchy where action should be rendered, along with options controlling the rendering.

New in version 7.1.

get_label(*, context: Context) → StrOrPromise[source]¶

Return the label for the action.

Parameters:

context (django.template.Context) – The current rendering context.

Returns:

The label to use for the action.

Return type:

str

should_render(*, context: Context) → bool[source]¶

Return whether this action should render.

This differs from hidden in that hidden actions still render but are hidden by CSS, whereas if this returns False the action will not be included in the DOM at all.

Parameters:

context (django.template.Context) – The current rendering context.

Returns:

True if the action should render.

Return type:

bool

class UploadFileAction[source]¶

Bases: BaseAction

The action to upload a new file attachment.

New in version 6.0.

action_id: str = 'upload-file'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

label: StrOrPromise | None = 'Add File'[source]¶

The user-visible label.

Type:

str

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

js_model_class: str = 'RB.AddFileAction'[source]¶

The class to instantiate for the JavaScript model.

Type:

str

placements: Sequence[ActionPlacement] | None = [<reviewboard.actions.base.ActionPlacement object>][source]¶

The placements of this action within the page.

Each entry defines a placement within an attachment point and an action parent/child hierarchy where action should be rendered, along with options controlling the rendering.

New in version 7.1.

should_render(*, context: Context) → bool[source]¶

Return whether this action should render.

This differs from hidden in that hidden actions still render but are hidden by CSS, whereas if this returns False the action will not be included in the DOM at all.

Parameters:

context (django.template.Context) – The current rendering context.

Returns:

True if the action should render.

Return type:

bool

class StarActionRenderer(*, action: BaseAction, placement: ActionPlacement)[source]¶

Bases: BaseActionRenderer

Action renderer for the starred action.

This provides a custom template used to render the action as a star, which can be pressed to star or unstar the review request.

New in version 7.1.

template_name: ClassVar[str | None] = 'reviews/star_action.html'[source]¶

The name of the template to use when rendering.

class StarAction[source]¶

Bases: BaseAction

The action to star a review request.

New in version 6.0.

action_id: str = 'star-review-request'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

default_renderer_cls[source]¶

alias of StarActionRenderer

label: StrOrPromise | None = ''[source]¶

The user-visible label.

Type:

str

placements: Sequence[ActionPlacement] | None = [<reviewboard.actions.base.ActionPlacement object>][source]¶

The placements of this action within the page.

Each entry defines a placement within an attachment point and an action parent/child hierarchy where action should be rendered, along with options controlling the rendering.

New in version 7.1.

should_render(*, context: Context) → bool[source]¶

Return whether this action should render.

This differs from hidden in that hidden actions still render but are hidden by CSS, whereas if this returns False the action will not be included in the DOM at all.

Parameters:

context (django.template.Context) – The current rendering context.

Returns:

True if the action should render.

Return type:

bool

class ArchiveMenuActionRenderer(*, action: BaseAction, placement: ActionPlacement)[source]¶

Bases: MenuActionGroupRenderer

Action renderer for the Archive menu.

This renders as a menu, but using a custom JavaScript view for managing the menu.

New in version 7.1.

js_view_class: ClassVar[str] = 'RB.ArchiveMenuActionView'[source]¶

The class to instantiate for the JavaScript view.

class ArchiveMenuAction[source]¶

Bases: BaseMenuAction

A menu for managing the visibility state of the review request.

New in version 6.0.

action_id: str = 'archive-menu'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

default_renderer_cls[source]¶

alias of ArchiveMenuActionRenderer

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

icon_class: Optional[str] = 'rb-icon rb-icon-archive-off'[source]¶

A class name to use for an icon.

If specified, this should be the entire class to apply to a <span> element to display an icon. For example, ‘fa fa-rss’.

Type:

str

verbose_label: StrOrPromise | None = 'Archive or Mute'[source]¶

The user-visible verbose label.

This can be used to provide a longer label for wider UIs that would benefit from a more descriptive label. It’s also intended for ARIA labels.

This is always optional.

New in version 7.1.

placements: Sequence[ActionPlacement] | None = [<reviewboard.actions.base.ActionPlacement object>][source]¶

The placements of this action within the page.

Each entry defines a placement within an attachment point and an action parent/child hierarchy where action should be rendered, along with options controlling the rendering.

New in version 7.1.

should_render(*, context: Context) → bool[source]¶

Return whether this action should render.

This differs from hidden in that hidden actions still render but are hidden by CSS, whereas if this returns False the action will not be included in the DOM at all.

Parameters:

context (django.template.Context) – The current rendering context.

Returns:

True if the action should render.

Return type:

bool

class ArchiveAction[source]¶

Bases: BaseAction

An action for archiving the review request.

New in version 6.0.

action_id: str = 'archive'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

js_model_class: str = 'RB.ArchiveAction'[source]¶

The class to instantiate for the JavaScript model.

Type:

str

label: StrOrPromise | None = 'Toggle Archived'[source]¶

The user-visible label.

Type:

str

placements: Sequence[ActionPlacement] | None = [<reviewboard.actions.base.ActionPlacement object>][source]¶

The placements of this action within the page.

Each entry defines a placement within an attachment point and an action parent/child hierarchy where action should be rendered, along with options controlling the rendering.

New in version 7.1.

class MuteAction[source]¶

Bases: BaseAction

An action for muting the review request.

New in version 6.0.

action_id: str = 'mute'[source]¶

The internal ID of the action.

This must be unique.

Type:

str

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

js_model_class: str = 'RB.MuteAction'[source]¶

The class to instantiate for the JavaScript model.

Type:

str

label: StrOrPromise | None = 'Toggle Muted'[source]¶

The user-visible label.

Type:

str

placements: Sequence[ActionPlacement] | None = [<reviewboard.actions.base.ActionPlacement object>][source]¶

The placements of this action within the page.

Each entry defines a placement within an attachment point and an action parent/child hierarchy where action should be rendered, along with options controlling the rendering.

New in version 7.1.

class BaseReviewRequestAction[source]¶

Bases: BaseAction

A base class for an action that can be applied to a review request.

Creating an action requires subclassing BaseReviewRequestAction and overriding any fields/methods as desired. Different instances of the same subclass can also override the class fields with their own instance fields.

Example

class UsedOnceAction(BaseReviewRequestAction):
    action_id = 'once'
    label = 'This is used once.'

class UsedMultipleAction(BaseReviewRequestAction):
    def __init__(self, action_id, label):
        super().__init__()

        self.action_id = 'repeat-' + action_id
        self.label = 'This is used multiple times,'

Note

Since the same action will be rendered for multiple different users in a multithreaded environment, the action state should not be modified after initialization. If we want different action attributes at runtime, then we can override one of the getter methods (such as get_label()), which by default will simply return the original attribute from initialization.

Deprecated since version 6.0: New code should be written using reviewboard.actions.base.BaseAction. This class will be removed in 8.0.

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

__init__() → None[source]¶

Initialize this action.

By default, actions are top-level and have no children.

property max_depth: int[source]¶

Lazily compute the max depth of any action contained by this action.

Top-level actions have a depth of zero, and child actions have a depth that is one more than their parent action’s depth.

Algorithmically, the notion of max depth is equivalent to the notion of height in the context of trees (from graph theory). We decided to use this term instead so as not to confuse it with the dimensional height of a UI element.

Returns:

The max depth of any action contained by this action.

Return type:

int

reset_max_depth() → None[source]¶

Reset the max_depth of this action and all its ancestors to zero.

get_dom_element_id() → str[source]¶

Return the ID used for the DOM element for this action.

Returns:

The ID used for the element.

Return type:

str

get_extra_context(*, request: HttpRequest, context: Context) → dict[source]¶

Return extra template context for the action.

Parameters:

• request (django.http.HttpRequest) – The HTTP request from the client.

• context (django.template.Context) – The current rendering context.

Returns:

Extra context to use when rendering the action’s template.

Return type:

dict

copy_to_dict(context: Context) → dict[source]¶

Copy this action instance to a dictionary.

This is a legacy implementation left to maintain compatibility with custom templates.

register(parent: Optional[BaseReviewRequestMenuAction] = None) → None[source]¶

Register this review request action instance.

Note

Newly registered top-level actions are appended to the left of the other previously registered top-level actions. So if we intend to register a collection of top-level actions in a certain order, then we likely want to iterate through the actions in reverse.

Parameters:

parent (BaseReviewRequestMenuAction, optional) – The parent action instance of this action instance.

Raises:

• KeyError – A second registration is attempted (action IDs must be unique across all types of actions and menu actions, at any depth).

• DepthLimitExceededError – The maximum depth limit is exceeded.

unregister() → None[source]¶

Unregister this review request action instance.

Note

This method can mutate its parent’s child actions. So if we are iteratively unregistering a parent’s child actions, then we should consider first making a clone of the list of children.

Raises:

KeyError – An unregistration is attempted before it’s registered.

class BaseReviewRequestMenuAction(child_actions: Optional[List[BaseReviewRequestAction]] = None)[source]¶

Bases: BaseMenuAction

A base class for an action with a dropdown menu.

Deprecated since version 6.0: New code should be written using reviewboard.actions.base.BaseMenuAction. This class will be removed in 8.0.

apply_to: Optional[List[str]] = ['view-diff', 'view-interdiff', 'view-diff-revision', 'file-attachment', 'screenshot', 'view-diff', 'view-interdiff', 'view-diff-revision', 'review-request-detail'][source]¶

A list of URLs to apply to.

If this is None, the action will be loaded on all pages. Otherwise, it will be limited to the URLs listed here.

Type:

list of str

__init__(child_actions: Optional[List[BaseReviewRequestAction]] = None) → None[source]¶

Initialize this menu action.

Parameters:

child_actions (list of BaseReviewRequestAction, optional) – The list of child actions to be contained by this menu action.

Raises:

• KeyError – A second registration is attempted (action IDs must be unique across all types of actions and menu actions, at any depth).

• DepthLimitExceededError – The maximum depth limit is exceeded.

get_dom_element_id() → str[source]¶

Return the ID used for the DOM element for this action.

Returns:

The ID used for the element.

Return type:

str

copy_to_dict(context: Context) → dict[source]¶

Copy this menu action instance to a dictionary.

This is a legacy implementation left to maintain compatibility with custom templates.

Parameters:

context (django.template.Context) – The collection of key-value pairs from the template.

Returns:

The corresponding dictionary.

Return type:

dict

get_extra_context(*, request: HttpRequest, context: Context) → dict[source]¶

Return extra template context for the action.

Parameters:

• request (django.http.HttpRequest) – The HTTP request from the client.

• context (django.template.Context) – The current rendering context.

Returns:

Extra context to use when rendering the action’s template.

Return type:

dict

property max_depth: int[source]¶

Lazily compute the max depth of any action contained by this action.

Returns:

The max depth of any action contained by this action.

Return type:

int

register(parent: Optional[BaseReviewRequestMenuAction] = None) → None[source]¶

Register this review request action instance.

Note

Newly registered top-level actions are appended to the left of the other previously registered top-level actions. So if we intend to register a collection of top-level actions in a certain order, then we likely want to iterate through the actions in reverse.

Parameters:

parent (BaseReviewRequestMenuAction, optional) – The parent action instance of this action instance.

Raises:

• KeyError – A second registration is attempted (action IDs must be unique across all types of actions and menu actions, at any depth).

• DepthLimitExceededError – The maximum depth limit is exceeded.

unregister() → None[source]¶

Unregister this review request action instance.

This menu action recursively unregisters its child action instances.

Raises:

KeyError – An unregistration is attempted before it’s registered.

register_actions(actions: List[Union[BaseReviewRequestAction, BaseReviewRequestMenuAction]], parent_id: Optional[str] = None) → None[source]¶

Register the given actions as children of the corresponding parent.

If no parent_id is given, then the actions are assumed to be top-level.

Deprecated since version 6.0: Users should switch to reviewboard.actions.actions_registry. This method will be removed in Review Board 8.

Parameters:

• actions (iterable of BaseReviewRequestAction) – The collection of action instances to be registered.

• parent_id (unicode, optional) – The action ID of the parent of each action instance to be registered.

Raises:

• KeyError – The parent action cannot be found or a second registration is attempted (action IDs must be unique across all types of actions and menu actions, at any depth).

• DepthLimitExceededError – The maximum depth limit is exceeded.

unregister_actions(action_ids: Iterable[str]) → None[source]¶

Unregister each of the actions corresponding to the given IDs.

Deprecated since version 6.0: Users should switch to reviewboard.actions.actions_registry. This method will be removed in Review Board 8.

Parameters:

action_ids (iterable of unicode) – The collection of action IDs corresponding to the actions to be removed.

Raises:

KeyError – An unregistration is attempted before it’s registered.

clear_all_actions() → None[source]¶

Clear all registered actions.

This method is really only intended to be used by unit tests. We might be able to remove this hack once we convert to djblets.registries.

Deprecated since version 6.0: Users should switch to reviewboard.actions.actions_registry. This method will be removed in Review Board 8.

Warning

This will clear all actions, even if they were registered in separate extensions.