l.r.i.d.IDistroSeriesPublic(ISeriesMixin, IHasAppointedDriver, IHasOwner, IBugTarget, ISpecificationGoal, IHasMilestones, IHasOfficialBugTags, IHasBuildRecords, IHasTranslationImports, IHasTranslationTemplates, IServiceUsage, IHasExpirableBugs) : interface documentation

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

Known subclasses: lp.registry.interfaces.webservice.IDistroSeries

Public IDistroSeries properties.
Attribute id The distroseries's unique number.
Attribute displayname Display name (deprecated)
Attribute distributionID The distribution ID.
Attribute named_version The combined display name and version.
Attribute parent The structural parent of this series - the distro
Attribute components The series components.
Attribute upload_components The series components that can be uploaded to.
Attribute sections The series sections.
Attribute sourcecount Source Packages Counter
Bool defer_translation_imports Suspends any translation imports for this series
Attribute binarycount Binary Packages Counter
Attribute architecturecount The number of architectures in this series.
Attribute messagecount The total number of translatable items in this series.
Attribute distroserieslanguages The set of dr-languages in this series.
Bool hide_all_translations Undocumented
Choice language_pack_base Language pack with the export of all translations
Choice language_pack_delta Language pack with the export of all translation updates
Choice language_pack_proposed Base or update language pack export that is being tested and
Object last_full_language_pack_exported Undocumented
Object last_delta_language_pack_exported Undocumented
Attribute packagings All of the Packaging entries for this distroseries.
Attribute specifications The specifications targeted to this series.
Attribute language_packs All language packs associated with this distribution series.
Bool backports_not_automatic Set NotAutomatic: yes and ButAutomaticUpgrades: yes in Release
Bool inherit_overrides_from_parents Undocumented
Method isUnstable Whether or not a distroseries is unstable.
Method getLatestUploads Return the latest five source uploads for this DistroSeries.
Attribute architectures All architectures in this series.
Attribute virtualized_architectures All architectures in this series where PPA is supported.
Attribute buildable_architectures All architectures in this series with available chroot tarball.
Method __getitem__ Return the distroarchseries for this distroseries with the
Method __str__ Return the name of the distroseries.
Method getDistroArchSeriesByProcessor Return the distroarchseries for this distroseries with the
Method getDistroArchSeries Return the distroarchseries for this distroseries with the
Method updateStatistics Update all the Rosetta stats for this distro series.
Method updatePackageCount Update the binary and source package counts for this distro
Method getSourcePackage Return a source package in this distro series by name.
Method getTranslatableSourcePackages Return a list of Source packages in this distribution series
Method getPrioritizedUnlinkedSourcePackages Return a list of package summaries that need packaging links.
Method getPrioritizedPackagings Return a list of packagings that need more upstream information.
Method getMostRecentlyLinkedPackagings Return a list of packagings that are the most recently linked.
Method getPackageUploads Get package upload records for this distribution series.
Method getUnlinkedTranslatableSourcePackages Return a list of source packages that can be translated in
Method getBinaryPackage Return a DistroSeriesBinaryPackage for this name.
Method getCurrentSourceReleases Get the current release of a list of source packages.
Method getPublishedSources Return the SourcePackagePublishingHistory(s)
Method getAllPublishedSources Return all currently published sources for the distroseries.
Method getAllUncondemnedSources Return all uncondemned sources for the distroseries.
Method getAllPublishedBinaries Return all currently published binaries for the distroseries.
Method getAllUncondemnedBinaries Return all uncondemned binaries for the distroseries.
Method getDistroSeriesLanguage Return the DistroSeriesLanguage for this distroseries and the
Method getDistroSeriesLanguageOrDummy Return the DistroSeriesLanguage for this distroseries and the
Method createUploadedSourcePackageRelease Create an uploads SourcePackageRelease.
Method getComponentByName Get the named component.
Method getSectionByName Get the named section.
Method addSection SQLObject provided method to fill a related join key section.
Method getBinaryPackagePublishing Get BinaryPackagePublishings in a DistroSeries.
Method getSourcePackagePublishing Return a selectResult of ISourcePackagePublishingHistory.
Method searchPackages Search through the packge cache for this distroseries and return
Method createQueueEntry Create a queue item attached to this distroseries.
Method newArch Create a new port or DistroArchSeries for this DistroSeries.
Method getPOFileContributorsByLanguage People who translated strings to the given language.
Method getSuite Return the suite for this distro series and the given pocket.
Method isSourcePackageFormatPermitted Check if the specified source format is allowed in this series.
Method getDerivedSeries Get all DistroSeries derived from this one.
Method getParentSeries Get all parent DistroSeries.
Method getDifferencesTo Return the differences between this series and the specified
Method isDerivedSeries Is this series a derived series?
Method isInitializing Is this series initializing?
Method isInitialized Has this series been initialized?
Method getInitializationJob Get the last IInitializeDistroSeriesJob for this series.
Method getDifferenceComments Get IDistroSeriesDifferenceComment items.

