l.r.i.w.IDistributionSourcePackage(IHeadingContext, IBugTarget, IHasBranches, IHasMergeProposals, IHasOfficialBugTags, IStructuralSubscriptionTarget, IQuestionTarget, IHasDrivers, IHasGitRepositories, IHasCodeImports) : interface documentation

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

Represents a source package in a distribution.

Create IDistributionSourcePackages by invoking IDistribution.getSourcePackage().

Attribute sourcepackagename The source package name.
Attribute displayname Display name (deprecated)
Attribute is_official Is this source package officially in the distribution?
Attribute summary The summary of binary packages built from this package
Attribute binary_names A list of binary package names 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 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.
Attribute drivers The drivers for the distribution.
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 __eq__ IDistributionSourcePackage comparison method.
Method __ne__ IDistributionSourcePackage comparison method.
Method delete Delete the persistent DSP if it exists.

Inherited from IBugTarget:

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

Inherited from IHasBugs (via IBugTarget):

Method searchTasks Search the IBugTasks reported on this entity.
Method getBugTaskWeightFunction Return a function that is used to weight the bug tasks.

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 IHasOfficialBugTags:

Method getUsedBugTagsWithOpenCounts Return name and bug count of tags having open bugs.
Method _getOfficialTagClause Get the storm clause for finding this targets tags.

Inherited from IStructuralSubscriptionTargetRead (via 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.
Attribute bug_subscriptions All subscriptions to bugs at the METADATA level or higher.
Method userCanAlterSubscription Check if a user can change a subscription for a person.
Method userCanAlterBugSubscription Check if a user can change a bug subscription for a person.
Method getSubscription Return the subscription for person, if it exists.
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 IStructuralSubscriptionTargetWrite (via IStructuralSubscriptionTarget):

Method addSubscription Add a subscription for this structure.
Method addBugSubscription Add a bug subscription for this structure.
Method addBugSubscriptionFilter Add a bug subscription filter for this structure.
Method removeBugSubscription Remove a subscription to bugs from this structure.

Inherited from IQuestionTargetPublic (via IQuestionTarget):

Method getQuestion Return the question by its id, if it is applicable to this target.
Method findSimilarQuestions Return questions similar to phrase.
Method getAnswerContactsForLanguage Return the list of Persons that provide support for a language.
Method getAnswerContactRecipients Return an INotificationRecipientSet of answer contacts.
Method getSupportedLanguages Return a list of languages spoken by at the answer contacts.
List answer_contacts Persons that are willing to provide support for this target. They receive email notifications about each new question as well as for changes to any questions related to this target.
List direct_answer_contacts IPersons that registered as answer contacts explicitely on this target. (answer_contacts may include answer contacts inherited from other context.)
Method canUserAlterAnswerContact Can the user add or remove the answer contact.

Inherited from ISearchableByQuestionOwner (via IQuestionTarget, IQuestionTargetPublic):

Method searchQuestions Return the questions from the collection matching search criteria.

Inherited from IQuestionCollection (via IQuestionTarget, IQuestionTargetPublic, ISearchableByQuestionOwner):

Method getQuestionLanguages Return the set of ILanguage used by all the questions in the

Inherited from IQuestionTargetView (via IQuestionTarget):

Method newQuestion Create a new question.
Method createQuestionFromBug Create and return a Question from a Bug.
Method addAnswerContact Add a new answer contact.
Method removeAnswerContact Remove an answer contact.

Inherited from IHasDrivers:

Method personHasDriverRights Does the given person have launchpad.Driver rights on this object?

Inherited from IHasCodeImports:

Method newCodeImport Create a new code import.
sourcepackagename =
The source package name.
displayname =
Display name (deprecated)
is_official =
Is this source package officially in the distribution?
summary =
The summary of binary packages built from this package
binary_names =
A list of binary package names 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.
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.
drivers =
The drivers for the distribution.
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.launchpad.net/soyuz/+bug/236922 for a plan on how this criteria will be centrally encoded.

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.

def delete():
Delete the persistent DSP if it exists.
ReturnsTrue if a persistent object was removed, otherwise False.
API Documentation for Launchpad, generated by pydoctor at 2022-06-16 00:00:12.