l.s.i.b.IBinaryPackageBuildSet(ISpecificBuildFarmJobSource) : interface documentation

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

Interface for BinaryPackageBuildSet
Method new Create a new IBinaryPackageBuild.
Method getBySourceAndLocation Return a build by its source, archive and architecture.
Method getBuildsForBuilder Return build records touched by a builder.
Method getBuildsForArchive Return build records targeted to a given IArchive.
Method getBuildsForDistro Retrieve `IBinaryPackageBuild`s for a given Distribution/DS/DAS.
Method getBuildsBySourcePackageRelease Return all builds related with the given list of source releases.
Method findBuiltOrPublishedBySourceAndArchive Find all successful builds for source relevant to an Archive.
Method getStatusSummaryForBuilds Return a summary of the build status for the given builds.
Method getByQueueEntry Return an IBuild instance for the given build queue entry.
Method preloadBuildsData Prefetch the data related to the builds.
Method createForSource Create missing build records for a source.

Inherited from ISpecificBuildFarmJobSource:

Method getByID Look up a concrete IBuildFarmJob by ID.
Method getByBuildFarmJobs "Look up the concrete `IBuildFarmJob`s for a list of BuildFarmJobs.
Method getByBuildFarmJob "Look up the concrete IBuildFarmJob for a BuildFarmJob.
Method addCandidateSelectionCriteria Provide a sub-query to refine the candidate job selection.
Method postprocessCandidate True if the candidate job is fine and should be dispatched
def new(source_package_release, archive, distro_arch_series, pocket, arch_indep=False, status=BuildStatus.NEEDSBUILD, builder=None, buildinfo=None):
Create a new IBinaryPackageBuild.
Parameterssource_package_releaseAn ISourcePackageRelease.
archiveAn IArchive in which context the build is built.
distro_arch_seriesAn IDistroArchSeries.
pocketAn item of PackagePublishingPocket.
arch_indepBuild architecture independent packages in addition to architecture specific ones.
statusA BuildStatus item indicating the builds status.
builderAn optional IBuilder.
buildinfoAn optional ILibraryFileAlias.
def getBySourceAndLocation(source_package_release, archive, distro_arch_series):
Return a build by its source, archive and architecture.

This is the natural key, and lookups don't consider copies between archives, just the archive in which the build originally occurred.

Parameterssource_package_releaseThe ISourcePackageRelease that is built.
archiveThe IArchive containing the build.
distro_arch_seriesThe IDistroArchSeries built against.
def getBuildsForBuilder(builder_id, status=None, name=None, pocket=None, arch_tag=None):
Return build records touched by a builder.
Parametersbuilder_idThe id of the builder for which to find builds.
statusIf status is provided, only builds with that status will be returned.
nameIf name is provided, only builds which correspond to a matching sourcepackagename will be returned (SQL LIKE).
pocketIf pocket is provided, only builds for that pocket will be returned.
arch_tagIf arch_tag is provided, only builds for that architecture will be returned.
Returnsa ResultSet representing the requested builds.
def getBuildsForArchive(archive, status=None, name=None, pocket=None, arch_tag=None):
Return build records targeted to a given IArchive.
ParametersarchiveThe archive for which builds will be returned.
statusIf status is provided, only builders with that status will be returned.
nameIf name is passed, return only build which the sourcepackagename matches (SQL LIKE).
pocketIf pocket is provided only builds for that pocket will be returned.
arch_tagIf arch_tag is provided, only builds for that architecture will be returned.
Returnsa ResultSet representing the requested builds.
def getBuildsForDistro(context, status=None, name=None, pocket=None, arch_tag=None):
Retrieve `IBinaryPackageBuild`s for a given Distribution/DS/DAS.

Optionally, for a given status and/or pocket, if ommited return all
records. If name is passed return only the builds which the
sourcepackagename matches (SQL LIKE).
def getBuildsBySourcePackageRelease(sourcepackagerelease_ids, buildstate=None):
Return all builds related with the given list of source releases.

Eager loads the PackageBuild and BuildFarmJob records for the builds.

:param sourcepackagerelease_ids: list of `ISourcePackageRelease`s;
:param buildstate: option build state filter.

:return: a list of `IBuild` records not target to PPA archives.
def findBuiltOrPublishedBySourceAndArchive(sourcepackagerelease, archive):
Find all successful builds for source relevant to an Archive.

This includes all successful builds for the source directly in
this archive, and any that had their binaries copied into this
archive.

:return: A dict mapping architecture tags (in string form,
    e.g. 'i386') to `BinaryPackageBuild`s for that build.
def getStatusSummaryForBuilds(builds):
Return a summary of the build status for the given builds.

The returned summary includes a status, a description of
that status and the builds related to the status.

:param builds: A list of build records.
:type builds: ``list``
:return: A dict consisting of the build status summary for the
    given builds. For example:
        {
            'status': BuildSetStatus.FULLYBUILT,
            'builds': [build1, build2]
        }
    or, an example where there are currently some builds building:
        {
            'status': BuildSetStatus.BUILDING,
            'builds':[build3]
        }
:rtype: ``dict``.
def getByQueueEntry(queue_entry):
Return an IBuild instance for the given build queue entry.

Retrieve the only one possible build record associated with the given build queue entry. If not found, return None.

def preloadBuildsData(builds):
Prefetch the data related to the builds.
def createForSource(sourcepackagerelease, archive, distroseries, pocket, architectures_available=None, logger=None):
Create missing build records for a source.
Parametersarchitectures_availableoptions 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.
loggeroptional context Logger object (used on DEBUG level).
Returnsa list of Builds created for this source publication.
API Documentation for Launchpad, generated by pydoctor at 2019-08-19 00:00:07.