Inherited from IHasDrivers (via ISeriesMixin):

Attribute drivers A list of drivers
Method personHasDriverRights Does the given person have launchpad.Driver rights on this object?

Inherited from IHasAppointedDriver:

Choice driver Undocumented

Inherited from IHasOwner:

Attribute owner The object's owner, which is an IPerson.

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 ISpecificationTarget (via ISpecificationGoal):

Method getSpecification Returns the specification with the given name, for this target,
Method getAllowedSpecificationInformationTypes Get the InformationTypes for this target's specifications.
Method getDefaultSpecificationInformationType Get the default InformationType for the target's specifications.

Inherited from IHasSpecifications (via ISpecificationGoal, ISpecificationTarget):

Method valid_specifications Valid specifications for this target.

Inherited from IHasMilestones:

Bool has_milestones Undocumented

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

Method getBuildRecords Return build records in the context it is implemented.

Inherited from IHasTranslationImports:

Method getFirstEntryToImport Return the first entry of the queue ready to be imported.
Method getTranslationImportQueueEntries Return entries in the translation import queue for this entity.

Inherited from IHasTranslationTemplates:

Bool has_translation_templates Undocumented
Bool has_current_translation_templates Undocumented
Bool has_obsolete_translation_templates Undocumented
Bool has_sharing_translation_templates Undocumented
Bool has_translation_files Undocumented
Method getTemplatesCollection Return templates as a TranslationTemplatesCollection.
Method getSharingPartner Return the object on the other side of the packaging link.
Method getCurrentTemplatesCollection Return TranslationTemplatesCollection of current templates.
Method getCurrentTranslationTemplates Return an iterator over all active translation templates.
Method getCurrentTranslationFiles Return an iterator over all active translation files.
Method getTranslationTemplates Return an iterator over all its translation templates.
Method getTranslationTemplateByName Return the template with the given name or None.
Method getTranslationTemplateFormats A list of native formats for all current translation templates.

Inherited from IServiceUsage:

Choice answers_usage Where does this pillar have an Answers forum?
Choice blueprints_usage Where does this pillar host blueprints?
Choice codehosting_usage Where does this pillar host code?
Choice bug_tracking_usage Where does this pillar track bugs?
Bool uses_launchpad Undocumented
id =
The distroseries's unique number.
displayname =
Display name (deprecated)
distributionID =
The distribution ID.
named_version =
The combined display name and version.
parent =
The structural parent of this series - the distro
components =
The series components.
upload_components =
The series components that can be uploaded to.
sections =
The series sections.
sourcecount =
Source Packages Counter
defer_translation_imports =
Suspends any translation imports for this series
binarycount =
Binary Packages Counter
architecturecount =
The number of architectures in this series.
messagecount =
The total number of translatable items in this series.
distroserieslanguages =
The set of dr-languages in this series.
hide_all_translations =
Undocumented
language_pack_base =
Language pack with the export of all translations available for this distribution series when it was generated. The subsequent update exports will be generated based on this one.
language_pack_delta =
Language pack with the export of all translation updates available for this distribution series since the language pack base was generated.
language_pack_proposed =
Base or update language pack export that is being tested and proposed to be used as the new language pack base or language pack update for this distribution series.
last_full_language_pack_exported =
Undocumented
last_delta_language_pack_exported =
Undocumented
packagings =
All of the Packaging entries for this distroseries.
specifications =
The specifications targeted to this series.
language_packs =
All language packs associated with this distribution series.
backports_not_automatic =
Set NotAutomatic: yes and ButAutomaticUpgrades: yes in Release files generated for the backports pocket. This tells apt to automatically upgrade within backports, but not into it.
inherit_overrides_from_parents =
Undocumented
def isUnstable():
Whether or not a distroseries is unstable.

