reviewboard.reviews.models¶

class BaseComment(*args, **kwargs)¶

Bases: Model

The base class for all comment types.

OPEN = 'O'¶

RESOLVED = 'R'¶

DROPPED = 'D'¶

VERIFYING_RESOLVED = 'A'¶

VERIFYING_DROPPED = 'B'¶

ISSUE_STATUSES = (('O', 'Open'), ('R', 'Resolved'), ('D', 'Dropped'), ('A', 'Waiting for verification to resolve'), ('B', 'Waiting for verification to drop'))¶

ISSUE_STATUS_TO_STRING = {'A': 'verifying-resolved', 'B': 'verifying-dropped', 'D': 'dropped', 'O': 'open', 'R': 'resolved'}¶

ISSUE_STRING_TO_STATUS = {'dropped': 'D', 'open': 'O', 'resolved': 'R', 'verifying-dropped': 'B', 'verifying-resolved': 'A'}¶

issue_opened¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

issue_status¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

reply_to¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

timestamp¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

text¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

rich_text¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

extra_data¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

objects¶

static issue_status_to_string(status)¶

Return a string representation of the status field.

Parameters:

status (unicode) – The value of the issue_status field.

Returns:

A string representation of the status used for the API and other interfaces.

Return type:

unicode

static issue_string_to_status(status)¶

Return a DB representation of the given status string.

Parameters:

status (unicode) – The status string to convert.

Returns:

A value suitable for storing in the issue_status field.

Return type:

unicode

property require_verification¶

Whether this comment requires verification before closing.

__init__(*args, **kwargs)¶

Initialize the comment.

Parameters:

• *args (tuple) – Positional arguments to pass through to the model initialization.

• **kwargs (dict) – Keyword arguments to pass through to the model initialization.

get_review_request()¶

Return this comment’s review request.

Returns:

The review request that this comment was made on.

Return type:

reviewboard.reviews.models.review_request.ReviewRequest

get_review()¶

Return this comment’s review.

Returns:

The review containing this comment.

Return type:

reviewboard.reviews.models.review.Review

get_review_url()¶

Return the URL to view this comment.

Returns:

The absolute URL to view this comment in the web UI.

Return type:

unicode

is_reply()¶

Return whether this comment is a reply to another comment.

Returns:

True if the comment is a reply.

Return type:

bool

is_accessible_by(user)¶

Return whether the user can access this comment.

Parameters:

user (django.contrib.auth.models.User) – The user being checked.

Returns:

True if the given user can access this comment.

Return type:

bool

is_mutable_by(user)¶

Return whether the user can modify this comment.

Parameters:

user (django.contrib.auth.models.User) – The user being checked.

Returns:

True if the given user can modify this comment.

Return type:

bool

public_replies(user=None)¶

Return the public replies to this comment.

Parameters:

user (django.contrib.auth.models.User, optional) – A user to filter by, if desired. If specified, only replies authored by this user will be returned.

Returns:

The public replies to this comment.

Return type:

list of reviewboard.reviews.models.base_comment.BaseComment

can_change_issue_status(user)¶

Return whether the user can change the issue status.

Currently, this is allowed for: - The user who owns the review request. - The user who opened the issue (posted the comment).

Parameters:

user (django.contrib.auth.models.User) – The user being checked.

Returns:

True if the given user is allowed to change the issue status.

Return type:

bool

can_verify_issue_status(user)¶

Return whether the user can verify the issue status.

Currently this is allowed for:

• The user who opened the issue.

• Administrators.

Parameters:

user (django.contrib.auth.models.User) – The user being checked.

Returns:

True if the given user is allowed to verify the issue status.

Return type:

bool

save(**kwargs)¶

Save the comment.

Parameters:

**kwargs (dict) – Keyword arguments passed to the method (unused).

__str__()¶

Return a string representation of the comment.

Returns:

A string representation of the comment.

Return type:

unicode

class Meta¶

Bases: object

abstract = False¶

app_label = 'reviews'¶

ordering = ['timestamp']¶

__annotations__ = {}¶

get_extra_data_json()¶

get_issue_status_display(*, field=<django.db.models.fields.CharField: issue_status>)¶

get_next_by_timestamp(*, field=<django.db.models.fields.DateTimeField: timestamp>, is_next=True, **kwargs)¶

get_previous_by_timestamp(*, field=<django.db.models.fields.DateTimeField: timestamp>, is_next=False, **kwargs)¶

reply_to_id¶

set_extra_data_json(json)¶

class Comment(*args, **kwargs)¶

Bases: BaseComment

A comment made on a diff.

A comment can belong to a single filediff or to an interdiff between two filediffs. It can also have multiple replies.

anchor_prefix = 'comment'¶

comment_type = 'diff'¶

filediff¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

interfilediff¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

first_line¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

num_lines¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

property last_line¶

property base_filediff_id¶

The base FileDiff ID for the cumulative diff this comment is on.

get_absolute_url()¶

diff_is_public() → bool¶

Return whether the diff(s) being commented on are public.

Returns:

True if the diff (and interdiff, if applicable) is public.

Return type:

bool

