Merge lp:~adeuring/launchpad/bug-588276 into lp:launchpad

[Abel Deuring]

This branch fixes bug 588276: "Enable use of bug_reported_acknowledgement in web UI"

It adds the field bug_reported_acknowledgement to edit forms for IDistribution, IDistributionSourcePackage, IProduct, IProjectGroup; FileBugViewBase.submit_bug_action() now tries to retrieve the bug filing acknowledgement message from the bug target and its parents. This is done in the new method getAcknowledgementMessage().

The property bug_reported_acknowledgement is defined for all bug targets, but only the four bug target types IDistribution, IDistributionSourcePackage, IProduct, IProjectGroup have database columns for it; other bug targets (IProductSeries, IDistroSeries, ISourcePackage) inherit it from their parents.

This acquisition logic is fine, but it ignores the case that a customized message is defined for a project group but not for a project within the project group, or for a distribution but not for DistributionSourcePackage. We should show in this case not the standard messae, but the message defined for the project group or the distribution, respectively.

Hence I duplicated/generalized the "acquisition logic" in the browser class method getAcknowledgementmessage() so that it works for DSP -> distribtuion and product -> project group too.

tests:

bin/test -t test_bugtarget_filebug (for getAcknowledgementmessage())
bin/test -t xx-bug-reporting-guidelines.txt (changes edit forms; shows that the notification shown in the web UI when a bug has been filed is customnizable).

no lint

[Graham Binns (gmb)]

> + "bug_reported_acknowledgement",
> ]
> custom_widget('bugtracker', ProductBugTrackerWidget)
>
> @@ -443,7 +446,7 @@
> else:
> private = False
>
> - notifications = ["Thank you for your bug report."]
> + notifications = [self.getAcknowledgementMessage(self.context)]
> params = CreateBugParams(
> title=title, comment=comment, owner=self.user,
> security_related=security_related, private=private,
> @@ -775,6 +778,47 @@
> })
> return guidelines
>
> + default_bug_reported_acknowledgement = "Thank you for your bug report."
> +
> + def getAcknowledgementMessage(self, context):
> + """An acknowlegement message displayed to the user."""
> + # If a given context has not a custom message, we go up in the

Minor grammatical nit pick: "does not have a" reads better than "has not a".

review: Approve (code)

=== modified file 'lib/lp/bugs/browser/bugtarget.py'
--- lib/lp/bugs/browser/bugtarget.py	2010-06-08 10:36:00 +0000
+++ lib/lp/bugs/browser/bugtarget.py	2010-06-16 08:24:32 +0000
@@ -120,6 +120,8 @@
     remote_product = copy_field(IProduct['remote_product'])
     bug_reporting_guidelines = copy_field(
         IBugTarget['bug_reporting_guidelines'])
+    bug_reported_acknowledgement = copy_field(
+        IBugTarget['bug_reported_acknowledgement'])
 
 
 def product_to_productbugconfiguration(product):
@@ -141,6 +143,7 @@
         "enable_bug_expiration",
         "remote_product",
         "bug_reporting_guidelines",
+        "bug_reported_acknowledgement",
         ]
     custom_widget('bugtracker', ProductBugTrackerWidget)
 
@@ -443,7 +446,7 @@
         else:
             private = False
 
-        notifications = ["Thank you for your bug report."]
+        notifications = [self.getAcknowledgementMessage(self.context)]
         params = CreateBugParams(
             title=title, comment=comment, owner=self.user,
             security_related=security_related, private=private,
@@ -775,6 +778,47 @@
                             })
         return guidelines
 