The distribution is "unstable" until it is released; after that point, all development on the Release pocket is stopped and development moves on to the other pockets.

def getLatestUploads():
Return the latest five source uploads for this DistroSeries.

It returns a list containing up to five elements as IDistributionSourcePackageRelease instances

architectures =
All architectures in this series.
virtualized_architectures =
All architectures in this series where PPA is supported.
buildable_architectures =
All architectures in this series with available chroot tarball.
def __getitem__(archtag):
Return the distroarchseries for this distroseries with the given architecturetag.
def __str__():
Return the name of the distroseries.
def getDistroArchSeriesByProcessor(processor):
Return the distroarchseries for this distroseries with the given architecturetag from a IProcessor.
ParametersprocessorAn IProcessor
ReturnsAn IDistroArchSeries or None when none was found.
@operation_parameters(TextLine(_('The architecture tag'), True))
@operation_returns_entry(Interface)
@export_read_operation()
def getDistroArchSeries(archtag):
Return the distroarchseries for this distroseries with the given architecturetag.
def updateStatistics(ztm):
Update all the Rosetta stats for this distro series.
def updatePackageCount():
Update the binary and source package counts for this distro series.
@operation_parameters(TextLine(_('The name of the source package'), True))
@operation_returns_entry(ISourcePackage)
@export_read_operation()
def getSourcePackage(name):
Return a source package in this distro series by name.

The name given may be a string or an ISourcePackageName-providing object. The source package may not be published in the distro series.

def getTranslatableSourcePackages():
Return a list of Source packages in this distribution series that can be translated.
def getPrioritizedUnlinkedSourcePackages():
Return a list of package summaries that need packaging links.

A summary is a dict of package (ISourcePackage), total_bugs, and total_messages (translatable messages).

def getPrioritizedPackagings():
Return a list of packagings that need more upstream information.
def getMostRecentlyLinkedPackagings():
Return a list of packagings that are the most recently linked.

At most five packages are returned of those most recently linked to an upstream.

@operation_parameters(Datetime(_('Created Since Timestamp'), _('Return items that are more recent than this timestamp.'), False), Choice(PackageUploadStatus, _('Package Upload Status'), _('Return only items that have this status.'), False), Reference(Interface, _('Archive'), _('Return only items for this archive.'), False), Choice(PackagePublishingPocket, _('Pocket'), _('Return only items targeted to this pocket'), False), Choice(PackageUploadCustomFormat, _('Custom Type'), _('Return only items with custom files of this type.'), False), TextLine(_('Package or file name'), False), TextLine(_('Package version'), False), Bool(_('Exact match'), _('Whether to filter name and version by exact matching.'), False))
@operation_returns_collection_of(Interface)
@export_read_operation()
def getPackageUploads(status=None, created_since_date=None, archive=None, pocket=None, custom_type=None, name=None, version=None, exact_match=False):
Get package upload records for this distribution series.
ParametersstatusFilter results by this PackageUploadStatus, or list of statuses.
created_since_dateIf specified, only returns items uploaded since the timestamp supplied.
archiveFilter results for this IArchive.
pocketFilter results by this PackagePublishingPocket or a list of PackagePublishingPocket.
custom_typeFilter results by this PackageUploadCustomFormat.
nameFilter results by this file name or package name.
versionFilter results by this version number string.
exact_matchIf True, look for exact string matches on the name and version filters. If False, look for a substring match so that e.g. a package "kspreadsheetplusplus" would match the search string "spreadsheet". Defaults to False.
ReturnsA result set containing IPackageUpload.
def getUnlinkedTranslatableSourcePackages():
Return a list of source packages that can be translated in this distribution series but which lack Packaging links.
def getBinaryPackage(name):
Return a DistroSeriesBinaryPackage for this name.

The name given may be an IBinaryPackageName or a string. The binary package may not be published in the distro series.