__annotations__ = {}¶

filediff_id¶

get_extra_data_json()¶

get_issue_status_display(*, field=<django.db.models.fields.CharField: issue_status>)¶

get_next_by_timestamp(*, field=<django.db.models.fields.DateTimeField: timestamp>, is_next=True, **kwargs)¶

get_previous_by_timestamp(*, field=<django.db.models.fields.DateTimeField: timestamp>, is_next=False, **kwargs)¶

id¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

interfilediff_id¶

replies¶

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

reply_to¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

review¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

set_extra_data_json(json)¶

class DefaultReviewer(*args, **kwargs)¶

Bases: Model

Represents reviewers automatically added to review requests.

A default reviewer entry automatically adds default reviewers to a review request when the diff modifies a file matching the file_regex pattern specified.

This is useful when different groups own different parts of a codebase. Adding DefaultReviewer entries ensures that the right people will always see the review request and discussions.

A file_regex of ".*" will add the specified reviewers by default for every review request.

Note that this is keyed off the same LocalSite as its “repository” member.

name¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

file_regex¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

repository¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

groups¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

people¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

local_site¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

objects = <reviewboard.reviews.managers.DefaultReviewerManager object>¶

is_accessible_by(user)¶

Returns whether the user can access this default reviewer.

is_mutable_by(user)¶

Returns whether the user can modify or delete this default reviewer.

Only those with the default_reviewer.change_group permission (such as administrators) can modify or delete default reviewers not bound to a LocalSite.

LocalSite administrators can modify or delete them on their LocalSites.

__str__()¶

Return str(self).

__annotations__ = {}¶

id¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

local_site_id¶

class FileAttachmentComment(*args, **kwargs)¶

Bases: BaseComment

A comment on a file attachment.

anchor_prefix = 'fcomment'¶

comment_type = 'file'¶

file_attachment¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

diff_against_file_attachment¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

review_ui¶

Return a ReviewUI appropriate for this comment.

If a ReviewUI is available for this type of file, an instance of one will be returned that’s associated with this comment’s FileAttachment and the one being diffed against (if any).

property thumbnail¶

Returns the thumbnail for this comment, if any, as HTML.

The thumbnail will be generated from the appropriate ReviewUI, if there is one for this type of file.

get_absolute_url()¶

Returns the URL for this comment.

get_link_text()¶

Returns the text for the link to the file.

attachment_is_public() → bool¶

Return whether the attachment(s) being commented on are public.

Returns:

True if the file attachment (and diff against file attachment, if applicable) is public.

Return type:

bool

__annotations__ = {}¶

diff_against_file_attachment_id¶

file_attachment_id¶

get_extra_data_json()¶

get_issue_status_display(*, field=<django.db.models.fields.CharField: issue_status>)¶

get_next_by_timestamp(*, field=<django.db.models.fields.DateTimeField: timestamp>, is_next=True, **kwargs)¶

get_previous_by_timestamp(*, field=<django.db.models.fields.DateTimeField: timestamp>, is_next=False, **kwargs)¶

id¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

replies¶

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

reply_to¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

review¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

set_extra_data_json(json)¶

class GeneralComment(*args, **kwargs)¶

Bases: BaseComment

A comment on a review request that is not tied to any code or file.

A general comment on a review request is used when a comment is not tied to specific lines of code or a special file attachment, and an issue is opened. Examples include suggestions for testing or pointing out errors in the change description.

anchor_prefix = 'gcomment'¶

comment_type = 'general'¶

get_absolute_url()¶

__annotations__ = {}¶

get_extra_data_json()¶

get_issue_status_display(*, field=<django.db.models.fields.CharField: issue_status>)¶

get_next_by_timestamp(*, field=<django.db.models.fields.DateTimeField: timestamp>, is_next=True, **kwargs)¶

get_previous_by_timestamp(*, field=<django.db.models.fields.DateTimeField: timestamp>, is_next=False, **kwargs)¶

id¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

replies¶

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

reply_to¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

review¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

set_extra_data_json(json)¶

class Group(*args, **kwargs)¶

Bases: Model

A group of people who can be targeted for review.

This is usually used to separate teams at a company or components of a project.

Each group can have an e-mail address associated with it, sending all review requests and replies to that address. If that e-mail address is blank, e-mails are sent individually to each member of that group.

name¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

display_name¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

mailing_list¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

email_list_only¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

users¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

local_site¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

is_default_group¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

incoming_request_count = <djblets.db.fields.counter_field.CounterField: incoming_request_count>¶

invite_only¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

visible¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

extra_data¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

objects = <reviewboard.reviews.managers.ReviewGroupManager object>¶

is_accessible_by(user, request=None, silent=False)¶

Returns true if the user can access this group.

is_mutable_by(user)¶

Returns whether or not the user can modify or delete the group.

The group is mutable by the user if they are an administrator with proper permissions, or the group is part of a LocalSite and the user is in the admin list.

__str__()¶

Return str(self).

get_absolute_url()¶

clean()¶

Clean method for checking null unique_together constraints.

Django has a bug where unique_together constraints for foreign keys aren’t checked properly if one of the relations is null. This means that users who aren’t using local sites could create multiple groups with the same name.

