reviewboard.accounts.forms.pages¶

class AccountPageForm(page, request, user, *args, **kwargs)[source]¶

Base class for a form on the My Account page.

AccountPageForms belong to AccountPages, and will be displayed on the My Account page for a user.

A simple form presents fields that can be filled out and posted. More advanced forms can supply their own template or even their own JavaScript models and views.

required_features = [][source]¶

Features required for a form to be displayed.

is_visible()[source]¶

Return whether or not the form should be rendered.

This is a base implementation that takes into account a set of required features.

Returns

bool: Whether or not the form should be rendered.

class AccountSettingsForm(page, request, user, *args, **kwargs)[source]¶

Form for the Settings page for an account.

load()[source]¶

Load data for the form.

save()[source]¶

Save the form.

class AvatarSettingsForm(*args, **kwargs)[source]¶

A form for configuring the avatar for a user.

This form will only be shown when avatars are enabled for the server.

avatar_service_registry = <SimpleLazyObject: <reviewboard.avatars.registry.AvatarServiceRegistry object>>[source]¶

The avatar service registry. Subclasses must override this.

is_visible()[source]¶

Return whether or not to show the avatar settings form.

Returns

Whether or not to show the avatar settings form.

Return type

bool

class APITokensForm(page, request, user, *args, **kwargs)[source]¶

Form for showing a user’s API tokens.

save_label = None[source]¶

The label for the save button.

This can be set to None to disable the button.

get_js_view_data()[source]¶

Get data to pass to the JavaScript view.

class ChangePasswordForm(page, request, user, *args, **kwargs)[source]¶

Form for changing a user’s password.

is_visible()[source]¶

Return whether or not the “change password” form should be shown.

Returns

Whether or not the form will be rendered.

Return type

bool

clean_old_password()[source]¶

Validate the ‘old_password’ field.

This checks to make sure the old password is correct when changing the password.

clean_password2()[source]¶

Validate the ‘password2’ field.

This makes sure that the two password fields match.

save()[source]¶

Save the form.

class ProfileForm(page, request, user, *args, **kwargs)[source]¶

Form for the Profile page for an account.

load()[source]¶

Load data for the form.

save()[source]¶

Save the form.

class GroupsForm(page, request, user, *args, **kwargs)[source]¶

Form for the group membership page.

Unlike most forms, this doesn’t deal with fields or saving to the database. Instead, it sets up the JavaScript View and provides serialized data representing the groups. The View handles group membership through the API.

save_label = None[source]¶

The label for the save button.

This can be set to None to disable the button.

get_js_view_data()[source]¶

Get data to pass to the JavaScript view.

class OAuthApplicationsForm(page, request, user, *args, **kwargs)[source]¶

The OAuth Application form.

This provides a list of all current OAuth2 applications the user has access to.

save_label = None[source]¶

The label for the save button.

This can be set to None to disable the button.

get_js_view_data()[source]¶

Return the data for the associated Javascript view.

Returns

Data to be passed to the Javascript view.

Return type

dict

static serialize_app(app)[source]¶

Serialize an application for the JavaScript view.

Parameters

app (reviewboard.oauth.models.Application) – The application to serialize.

Returns

The serialized application.

Return type

dict

class OAuthTokensForm(page, request, user, *args, **kwargs)[source]¶

The OAuth Token form

This provides a list of all current OAuth2 tokens the user has created.

save_label = None[source]¶

The label for the save button.

This can be set to None to disable the button.

get_js_view_data()[source]¶

Return the data for the JavaScript view.

Returns

A dict containing a single key:

'tokens' (list):

A list of serialized information about each token.

Return type

dict

static serialize_token(token)[source]¶

Serialize a single token for the JavaScript view.

Returns

A dict with the following keys:

'apiURL' (unicode):

The URL to access the token via the API.

'application' (unicode):

The name of the application the token is associated with.

Return type

dict

class PrivacyForm(*args, **kwargs)[source]¶

A form for displaying privacy information and gathering consent.

This will display a user’s privacy rights, link to any configured Privacy Policy document, and display a form for gathering consent for features that make use of the user’s personally identifying information.

load()[source]¶

Load the form data.

If a ?next query argument is provided, it will be loaded into the initial value for the next_url so that it will persist through page submission.

is_visible()[source]¶

Return whether or not the form should be rendered.

This will check if there’s any information to display in this form. It’s only displayed if consent requirements are enabled or there’s any privacy information configured in Admin Settings.

Returns

bool: Whether or not the form should be rendered.

get_extra_context()[source]¶

Return extra context for the template.

Returns

Context used for rendering the form’s template.

Return type

dict

clean_next_url()[source]¶

Clean the next_url field.

Returns

The URL to redirect to, if any.

Return type

unicode

save()[source]¶

Save the privacy form.

This may redirect the user to the next URL if it is specified.

Returns

A redirect to the next URL if given and None otherwise.

Return type

django.http.HttpResponseRedirect