lp.soyuz.interfaces.buildrecords.IHasBuildRecords : API documentation

@rename_parameters_as('source_name')
@operation_parameters(TextLine(_('Source package name'), False), Choice(_('Build status'), False, _('The status of this build record'), BuildStatus), Choice(_('Pocket'), False, True, _('The pocket into which this entry is published'), PackagePublishingPocket))
@call_with(REQUEST_USER, True)
@operation_returns_collection_of(Interface)
@export_read_operation()
@operation_for_version('beta')
def getBuildRecords(build_state=None, name=None, pocket=None, arch_tag=None, user=None, binary_only=True):

Return build records in the context it is implemented.

It excludes build records generated by Gina (imported from a external repository), where IBuild.datebuilt is null and IBuild.buildstate is BuildStatus.FULLYBUILT.

The result is simply not filtered if the optional filters are omitted by call sites.

Parameters	build_state	optional `BuildStatus` value for filtering build records;
	name	optional string for filtering build source package name. Sub-string matching is allowed via SQL LIKE.
	pocket	optional `PackagePublishingPocket` value for filtering build records;
	arch_tag	optional string for filtering build source packages by their architecture tag;
	user	optional `IPerson` corresponding to the user performing the request. It will filter out build records for which the user have no 'view' permission.
	binary_only	optional boolean indicating whether only `BinaryPackageBuild` objects should be returned, or more general `PackageBuild` objects (which may include, for example, `SourcePackageRecipeBuild` objects.
Returns	a result set containing `IPackageBuild` records ordered by descending `IPackageBuild.date_finished` except when builds are filtered by `BuildStatus.NEEDSBUILD`, in this case records are ordered by descending `BuildQueue.lastscore` (dispatching order).

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