__annotations__ = {}¶

decrement_incoming_request_count(*args, **kwargs)¶

defaultreviewer_set¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

drafts¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

get_extra_data_json()¶

id¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

increment_incoming_request_count(*args, **kwargs)¶

local_site_id¶

reinit_incoming_request_count()¶

reload_incoming_request_count()¶

repositories¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

review_requests¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

set_extra_data_json(json)¶

starred_by¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

class Review(*args, **kwargs)¶

Bases: Model

A review of a review request.

SHIP_IT_TEXT = 'Ship It!'¶

REVOKED_SHIP_IT_TEXT = '~~Ship It!~~'¶

FIX_IT_THEN_SHIP_IT_TEXT = 'Fix it, then Ship it!'¶

review_request¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

user¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

timestamp¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

public¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

ship_it¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

base_reply_to¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

email_message_id¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

time_emailed¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

body_top¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

body_top_rich_text¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

body_bottom¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

body_bottom_rich_text¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

body_top_reply_to¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

body_bottom_reply_to¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

comments¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

screenshot_comments¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

file_attachment_comments¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

general_comments¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

extra_data¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

rich_text¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

reviewed_diffset¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

objects = <reviewboard.reviews.managers.ReviewManager object>¶

ship_it_only¶

Return if the review only contains a “Ship It!”.

Returns:

True if the review is only a “Ship It!” and False otherwise.

Return type:

bool

can_user_revoke_ship_it(user)¶

Return whether a given user can revoke a Ship It.

Parameters:

user (django.contrib.auth.models.User) – The user to check permissions for.

Returns:

True if the user has permissions to revoke a Ship It. False if they don’t.

Return type:

bool

revoke_ship_it(user)¶

Revoke the Ship It status on this review.

The Ship It status will be removed, and the ReviewRequest.shipit_count counter will be decremented.

If the body_top text is equal to SHIP_IT_TEXT, then it will replaced with REVOKED_SHIP_IT_TEXT.

Callers are responsible for checking whether the user has permission to revoke Ship Its by using can_user_revoke_ship_it().

Raises:

reviewboard.reviews.errors.RevokeShipItError – The Ship It could not be revoked. Details will be in the error message.

all_participants¶

Return all participants in the review’s discussion.

This will always contain the user who filed the review, plus every user who has published a reply to the review.

The result is cached. Repeated calls will return the same result.

Returns:

The users who participated in the discussion.

Return type:

set of django.contrib.auth.models.User

is_accessible_by(user)¶

Returns whether the user can access this review.

is_mutable_by(user)¶

Returns whether the user can modify this review.

__str__()¶

Return str(self).

is_reply()¶

Returns whether or not this review is a reply to another review.

is_new_for_user(user, last_visited)¶

Return whether this review is new for a user.

The review is considered new if their last visited time is older than the review’s published timestamp and the user is not the one who created the review.

Parameters:

• user (django.contrib.auth.models.User) – The user accessing the review.

• last_visited (datetime.datetime) – The last time the user accessed a page where the review would be shown.

Returns:

True if the review is new to this user. False if it’s older than the last visited time or the user created it.

Return type:

bool

public_replies()¶

Returns a list of public replies to this review.

public_body_top_replies(user=None)¶

Returns a list of public replies to this review’s body top.

public_body_bottom_replies(user=None)¶

Returns a list of public replies to this review’s body bottom.

get_pending_reply(user)¶

Return the pending reply owned by the specified user.

Parameters:

user (django.contrib.auth.models.User) – The user to find the reply for.

Returns:

The pending reply object, if present. None if there is no pending reply.

Return type:

reviewboard.reviews.models.review.Review

save(**kwargs)¶

Save the current instance. Override this in a subclass if you want to control the saving process.

The ‘force_insert’ and ‘force_update’ parameters can be used to insist that the “save” must be an SQL insert or update (or equivalent for non-SQL backends), respectively. Normally, they should not be set.

can_publish(review_request_will_publish: bool = False) → Tuple[bool, Optional[str]]¶

Check if this review can be published.

Parameters:

review_request_will_publish (bool, optional) – Whether the review request is also being published.

Returns:

A two-tuple describing whether the review can be published, and if not, why not.

Tuple:

• 1 (bool) – Whether the review can be published.

• 2 (str) – An error message describing why the review cannot be published.

Return type:

tuple

publish(user: Optional[User] = None, trivial: bool = False, to_owner_only: bool = False, request: Optional[HttpRequest] = None, review_request_will_publish: bool = False, *args, **kwargs) → None¶

Publish this review.

This will make the review public and update the timestamps of all contained comments.

Parameters:

• user (django.contrib.auth.models.User, optional) – The user publishing the review.

• trivial (bool, optional) – Whether to skip any e-mail notifications.

• to_owner_only (bool, optional) – Whether to address notifications only to the owner of the review request.

• request (djang.http.HttpRequest, optional) – The HTTP request.

• review_request_will_publish (bool, optional) –

  Whether the review request is also being published.

  New in version 6.0.

