~launchpad-pqm/launchpad/devel

DistributionSourcePackageRelease views

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

    # Create a brand new publication of 'testing-dspr - 1.0' for tests.

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

    >>> stp = SoyuzTestPublisher()

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

    >>> stp.prepareBreezyAutotest()

    >>> source = stp.getPubSource('testing-dspr', version='1.0')

    >>> login(ANONYMOUS)

    >>> dspr = stp.ubuntutest.getSourcePackageRelease(

    ...     source.sourcepackagerelease)

`DistributionSourcePackageReleaseView` provides 'page_title', which

simply mimics the `DistributionSourcePackageRelease.title`.

    >>> dspr_view = create_initialized_view(dspr, name="+index")

    >>> print dspr.title

    "testing-dspr" 1.0 source package in ubuntutest

    >>> dspr_view.page_title

    u'\u201ctesting-dspr\u201d 1.0 source package in ubuntutest'

The 'files' property returns a list of files included in the source

upload encapsulated as `ProxiedLibraryFileAlias` objects. Their

'http_url' points to the LP proxied url which normalizes the path

tofiles allowing them to be downloaded using `dget`.

    >>> for source_file in dspr_view.files:

    ...     print source_file.filename, source_file.http_url

    testing-dspr_1.0.dsc

    http://.../ubuntutest/+archive/primary/+files/testing-dspr_1.0.dsc

The 'sponsor' property indicates whether the upload was 'sponsored' or

not. When the upload was signed by someone else than the source

creator, the upload signer is the sponsor.

    >>> print dspr.creator.displayname

    Foo Bar

    >>> print dspr_view.sponsor

    None

    # Forcibly change the SPR.creator, so the source becomes 'sponsored'.

    >>> from zope.security.proxy import removeSecurityProxy

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

    >>> a_person = factory.makePerson(name='novice')

    >>> removeSecurityProxy(dspr.sourcepackagerelease).creator = a_person

    >>> login(ANONYMOUS)

    >>> dspr_view = create_initialized_view(dspr, name="+index")

    >>> print dspr.creator.displayname

    Novice

    >>> print dspr_view.sponsor.displayname

    Foo Bar

'currently_published' contains only PUBLISHED publications for this

`DistributionSourcePackageRelease` object. Since the testing DSPR only

contains a PENDING publication (see `SoyuzTestPublisher.getPubSource`)

this property is empty.

    >>> len(dspr_view.currently_published)

    0

It gets populated according to the publishing cycle, and subsequent

copies.

    # Publish the pending testing publication.

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

    >>> source.setPublished()

    >>> transaction.commit()

    >>> login(ANONYMOUS)

    >>> dspr_view = create_initialized_view(dspr, name="+index")

    >>> for publishing in dspr_view.currently_published:

    ...     print publishing.distroseries.name

    breezy-autotest

    # Copy the testing publication to another series.

    >>> from lp.soyuz.interfaces.publishing import PackagePublishingPocket

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

    >>> release_pocket =  PackagePublishingPocket.RELEASE

    >>> hoary = stp.ubuntutest.getSeries('hoary-test')

    >>> copied_source = source.copyTo(

    ...     hoary, release_pocket, stp.ubuntutest.main_archive)

    >>> copied_source.setPublished()

    >>> transaction.commit()

    >>> login(ANONYMOUS)

    >>> dspr_view = create_initialized_view(dspr, name="+index")

    >>> for publishing in dspr_view.currently_published:

    ...     print publishing.distroseries.name

    hoary-test

    breezy-autotest

'grouped_builds' returns a list of dictionaries which contains

`IBuild`s for a given `IDistroSeries`.

    >>> def print_grouped_builds():

    ...     for build_group in dspr_view.grouped_builds:

    ...         arch_tags = ' '.join(

    ...             build.arch_tag for build in build_group['builds'])

    ...         print '%s: %s' % (build_group['distroseries'].name, arch_tags)

    ...     print 'END'

    >>> print_grouped_builds()

    END

    # Create default builds for the testing DSPR.

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

    >>> unused = source.createMissingBuilds()

    >>> login(ANONYMOUS)

    >>> dspr_view = create_initialized_view(dspr, name="+index")

    >>> print_grouped_builds()

    breezy-autotest: i386

    END

The returned dictionaries are ordered by descending distroseries

version and their 'builds' are ordered by ascending 'architecturetag'.

    # Create extras builds for the testing DSPR.

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

    >>> hoary_amd64 = hoary['amd64']

    >>> unused = source.sourcepackagerelease.createBuild(

    ...     hoary_amd64, release_pocket, stp.ubuntutest.main_archive)

    >>> breezy_hppa = stp.breezy_autotest['hppa']

    >>> unused = source.sourcepackagerelease.createBuild(

    ...     breezy_hppa, release_pocket, stp.ubuntutest.main_archive)

    >>> login(ANONYMOUS)

    >>> dspr_view = create_initialized_view(dspr, name="+index")

    >>> print_grouped_builds()

    hoary-test: amd64

    breezy-autotest: hppa i386

    END