blob: 069d1917feb1329d90a15f323153336883be3d5f [file] [log] [blame]
# Copyright 2016 The Chromium Authors. All rights reserved.
# Use of this source code is govered by a BSD-style
# license that can be found in the LICENSE file or at
"""Page and form handlers for project administration "advanced" subtab.
The advanced subtab allows the project to be archived, unarchived, deleted, or
marked as moved. Site admins can use this page to "doom" a project, which is
basically archiving it in a way that cannot be reversed by the project owners.
The page also shows project data storage quota and usage values, and
site admins can edit those quotas.
import logging
import time
from third_party import ezt
from framework import framework_constants
from framework import framework_helpers
from framework import permissions
from framework import servlet
from framework import template_helpers
from framework import urls
from proto import project_pb2
from tracker import tracker_constants
class ProjectAdminAdvanced(servlet.Servlet):
"""A page with project state options for the Project Owner(s)."""
_PAGE_TEMPLATE = 'project/project-admin-advanced-page.ezt'
def AssertBasePermission(self, mr):
"""Make sure that the logged in user has permission to view this page.
mr: commonly used info parsed from the request.
super(ProjectAdminAdvanced, self).AssertBasePermission(mr)
if not self.CheckPerm(mr, permissions.EDIT_PROJECT):
raise permissions.PermissionException(
'User is not allowed to administer this project')
def GatherPageData(self, mr):
"""Build up a dictionary of data values to use when rendering the page.
mr: commonly used info parsed from the request.
Dict of values used by EZT for rendering the "Advanced" subtab.
page_data = {
'admin_tab_mode': self.ADMIN_TAB_ADVANCED,
return page_data
def _GatherPublishingOptions(self, mr):
"""Gather booleans to control the publishing buttons to show in EZT."""
state = mr.project.state
offer_archive = state != project_pb2.ProjectState.ARCHIVED
offer_delete = state == project_pb2.ProjectState.ARCHIVED
offer_publish = (
state == project_pb2.ProjectState.ARCHIVED and
(self.CheckPerm(mr, permissions.PUBLISH_PROJECT) or
not mr.project.state_reason))
offer_move = state == project_pb2.ProjectState.LIVE
offer_doom = self.CheckPerm(mr, permissions.ADMINISTER_SITE)
moved_to = mr.project.moved_to or 'http://'
publishing_data = {
'offer_archive': ezt.boolean(offer_archive),
'offer_publish': ezt.boolean(offer_publish),
'offer_delete': ezt.boolean(offer_delete),
'offer_move': ezt.boolean(offer_move),
'moved_to': moved_to,
'offer_doom': ezt.boolean(offer_doom),
'default_doom_reason': framework_constants.DEFAULT_DOOM_REASON,
return publishing_data
def _GatherQuotaData(self, mr):
"""Gather quota info from backends so that it can be passed to EZT."""
offer_quota_editing = self.CheckPerm(mr, permissions.EDIT_QUOTA)
quota_data = {
'offer_quota_editing': ezt.boolean(offer_quota_editing),
'attachment_quota': self._BuildAttachmentQuotaData(mr.project),
return quota_data
def _BuildComponentQuota(self, used_bytes, quota_bytes, field_name):
"""Return an object to easily display quota info in EZT."""
if quota_bytes:
used_percent = 100 * used_bytes / quota_bytes
used_percent = 0
quota_mb = quota_bytes / 1024 / 1024
return template_helpers.EZTItem(
avail_percent=100 - used_percent,
def _BuildAttachmentQuotaData(self, project):
return self._BuildComponentQuota(
project.attachment_quota or
def ProcessFormData(self, mr, post_data):
"""Process the posted form.
mr: commonly used info parsed from the request.
post_data: dictionary of HTML form data.
String URL to redirect to after processing is completed.
if 'savechanges' in post_data:
self._ProcessQuota(mr, post_data)
self._ProcessPublishingOptions(mr, post_data)
if 'deletebtn' in post_data:
url = framework_helpers.FormatAbsoluteURL(
mr, urls.HOSTING_HOME, include_project=False)
url = framework_helpers.FormatAbsoluteURL(
mr, urls.ADMIN_ADVANCED, saved=1, ts=int(time.time()))
return url
def _ProcessQuota(self, mr, post_data):
"""Process form data to update project quotas."""
if not self.CheckPerm(mr, permissions.EDIT_QUOTA):
raise permissions.PermissionException(
'User is not allowed to change project quotas')
new_attachment_quota = int(post_data['attachment_quota_mb'])
new_attachment_quota *= 1024 * 1024
except ValueError:
mr.errors.attachment_quota = 'Invalid value'
self.PleaseCorrect(mr) # Don't echo back the bad input, just start over.
mr.cnxn, mr.project.project_id,
def _ProcessPublishingOptions(self, mr, post_data):
"""Process form data to update project state."""
# Note that EDIT_PROJECT is the base permission for this servlet, but
# dooming and undooming projects also requires PUBLISH_PROJECT.
state = mr.project.state
if 'archivebtn' in post_data and not mr.project.delete_time:
mr.cnxn, mr.project.project_id,
elif 'deletebtn' in post_data: # Mark the project for immediate deletion.
if state != project_pb2.ProjectState.ARCHIVED:
raise permissions.PermissionException(
'Projects must be archived before being deleted')
mr.cnxn, mr.project_id,
elif 'doombtn' in post_data: # Go from any state to forced ARCHIVED.
if not self.CheckPerm(mr, permissions.PUBLISH_PROJECT):
raise permissions.PermissionException(
'User is not allowed to doom projects')
reason = post_data.get('reason')
delete_time = time.time() + framework_constants.DEFAULT_DOOM_PERIOD
mr.cnxn, mr.project.project_id,
state=project_pb2.ProjectState.ARCHIVED, state_reason=reason,
elif 'publishbtn' in post_data: # Go from any state to LIVE
if (mr.project.delete_time and
not self.CheckPerm(mr, permissions.PUBLISH_PROJECT)):
raise permissions.PermissionException(
'User is not allowed to unarchive doomed projects')
mr.cnxn, mr.project.project_id,
state=project_pb2.ProjectState.LIVE, state_reason='', delete_time=0,
elif 'movedbtn' in post_data: # Record the moved_to location.
if state != project_pb2.ProjectState.LIVE:
raise permissions.PermissionException(
'This project is not live, no user can move it')
moved_to = post_data.get('moved_to', '')
mr.cnxn, mr.project.project_id, moved_to=moved_to)