• *args (tuple) – Positional arguments for future expansion.

• **kwargs (dict) – Keyword arguments for future expansion.

delete()¶

Deletes this review.

This will enforce that all contained comments are also deleted.

get_absolute_url()¶

get_all_comments(**kwargs)¶

Return a list of all contained comments of all types.

has_comments(only_issues=False)¶

Return whether the review contains any comments/issues.

Parameters:

only_issues (bool, optional) – Whether or not to check for comments where issue_opened is True. True to check for issues, or False to check for comments only. Defaults to False.

Returns:

True if the review contains any comments/issues and False otherwise.

Return type:

bool

__annotations__ = {}¶

base_reply_to_id¶

body_bottom_replies¶

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

body_bottom_reply_to_id¶

body_top_replies¶

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

body_top_reply_to_id¶

get_extra_data_json()¶

get_next_by_timestamp(*, field=<django.db.models.fields.DateTimeField: timestamp>, is_next=True, **kwargs)¶

get_previous_by_timestamp(*, field=<django.db.models.fields.DateTimeField: timestamp>, is_next=False, **kwargs)¶

id¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

replies¶

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

review_request_id¶

reviewed_diffset_id¶

set_extra_data_json(json)¶

status_update¶

Accessor to the related object on the reverse side of a one-to-one relation.

In the example:

class Restaurant(Model):
    place = OneToOneField(Place, related_name='restaurant')

Place.restaurant is a ReverseOneToOneDescriptor instance.

user_id¶

class ReviewRequest(*args, **kwargs)¶

Bases: BaseReviewRequestDetails

A review request.

This is one of the primary models in Review Board. Most everything is associated with a review request.

The ReviewRequest model contains detailed information on a review request. Some fields are user-modifiable, while some are used for internal state.

PENDING_REVIEW = 'P'¶

SUBMITTED = 'S'¶

DISCARDED = 'D'¶

STATUSES = (('P', 'Pending Review'), ('S', 'Submitted'), ('D', 'Discarded'))¶

ISSUE_COUNTER_FIELDS = {'A': 'issue_verifying_count', 'B': 'issue_verifying_count', 'D': 'issue_dropped_count', 'O': 'issue_open_count', 'R': 'issue_resolved_count'}¶

summary¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

submitter¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

time_added¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

last_updated¶

A descriptor for tracking the modification of a value.

field_name¶

The attribute name of the field on the model.

Type:

unicode

state_name¶

The attribute name of the state on the model.

Type:

unicode

status¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

public¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

changenum¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

repository¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

email_message_id¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

time_emailed¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

diffset_history¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

target_groups¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

target_people¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

screenshots¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

inactive_screenshots¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

file_attachments¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

inactive_file_attachments¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

file_attachment_histories¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

changedescs¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

depends_on¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

last_review_activity_timestamp¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

shipit_count = <djblets.db.fields.counter_field.CounterField: shipit_count>¶

issue_open_count = <djblets.db.fields.counter_field.CounterField: issue_open_count>¶

issue_resolved_count = <djblets.db.fields.counter_field.CounterField: issue_resolved_count>¶

issue_dropped_count = <djblets.db.fields.counter_field.CounterField: issue_dropped_count>¶

issue_verifying_count = <djblets.db.fields.counter_field.CounterField: issue_verifying_count>¶

screenshots_count = <djblets.db.fields.relation_counter_field.RelationCounterField: screenshots_count>¶

inactive_screenshots_count = <djblets.db.fields.relation_counter_field.RelationCounterField: inactive_screenshots_count>¶

file_attachments_count = <djblets.db.fields.relation_counter_field.RelationCounterField: file_attachments_count>¶

inactive_file_attachments_count = <djblets.db.fields.relation_counter_field.RelationCounterField: inactive_file_attachments_count>¶

local_site¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

local_id¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

objects = <reviewboard.reviews.managers.ReviewRequestManager object>¶

static status_to_string(status)¶

Return a string representation of a review request status.

Parameters:

status (unicode) – A single-character string representing the status.

Returns:

A longer string representation of the status suitable for use in the API.

Return type:

unicode

static string_to_status(status)¶

Return a review request status from an API string.

Parameters:

status (unicode) – A string from the API representing the status.

Returns:

A single-character string representing the status, suitable for storage in the status field.

Return type:

unicode

get_commit()¶

set_commit(commit_id)¶

property commit¶

property approved¶

Returns whether or not a review request is approved by reviewers.

On a default installation, a review request is approved if it has at least one Ship It!, and doesn’t have any open issues.

Extensions may customize approval by providing their own ReviewRequestApprovalHook.

property approval_failure¶

Returns the error indicating why a review request isn’t approved.

If approved is False, this will provide the text describing why it wasn’t approved.

Extensions may customize approval by providing their own ReviewRequestApprovalHook.

property owner¶

The owner of a review request.

This is an alias for submitter. It provides compatibility with ReviewRequestDraft.owner, for functions working with either method, and for review request fields, but it cannot be used for queries.

property created_with_history¶

Whether or not this review request was created with commit support.

This property can only be changed before the review request is created (i.e., before save() is called and it has a primary key assigned).

