lp.soyuz.interfaces.build.IBuildSet : API documentation

Method	getBuildBySRAndArchtag	Return a build for a SourcePackageRelease and an ArchTag
Method	getByBuildID	Return the exact build specified.
Method	getPendingBuildsForArchSet	Return all pending build records within a group of ArchSeries
Method	getBuildsForBuilder	Return build records touched by a builder.
Method	getBuildsForArchive	Return build records targeted to a given IArchive.
Method	getBuildsByArchIds	Retrieve Build Records for a given arch_ids list.
Method	retryDepWaiting	Re-process all MANUALDEPWAIT builds for a given IDistroArchSeries.
Method	getBuildsBySourcePackageRelease	Return all builds related with the given list of source releases.
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	getQueueEntriesForBuildIDs	Return the IBuildQueue instances for the IBuild IDs at hand.
Method	calculateCandidates	Return the BuildQueue records for the given archseries's Builds.

def getByBuildID(id):

Return the exact build specified.

id is the numeric ID of the build record in the database. I.E. getUtility(IBuildSet).getByBuildID(foo).id == foo

def getPendingBuildsForArchSet(archseries):

Return all pending build records within a group of ArchSeries

Pending means that buildstate is NEEDSBUILD.

def getBuildsForBuilder(builder_id, status=None, name=None, arch_tag=None):

Return build records touched by a builder.

Parameters	builder_id	The id of the builder for which to find builds.
	status	If status is provided, only builds with that status will be returned.
	name	If name is provided, only builds which correspond to a matching sourcepackagename will be returned (SQL LIKE).
	arch_tag	If arch_tag is provided, only builds for that architecture will be returned.
Returns	a `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.

Parameters	archive	The archive for which builds will be returned.
	status	If status is provided, only builders with that status will be returned.
	name	If name is passed, return only build which the sourcepackagename matches (SQL LIKE).
	pocket	If pocket is provided only builds for that pocket will be returned.
	arch_tag	If arch_tag is provided, only builds for that architecture will be returned.
Returns	a `ResultSet` representing the requested builds.

def getBuildsByArchIds(arch_ids, status=None, name=None, pocket=None):

Retrieve Build Records for a given arch_ids list.

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 retryDepWaiting(distroarchseries):

Re-process all MANUALDEPWAIT builds for a given IDistroArchSeries.

This method will update all the dependency lines of all MANUALDEPWAIT records in the given architecture and those with all dependencies satisfied at this point will be automatically retried and re-scored.

def getBuildsBySourcePackageRelease(sourcepackagerelease_ids, buildstate=None):

Return all builds related with the given list of source releases.

: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 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 getQueueEntriesForBuildIDs(build_ids):

Return the IBuildQueue instances for the IBuild IDs at hand.

Retrieve the build queue and related builder rows associated with the builds in question where they exist.

def calculateCandidates(archseries):

Return the BuildQueue records for the given archseries's Builds.

Returns a selectRelease of BuildQueue items for sorted by descending 'lastscore' for Builds within the given archseries.

'archseries' argument should be a list of DistroArchSeries and it is asserted to not be None/empty.

l.s.i.b.IBuildSet(Interface) : interface documentation