~launchpad-pqm/launchpad/devel

=====================

The PPA packages page

=====================

The PPA packages page is accessible from the PPA page.

    >>> anon_browser.open('http://launchpad.dev/~cprov/+archive/ppa')

    >>> anon_browser.getLink('View package details').click()

    >>> print anon_browser.url

    http://launchpad.dev/~cprov/+archive/ppa/+packages

    >>> print anon_browser.title

    Packages in...

Page structure

==============

The PPA packages page uses the 'Overview' application button and displays

a descriptive main heading.

    >>> print_location(anon_browser.contents)

    Hierarchy: Celso Providelo > PPA for Celso Providelo > Packages in...

    Tabs:

    * Overview (selected) - http://launchpad.dev/~cprov

    * Code - http://code.launchpad.dev/~cprov

    * Bugs - http://bugs.launchpad.dev/~cprov

    * Blueprints - http://blueprints.launchpad.dev/~cprov

    * Translations - http://translations.launchpad.dev/~cprov

    * Answers - http://answers.launchpad.dev/~cprov

    Main heading: Packages in ...PPA for Celso Providelo...

You can see the build details of the packages in the archive by using

the 'View all builds' link.

    >>> anon_browser.getLink('View all builds').click()

    >>> print anon_browser.title

    Builds : PPA for Celso Providelo : Celso Providelo

    >>> print anon_browser.url

    http://launchpad.dev/~cprov/+archive/ppa/+builds

The rest of the builds page functionality is tested generically at

in xx-builds-pages.txt.

Package totals

==============