+    default_bug_reported_acknowledgement = "Thank you for your bug report."
+
+    def getAcknowledgementMessage(self, context):
+        """An acknowlegement message displayed to the user."""
+        # If a given context doesnot have a custom message, we go up in the
+        # "object hierachy" until we find one. If no cusotmized messages
+        # exist for any conext, a default message is returned.
+        #
+        # bug_reported_acknowledgement is defined as a "real" property
+        # for IDistribution, IDistributionSourcePackage, IProduct and
+        # IProjectGroup. Other IBugTarget implementations inherit this
+        # property from their parents. For these classes, we can directly
+        # try to find a custom message farther up in the hierarchy.
+        message = context.bug_reported_acknowledgement
+        if message is not None and len(message.strip()) > 0:
+            return message
+        next_context = None
+        if IProductSeries.providedBy(context):
+            # we don't need to look at
+            # context.product.bug_reported_acknowledgement because a
+            # product series inherits this property from the product.
+            next_context = context.product.project
+        elif IProduct.providedBy(context):
+            next_context = context.project
+        elif IDistributionSourcePackage.providedBy(context):
+            next_context = context.distribution
+        # IDistroseries and ISourcePackage inherit
+        # bug_reported_acknowledgement from their IDistribution, so we
+        # don't need to look up this property in IDistribution.
+        # IDistribution and IProjectGroup don't have any parents.
+        elif (IDistribution.providedBy(context) or
+              IProjectGroup.providedBy(context) or
+              IDistroSeries.providedBy(context) or
+              ISourcePackage.providedBy(context)):
+            pass
+        else:
+            raise TypeError("Unexpected bug target: %r" % context)
+        if next_context is not None:
+            return self.getAcknowledgementMessage(next_context)
+        return self.default_bug_reported_acknowledgement
+
     @cachedproperty
     def extra_data_processing_job(self):
         """Return the ProcessApportBlobJob for a given BLOB token."""

=== modified file 'lib/lp/bugs/browser/tests/test_bugtarget_configure.py'
--- lib/lp/bugs/browser/tests/test_bugtarget_configure.py	2010-05-26 18:52:31 +0000
+++ lib/lp/bugs/browser/tests/test_bugtarget_configure.py	2010-06-16 08:24:32 +0000
@@ -31,6 +31,7 @@
             'field.enable_bug_expiration': 'on',
             'field.remote_product': 'sf-boing',
             'field.bug_reporting_guidelines': 'guidelines',
+            'field.bug_reported_acknowledgement': 'acknowledgement message',
             'field.actions.change': 'Change',
             }
 
@@ -42,7 +43,7 @@
         fields = [
             'bug_supervisor', 'security_contact', 'bugtracker',
             'enable_bug_expiration', 'remote_product',
-            'bug_reporting_guidelines']
+            'bug_reporting_guidelines', 'bug_reported_acknowledgement']
         self.assertEqual(fields, view.field_names)
         self.assertEqual('http://launchpad.dev/boing', view.next_url)
         self.assertEqual('http://launchpad.dev/boing', view.cancel_url)
@@ -61,6 +62,9 @@
         self.assertTrue(self.product.enable_bug_expiration)
         self.assertEqual('sf-boing', self.product.remote_product)
         self.assertEqual('guidelines', self.product.bug_reporting_guidelines)
+        self.assertEqual(
+            'acknowledgement message',
+            self.product.bug_reported_acknowledgement)
 
     def test_bug_supervisor_invalid(self):
         # Verify that invalid bug_supervisor states are reported.