property review_participants¶

Return the participants in reviews on the review request.

This will contain the users who published any reviews or replies on the review request. The list will be in username sort order and will not contain duplicates.

This will only contain the owner of the review request if they’ve filed a review or reply.

Returns:

The users who filed reviews or replies.

Return type:

set of django.contrib.auth.models.User

get_new_reviews(user)¶

Returns all new reviews since last viewing this review request.

This will factor in the time the user last visited the review request, and find any reviews that have been added or updated since.

get_display_id()¶

Returns the ID that should be exposed to the user.

property display_id¶

Returns the ID that should be exposed to the user.

get_public_reviews()¶

Returns all public top-level reviews for this review request.

is_accessible_by(user, local_site=None, request=None, silent=False)¶

Returns whether or not the user can read this review request.

This performs several checks to ensure that the user has access. This user has access if:

• The review request is public or the user can modify it (either by being an owner or having special permissions).

• The repository is public or the user has access to it (either by being explicitly on the allowed users list, or by being a member of a review group on that list).

• The user is listed as a requested reviewer or the user has access to one or more groups listed as requested reviewers (either by being a member of an invite-only group, or the group being public).

is_mutable_by(user)¶

Return whether the user can modify this review request.

Parameters:

user (django.contrib.auth.models.User) – The user to check.

Returns:

Whether the user can modify this review request.

Return type:

bool

is_status_mutable_by(user)¶

Return whether the user can modify this review request’s status.

Parameters:

user (django.contrib.auth.models.User) – The user to check.

Returns:

Whether the user can modify this review request’s status.

Return type:

bool

is_deletable_by(user)¶

Return whether the user can delete this review request.

Parameters:

user (django.contrib.auth.models.User) – The user to check.

Returns:

Whether the user can delete this review request.

Return type:

bool

get_draft(user: Optional[User] = None) → Optional[ReviewRequestDraft]¶

Returns the draft of the review request.

If a user is specified, then the draft will be returned only if owned by the user. Otherwise, None will be returned.

Parameters:

user (django.contrib.auth.models.User) – The user who must own the draft.

Returns:

The draft of the review request or None.

Return type:

reviewboard.reviews.models.review_request_draft.ReviewRequestDraft

get_pending_review(user)¶

Returns the pending review owned by the specified user, if any.

This will return an actual review, not a reply to a review.

get_last_activity_info(diffsets=None, reviews=None)¶

Return the last public activity information on the review request.

Parameters:

• diffsets (list of reviewboard.diffviewer.models.DiffSet, optional) –

  The list of diffsets to compare for latest activity.

  If not provided, this will be populated with the last diffset.

• reviews (list of reviewboard.reviews.models.Review, optional) –

  The list of reviews to compare for latest activity.

  If not provided, this will be populated with the latest review.

Returns:

A dictionary with the following keys:

timestamp:

The datetime that the object was updated.

updated_object:

The object that was updated. This will be one of the following:

• The ReviewRequest itself.

• A Review.

• A DiffSet.

changedesc:

The latest ChangeDescription, if any.

Return type:

dict

changeset_is_pending(commit_id)¶

Returns whether the associated changeset is pending commit.

For repositories that support it, this will return whether the associated changeset is pending commit. This requires server-side knowledge of the change.

get_absolute_url()¶

get_diffsets()¶

Returns a list of all diffsets on this review request.

This will also fetch all associated FileDiffs, as well as a count of the number of files (stored in DiffSet.file_count).

get_latest_diffset()¶

Returns the latest diffset for this review request.

property has_diffsets: bool¶

Whether this review request has any diffsets.

Type:

bool

get_close_info() → ReviewRequestCloseInfo¶

Return metadata of the most recent closing of a review request.

This is a helper which is used to gather the data which is rendered in the close description boxes on various pages.

Returns:

The close information.

Return type:

ReviewRequestCloseInfo

get_blocks()¶

Returns the list of review request this one blocks.

The returned value will be cached for future lookups.

get_file_attachments_data(*, active_attachments: Optional[FileAttachmentSequence] = None, inactive_attachments: Optional[FileAttachmentSequence] = None, draft_active_attachments: Optional[FileAttachmentSequence] = None, draft_inactive_attachments: Optional[FileAttachmentSequence] = None) → ReviewRequestFileAttachmentsData¶

Return data about a review request and its draft’s file attachments.

This returns sets of the active and inactive file attachment IDs that are attached to the review request or its draft. This data is used in get_file_attachment_state().

The active and inactive file attachments on the review request and its draft may be passed in to avoid fetching them again if they’ve already been fetched elsewhere.

The returned data will be cached for future lookups.

New in version 6.0.

Parameters:

• active_attachments (list of FileAttachment, optional) – The list of active file attachments on the review request.

• inactive_attachments (list of FileAttachment, optional) – The list of inactive file attachments on the review request.

• draft_active_attachments (list of FileAttachment, optional) – The list of active file attachments on the review request draft.

• draft_inactive_attachments (list of FileAttachment, optional) – The list of inactive file attachments on the review request draft.

Returns:

The data about the file attachments on a review request and its draft.

