lp.registry.interfaces.distroseriesdifference.IDistroSeriesDifferenceSource : API documentation

Method	new	Create an `IDistroSeriesDifference`.
Method	getForDistroSeries	Return differences for the derived distro series sorted by
Method	getByDistroSeriesNameAndParentSeries	Returns a single difference matching the series, name and parent
Method	getSimpleUpgrades	Find pending upgrades that can be performed mindlessly.

def new(derived_series, source_package_name, parent_series):

Create an IDistroSeriesDifference.

Parameters	derived_series	The distribution series which was derived from a parent. If a series without a parent is passed an exception is raised. (type: `IDistroSeries`.)
	source_package_name	A source package name identifying the package with a difference. (type: `ISourcePackageName`.)
	parent_series	The distribution series which has the derived series as a child. If there is only one parent, it does not need to be specified. (type: `IDistroSeries`.)
Returns	A new `DistroSeriesDifference` object.
Raises	NotADerivedSeriesError	When the passed distro series is not a derived series.

def getForDistroSeries(distro_series, difference_type=None, name_filter=None, status=None, child_version_higher=False, parent_series=None, packagesets=None, changed_by=None):

Return differences for the derived distro series sorted by
package name.

:param distro_series: The derived distribution series which is to be
    searched for differences.
:type distro_series: `IDistroSeries`.
:param difference_type: The type of difference to include in the
    results.
:type difference_type: `DistroSeriesDifferenceType`.
:param name_filter: Name of either a source package or a package set
    to look for.  If given, return only packages whose name matches
    this string, or that are in a `Packageset` those name matches it.
:type name_filter: unicode.
:param status: Only differences matching the status(es) will be
    included.
:type status: `DistroSeriesDifferenceStatus`.
:param child_version_higher: Only differences for which the child's
    version is higher than the parent's version will be included.
:type child_version_higher: bool.
:param parent_series: The parent series to consider. Consider all
    parent series if this parameter is None.
:type distro_series: `IDistroSeries`.
:param packagesets: Optional iterable of `Packageset` to filter by.
:param changed_by: An optional `Person` (an individual or a team) or a
    collection of `Person`s. The results are limited to only those
    changes made by the given people.
:return: A result set of `IDistroSeriesDifference`.

def getByDistroSeriesNameAndParentSeries(distro_series, source_package_name, parent_series):

Returns a single difference matching the series, name and parent
series.

:param distro_series: The derived distribution series which is to be
    searched for differences.
:type distro_series: `IDistroSeries`.
:param source_package_name: The name of the package difference.
:type source_package_name: unicode.
:param parent_series: The parent distribution series of the package
difference.
:type distro_series: `IDistroSeries`.

def getSimpleUpgrades(distro_series):

Find pending upgrades that can be performed mindlessly.

These are DistroSeriesDifferences where the parent has been updated and the child still has the old version, unchanged.

Blacklisted items are excluded.

l.r.i.d.IDistroSeriesDifferenceSource(Interface) : interface documentation