=== added file 'lib/lp/bugs/browser/tests/test_bugtarget_filebug.py'
--- lib/lp/bugs/browser/tests/test_bugtarget_filebug.py	1970-01-01 00:00:00 +0000
+++ lib/lp/bugs/browser/tests/test_bugtarget_filebug.py	2010-06-16 08:24:32 +0000
@@ -0,0 +1,264 @@
+# Copyright 2010 Canonical Ltd.  This software is licensed under the
+# GNU Affero General Public License version 3 (see the file LICENSE).
+
+__metaclass__ = type
+
+
+import unittest
+
+from canonical.launchpad.ftests import login
+from canonical.launchpad.webapp.servers import LaunchpadTestRequest
+from canonical.testing import LaunchpadFunctionalLayer
+
+from lp.bugs.browser.bugtarget import FileBugInlineFormView
+from lp.testing import login_person, TestCaseWithFactory
+from lp.testing.views import create_initialized_view
+
+class TestBugTargetFileBugConfirmationMessage(TestCaseWithFactory):
+
+    layer = LaunchpadFunctionalLayer
+
+    def setUp(self):
+        super(TestBugTargetFileBugConfirmationMessage, self).setUp()
+        login('[e-mail]')
+        self.product = self.factory.makeProduct()
+
+    def test_getAcknowledgementMessage_product(self):
+        # If there is not customized confirmation message, a default
+        # message is displayed.
+        product = self.factory.makeProduct()
+        view = FileBugInlineFormView(product, LaunchpadTestRequest())
+        self.assertEqual(
+            u"Thank you for your bug report.",
+            view.getAcknowledgementMessage(product))
+
+        # If a product contains a customized bug filing confirmation
+        # message, it is retrieved by
+        # FilebugViewBase.bug_reported_acknowledgement
+        product.bug_reported_acknowledgement = (
+            u"We really appreciate your bug report")
+        view = FileBugInlineFormView(product, LaunchpadTestRequest())
+        self.assertEqual(
+            u"We really appreciate your bug report",
+            view.getAcknowledgementMessage(product))
+
+        # If the custom message is set to a string containing only white,
+        # space, the default message is used again.
+        product.bug_reported_acknowledgement = ' \t'
+        view = FileBugInlineFormView(product, LaunchpadTestRequest())
+        self.assertEqual(
+            u"Thank you for your bug report.",
+            view.getAcknowledgementMessage(product))
+
+    def test_getAcknowledgementMessage_product_in_project_group(self):
+        # If a product is part of a project group and if the project
+        # group has a customized bug filing confirmation message,
+        # this message is displayed.
+        project_group = self.factory.makeProject()
+        product = self.factory.makeProduct(project=project_group)
+
+        # Without any customized bug filing confirmation message, the
+        # default message is used.
+        view = FileBugInlineFormView(product, LaunchpadTestRequest())
+        self.assertEqual(
+            u"Thank you for your bug report.",
+            view.getAcknowledgementMessage(product))
+
+        # If the project group has a customized message, it is used.
+        project_group.bug_reported_acknowledgement = (
+            "Thanks for filing a bug for one of our many products.")
+        view = FileBugInlineFormView(product, LaunchpadTestRequest())
+        self.assertEqual(
+            u"Thanks for filing a bug for one of our many products.",
+            view.getAcknowledgementMessage(product))
+
+        # But if the product itself has a customized message too, this
+        # message is used instead of the project group's message.
+        product.bug_reported_acknowledgement = (
+            u"Thanks for filing a bug for this very special product.")
+        view = FileBugInlineFormView(product, LaunchpadTestRequest())
+        self.assertEqual(
+            u"Thanks for filing a bug for this very special product.",
+            view.getAcknowledgementMessage(product))
+
+    def test_getAcknowledgementMessage_product_series(self):
+        # If there is not customized confirmation message, a default
+        # message is displayed.
+        product_series = self.factory.makeProductSeries()
+        view = FileBugInlineFormView(product_series, LaunchpadTestRequest())
+        self.assertEqual(
+            u"Thank you for your bug report.",
+            view.getAcknowledgementMessage(product_series))
+
+        # If a product contains a customized bug filing confirmation
+        # message, it is retrieved for a product series context by
+        # FilebugViewBase.bug_reported_acknowledgement
+        product_series.product.bug_reported_acknowledgement = (
+            u"We really appreciate your bug report")
+        view = FileBugInlineFormView(product_series, LaunchpadTestRequest())
+        self.assertEqual(
+            u"We really appreciate your bug report",
+            view.getAcknowledgementMessage(product_series))
+
+    def test_getAcknowledgementMessage_product_series_in_project_group(self):
+        # If a product_series is part of a project group and if the project
+        # group has a customized bug filing confirmation message,
+        # this message is displayed.
+        project_group = self.factory.makeProject()
+        product = self.factory.makeProduct(project=project_group)
+        product_series = self.factory.makeProductSeries(product=product)
+
+        # Without any customized bug filing confirmation message, the
+        # default message is used.
+        view = FileBugInlineFormView(product_series, LaunchpadTestRequest())
+        self.assertEqual(
+            u"Thank you for your bug report.",
+            view.getAcknowledgementMessage(product_series))
+
+        # If the project group has a customized message, it is used.
+        project_group.bug_reported_acknowledgement = (
+            u"Thanks for filing a bug for one of our many product_seriess.")
+        view = FileBugInlineFormView(product_series, LaunchpadTestRequest())
+        self.assertEqual(
+            u"Thanks for filing a bug for one of our many product_seriess.",
+            view.getAcknowledgementMessage(product_series))
+
+        # But if the product has a customized message too, this
+        # message is used instead of the project group's message.
+        product.bug_reported_acknowledgement = (
+            u"Thanks for filing a bug for this very special product.")
+        view = FileBugInlineFormView(product_series, LaunchpadTestRequest())
+        self.assertEqual(
+            u"Thanks for filing a bug for this very special product.",
+            view.getAcknowledgementMessage(product_series))
+
+    def test_getAcknowledgementMessage_distribution(self):
+        # If there is not customized confirmation message, a default
+        # message is displayed.
+        distribution = self.factory.makeDistribution()
+        view = FileBugInlineFormView(distribution, LaunchpadTestRequest())
+        self.assertEqual(
+            u"Thank you for your bug report.",
+            view.getAcknowledgementMessage(distribution))
+
+        # If a distribution contains a customized bug filing confirmation
+        # message, it is retrieved by
+        # FilebugViewBase.bug_reported_acknowledgement
+        distribution.bug_reported_acknowledgement = (
+            u"We really appreciate your bug report")
+        view = FileBugInlineFormView(distribution, LaunchpadTestRequest())
+        self.assertEqual(
+            u"We really appreciate your bug report",
+            view.getAcknowledgementMessage(distribution))
+
+    def test_getAcknowledgementMessage_distroseries(self):
+        # If there is not customized confirmation message, a default
+        # message is displayed.
+        distroseries = self.factory.makeDistroSeries()
+        view = FileBugInlineFormView(distroseries, LaunchpadTestRequest())
+        self.assertEqual(
+            u"Thank you for your bug report.",
+            view.getAcknowledgementMessage(distroseries))
+
+        # DistroSeries objects do not have their own, independent
+        # property bug_reported_acknowledgement; instead, it is
+        # acquired from the parent distribution.
+        distroseries.distribution.bug_reported_acknowledgement = (
+            u"We really appreciate your bug report")
+        view = FileBugInlineFormView(distroseries, LaunchpadTestRequest())
+        self.assertEqual(
+            u"We really appreciate your bug report",
+            view.getAcknowledgementMessage(distroseries))
+
+    def test_getAcknowledgementMessage_sourcepackage(self):
+        # If there is not customized confirmation message, a default
+        # message is displayed.
+        sourcepackage = self.factory.makeSourcePackage()
+        view = FileBugInlineFormView(sourcepackage, LaunchpadTestRequest())
+        self.assertEqual(
+            u"Thank you for your bug report.",
+            view.getAcknowledgementMessage(sourcepackage))
+
+        # SourcePackage objects do not have their own, independent
+        # property bug_reported_acknowledgement; instead, it is
+        # acquired from the parent distribution.
+        sourcepackage.distribution.bug_reported_acknowledgement = (
+            u"We really appreciate your bug report")
+        view = FileBugInlineFormView(sourcepackage, LaunchpadTestRequest())
+        self.assertEqual(
+            u"We really appreciate your bug report",
+            view.getAcknowledgementMessage(sourcepackage))
+
+    def test_getAcknowledgementMessage_distributionsourcepackage(self):
+        # If there is not customized confirmation message, a default
+        # message is displayed.
+        dsp = self.factory.makeDistributionSourcePackage()
+        view = FileBugInlineFormView(dsp, LaunchpadTestRequest())
+        self.assertEqual(
+            u"Thank you for your bug report.",
+            view.getAcknowledgementMessage(dsp))
+
+        # If a custom message is defined for a DSP, it is used instead of
+        # the default message.
+        dsp.bug_reported_acknowledgement = (
+            u"We really appreciate your bug report")
+        view = FileBugInlineFormView(dsp, LaunchpadTestRequest())
+        self.assertEqual(
+            u"We really appreciate your bug report",
+            view.getAcknowledgementMessage(dsp))
+
+    def test_getAcknowledgementMessage_dsp_custom_distro_message(self):
+        # If a distribution has a customized conformatom message, it
+        # is used for bugs filed on DsitributionSourcePackages.
+        dsp = self.factory.makeDistributionSourcePackage()
+        dsp.distribution.bug_reported_acknowledgement = (
+            u"Thank you for filing a bug in our distribution")
+        view = FileBugInlineFormView(dsp, LaunchpadTestRequest())
+        self.assertEqual(
+            u"Thank you for filing a bug in our distribution",
+            view.getAcknowledgementMessage(dsp))
+
+        # Bug if a custom message is defined for a DSP, it is used instead of
+        # the message for the distribution.
+        dsp.bug_reported_acknowledgement = (
+            u"Thank you for filing a bug for this DSP")
+        view = FileBugInlineFormView(dsp, LaunchpadTestRequest())
+        self.assertEqual(
+            u"Thank you for filing a bug for this DSP",
+            view.getAcknowledgementMessage(dsp))
+
+    def test_bug_filed_acknowlegdgement_notification(self):
+        # When a user files a bug, an acknowledgement notification is added
+        # to the response.
+        product = self.factory.makeProduct()
+        login_person(product.owner)
+        view = FileBugInlineFormView(product, LaunchpadTestRequest())
+        form_data = {
+            'title': 'A bug title',
+            'comment': 'whatever',
+            }
+        view = create_initialized_view(product, name='+filebug')
+        view.submit_bug_action.success(form_data)
+        self.assertEqual(
+            ["Thank you for your bug report."],
+            [notification.message
+             for notification in view.request.response.notifications])
+
+        # This message can be customized.
+        product.bug_reported_acknowledgement = (
+            u"We really appreciate your bug report")
+        view = create_initialized_view(product, name='+filebug')
+        view.submit_bug_action.success(form_data)
+        self.assertEqual(
+            [u"We really appreciate your bug report"],
+            [notification.message
+             for notification in view.request.response.notifications])
+
+def test_suite():
+    suite = unittest.TestSuite()
+    suite.addTest(unittest.makeSuite(TestBugTargetFileBugConfirmationMessage))
+    return suite
+
+
+if __name__ == '__main__':
+    unittest.TextTestRunner().run(test_suite())