Return type:

ReviewRequestFileAttachmentsData

get_file_attachment_state(file_attachment: FileAttachment) → FileAttachmentState¶

Get the state of a file attachment attached to this review request.

New in version 6.0.

Parameters:

file_attachment (reviewboard.attachments.models.FileAttachment) – The file attachment whose state will be returned.

Returns:

The file attachment state.

Return type:

FileAttachmentState

save(update_counts=False, old_submitter=None, **kwargs)¶

Save the current instance. Override this in a subclass if you want to control the saving process.

The ‘force_insert’ and ‘force_update’ parameters can be used to insist that the “save” must be an SQL insert or update (or equivalent for non-SQL backends), respectively. Normally, they should not be set.

delete(**kwargs)¶

can_publish()¶

can_add_default_reviewers()¶

Return whether default reviewers can be added to the review request.

Default reviewers can only be added if the review request supports repositories and doesn’t yet have any published diffs.

Returns:

True if new default reviewers can be added. False if they cannot.

Return type:

bool

close(close_type: str, user: Optional[User] = None, description: Optional[str] = None, rich_text: bool = False, **kwargs) → None¶

Close the review request.

Changed in version 6.0: The type argument has been completely removed.

Changed in version 3.0: The type argument is deprecated: close_type should be used instead.

This method raises ValueError instead of AttributeError when the close_type has an incorrect value.

Parameters:

• close_type (str) – How the close occurs. This should be one of SUBMITTED or DISCARDED.

• user (django.contrib.auth.models.User, optional) – The user who is closing the review request.

• description (str, optional) – An optional description that indicates why the review request was closed.

• rich_text (bool, optional) – Indicates whether or not that the description is rich text.

• **kwargs (dict, unused) – Additional keyword arguments, for future expansion.

Raises:

• ValueError – The provided close type is not a valid value.

• reviewboard.reviews.errors.PermissionError – The user does not have permission to close the review request.

• reviewboard.reviews.errors.PublishError – An attempt was made to close an un-published review request as submitted.

reopen(user=None)¶

Reopens the review request for review.

publish(user: User, trivial: bool = False, validate_fields: bool = True) → Optional[ChangeDescription]¶

Publish the current draft attached to this review request.

The review request will be mark as public, and signals will be emitted for any listeners.

Changed in version 6.0: Added the change description as a return type.

Parameters:

• user (django.contrib.auth.models.User) – The user performing the publish operation.

• trivial (bool, optional) – Whether to skip any e-mail notifications.

• validate_fields (bool, optional) – Whether to validate fields before publishing.

Returns:

The change description, if this was an update to an already-public review request. If this is an initial publish, this will return None.

Return type:

reviewboard.changedescs.models.ChangeDescription

Raises:

reviewboard.reviews.errors.PublishError – An error occurred while publishing.

determine_user_for_changedesc(changedesc)¶

Determine the user associated with the change description.

Parameters:

changedesc (reviewboard.changedescs.models.ChangeDescription) – The change description.

Returns:

The user associated with the change description.

Return type:

django.contrib.auth.models.User

get_review_request()¶

Returns this review request.

This is provided so that consumers can be passed either a ReviewRequest or a ReviewRequestDraft and retrieve the actual ReviewRequest regardless of the object.

__annotations__ = {}¶

blocks¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

decrement_file_attachments_count(*args, **kwargs)¶

decrement_inactive_file_attachments_count(*args, **kwargs)¶

decrement_inactive_screenshots_count(*args, **kwargs)¶

decrement_issue_dropped_count(*args, **kwargs)¶

decrement_issue_open_count(*args, **kwargs)¶

decrement_issue_resolved_count(*args, **kwargs)¶

decrement_issue_verifying_count(*args, **kwargs)¶

decrement_screenshots_count(*args, **kwargs)¶

decrement_shipit_count(*args, **kwargs)¶

diffset_history_id¶

draft¶

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

draft_blocks¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

get_extra_data_json()¶

get_next_by_last_updated(*, field=<djblets.db.fields.modification_timestamp_field.ModificationTimestampField: last_updated>, is_next=True, **kwargs)¶

get_next_by_time_added(*, field=<django.db.models.fields.DateTimeField: time_added>, is_next=True, **kwargs)¶

get_previous_by_last_updated(*, field=<djblets.db.fields.modification_timestamp_field.ModificationTimestampField: last_updated>, is_next=False, **kwargs)¶

get_previous_by_time_added(*, field=<django.db.models.fields.DateTimeField: time_added>, is_next=False, **kwargs)¶

get_status_display(*, field=<django.db.models.fields.CharField: status>)¶

id¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

increment_file_attachments_count(*args, **kwargs)¶

increment_inactive_file_attachments_count(*args, **kwargs)¶

increment_inactive_screenshots_count(*args, **kwargs)¶

increment_issue_dropped_count(*args, **kwargs)¶

increment_issue_open_count(*args, **kwargs)¶

increment_issue_resolved_count(*args, **kwargs)¶

increment_issue_verifying_count(*args, **kwargs)¶

increment_screenshots_count(*args, **kwargs)¶

