lp.buildmaster.interfaces.buildfarmjob.ISpecificBuildFarmJobSource : API documentation

A utility for retrieving objects of a specific IBuildFarmJob type.

Implementations are registered with their BuildFarmJobType's name.

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 getByID(id):

Look up a concrete IBuildFarmJob by ID.

Parameters id An ID of the concrete job class to look up.

def getByBuildFarmJobs(build_farm_jobs):

"Look up the concrete `IBuildFarmJob`s for a list of BuildFarmJobs.

:param build_farm_jobs: A list of BuildFarmJobs for which to get the
    concrete jobs.

def getByBuildFarmJob(build_farm_job):

"Look up the concrete IBuildFarmJob for a BuildFarmJob.

Parameters build_farm_job A BuildFarmJob for which to get the concrete job.

def addCandidateSelectionCriteria(processor, virtualized):

Provide a sub-query to refine the candidate job selection.

Return a sub-query to narrow down the list of candidate jobs. The sub-query will become part of an "outer query" and is free to refer to the BuildQueue and BuildFarmJob tables already utilized in the latter.

Parameters	processor	the type of processor that the candidate jobs are expected to run on.
	virtualized	whether the candidate jobs are expected to run on the `processor` natively or inside a virtual machine.
Returns	a string containing a sub-query that narrows down the list of candidate jobs.

def postprocessCandidate(job, logger):

True if the candidate job is fine and should be dispatched to a builder, False otherwise.

Parameters	job	The `BuildQueue` instance to be scrutinized.
	logger	The logger to use.
Returns	True if the candidate job should be dispatched to a builder, False otherwise.

l.b.i.b.ISpecificBuildFarmJobSource(Interface) : interface documentation