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

Part of lp.buildmaster.interfaces.buildqueue View In Hierarchy

A Launchpad Auto Build queue entry.

This table contains work-in-progress in Buildd environment, as well as incoming jobs.

It relates a pending Builds with an heuristic index (last_score) which is used to order build jobs in a proper way.

When building (job dispatched) it also includes the responsible Builder (builder), the time it has started (buildstarted) and up to 2 Kbytes of the current processing log (logtail).

Attribute id Job identifier
Text logtail The current tail of the log of the job
Int lastscore This job's score.
Bool manual Whether or not the job was manually scored.
Bool virtualized The virtualization setting required by this build farm job.
Choice status The status of this build queue item.
Timedelta estimated_duration Estimated job duration interval.
Timedelta current_build_duration Time spent building so far.
Method manualScore Manually set a score value to a queue item and lock it.
Method score The job score calculated for the job type in question.
Method destroySelf Delete this entry from the database.
Method markAsBuilding Set this queue item to a 'building' state.
Method collectStatus Collect status information from the builder.
Method suspend Suspend this waiting job, removing it from the active queue.
Method resume Resume this suspended job, adding it to the active queue.
Method reset Reset this job, so it can be re-dispatched.
Method cancel Cancel this job, it will not be re-dispatched.
Method markAsCancelled Mark this job's cancellation as completed.
Attribute build_cookie A string which uniquely identifies the job in the build farm.
Datetime date_started Time when the job started.
Method getEstimatedJobStartTime Get the estimated start time for a pending build farm job.
id =
Job identifier
logtail =
The current tail of the log of the job
lastscore =
This job's score.
manual =
Whether or not the job was manually scored.
virtualized =
The virtualization setting required by this build farm job.
status =
The status of this build queue item.
estimated_duration =
Estimated job duration interval.
current_build_duration =
Time spent building so far.
def manualScore(value):
Manually set a score value to a queue item and lock it.
def score():
The job score calculated for the job type in question.
def destroySelf():
Delete this entry from the database.
def markAsBuilding(builder):
Set this queue item to a 'building' state.
def collectStatus(slave_status):
Collect status information from the builder.
def suspend():
Suspend this waiting job, removing it from the active queue.
def resume():
Resume this suspended job, adding it to the active queue.
def reset():
Reset this job, so it can be re-dispatched.
def cancel():
Cancel this job, it will not be re-dispatched.
def markAsCancelled():
Mark this job's cancellation as completed.

Only buildd-manager and cancel() should call this directly. Everyone else wants to use cancel().

build_cookie =
A string which uniquely identifies the job in the build farm.
date_started =
Time when the job started.
def getEstimatedJobStartTime():
Get the estimated start time for a pending build farm job.
Returnsa timestamp upon success or None on failure. None indicates that an estimated start time is not available.
RaisesAssertionError when the build job is not in the JobStatus.WAITING state.
API Documentation for Launchpad, generated by pydoctor at 2019-09-23 00:00:04.