l.s.i.s.ISourcePackageRelease(Interface) : interface documentation

Part of lp.soyuz.interfaces.sourcepackagerelease View In Hierarchy

Known subclasses: lp.soyuz.interfaces.distributionsourcepackagerelease.IDistributionSourcePackageRelease, lp.soyuz.interfaces.reporting.ILatestPersonSourcePackageReleaseCache

A source package release, e.g. apache-utils 2.0.48-3
Attribute id SourcePackageRelease identifier
Attribute creatorID DB ID of creator
Attribute creator Person that created this release
Attribute maintainerID DB ID of the maintainer
Attribute maintainer The person in general responsible for this release
Attribute version A version string
Attribute dateuploaded Date of Upload
Attribute urgency Source Package Urgency
Attribute signing_key_owner Signing key owner
Attribute signing_key_fingerprint Signing key fingerprint
Attribute component Source Package Component
Attribute format The Source Package Format
Attribute changelog LibraryFileAlias containing debian/changelog.
Attribute changelog_entry Source Package Change Log Entry
Attribute change_summary The message on the latest change in this release. This is usually a snippet from the changelog
Attribute buildinfo LibraryFileAlias containing build information for this source upload, if any.
TextLine builddepends A comma-separated list of packages on which this package depends to build
TextLine builddependsindep Same as builddepends, but the list is of arch-independent packages
TextLine build_conflicts Binaries that will conflict when building this source.
TextLine build_conflicts_indep Same as build-conflicts but only lists arch-independent binaries.
TextLine architecturehintlist Architectures where this packages is supposed to be built
TextLine dsc_maintainer_rfc822 Original maintainer line contained in the DSC file.
TextLine dsc_standards_version DSC standards version used to build this source.
TextLine dsc_format DSC file format used to upload this source
TextLine dsc_binaries Binaries claimed to be generated by this source.
Attribute dsc The DSC file for this SourcePackageRelease
Attribute copyright Copyright information for this SourcePackageRelease, if available.
Attribute section Section this Source Package Release belongs to
Attribute builds Builds for this sourcepackagerelease excluding PPA archives.
Attribute files IBinaryPackageFile entries for this sourcepackagerelease
Attribute sourcepackagename SourcePackageName table reference
Attribute sourcepackagenameID SourcePackageName id.
Attribute upload_distroseries The distroseries in which this package was first uploaded in Launchpad
Attribute publishings MultipleJoin on SourcepackagePublishing
List user_defined_fields Undocumented
TextLine homepage Upstream project homepage as set in the package. This URL is not sanitized.
Attribute name The sourcepackagename for this release, as text
Attribute title The title of this sourcepackagerelease
Attribute age Time passed since the source package release is present in Launchpad
Attribute failed_builds A (potentially empty) list of build failures that happened for this source package release, or None
Attribute needs_building A boolean that indicates whether this package still needs to be built (on any architecture)
Attribute published_archives A set of all the archives that this source package is published in.
Attribute upload_archive The archive for which this package was first uploaded in Launchpad
Attribute upload_changesfile The LibraryFileAlias object containing the changes file which was originally uploaded with this source package release. It's 'None' if it is a source imported by Gina.
Attribute package_upload The PackageUpload record corresponding to original upload of this source package release. It's 'None' if it is a source imported by Gina.
Attribute uploader The user who uploaded the package.
Method getUserDefinedField Case-insensitively get a user-defined field.
Method addFile Add the provided library file alias (file) to the list of files
Method getFileByName Return the corresponding ILibraryFileAlias in this context.
Method override Uniform method to override sourcepackagerelease attribute.
Attribute package_diffs All IPackageDiff generated from this context.
Method getDiffTo Return an IPackageDiff to a given ISourcePackageRelease.
Method requestDiffTo Request a package diff from the context source to a given source.
Method getPackageSize Get the size total (in KB) of files comprising this package.
Method aggregate_changelog Get all the changelogs since the version specified.
id =
SourcePackageRelease identifier
creatorID =
DB ID of creator
creator =
Person that created this release
maintainerID =
DB ID of the maintainer
maintainer =
The person in general responsible for this release
version =
A version string
dateuploaded =
Date of Upload
urgency =
Source Package Urgency
signing_key_owner =
Signing key owner
signing_key_fingerprint =
Signing key fingerprint
component =
Source Package Component
format =
The Source Package Format
changelog =
LibraryFileAlias containing debian/changelog.
changelog_entry =
Source Package Change Log Entry
change_summary =
The message on the latest change in this release. This is usually a snippet from the changelog
buildinfo =
LibraryFileAlias containing build information for this source upload, if any.
builddepends =
A comma-separated list of packages on which this package depends to build
builddependsindep =
Same as builddepends, but the list is of arch-independent packages
build_conflicts =
Binaries that will conflict when building this source.
build_conflicts_indep =
Same as build-conflicts but only lists arch-independent binaries.
architecturehintlist =
Architectures where this packages is supposed to be built
dsc_maintainer_rfc822 =
Original maintainer line contained in the DSC file.
dsc_standards_version =
DSC standards version used to build this source.
dsc_format =
DSC file format used to upload this source
dsc_binaries =
Binaries claimed to be generated by this source.
dsc =
The DSC file for this SourcePackageRelease
copyright =
Copyright information for this SourcePackageRelease, if available.
section =
Section this Source Package Release belongs to
builds =
Builds for this sourcepackagerelease excluding PPA archives.
files =
IBinaryPackageFile entries for this sourcepackagerelease
sourcepackagename =
SourcePackageName table reference
sourcepackagenameID =
SourcePackageName id.
upload_distroseries =
The distroseries in which this package was first uploaded in Launchpad
publishings =
MultipleJoin on SourcepackagePublishing
user_defined_fields =
Undocumented
homepage =
Upstream project homepage as set in the package. This URL is not sanitized.
name =
The sourcepackagename for this release, as text
title =
The title of this sourcepackagerelease
age =
Time passed since the source package release is present in Launchpad
failed_builds =
A (potentially empty) list of build failures that happened for this source package release, or None
needs_building =
A boolean that indicates whether this package still needs to be built (on any architecture)
published_archives =
A set of all the archives that this source package is published in.
upload_archive =
The archive for which this package was first uploaded in Launchpad
upload_changesfile =
The LibraryFileAlias object containing the changes file which was originally uploaded with this source package release. It's 'None' if it is a source imported by Gina.
package_upload =
The PackageUpload record corresponding to original upload of this source package release. It's 'None' if it is a source imported by Gina.
uploader =
The user who uploaded the package.
def getUserDefinedField(name):
Case-insensitively get a user-defined field.
def addFile(file, filetype=None):
Add the provided library file alias (file) to the list of files in this package.
def getFileByName(filename):
Return the corresponding ILibraryFileAlias in this context.

