def create_milestone(self, name=None, due=None):
        """Creates the specified milestone, with a random name if none is
        provided.  Returns the name of the milestone.
        """
        if name == None:
            name = random_unique_camel()
        milestone_url = self.url + "/admin/ticket/milestones"
        tc.go(milestone_url)
        tc.url(milestone_url)
        tc.formvalue('addmilestone', 'name', name)
        if due:
            # TODO: How should we deal with differences in date formats?
            tc.formvalue('addmilestone', 'duedate', due)
        tc.submit()
        tc.notfind(internal_error)
        tc.notfind('Milestone .* already exists')
        tc.url(milestone_url)
        tc.find(name)

        # Make sure it's on the roadmap.
        tc.follow('Roadmap')
        tc.url(self.url + "/roadmap")
        tc.find('Milestone:.*%s' % name)
        tc.follow(name)
        tc.url('%s/milestone/%s' % (self.url, unicode_quote(name)))
        if not due:
            tc.find('No date set')

        return name

 def go_to_view_tickets(self, href='report'):
     """Surf to the View Tickets page. By default this will be the Reports
     page, but 'query' can be specified for the `href` argument to support
     non-default configurations."""
     self.go_to_front()
     tc.follow('View Tickets')
     tc.url(self.url + '/' + href.lstrip('/'))

 def create_component(self, name=None, owner=None, description=None):
     """Creates the specified component, with a random camel-cased name if
     none is provided.  Returns the name."""
     if name is None:
         name = random_unique_camel()
     component_url = self.url + "/admin/ticket/components"
     tc.go(component_url)
     tc.url(component_url)
     tc.formvalue('addcomponent', 'name', name)
     if owner is not None:
         tc.formvalue('addcomponent', 'owner', owner)
     tc.submit()
     # Verify the component appears in the component list
     tc.url(component_url)
     tc.find(name)
     tc.notfind(internal_error)
     if description is not None:
         tc.follow(r"\b%s\b" % name)
         tc.formvalue('modcomp', 'description', description)
         tc.submit('save')
         tc.url(component_url)
         tc.find("Your changes have been saved.")
         tc.notfind(internal_error)
     # TODO: verify the component shows up in the newticket page
     return name

    def create_ticket(self, summary=None, info=None):
        """Create a new (random) ticket in the test environment.  Returns
        the new ticket number.

        :param summary:
            may optionally be set to the desired summary
        :param info:
            may optionally be set to a dictionary of field value pairs for
            populating the ticket.  ``info['summary']`` overrides summary.

        `summary` and `description` default to randomly-generated values.
        """
        self.go_to_front()
        tc.follow(r"\bNew Ticket\b")
        tc.notfind(internal_error)
        if summary is None:
            summary = random_sentence(5)
        tc.formvalue('propertyform', 'field_summary', summary)
        tc.formvalue('propertyform', 'field_description', random_page())
        if info:
            for field, value in info.items():
                tc.formvalue('propertyform', 'field_%s' % field, value)
        tc.submit('submit')
        # we should be looking at the newly created ticket
        tc.url(self.url + '/ticket/%s' % (self.ticketcount + 1))
        tc.notfind(internal_error)
        # Increment self.ticketcount /after/ we've verified that the ticket
        # was created so a failure does not trigger spurious later
        # failures.
        self.ticketcount += 1

        return self.ticketcount

 def go_to_preferences(self, panel_label=None):
     """Surf to the preferences page. Continue surfing to a specific
     preferences panel if `panel_label` is specified."""
     self.go_to_front()
     tc.follow(r"\bPreferences\b")
     tc.url(self.url + '/prefs')
     if panel_label is not None:
         tc.follow(r"\b%s\b" % panel_label)

 def go_to_admin(self, panel_label=None):
     """Surf to the webadmin page. Continue surfing to a specific
     admin page if `panel_label` is specified."""
     self.go_to_front()
     tc.follow(r"\bAdmin\b")
     tc.url(self.url + '/admin')
     if panel_label is not None:
         tc.follow(r"\b%s\b" % panel_label)

 def login(self, username):
     """Login as the given user"""
     tc.add_auth("", self.url, username, username)
     self.go_to_front()
     tc.find("Login")
     tc.follow("Login")
     # We've provided authentication info earlier, so this should
     # redirect back to the base url.
     tc.find("logged in as %s" % username)
     tc.find("Logout")
     tc.url(self.url)
     tc.notfind(internal_error)

 def create_report(self, title, query, description):
     """Create a new report with the given title, query, and description"""
     self.go_to_front()
     tc.follow('View Tickets')
     tc.formvalue('create_report', 'action', 'new') # select the right form
     tc.submit()
     tc.find('New Report')
     tc.notfind(internal_error)
     tc.formvalue('edit_report', 'title', title)
     tc.formvalue('edit_report', 'description', description)
     tc.formvalue('edit_report', 'query', query)
     tc.submit()
     reportnum = b.get_url().split('/')[-1]
     # TODO: verify the url is correct
     # TODO: verify the report number is correct
     # TODO: verify the report does not cause an internal error
     # TODO: verify the title appears on the report list
     return reportnum

 def logout(self):
     """Logout"""
     tc.follow("Logout")
     tc.notfind(internal_error)

 def go_to_roadmap(self):
     """Surf to the roadmap page."""
     self.go_to_front()
     tc.follow('\\bRoadmap\\b')
     tc.url(self.url + '/roadmap')

 def go_to_admin(self):
     """Surf to the webadmin page."""
     self.go_to_front()
     tc.follow('\\bAdmin\\b')

 def go_to_query(self):
     """Surf to the custom query page."""
     self.go_to_front()
     tc.follow('View Tickets')
     tc.follow('Custom Query')
     tc.url(self.url + '/query')

 def go_to_timeline(self):
     """Surf to the timeline page."""
     self.go_to_front()
     tc.follow('Timeline')
     tc.url(self.url + '/timeline')

 def go_to_milestone(self, name):
     """Surf to the specified milestone page. Assumes milestone exists."""
     self.go_to_roadmap()
     tc.follow('\\bMilestone: %s\\b' % name)
     tc.url(self.url + '/milestone/%s' % name)

 def go_to_query(self):
     """Surf to the custom query page."""
     self.go_to_front()
     tc.follow(r"\bView Tickets\b")
     tc.follow(r"\bNew Custom Query\b")
     tc.url(self.url + '/query')