increment_shipit_count(*args, **kwargs)¶

local_site_id¶

reinit_file_attachments_count()¶

reinit_inactive_file_attachments_count()¶

reinit_inactive_screenshots_count()¶

reinit_issue_dropped_count()¶

reinit_issue_open_count()¶

reinit_issue_resolved_count()¶

reinit_issue_verifying_count()¶

reinit_screenshots_count()¶

reinit_shipit_count()¶

reload_file_attachments_count()¶

reload_inactive_file_attachments_count()¶

reload_inactive_screenshots_count()¶

reload_issue_dropped_count()¶

reload_issue_open_count()¶

reload_issue_resolved_count()¶

reload_issue_verifying_count()¶

reload_screenshots_count()¶

reload_shipit_count()¶

repository_id¶

reviews¶

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

set_extra_data_json(json)¶

starred_by¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

status_updates¶

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

submitter_id¶

trophies¶

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

visits¶

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

class ReviewRequestDraft(*args, **kwargs)¶

Bases: BaseReviewRequestDetails

A draft of a review request.

When a review request is being modified, a special draft copy of it is created containing all the details of the review request. This copy can be modified and eventually saved or discarded. When saved, the new details are copied back over to the originating ReviewRequest.

summary¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

owner¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

review_request¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

last_updated¶

A descriptor for tracking the modification of a value.

field_name¶

The attribute name of the field on the model.

Type:

unicode

state_name¶

The attribute name of the state on the model.

Type:

unicode

diffset¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

changedesc¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

target_groups¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

target_people¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

screenshots¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

inactive_screenshots¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

file_attachments¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

inactive_file_attachments¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

property submitter¶

property repository¶

property local_site¶

depends_on¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

screenshots_count = <djblets.db.fields.relation_counter_field.RelationCounterField: screenshots_count>¶

inactive_screenshots_count = <djblets.db.fields.relation_counter_field.RelationCounterField: inactive_screenshots_count>¶

file_attachments_count = <djblets.db.fields.relation_counter_field.RelationCounterField: file_attachments_count>¶

inactive_file_attachments_count = <djblets.db.fields.relation_counter_field.RelationCounterField: inactive_file_attachments_count>¶

objects = <djblets.db.managers.ConcurrencyManager object>¶

property commit¶

get_latest_diffset()¶

Returns the diffset for this draft.

is_accessible_by(user)¶

Returns whether or not the user can access this draft.

is_mutable_by(user)¶

Returns whether or not the user can modify this draft.

get_file_attachments_data(*, active_attachments: Optional[FileAttachmentSequence] = None, inactive_attachments: Optional[FileAttachmentSequence] = None, draft_active_attachments: Optional[FileAttachmentSequence] = None, draft_inactive_attachments: Optional[FileAttachmentSequence] = None, **kwargs) → ReviewRequestFileAttachmentsData¶

Return data about a review request and its draft’s file attachments.

This returns sets of the active and inactive file attachment IDs that are attached to the review request or its draft. This data is used in ReviewRequest.get_file_attachment_state().

The active and inactive file attachments on the review request and its draft may be passed in to avoid fetching them again if they’ve already been fetched elsewhere.

The returned data will be cached for future lookups.

New in version 6.0.

Parameters:

• active_attachments (list, optional) – The list of active file attachments on the review request.

• inactive_attachments (list, optional) – The list of inactive file attachments on the review request.

• draft_active_attachments (list, optional) – The list of active file attachments on the review request draft.

• draft_inactive_attachments (list, optional) – The list of inactive file attachments on the review request draft.

Returns:

The data about the file attachments on a review request and its draft.

Return type:

ReviewRequestFileAttachmentsData

get_file_attachment_state(file_attachment: FileAttachment) → FileAttachmentState¶

Get the state of a file attachment attached to this review request.

New in version 6.0.

Parameters:

file_attachment (reviewboard.attachments.models.FileAttachment) – The file attachment whose state will be returned.

Returns:

The file attachment state.

Return type:

FileAttachmentState

static create(review_request, changedesc=None)¶

Create a draft based on a review request.

This will copy over all the details of the review request that we care about. If a draft already exists for the review request, the draft will be returned.

Parameters:

• review_request (reviewboard.reviews.models.review_request.ReviewRequest) – The review request to fetch or create the draft from.

• changedesc (reviewboard.changedescs.models.ChangeDescription) – A custom change description to set on the draft. This will always be set, overriding any previous one if already set.

Returns:

The resulting draft.

Return type:

ReviewRequestDraft

publish(review_request: Optional[ReviewRequest] = None, user: Optional[User] = None, trivial: bool = False, send_notification: bool = True, validate_fields: bool = True, timestamp: Optional[datetime] = None) → ChangeDescription¶

Publish this draft.

This is an internal method. Programmatic publishes should use reviewboard.reviews.models.review_request.ReviewRequest.publish() instead.

This updates and returns the draft’s ChangeDescription, which contains the changed fields. This is used by the e-mail template to tell people what’s new and interesting.

The keys that may be saved in fields_changed in the ChangeDescription are:

• submitter

• summary

• description

• testing_done

