rbtools.commands.review¶

Implementation of rbt review.

Classes

class rbtools.commands.review.ReviewSubCommand(options, config, *args, **kwargs)[source]¶

Bases: BaseSubCommand

A subcommand for review actions.

needs_api = True[source]¶

Whether the command needs the API client.

If this is set, the initialization of the command will set api_client and api_root.

New in version 3.0.

Type:

bool

create_review_if_missing = True[source]¶

Whether to create the review if it does not exist.

Type:

bool

get_review_draft()[source]¶

Return the review draft, creating if desired.

Returrns:

rbtools.api.resource.ItemResource: The review draft resource.

class rbtools.commands.review.AddCommentSubCommand(options, config, *args, **kwargs)[source]¶

Bases: ReviewSubCommand

Base class for comment subcommands.

option_list = [<rbtools.commands.OptionGroup object>][source]¶

Command-line options for this command.

Type:

list of Option or OptionGroup

add_comment(text_type)[source]¶

Create the comment.

Parameters:

text_type (unicode) – The text type to use.

Raises:

rbtools.api.errors.APIError – An error occurred while performing API requests.

main()[source]¶

Run the command.

class rbtools.commands.review.AddDiffComment(options, config, *args, **kwargs)[source]¶

Bases: AddCommentSubCommand

Subcommand to add a diff comment to a draft review.

name = 'add-diff-comment'[source]¶

The name of the command.

Type:

unicode

help_text = 'Add a comment to a diff as part of a draft review.'[source]¶

The subcommand’s help text.

Type:

unicode

option_list = [<rbtools.commands.OptionGroup object>, <rbtools.commands.OptionGroup object>][source]¶

Command-line options for this command.

Type:

list of Option or OptionGroup

add_comment(text_type)[source]¶

Create the comment.

Parameters:

text_type (unicode) – The text type to use.

Raises:

• rbtools.api.errors.APIError – An error occurred while performing API requests.

• rbtools.commands.CommandError – Another error occurred while creating the comment.

class rbtools.commands.review.AddFileAttachmentComment(options, config, *args, **kwargs)[source]¶

Bases: AddCommentSubCommand

Subcommand to add a file attachment comment to a review draft.

name = 'add-file-attachment-comment'[source]¶

The name of the command.

Type:

unicode

help_text = 'Add a comment to a file attachment as part of a draft review.'[source]¶

The subcommand’s help text.

Type:

unicode

option_list = [<rbtools.commands.OptionGroup object>, <rbtools.commands.OptionGroup object>][source]¶

Command-line options for this command.

Type:

list of Option or OptionGroup

add_comment(text_type)[source]¶

Create the comment.

Parameters:

text_type (unicode) – The text type to use.

Raises:

rbtools.api.errors.APIError – An error occurred while performing API requests.

class rbtools.commands.review.AddGeneralComment(options, config, *args, **kwargs)[source]¶

Bases: AddCommentSubCommand

Subcommand to add a general comment to a review draft.

name = 'add-general-comment'[source]¶

The name of the command.

Type:

unicode

help_text = 'Add a general comment as part of a draft review.'[source]¶

The subcommand’s help text.

Type:

unicode

add_comment(text_type)[source]¶

Create the comment.

Parameters:

text_type (unicode) – The text type to use.

Raises:

rbtools.api.errors.APIError – An error occurred while performing API requests.

class rbtools.commands.review.Discard(options, config, *args, **kwargs)[source]¶

Bases: ReviewSubCommand

Subcommand to discard a draft review.

name = 'discard'[source]¶

The name of the command.

Type:

unicode

help_text = 'Discard a draft review.'[source]¶

The subcommand’s help text.

Type:

unicode

create_review_if_missing = False[source]¶

Whether to create the review if it does not exist.

Type:

bool

main()[source]¶

Run the review discard command.

class rbtools.commands.review.Edit(options, config, *args, **kwargs)[source]¶

Bases: ReviewSubCommand

Subcommand to create or edit draft reviews.

name = 'edit'[source]¶

The name of the command.

Type:

unicode

help_text = 'Create or edit a draft review.'[source]¶

The subcommand’s help text.

Type:

unicode

option_list = [<rbtools.commands.OptionGroup object>][source]¶

Command-line options for this command.

Type:

list of Option or OptionGroup

main()[source]¶

Run the review edit command.

class rbtools.commands.review.Publish(options, config, *args, **kwargs)[source]¶

Bases: ReviewSubCommand

Subcommand for publishing a review draft.

name = 'publish'[source]¶

The name of the command.

Type:

unicode

help_text = 'Publish a draft review.'[source]¶

The subcommand’s help text.

Type:

unicode

create_review_if_missing = False[source]¶

Whether to create the review if it does not exist.

Type:

bool

main()[source]¶

Run the review publish command.

class rbtools.commands.review.Review(transport_cls=<class 'rbtools.api.transport.sync.SyncTransport'>, stdout=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='utf-8'>, stderr=<_io.TextIOWrapper name='<stderr>' mode='w' encoding='utf-8'>, stdin=<_io.TextIOWrapper name='<stdin>' mode='r' encoding='utf-8'>)[source]¶

Bases: BaseMultiCommand

RBTools command to create and publish reviews.

name = 'review'[source]¶

The name of the command.

Type:

unicode

author = 'The Review Board Project'[source]¶

The author of the command.

Type:

unicode

description = 'Creates, updates, and edits reviews.'[source]¶

A short description of the command, suitable for display in usage text.

Type:

unicode

subcommands = [<class 'rbtools.commands.review.Edit'>, <class 'rbtools.commands.review.Publish'>, <class 'rbtools.commands.review.AddDiffComment'>, <class 'rbtools.commands.review.AddGeneralComment'>, <class 'rbtools.commands.review.AddFileAttachmentComment'>, <class 'rbtools.commands.review.Discard'>][source]¶

The available subcommands.

This is a list of BaseSubCommand sub classes.

Type:

list

common_subcommand_option_list = [<rbtools.commands.OptionGroup object>, <rbtools.commands.OptionGroup object>][source]¶

Options common to all subcommands.

Type:

list