=== modified file 'lib/lp/bugs/stories/guided-filebug/xx-bug-reporting-guidelines.txt'
--- lib/lp/bugs/stories/guided-filebug/xx-bug-reporting-guidelines.txt	2010-03-16 22:07:45 +0000
+++ lib/lp/bugs/stories/guided-filebug/xx-bug-reporting-guidelines.txt	2010-06-16 08:24:32 +0000
@@ -1,7 +1,9 @@
-= Bug Reporting Guidelines =
+= Bug Reporting Guidelines and acknowledgement messages =
 
 Some helpful explanatory text - guidelines - can be set for
-distributions, product groups, products, and source packages.
+distributions, product groups, products, and source packages, as wel
+as an acknowledgement message that is displayed when a bug has been
+filed.
 
     >>> contexts = [
     ...     ('Ubuntu', 'ubuntu', '+edit'),
@@ -16,6 +18,9 @@
     ...     admin_browser.getControl(
     ...         name='field.bug_reporting_guidelines').value = (
     ...         "The version of %s you're using." % (context_name,))
+    ...     admin_browser.getControl(
+    ...         name='field.bug_reported_acknowledgement').value = (
+    ...         "Thank you for filing a bug for %s" % context_name)
     ...     if context_path == 'ubuntu':
     ...         admin_browser.getControl('Change', index=3).click()
     ...     else:
@@ -30,6 +35,9 @@
     ...     print '  <%s>' % user_browser.url
     ...     print extract_text(find_tag_by_id(
     ...         user_browser.contents, 'bug-reporting-guidelines'))
+    >>> def print_acknowledgement_message(browser):
+    ...     print extract_text(find_tags_by_class(
+    ...         user_browser.contents, 'informational message')[0])
 
     >>> for context_name, context_path, view in contexts:
     ...     filebug_url = (
@@ -49,22 +57,29 @@
     ...     user_browser.open(filebug_url)
     ...     user_browser.getControl('Summary').value = "It doesn't work"
     ...     user_browser.getControl('Continue').click()
+    ...     user_browser.getControl('Further information').value = (
+    ...         'please help!')
     ...     print_guidelines(context_name, user_browser)
+    ...     user_browser.getControl('Submit Bug Report').click()
+    ...     print_acknowledgement_message(user_browser)
     *
     Ubuntu
       <http://launchpad.dev/ubuntu/+filebug>
     Ubuntu guidelines:
     The version of Ubuntu you're using.
+    Thank you for filing a bug for Ubuntu
     *
     Mozilla
       <http://launchpad.dev/mozilla/+filebug>
     The Mozilla Project guidelines:
     The version of Mozilla you're using.
+    Thank you for filing a bug for Mozilla
     *
     Firefox
       <http://launchpad.dev/firefox/+filebug>
     Mozilla Firefox guidelines:
     The version of Firefox you're using.
+    Thank you for filing a bug for Firefox
     *
     alsa-utils in Ubuntu
       <http://launchpad.dev/ubuntu/+source/alsa-utils/+filebug>
@@ -72,6 +87,7 @@
     The version of alsa-utils in Ubuntu you're using.
     Ubuntu guidelines:
     The version of Ubuntu you're using.
+    Thank you for filing a bug for alsa-utils in Ubuntu
 
 Note how the alsa-utils in Ubuntu specific guidelines were displayed
 followed by the general Ubuntu guidelines.

=== modified file 'lib/lp/registry/browser/distribution.py'
--- lib/lp/registry/browser/distribution.py	2010-05-14 08:05:23 +0000
+++ lib/lp/registry/browser/distribution.py	2010-06-16 08:24:32 +0000
@@ -767,7 +767,8 @@
 
     schema = IDistribution
     field_names = ['displayname', 'title', 'summary', 'description',
-                   'bug_reporting_guidelines', 'icon', 'logo', 'mugshot',
+                   'bug_reporting_guidelines', 'bug_reported_acknowledgement',
+                   'icon', 'logo', 'mugshot',
                    'official_malone', 'enable_bug_expiration',
                    'official_blueprints', 'official_rosetta',
                    'official_answers', 'translation_focus', ]

=== modified file 'lib/lp/registry/browser/distributionsourcepackage.py'
--- lib/lp/registry/browser/distributionsourcepackage.py	2010-03-03 19:15:17 +0000
+++ lib/lp/registry/browser/distributionsourcepackage.py	2010-06-16 08:24:32 +0000
@@ -478,6 +478,7 @@
     schema = IDistributionSourcePackage
     field_names = [
         'bug_reporting_guidelines',
+        'bug_reported_acknowledgement',
         ]
 
     @property

=== modified file 'lib/lp/registry/browser/project.py'
--- lib/lp/registry/browser/project.py	2010-05-11 17:43:20 +0000
+++ lib/lp/registry/browser/project.py	2010-06-16 08:24:32 +0000
@@ -324,8 +324,9 @@
     schema = IProjectGroup
     field_names = [
         'name', 'displayname', 'title', 'summary', 'description',
-        'bug_reporting_guidelines', 'homepageurl', 'bugtracker',
-        'sourceforgeproject', 'freshmeatproject', 'wikiurl']
+        'bug_reporting_guidelines', 'bug_reported_acknowledgement',
+        'homepageurl', 'bugtracker', 'sourceforgeproject',
+        'freshmeatproject', 'wikiurl']
 
 
     @action('Change Details', name='change')

=== modified file 'lib/lp/registry/browser/tests/distribution-views.txt'
--- lib/lp/registry/browser/tests/distribution-views.txt	2010-05-19 16:58:45 +0000
+++ lib/lp/registry/browser/tests/distribution-views.txt	2010-06-16 08:24:32 +0000
@@ -111,9 +111,10 @@
 
     >>> view.field_names
     ['displayname', 'title', 'summary', 'description',
-     'bug_reporting_guidelines', 'icon', 'logo', 'mugshot', 'official_malone',
-     'enable_bug_expiration', 'official_blueprints', 'official_rosetta',
-     'official_answers', 'translation_focus']
+     'bug_reporting_guidelines', 'bug_reported_acknowledgement', 'icon',
+     'logo', 'mugshot', 'official_malone', 'enable_bug_expiration',
+     'official_blueprints', 'official_rosetta', 'official_answers',
+     'translation_focus']
 
     >>> del form['field.name']
     >>> del form['field.actions.save']

=== modified file 'lib/lp/registry/browser/tests/distributionsourcepackage-views.txt'
--- lib/lp/registry/browser/tests/distributionsourcepackage-views.txt	2009-12-13 11:55:40 +0000
+++ lib/lp/registry/browser/tests/distributionsourcepackage-views.txt	2010-06-16 08:24:32 +0000
@@ -165,7 +165,7 @@
 The view allows the user the set the bug_reporting_guidelines field.
 
     >>> view.field_names
-    ['bug_reporting_guidelines']
+    ['bug_reporting_guidelines', 'bug_reported_acknowledgement']
 
     >>> print package.bug_reporting_guidelines
     None