The following file types (and extension) can be looked up in the SourcePackageRelease context:

  • Source files: '.orig.tar.gz', 'tar.gz', '.diff.gz' and '.dsc'.

:raises NotFoundError if no file could be found.

:return the corresponding ILibraryFileAlias if the file was found.

Parametersfilenamethe exact filename to be looked up.
def override(component=None, section=None, urgency=None):
Uniform method to override sourcepackagerelease attribute.

All arguments are optional and can be set individually. A non-passed argument remains untouched.

package_diffs =
All IPackageDiff generated from this context.
def getDiffTo(to_sourcepackagerelease):
Return an IPackageDiff to a given ISourcePackageRelease.

Return None if it was not yet requested.

def requestDiffTo(requester, to_sourcepackagerelease):
Request a package diff from the context source to a given source.
Parametersrequester: it's the diff requester, any valid IPerson;
to_source: it's the ISourcePackageRelease to diff against.
Returnsthe corresponding IPackageDiff record.
RaisesPackageDiffAlreadyRequestedwhen there is already a PackageDiff record matching the request being made.
def getPackageSize():
Get the size total (in KB) of files comprising this package.

Please note: empty packages (i.e. ones with no files or with files that are all empty) have a size of zero.

Returnstotal size (in KB) of this package
def aggregate_changelog(since_version):
Get all the changelogs since the version specified.
Parameterssince_versionReturn changelogs of all versions after since_version up to and including the version of the sourcepackagerelease for this publication.
ReturnsA concatenated set of changelogs of all the required versions, with a blank line between each. If there is no changelog, or there is an error parsing it, None is returned.
API Documentation for Launchpad, generated by pydoctor at 2022-06-16 00:00:12.