l.r.i.d.IDistributionSourcePackage(IBugTarget, IHasBranches, IHasMergeProposals, IStructuralSubscriptionTarget, IHasOfficialBugTags) : interface documentation

Part of lp.registry.interfaces.distributionsourcepackage View In Hierarchy

Known implementations: lp.registry.model.distributionsourcepackage.DistributionSourcePackage

Represents a source package in a distribution.

Create IDistributionSourcePackages by invoking IDistribution.getSourcePackage().

Attribute sourcepackagename The source package name.
Attribute summary The summary of binary packages built from this package
Attribute currentrelease The latest published IDistributionSourcePackageRelease of a source package with this name in the distribution or distroseries, or None if no source package with that name is published in this distroseries.
Attribute releases The list of all releases of this source package in this distribution.
Attribute development_version The development version of this source package. 'None' if there is no such package -- this occurs when there is no current series for the distribution.
Attribute total_bug_heat Sum of the bug heat for all the bugs matching the distribution and sourcepackagename of the IDistributionSourcePackage.
Attribute max_bug_heat Maximum bug heat for a single bug matching the distribution and sourcepackagename of the IDistributionSourcePackage.
Attribute bug_count Number of bugs matching the distribution and sourcepackagename of the IDistributionSourcePackage.
Attribute po_message_count Number of translations matching the distribution and sourcepackagename of the IDistributionSourcePackage.
Method getReleasesAndPublishingHistory Return a list of all releases of this source package in this
Attribute publishing_history Return a list of publishing records for this source package in this distribution.
Attribute current_publishing_records Return a list of CURRENT publishing records for this source package in this distribution.
Method getVersion Return the a DistributionSourcePackageRelease with the given
Method get_distroseries_packages Return a list of DistroSeriesSourcePackage objects, each
Method findRelatedArchives Return Archives which publish this source package.
Attribute latest_overall_publication The latest publication for this package across its distribution.
Method bugtasks Bug tasks on this source package, sorted newest first.
Method __eq__ IDistributionSourcePackage comparison method.
Method __ne__ IDistributionSourcePackage comparison method.

Inherited from IBugTarget:

Attribute bugtargetdisplayname A display name for this bug target
Attribute bugtargetname The target as shown in mail notifications.
Method createBug Create a new bug on this target.

Inherited from IHasBugs (via IBugTarget):

Attribute open_bugtasks A list of open bugTasks for this target.
Attribute closed_bugtasks A list of closed bugTasks for this target.
Attribute inprogress_bugtasks A list of in-progress bugTasks for this target.
Attribute high_bugtasks A list of high importance BugTasks for this target.
Attribute critical_bugtasks A list of critical BugTasks for this target.
Attribute new_bugtasks A list of New BugTasks for this target.
Attribute unassigned_bugtasks A list of unassigned BugTasks for this target.
Attribute all_bugtasks A list of all BugTasks ever reported for this target.
Attribute has_bugtasks True if a BugTask has ever been reported for this target.
Method searchTasks Search the IBugTasks reported on this entity.
Method getBugCounts Return a dict with the number of bugs in each possible status.

Inherited from IHasBranches:

Method getBranches Returns all branches with the given lifecycle status.

Inherited from IHasMergeProposals:

Method getMergeProposals Returns all merge proposals of a given status.

Inherited from IStructuralSubscriptionTarget:

Method getSubscriptions Return all the subscriptions with the specified levels.
Attribute parent_subscription_target The target's parent, or None if one doesn't exist.
Method userCanAlterSubscription Check if a user can change a subscription for a person.
Method addSubscription Add a subscription for this structure.
Method userCanAlterBugSubscription Check if a user can change a bug subscription for a person.
Method addBugSubscription Add a bug subscription for this structure.
Method removeBugSubscription Remove a subscription to bugs from this structure.
Method getSubscription Return the subscription for person, if it exists.
Method getBugNotificationsRecipients Return the set of bug subscribers to this target.
Attribute target_type_display The type of the target, for display.
Method userHasBugSubscriptions Is user subscribed, directly or via a team, to bug mail?

Inherited from IHasOfficialBugTags:

Method getUsedBugTags Return the tags used by the context as a sorted list of strings.
Method getUsedBugTagsWithOpenCounts Return name and bug count of tags having open bugs.
Method _getOfficialTagClause Get the storm clause for finding this targets tags.
sourcepackagename =
The source package name.
summary =
The summary of binary packages built from this package
currentrelease =
The latest published IDistributionSourcePackageRelease of a source package with this name in the distribution or distroseries, or None if no source package with that name is published in this distroseries.
releases =
The list of all releases of this source package in this distribution.
development_version =
The development version of this source package. 'None' if there is no such package -- this occurs when there is no current series for the distribution.
total_bug_heat =
Sum of the bug heat for all the bugs matching the distribution and sourcepackagename of the IDistributionSourcePackage.
max_bug_heat =
Maximum bug heat for a single bug matching the distribution and sourcepackagename of the IDistributionSourcePackage.
bug_count =
Number of bugs matching the distribution and sourcepackagename of the IDistributionSourcePackage.
po_message_count =
Number of translations matching the distribution and sourcepackagename of the IDistributionSourcePackage.
def getReleasesAndPublishingHistory():
Return a list of all releases of this source package in this distribution and their corresponding publishing history.

Items in the list are tuples comprised of a DistributionSourcePackage and a list of SourcePackagePublishingHistory objects.

publishing_history =
Return a list of publishing records for this source package in this distribution.
current_publishing_records =
Return a list of CURRENT publishing records for this source package in this distribution.
def getVersion(version):
Return the a DistributionSourcePackageRelease with the given version, or None if there has never been a release with that version in this distribution.
def get_distroseries_packages(active_only=True):
Return a list of DistroSeriesSourcePackage objects, each representing this same source package in the series of this distribution.

By default, this will return SourcePackage's in active distroseries only. You can set only_active=False to return a source package for EVERY series where this source package was published.

def findRelatedArchives(exclude_archive=None, archive_purpose=ArchivePurpose.PPA, required_karma=0):
Return Archives which publish this source package.
Parametersexclude_archivean archive to exclude from the results, used to exclude the current context from which the method is called.
archive_purposeused to filter the results to certain archive purposes. Defaults to PPA.
required_karmaif non-zero then the results will be limited to archives where the creator of the related source package release in that archive has karma greater than the specified value.
ReturnsA ResultSet of non-unique IArchive with the results ordered by the descending package karma.
latest_overall_publication =
The latest publication for this package across its distribution.

The criteria for determining the publication are:
  • Only PUBLISHED or OBSOLETE publications
  • Only updates, security or release pockets
  • PUBLISHED wins over OBSOLETE
  • The latest distroseries wins
  • updates > security > release

See https://bugs.edge.launchpad.net/soyuz/+bug/236922 for a plan on how this criteria will be centrally encoded.

@rename_parameters_as('limit')
@operation_parameters(Int(_('The maximum number of bug tasks to return'), 1))
@operation_returns_collection_of(IBugTask)
@export_operation_as('getBugTasks')
@export_read_operation()
def bugtasks(quantity=None):
Bug tasks on this source package, sorted newest first.

If needed, you can limit the number of bugtasks you are interested in using the quantity parameter.

def __eq__(other):
IDistributionSourcePackage comparison method.

Distro sourcepackages compare equal only if their distribution and sourcepackagename compare equal.

def __ne__(other):
IDistributionSourcePackage comparison method.

Distro sourcepackages compare not equal if either of their distribution or sourcepackagename compare not equal.

API Documentation for Launchpad, generated by pydoctor at 2010-09-27 00:00:11.