• bugs_closed

• depends_on

• branch

• target_groups

• target_people

• screenshots

• screenshot_captions

• diff

• Any custom field IDs

Each field in ‘fields_changed’ represents a changed field. This will save fields in the standard formats as defined by the ‘ChangeDescription’ documentation, with the exception of the ‘screenshot_captions’ and ‘diff’ fields.

For the ‘screenshot_captions’ field, the value will be a dictionary of screenshot ID/dict pairs with the following fields:

• old: The old value of the field

• new: The new value of the field

For the diff field, there is only ever an added field, containing the ID of the new diffset.

Parameters:

• review_request (reviewboard.reviews.models.review_request.ReviewRequest, optional) – The review request associated with this diff. If not provided, it will be looked up.

• user (django.contrib.auth.models.User, optional) – The user publishing the draft. If not provided, this defaults to the review request submitter.

• trivial (bool, optional) –

  Whether or not this is a trivial publish.

  Trivial publishes do not result in e-mail notifications.

• send_notification (bool, optional) –

  Whether or not this will emit the reviewboard.reviews.signals.review_request_published signal.

  This parameter is intended for internal use only.

• validate_fields (bool, optional) –

  Whether or not the fields should be validated.

  This should only be False in the case of programmatic publishes, e.g., from close as submitted hooks.

• timestamp (datetime.datetime, optional) – The datetime that should be used for all timestamps for objects published (DiffSet, ChangeDescription) over the course of the method.

Returns:

The change description that results from this publish (if any).

If this is an initial publish, there will be no change description (and this function will return None).

Return type:

reviewboard.changedescs.models.ChangeDescription

update_from_commit_id(commit_id)¶

Update the data from a server-side changeset.

If the commit ID refers to a pending changeset on an SCM which stores such things server-side (like Perforce), the details like the summary and description will be updated with the latest information.

If the change number is the commit ID of a change which exists on the server, the summary and description will be set from the commit’s message, and the diff will be fetched from the SCM.

Parameters:

commit_id (unicode) – The commit ID or changeset ID that the draft will update from.

Returns:

The list of draft fields that have been updated from the commit.

Return type:

list of unicode

Raises:

• reviewboard.hostingsvcs.errors.HostingServiceError – The hosting service backing the repository encountered an error.

• reviewboard.scmtools.errors.InvalidChangeNumberError – The commit ID could not be found in the repository.

• reviewboard.scmtools.errors.SCMError – The repository tool encountered an error.

• NotImplementedError – The repository does not support fetching information from commit IDs.

update_from_pending_change(commit_id: str, changeset: ChangeSet) → List[str]¶

Update the data from a server-side pending changeset.

This will fetch the metadata from the server and update the fields on the draft.

Changed in version 6.0: Added support for setting extra_data.

Parameters:

• commit_id (str) – The changeset ID that the draft will update from.

• changeset (reviewboard.scmtools.core.ChangeSet) – The changeset information to update from.

Returns:

The list of draft fields that have been updated from the change.

Return type:

list of str

Raises:

reviewboard.scmtools.errors.InvalidChangeNumberError – A changeset could not be found.

update_from_committed_change(commit_id)¶

Update from a committed change present on the server.

Fetches the commit message and diff from the repository and sets the relevant fields.

Parameters:

commit_id (unicode) – The commit ID to update from.

Returns:

The list of draft fields that have been updated from the commit message.

Return type:

list of unicode

copy_fields_to_request(review_request: ReviewRequest) → None¶

Copy draft fields to the review request.

This will loop through all fields on the review request, copying any changes from the draft to the review request, in preparation for a publish.

Parameters:

review_request (reviewboard.reviews.models.review_request.ReviewRequest) – The review request to copy the fields to.

get_review_request()¶

Returns the associated review request.

__annotations__ = {}¶

changedesc_id¶

decrement_file_attachments_count(*args, **kwargs)¶

decrement_inactive_file_attachments_count(*args, **kwargs)¶

decrement_inactive_screenshots_count(*args, **kwargs)¶

decrement_screenshots_count(*args, **kwargs)¶

diffset_id¶

get_extra_data_json()¶

get_next_by_last_updated(*, field=<djblets.db.fields.modification_timestamp_field.ModificationTimestampField: last_updated>, is_next=True, **kwargs)¶

get_previous_by_last_updated(*, field=<djblets.db.fields.modification_timestamp_field.ModificationTimestampField: last_updated>, is_next=False, **kwargs)¶

id¶

A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

increment_file_attachments_count(*args, **kwargs)¶

increment_inactive_file_attachments_count(*args, **kwargs)¶

increment_inactive_screenshots_count(*args, **kwargs)¶

increment_screenshots_count(*args, **kwargs)¶

owner_id¶

reinit_file_attachments_count()¶

reinit_inactive_file_attachments_count()¶

reinit_inactive_screenshots_count()¶

reinit_screenshots_count()¶

reload_file_attachments_count()¶

reload_inactive_file_attachments_count()¶

reload_inactive_screenshots_count()¶

reload_screenshots_count()¶

review_request_id¶

set_extra_data_json(json)¶