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_version(self, name=None, releasetime=None):
     """Create a new version.  The name defaults to a random camel-cased
     word if not provided."""
     version_admin = self.url + "/admin/ticket/versions"
     if name == None:
         name = random_unique_camel()
     tc.go(version_admin)
     tc.url(version_admin)
     tc.formvalue('addversion', 'name', name)
     if releasetime != None:
         tc.formvalue('addversion', 'time', releasetime)
     tc.submit()
     tc.url(version_admin)
     tc.find(name)
     tc.notfind(internal_error)

 def create_enum(self, kind, name=None):
     """Helper to create the specified enum (used for ``priority``,
     ``severity``, etc). If no name is given, a unique random word is used.
     The name is returned.
     """
     if name == None:
         name = random_unique_camel()
     priority_url = self.url + "/admin/ticket/" + kind
     tc.go(priority_url)
     tc.url(priority_url)
     tc.formvalue('addenum', 'name', name)
     tc.submit()
     tc.url(priority_url)
     tc.find(name)
     tc.notfind(internal_error)
     return name

 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 create_component(self, name=None, user=None):
     """Creates the specified component, with a random camel-cased name if
     none is provided.  Returns the name."""
     if name == 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 user != None:
         tc.formvalue('addcomponent', 'owner', user)
     tc.submit()
     # Verify the component appears in the component list
     tc.url(component_url)
     tc.find(name)
     tc.notfind(internal_error)
     # TODO: verify the component shows up in the newticket page
     return name

    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 create_wiki_page(self, page, content=None):
        """Creates the specified wiki page, with random content if none is
        provided.
        """
        if content == None:
            content = random_page()
        page_url = self.url + "/wiki/" + page
        tc.go(page_url)
        tc.url(page_url)
        tc.find("The page %s does not exist." % page)
        tc.formvalue('modifypage', 'action', 'edit')
        tc.submit()
        tc.url(page_url + '\\?action=edit')

        tc.formvalue('edit', 'text', content)
        tc.submit('save')
        tc.url(page_url+'$')

        # verify the event shows up in the timeline
        self.go_to_timeline()
        tc.formvalue('prefs', 'wiki', True)
        tc.submit()
        tc.find(page + ".*created")

    def create_wiki_page(self, name=None, content=None, comment=None):
        """Creates a wiki page, with a random unique CamelCase name if none
        is provided, random content if none is provided and a random comment
        if none is provided.  Returns the name of the wiki page.
        """
        if name is None:
            name = random_unique_camel()
        if content is None:
            content = random_page()
        self.go_to_wiki(name)
        tc.find("The page %s does not exist." % name)

        self.edit_wiki_page(name, content, comment)

        # verify the event shows up in the timeline
        self.go_to_timeline()
        tc.formvalue('prefs', 'wiki', True)
        tc.submit()
        tc.find(name + ".*created")

        self.go_to_wiki(name)

        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('New Ticket')
        tc.notfind(internal_error)
        if summary == None:
            summary = random_sentence(4)
        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))
        # Increment self.ticketcount /after/ we've verified that the ticket
        # was created so a failure does not trigger spurious later
        # failures.
        self.ticketcount += 1

        # verify the ticket creation event shows up in the timeline
        self.go_to_timeline()
        tc.formvalue('prefs', 'ticket', True)
        tc.submit()
        tc.find('Ticket.*#%s.*created' % self.ticketcount)

        return self.ticketcount

 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)