lp.soyuz.interfaces.publishing.ISourcePackagePublishingHistoryPublic : API documentation

id =

Undocumented

sourcepackagenameID =

Undocumented

sourcepackagename =

The source package name being published

sourcepackagereleaseID =

Undocumented

sourcepackagerelease =

The source package release being published

distroseriesID =

DB ID for distroseries.

component =

Undocumented

sectionID =

DB ID for the section

section =

Undocumented

supersededby =

Undocumented

removed_byID =

DB ID for removed_by.

meta_sourcepackage =

Return an ISourcePackage meta object correspondent to the sourcepackagerelease attribute inside a specific distroseries

meta_distributionsourcepackagerelease =

Return an IDistributionSourcePackageRelease meta object correspondent to the sourcepackagerelease attribute inside this distribution

newer_distroseries_version =

An IDistroSeriosSourcePackageRelease with a newer version of this package that has been published in the main distribution series, if one exists, or None.

creatorID =

DB ID for creator.

sponsorID =

DB ID for sponsor.

@operation_returns_collection_of(Interface)
@export_read_operation()
def getPublishedBinaries():

Return all resulted IBinaryPackagePublishingHistory.

Follow the build record and return every PUBLISHED or PENDING binary publishing record for any DistroArchSeries in this DistroSeries and in the same IArchive and Pocket, ordered by architecture tag.

Returns a list with all corresponding publishing records.

def getBuiltBinaries():

Return all unique binary publications built by this source.

Follow the build record and return every unique binary publishing record in the context DistroSeries and in the same IArchive and Pocket.

There will be only one entry for architecture independent binary publications.

Returns a list containing all unique IBinaryPackagePublishingHistory.

@operation_returns_collection_of(Interface)
@export_read_operation()
def getBuilds():

Return a list of IBuild objects in this publishing context.

The builds are ordered by DistroArchSeries.architecturetag.

Returns a list of IBuilds.

def getFileByName(name):

Return the file with the specified name.

Only supports 'changelog' at present.

@export_read_operation()
def changesFileUrl():

The .changes file URL for this source publication.

Returns the .changes file URL for this source (a string).

@export_read_operation()
@operation_for_version('devel')
def changelogUrl():

The URL for this source package release's changelog.

Returns the changelog file URL for this source (a string).

def createMissingBuilds(architectures_available=None, logger=None):

Create missing Build records for a published source.

P-a-s should be used when accepting sources to the PRIMARY archive (in drescher). It explicitly ignores given P-a-s for sources targeted to PPAs.

Parameters	architectures_available	options list of `DistroArchSeries` that should be considered for build creation; if not given it will be calculated in place, all architectures for the context distroseries with available chroot.
	logger	optional context Logger object (used on DEBUG level).
Returns	a list of `Builds` created for this source publication.

def getSourceAndBinaryLibraryFiles():

Return a list of LibraryFileAlias for all source and binaries.

All the source files and all binary files ever published to the same archive context are returned as a list of LibraryFileAlias records.

Returns a list of ILibraryFileAlias.

def supersede(dominant=None, logger=None):

Supersede this publication.

Parameters	dominant	optional `ISourcePackagePublishingHistory` which is triggering the domination.
	logger	optional object to which debug information will be logged.

def copyTo(distroseries, pocket, archive, overrides=None, creator=None):

Copy this publication to another location.

Parameters	distroseries	The `IDistroSeries` to copy the source publication into.
	pocket	The `PackagePublishingPocket` to copy into.
	archive	The `IArchive` to copy the source publication into.
	overrides	A tuple of override data as returned from a `IOverridePolicy`.
	creator	the `IPerson` to use as the creator for the copied publication.
	packageupload	The `IPackageUpload` that caused this publication to be created.
Returns	a `ISourcePackagePublishingHistory` record representing the source in the destination location.

def getStatusSummaryForBuilds():

Return a summary of the build status for the related builds.

This method augments IBuildSet.getBuildStatusSummaryForBuilds() by
additionally checking to see if all the builds have been published
before returning the fully-built status.

:return: A dict consisting of the build status summary for the
    related builds. For example:
        {
            'status': PackagePublishingStatus.PENDING,
            'builds': [build1, build2]
        }

@export_read_operation()
@operation_parameters(Bool(_('Include Metadata'), False))
def sourceFileUrls(include_meta=False):

URLs for this source publication's uploaded source files.

Parameters	include_meta	Return a list of dicts with keys url, size, and sha256 for each URL instead of a simple list.
Returns	A collection of URLs for this source.

@export_read_operation()
def binaryFileUrls():

URLs for this source publication's binary files.

Returns A collection of URLs for this source.

@export_read_operation()
@operation_parameters(TextLine(_('To Version'), True))
def packageDiffUrl(to_version):

URL of the debdiff file between this and the supplied version.

Parameters	to_version	The version of the source package for which you want to get the diff to.
Returns	A URL to the librarian file containing the diff.

Attribute	files	Files included in this publication.
Attribute	age	Age of the publishing record.
Method	publish	Publish or ensure contents of this publish record
Method	requestObsolescence	Make this publication obsolete.

Int	id	Undocumented
Int	sourcepackagenameID	Undocumented
Attribute	sourcepackagename	The source package name being published
Int	sourcepackagereleaseID	Undocumented
Attribute	sourcepackagerelease	The source package release being published
Attribute	distroseriesID	DB ID for distroseries.
Int	component	Undocumented
Attribute	sectionID	DB ID for the section
Int	section	Undocumented
Int	supersededby	Undocumented
Attribute	removed_byID	DB ID for removed_by.
Attribute	meta_sourcepackage	Return an ISourcePackage meta object correspondent to the sourcepackagerelease attribute inside a specific distroseries
Attribute	meta_distributionsourcepackagerelease	Return an IDistributionSourcePackageRelease meta object correspondent to the sourcepackagerelease attribute inside this distribution
Attribute	newer_distroseries_version	An `IDistroSeriosSourcePackageRelease` with a newer version of this package that has been published in the main distribution series, if one exists, or None.
Attribute	creatorID	DB ID for creator.
Attribute	sponsorID	DB ID for sponsor.
Method	getPublishedBinaries	Return all resulted `IBinaryPackagePublishingHistory`.
Method	getBuiltBinaries	Return all unique binary publications built by this source.
Method	getBuilds	Return a list of `IBuild` objects in this publishing context.
Method	getFileByName	Return the file with the specified name.
Method	changesFileUrl	The .changes file URL for this source publication.
Method	changelogUrl	The URL for this source package release's changelog.
Method	createMissingBuilds	Create missing Build records for a published source.
Method	getSourceAndBinaryLibraryFiles	Return a list of `LibraryFileAlias` for all source and binaries.
Method	supersede	Supersede this publication.
Method	copyTo	Copy this publication to another location.
Method	getStatusSummaryForBuilds	Return a summary of the build status for the related builds.
Method	sourceFileUrls	URLs for this source publication's uploaded source files.
Method	binaryFileUrls	URLs for this source publication's binary files.
Method	packageDiffUrl	URL of the debdiff file between this and the supplied version.

l.s.i.p.ISourcePackagePublishingHistoryPublic(IPublishingView) : interface documentation