lp.soyuz.interfaces.binarypackagebuild.IBinaryPackageBuildSet : API documentation

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.

Parameters	source_package_release	An `ISourcePackageRelease`.
	archive	An `IArchive` in which context the build is built.
	distro_arch_series	An `IDistroArchSeries`.
	pocket	An item of `PackagePublishingPocket`.
	arch_indep	Build architecture independent packages in addition to architecture specific ones.
	status	A `BuildStatus` item indicating the builds status.
	builder	An optional `IBuilder`.
	buildinfo	An 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.

Parameters	source_package_release	The `ISourcePackageRelease` that is built.
	archive	The `IArchive` containing the build.
	distro_arch_series	The `IDistroArchSeries` built against.

def getBuildsForBuilder(builder_id, status=None, name=None, pocket=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).
	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 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 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 createForSource(sourcepackagerelease, archive, distroseries, pocket, architectures_available=None, logger=None):

Create missing build records for a source.

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.

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