A summary of the package totals is presented in a portlet (although the

actual values are loaded in asynchronously.

    >>> anon_browser.open(

    ...     'http://launchpad.dev/~cprov/+archive/ppa/+packages')

    >>> package_totals = find_portlet(

    ...     anon_browser.contents, "Package totals")

    >>> print extract_text(package_totals)

    Package totals

    ...

    Package counters and estimated archive size temporarily

    unavailable.

Package build summary

=====================

A summary of the builds for the PPA is also presented.

    >>> build_summary = find_portlet(

    ...     anon_browser.contents, "View all builds Package build summary")

    >>> print extract_text(build_summary)

    View...

    A total of 4 builds have been dispatched for this PPA.

    Completed builds

    3 successful

    1 failed

Successful builds link directly to the builds filter.

    >>> successful_builds_link = anon_browser.getLink('3 successful')

    >>> print successful_builds_link.url

    http://launchpad.dev/~cprov/+archive/ppa/+builds?build_state=built

The detailed Packages list

==========================

    >>> def print_archive_package_rows(contents):

    ...     package_table = find_tag_by_id(

    ...         contents, 'packages_list')

    ...     for ppa_row in package_table.findChildren('tr'):

    ...         print extract_text(ppa_row)

    >>> print_archive_package_rows(anon_browser.contents)

    Source              Published   Status     Series      Section  Build

        Status

    cdrkit - 1.0        2007-07-09  Published  Breezy-a... Editors  i386

    ice...(changes file) 2007-07-09  Published  Warty       Editors  i386

    pmount - 0.1-1      2007-07-09  Published  Warty       Editors

Each data row is expandable to contain some sections containing:

 * Publishing details

 * The source package's changelog

 * Any built packages and their description

 * The list of files for this package

    >>> expander_url = anon_browser.getLink(id='pub29-expander').url

    >>> anon_browser.open(expander_url)

    >>> print extract_text(anon_browser.contents)

    Publishing details

      Published on 2007-07-09

      Copied from ubuntu hoary in Primary Archive for Ubuntu Linux

    Changelog

      pmount (0.1-1) hoary; urgency=low

      * Fix description (Malone #1)

      * Fix debian (Debian #2000)

      * Fix warty (Warty Ubuntu #1)

      -- Sample Person...

    Builds

      i386

    Built packages

      pmount

      pmount shortdesc

    Package files

      No files published for this package.

If a the binaries for a package are fully built, but have not yet been

published, this will be indicated to the viewer:

    # First, we'll update the binary publishing history for the i386

    # record so that it is pending publication.

    >>> login('foo.bar@canonical.com')

    >>> from zope.component import getUtility

    >>> from lp.registry.interfaces.person import IPersonSet

    >>> cprov = getUtility(IPersonSet).getByName('cprov')

    >>> cprov_ppa = cprov.archive

    >>> pmount_i386_pub = cprov_ppa.getAllPublishedBinaries(

    ...     name='pmount', version='0.1-1')[1]

    >>> print pmount_i386_pub.displayname

    pmount 0.1-1 in warty i386

    >>> from lp.soyuz.enums import PackagePublishingStatus

    >>> pmount_i386_pub.status = PackagePublishingStatus.PENDING

    >>> pmount_i386_pub.datepublished = None

    >>> transaction.commit()

    >>> logout()

    # Now, to re-display the pmount expanded section:

    >>> anon_browser.open(expander_url)

    >>> print extract_text(anon_browser.contents)

    Note: Some binary packages for this source are not yet published in the

    repository.

    Publishing details

      Published on 2007-07-09

      Copied from ubuntu hoary in Primary Archive for Ubuntu Linux

    Changelog

      pmount (0.1-1) hoary; urgency=low

      * Fix description (Malone #1)

      * Fix debian (Debian #2000)

      * Fix warty (Warty Ubuntu #1)

      -- Sample Person...

    Builds

      i386 - Pending publication

    Built packages

      pmount

      pmount shortdesc

    Package files

      No files published for this package.

When the package is copied from a PPA, the archive title will link

back to the source PPA.

    >>> anon_browser.open(

    ...     "http://launchpad.dev/~cprov/+archive/ppa/+packages")

    >>> expander_url = anon_browser.getLink(id='pub28-expander').url

    >>> anon_browser.open(expander_url)

    >>> anon_browser.getLink("PPA for Mark Shuttleworth").url

    'http://launchpad.dev/~mark/+archive/ppa'

This link is not present if the user does not have permission to view

the PPA.  We create a private PPA with a published source and then copy

the source into a public PPA to demonstrate this.

    >>> login('foo.bar@canonical.com')

    >>> from lp.registry.interfaces.distribution import IDistributionSet

    >>> ubuntu = getUtility(IDistributionSet).getByName(

    ...     'ubuntu')

    >>> warty = ubuntu.getSeries('warty')

    >>> private_ppa = factory.makeArchive(

    ...     name='p3a', private=True, owner=cprov,

    ...     distribution=ubuntu)

    >>> joe = factory.makePerson(name="joe")

    >>> public_ppa = factory.makeArchive(

    ...     owner=joe, distribution=ubuntu, name='ppa')

    >>> from lp.soyuz.tests.test_publishing import SoyuzTestPublisher

    >>> test_publisher = SoyuzTestPublisher()

    >>> test_publisher.prepareBreezyAutotest()

    >>> source = test_publisher.getPubSource(

    ...     sourcename='foo', archive=private_ppa, distroseries=warty)

    >>> copied_source = source.copyTo(

    ...     source.distroseries, source.pocket, public_ppa)

    >>> expander_link_id = "pub%s-expander" % copied_source.id

    >>> logout()

We can view the link on the public PPA to Celso's private PPA when logged

in as Celso.

    >>> cprov_browser = setupBrowser(

    ...     auth="Basic celso.providelo@canonical.com:cprov")

    >>> cprov_browser.open(

    ...     "http://launchpad.dev/~joe/+archive/ppa/+packages")

    >>> expander_url = cprov_browser.getLink(id=expander_link_id).url

    >>> cprov_browser.open(expander_url)

    >>> print cprov_browser.getLink("PPA named p3a for Celso Providelo").url

    http://launchpad.dev/~cprov/+archive/p3a

But Joe himself will not see the link.

    >>> joe_browser = setupBrowser(

    ...     auth="Basic joe@example.com:test")

    >>> joe_browser.open(expander_url)

    >>> joe_browser.getLink("PPA named p3a for Celso Providelo")

    Traceback (most recent call last):

    ...

    LinkNotFoundError

And neither can an anonymous user.

    >>> anon_browser.open(expander_url)

    >>> anon_browser.getLink("PPA named p3a for Celso Providelo")

    Traceback (most recent call last):

    ...

    LinkNotFoundError

While we are there, we can also see that the private PPA's 'repository-size'

pagelet isn't publicly available.

    >>> anon_browser.open(

    ...     "http://launchpad.dev/~cprov/+archive/p3a/+repository-size")

    Traceback (most recent call last):

    ...

    Unauthorized: (..., 'launchpad.View')

Searching the packages list

===========================

We can search a PPA for a particular package.  A non-existent package shows

no results.

    >>> anon_browser.open(

    ...     "http://launchpad.dev/~cprov/+archive/ppa/+packages")

    >>> field = anon_browser.getControl(name='field.name_filter')

    >>> field.value = 'nonexistentpackage'

    >>> anon_browser.getControl('Filter', index=0).click()

    >>> len(find_tags_by_class(anon_browser.contents, 'archive_package_row'))

    0

Searching for the package iceweasel shows that Celso is providing this.

    >>> field = anon_browser.getControl(name='field.name_filter')

    >>> field.value = 'iceweasel'

    >>> anon_browser.getControl('Filter', index=0).click()

    >>> len(find_tags_by_class(anon_browser.contents, 'archive_package_row'))

    2

In order to have a wider coverage in search status filter we will

modify some publication in Celso's PPA to SUPERSEDED and DELETED

states. Note, for consistency we have to create the binary publishing records

for iceweasel before marking it as superseded.

    >>> from zope.component import getUtility

    >>> from lp.registry.interfaces.person import IPersonSet

    >>> login('foo.bar@canonical.com')

    >>> cprov = getUtility(IPersonSet).getByName('cprov')

    >>> iceweasel_pub = cprov.archive.getPublishedSources(

    ...     name='iceweasel').first()

    >>> bpr = test_publisher.uploadBinaryForBuild(

    ...     iceweasel_pub.getBuilds()[0], 'bar-bin')

    >>> pub_bins = test_publisher.publishBinaryInArchive(

    ...     bpr, cprov.archive, status=PackagePublishingStatus.PUBLISHED)

    >>> iceweasel_pub.status = (

    ...     PackagePublishingStatus.SUPERSEDED)

    >>> pmount_pub = cprov.archive.getPublishedSources(name='pmount').first()

    >>> pmount_pub.status = PackagePublishingStatus.DELETED

    >>> pmount_pub.removed_by = cprov

    >>> pmount_pub.removal_comment = 'nhack !'

    >>> logout()

    >>> transaction.commit()

    >>> from canonical.database.sqlbase import flush_database_updates

    >>> flush_database_updates()

The default status filter is 'published', which means that, by

default, PPA pages will only present PUBLISHED or PENDING packages.

    >>> field = anon_browser.getControl(name='field.name_filter')

    >>> field.value = ''

    >>> anon_browser.getControl('Filter', index=0).click()

    >>> print_archive_package_rows(anon_browser.contents)

    Source          Published   Status     Series           Section  Build

        Status

    cdrkit - 1.0    2007-07-09  Published  Breezy-autotest  Editors  i386

Use can explicitly select 'published' filter and will get the same result.

    >>> anon_browser.getControl(name='field.status_filter').value = ['published']

    >>> anon_browser.getControl('Filter', index=0).click()

    >>> print_archive_package_rows(anon_browser.contents)

    Source          Published   Status     Series           Section  Build

        Status

    cdrkit - 1.0    2007-07-09  Published  Breezy-autotest  Editors  i386

When needed the users can select the 'superseded' filter and the

result will only contain packages SUPERSEDED or DELETED.

    >>> anon_browser.getControl(name='field.status_filter').value = ['superseded']

    >>> anon_browser.getControl('Filter', index=0).click()

    >>> print_archive_package_rows(anon_browser.contents)

    Source            Published    Status        Series   Section  Build

        Status

    i...(changes file) 2007-07-09   Superseded    Warty    Editors

    pmount - 0.1-1    2007-07-09   Deleted       Warty    Editors

The 'Any Status' filter is also available, so the user can search over

any package ever published in the context PPA.

    >>> anon_browser.getControl(name='field.status_filter').value = ['']

    >>> anon_browser.getControl('Filter', index=0).click()

    >>> print_archive_package_rows(anon_browser.contents)

    Source             Published    Status     Series      Section  Build

        Status

    cdrkit - 1.0       2007-07-09   Published  Breezy-a... Editors  i386

    ic...(changes file) 2007-07-09   Superseded Warty       Editors

    pmount - 0.1-1     2007-07-09   Deleted    Warty       Editors

Team PPA package pages

======================

Team PPA package pages contain an extra column showing which team member

uploaded the package. First we need to set up a team PPA and publish

something to it.

    >>> foo_browser = setupBrowser(auth="Basic foo.bar@canonical.com:test")

    >>> foo_browser.open("http://launchpad.dev/~ubuntu-team/+activate-ppa")

    >>> foo_browser.getControl(name="field.displayname").value = (

    ...     'PPA for Ubuntu team')

    >>> foo_browser.getControl(name="field.accepted").value = True

    >>> foo_browser.getControl('Activate').click()

    >>> ubuntu_ppa_url = foo_browser.url

Publish mozilla-firefox to ubuntu-team's PPA and ensure that it is signed

by name16 (Foo Bar) who is a member - the signer is presented as the uploader

in the list.

    >>> from lp.soyuz.tests.ppa import publishToTeamPPA

    >>> login(ANONYMOUS)

    >>> publishToTeamPPA(team_name="ubuntu-team")

    >>> logout()

    >>> transaction.commit()

    >>> flush_database_updates()

Access ubuntu-team's PPA page:

    >>> foo_browser.open(ubuntu_ppa_url)

    >>> foo_browser.getLink('View package details').click()

The package row data shows the uploader:

    >>> print_archive_package_rows(foo_browser.contents)

    Source              Uploader ... Status   Series  Section  Build Status

    mozilla-firefox...  name16       Pending  Hoary   Base

Links from files go to their on-archive locations:

    >>> expander_id = find_tags_by_class(

    ...     foo_browser.contents, 'expander')[0]['id']

    >>> expander_url = foo_browser.getLink(id=expander_id).url

    >>> anon_browser.open(expander_url)

    >>> print anon_browser.getLink("orig").url

    http://.../firefox_0.9.2.orig.tar.gz

The uploader name is linkified to that user's home page:

    >>> foo_browser.getLink(url="~name16").click()

    >>> foo_browser.url

    'http://launchpad.dev/~name16'

PPA Build Status column

=======================

Each row in the PPA package list contains a special column that

summarises its 'build status'. It contains the following information

for each published source:

 * Completely built: green 'yes' icon only;

 * Build in progress: 'processing' icon, followed by the

   architecture tags being built linking to the corresponding build

   page

 * Build failures: red 'no' icon, followed by the architecture tags

   which have failed to build linking to the corresponding build page.

Anyone can see the build status for package in Celso's PPA.

    >>> anon_browser.open(

    ...     "http://launchpad.dev/~cprov/+archive/ppa/+packages")

    >>> def print_build_status(contents):

    ...     rows = find_tags_by_class(contents, 'archive_package_row')

    ...     headers = rows[0].findAll('th')

    ...     print extract_text(headers[0]), extract_text(headers[-1])

    ...     for row in rows[1:]:

    ...         columns = row.findAll('td')

    ...         name = extract_text(columns[0])

    ...         built_icon = columns[-1].img['src']

    ...         built_text = columns[-1].a

    ...         if built_text is not None:

    ...             built_text = built_text.renderContents()

    ...         print name, built_icon, built_text

    >>> print_build_status(anon_browser.contents)

    Source                    Build Status

    cdrkit - 1.0              /@@/no i386

As mentioned before anyone can visualise 'at a glance' that there was

a failure while building 'cdrkit' source in Celso's PPA. They can also

easily see that the failure was in the i386 build, and optionally

click in the link to visit the build-record page (to check the dates

of downloading the buildlog).

    >>> anon_browser.getLink('i386').click()

    >>> print anon_browser.title

    i386 build of cdrkit 1.0 : PPA for Celso Providelo : Celso Providelo

This feature is also useful from the PPA owner perspective. When Celso

sees that there was a failure while building 'cdrkit' on i386 he can

quickly 'retry' the failure.

    >>> cprov_browser = setupBrowser(

    ...     auth='Basic celso.providelo@canonical.com:cprov')

    >>> cprov_browser.open(

    ...     "http://launchpad.dev/~cprov/+archive/ppa/+packages")

    >>> cprov_browser.getLink('i386').click()

    >>> cprov_browser.getLink("Retry this build").click()

    >>> cprov_browser.getControl("Retry Build").click()

At this point anyone can also visualise that 'cdrkit' source is being

built in Celso's PPA.

    >>> anon_browser.open(

    ...     "http://launchpad.dev/~cprov/+archive/ppa/+packages")

    >>> print_build_status(anon_browser.contents)

    Source                    Build Status

    cdrkit - 1.0              /@@/build-needed i386

Again the architecture tags listed on the 'built' column link to the

corresponding build page.

    >>> anon_browser.getLink('i386').click()

    >>> print anon_browser.title

    i386 build of cdrkit 1.0 : PPA for Celso Providelo : Celso Providelo