def getCurrentSourceReleases(source_package_names):
Get the current release of a list of source packages.
Parameterssource_package_namesa list of ISourcePackageName instances.
Returnsa dict where the key is a ISourcePackage and the value is a IDistributionSourcePackageRelease.
def getPublishedSources(sourcepackage_or_name, pocket=None, version=None, include_pending=False, archive=None):
Return the SourcePackagePublishingHistory(s)

Deprecated. Use IArchive.getPublishedSources instead.

Given a ISourcePackageName or name.

If pocket is not specified, we look in all pockets.

If version is not specified, return packages with any version.

If 'include_pending' is True, we return also the pending publication records, those packages that will get published in the next publisher run (it's only useful when we need to know if a given package is known during a publisher run, mostly in pre-upload checks)

If 'archive' is not specified consider publication in the main_archive, otherwise respect the given value.

def getAllPublishedSources():
Return all currently published sources for the distroseries.

Return publications in the main archives only.

def getAllUncondemnedSources():
Return all uncondemned sources for the distroseries.

An uncondemned publication is one without scheduleddeletiondate set.

Return publications in the main archives only.

def getAllPublishedBinaries():
Return all currently published binaries for the distroseries.

Return publications in the main archives only.

def getAllUncondemnedBinaries():
Return all uncondemned binaries for the distroseries.

An uncondemned publication is one without scheduleddeletiondate set.

Return publications in the main archives only.

def getDistroSeriesLanguage(language):
Return the DistroSeriesLanguage for this distroseries and the given language, or None if there's no DistroSeriesLanguage for this distribution and the given language.
def getDistroSeriesLanguageOrDummy(language):
Return the DistroSeriesLanguage for this distroseries and the given language, or a DummyDistroSeriesLanguage.
def createUploadedSourcePackageRelease(sourcepackagename, version, maintainer, builddepends, builddependsindep, architecturehintlist, component, creator, urgency, changelog, changelog_entry, dsc, dscsigningkey, section, dsc_maintainer_rfc822, dsc_standards_version, dsc_format, dsc_binaries, archive, copyright, build_conflicts, build_conflicts_indep, dateuploaded=None, source_package_recipe_build=None, user_defined_fields=None, homepage=None, buildinfo=None):

Create an uploads SourcePackageRelease.

Set this distroseries set to be the uploadeddistroseries.

All arguments are mandatory, they are extracted/built when processing and uploaded source package:

Parametersdateuploadedtimestamp, if not provided will be UTC_NOW
sourcepackagenameISourcePackageName
versionstring, a debian valid version
maintainerIPerson designed as package maintainer
creatorIPerson, package uploader
componentIComponent
sectionISection
urgencydbschema.SourcePackageUrgency
dscsigningkeyIGPGKey used to sign the DSC file
dscstring, original content of the dsc file
copyrightstring, the original debian/copyright content
changelogLFA ID of the debian/changelog file in librarian
changelog_entrystring, changelog extracted from the changesfile
architecturehintliststring, DSC architectures
builddependsstring, DSC build dependencies
builddependsindepstring, DSC architecture independent build dependencies.
build_conflictsstring, DSC Build-Conflicts content
build_conflicts_indepstring, DSC Build-Conflicts-Indep content
dsc_maintainer_rfc822string, DSC maintainer field
dsc_standards_versionstring, DSC standards version field
dsc_formatstring, DSC format version field
dsc_binariesstring, DSC binaries field
archiveIArchive to where the upload was targeted
dateuploadedoptional datetime, if omitted assumed nowUTC
source_package_recipe_buildoptional SourcePackageRecipeBuild
user_defined_fieldsoptional sequence of key-value pairs with user defined fields.
homepageoptional string with (unchecked) upstream homepage URL
buildinfooptional LFA with build information file
Returnsthe just creates SourcePackageRelease
def getComponentByName(name):
Get the named component.

Raise NotFoundError if the component is not in the permitted component list for this distroseries.

def getSectionByName(name):
Get the named section.

Raise NotFoundError if the section is not in the permitted section list for this distroseries.

def addSection(section):
SQLObject provided method to fill a related join key section.
def getBinaryPackagePublishing(archtag, pocket, component, archive):
Get BinaryPackagePublishings in a DistroSeries.

Can optionally restrict the results by architecturetag, pocket and/or component.

If archive is passed, restricted the results to the given archive, if it is suppressed the results will be restricted to the distribution 'main_archive'.

def getSourcePackagePublishing(pocket, component, archive):
Return a selectResult of ISourcePackagePublishingHistory.

According status and pocket. If archive is passed, restricted the results to the given archive, if it is suppressed the results will be restricted to the distribution 'main_archive'.

def searchPackages(text):
Search through the packge cache for this distroseries and return DistroSeriesBinaryPackage objects that match the given text.
def createQueueEntry(pocket, archive, changesfilename=None, changesfilecontent=None, changes_file_alias=None, signingkey=None, package_copy_job=None):
Create a queue item attached to this distroseries.

Create a new PackageUpload to the given pocket and archive.

The default state is NEW. Any further state changes go through the Queue state-machine.

ParameterspocketThe PackagePublishingPocket to upload to.
archiveThe Archive to upload to. Must be for the same Distribution as this series.
changesfilenameName for the upload's .changes file. You may specify a changes file by passing both changesfilename and changesfilecontent, or by passing changes_file_alias.
changesfilecontentText for the changes file. It will be signed and stored in the Librarian. Must be passed together with changesfilename; alternatively, you may provide a changes_file_alias to replace both of these.
changes_file_aliasA LibraryFileAlias containing the .changes file. Security warning: unless the file has already been checked, this may open us up to replay attacks as per bugs 159304 and 451396. Use changes_file_alias only if you know this can't happen.
signingkeyIGPGKey used to sign the changes file, or None if it is unsigned.
ReturnsA new PackageUpload.
def newArch(architecturetag, processor, official, owner, enabled=True):
Create a new port or DistroArchSeries for this DistroSeries.
def getPOFileContributorsByLanguage(language):
People who translated strings to the given language.

The people that translated only IPOTemplate objects that are not current will not appear in the returned list.

def getSuite(pocket):
Return the suite for this distro series and the given pocket.
ParameterspocketA DBItem of PackagePublishingPocket.
ReturnsA string.
def isSourcePackageFormatPermitted(format):
Check if the specified source format is allowed in this series.
ParametersformatThe SourcePackageFormat to check.
@operation_returns_collection_of(Interface)
@export_read_operation()
def getDerivedSeries():
Get all DistroSeries derived from this one.
@operation_returns_collection_of(Interface)
@export_read_operation()
def getParentSeries():
Get all parent DistroSeries.
@operation_parameters(Reference(Interface, _('The parent series to consider.'), False), Choice(DistroSeriesDifferenceType, _('Only return differences of this type.'), False), TextLine(_('Only return differences for packages matching this name.'), False), Choice(DistroSeriesDifferenceStatus, _('Only return differences of this status.'), False), Bool(_("Only return differences for which the child's version is higher than the parent's."), False))
@operation_returns_collection_of(Interface)
@export_read_operation()
@operation_for_version('devel')
def getDifferencesTo(parent_series, difference_type, source_package_name_filter, status, child_version_higher):
Return the differences between this series and the specified parent_series (or all the parent series if parent_series is None).
Parametersparent_seriesThe parent series for which the differences should be returned. All parents are considered if this is None.
difference_typeThe type of the differences to return.
source_package_name_filterA package name to use as a filter for the differences.
statusThe status of the differences to return.
child_version_higherOnly return differences for which the child's version is higher than the parent's version.
def isDerivedSeries():
Is this series a derived series?

A derived series has one or more parent series.

def isInitializing():
Is this series initializing?
def isInitialized():
Has this series been initialized?
def getInitializationJob():
Get the last IInitializeDistroSeriesJob for this series.
ReturnsNone if no job is found or an IInitializeDistroSeriesJob.
@operation_parameters(Datetime(_('Minimum creation timestamp'), _('Ignore comments that are older than this.'), False), TextLine(_('Name of source package'), _('Only return comments for this source package.'), False))
@operation_returns_collection_of(Interface)
@export_read_operation()
@operation_for_version('devel')
def getDifferenceComments(since=None, source_package_name=None):
Get IDistroSeriesDifferenceComment items.
ParameterssinceIgnore comments older than this timestamp.
source_package_nameReturn only comments for a source package with this name.
ReturnsA Storm result set of IDistroSeriesDifferenceComment objects for this distroseries, ordered from oldest to newest comment.
API Documentation for Launchpad, generated by pydoctor at 2022-06-16 00:00:12.