Finds branches by URL.
Either from the external specified in Branch.url, from the URL on http://bazaar.launchpad.net/, or from the lp: URL.
This is a frontend shim to IBranchLookup.getByUrls to allow it to be exported over the API. If you want to call this from within the Launchpad app, use the IBranchLookup version instead.
| param urls: | An iterable of URLs expressed as strings. |
|---|---|
| return: | A dictionary mapping URLs to branches. If the URL has no associated branch, the URL will map to None. |
A list of URLs of branches
These can be URLs external to Launchpad, lp: URLs, or http://bazaar.launchpad.net/ URLs, or any mix of all these different kinds.
Find a branch by its ~owner/product/name unique name.
Return None if no match was found.
Find a branch by URL.
Either from the external specified in Branch.url, from the URL on http://bazaar.launchpad.net/ or the lp: URL.
This is a frontend shim to IBranchLookup.getByUrl to allow it to be exported over the API. If you want to call this from within the Launchpad app, use the IBranchLookup version instead.
Return None if no match was found.
A set of IBugTracker's.
Each BugTracker is a distinct instance of a bug tracking tool. For example, bugzilla.mozilla.org is distinct from bugzilla.gnome.org.
Get a BugTracker by its name.
If no tracker with the given name exists, return default.
Make sure that there is a bugtracker for the given base url.
If not, create one using the given attributes.
Location
The top-level URL for the bug tracker, or an upstream email address. This must be accurate so that Launchpad can link to external bug reports.
Title
A descriptive label for this tracker to show in listings.
Summary
A brief introduction or overview of this bug tracker instance.
Contact details
The contact details for the external bug tracker (so that, for example, its administrators can be contacted about a security breach).
Name
A URL-friendly name for the bug tracker, such as "mozilla-bugs".
Collections of builders.
IBuilderSet provides access to all Builders in the system, and also acts as a Factory to allow the creation of new Builders. Methods on this interface should deal with the set of Builders: methods that affect a single Builder should be on IBuilder.
The collection of languages.
The standard get method will return only the visible languages. If you want to access all languages known to Launchpad, use the getAllLanguages method.
Search the IBugTasks reported on this entity.
| search_params: | a BugTaskSearchParams object |
|---|
Return an iterable of matching results.
Note: milestone is currently ignored for all IBugTargets except IProduct.
Status upstream
Indicates the status of any remote watches associated with the bug. Possible values include: pending_bugwatch, hide_upstream, resolved_upstream, and open_upstream.
Tags
String or list of strings for tags to search. To exclude, prepend a '-', e.g. '-unwantedtag'
Status
Show only bugs with the given status value or list of values.
Tags combination
Search for any or all of the tags specified.
Component
Distribution package archive grouping. E.g. main, universe, multiverse
Importance
Show only bugs with the given importance or list of importances.
Information Type
Show only bugs with the given information type or list of information types.
Milestone
Show only bug tasks targeted to this milestone.
Create a bug (with an appropriate bugtask) and return it.
| param target: | The Project, Distribution or DistributionSourcePackage affected by this bug. |
|---|---|
| param title: | The title shown in bug listings. |
| param description: | |
| The description of the issue. | |
| param information_type: | |
| Set the bug's information type to one different from the project's default. The type must conform to the project's bug sharing policy. (optional) | |
| param tags: | A list of bug tags. (optional) |
| param security_related: | |
| Is this bug's information type Private Security? (deprecated) | |
| param tags: | Is this bug's information type Private user data. (deprecated) |
Things to note when using this factory:
- The reporter will be subscribed to the bug.
- Only people that the project shares with will see the bug when the bug's information type is Proprietary, Private, or Private Security.
Summary
A one-line summary of the problem.
Description
A detailed description of the problem, including the steps required to reproduce it.
Tags
Space-separated keywords for classifying this bug report.
Information Type
The type of information contained in this bug report.
This bug report should be private
Private bug reports are visible only to their subscribers.
Return the single package set with the given name (if any).
| param distroseries: | |
|---|---|
| the distroseries to which the new packageset is related. | |
| param name: | the name of the package set sought. |
| return: | An IPackageset instance. |
| raise NoSuchPackageSet: | |
| if no package set is found. | |
Distribution series
The distroseries to which this package set is related.
Return the package sets associated with the given distroseries.
| param distroseries: | |
|---|---|
| A DistroSeries. | |
| return: | An iterable collection of IPackageset instances. |
Distribution series
The distroseries to which this package set is related.
Get the package sets that include this source package.
Return all package sets that directly or indirectly include the given source package name.
| param sourcepackagename: | |
|---|---|
| the included source package name; can be either a string or a ISourcePackageName. | |
| param distroseries: | |
| the IDistroSeries in which to look for sets. If omitted, matching package sets from all series will be returned. | |
| param direct_inclusion: | |
| if this flag is set to True, then only package sets that directly include this source package name will be considered. | |
| raises NoSuchSourcePackageName: | |
| if a source package with the given name cannot be found. | |
| return: | A (potentially empty) sequence of IPackageset instances. |
Distribution series
The distroseries to which this package set is related.
Create a new package set.
| param name: | the name of the package set to be created. |
|---|---|
| param description: | |
| the description for the package set to be created. | |
| param owner: | the owner of the package set to be created. |
| param distroseries: | |
| the distroseries to which the new packageset is related. | |
| param related_set: | |
| the newly created package set is to be related to related_set (by being placed in the same package group). | |
| raises DuplicatePackagesetName: | |
| if a package set with the same name exists in distroseries already. | |
| return: | a newly created IPackageset. |
Person
The person who owns this package set.
Related package set
The new package set will share the package set group with this one.
Distroseries
The distribution series to which the packageset is related.
Return the person with the given email address.
Return None if there is no person with the given email address.
Return all Teams whose name, displayname or email address match <text>.
The results will be ordered using the default ordering specified in Person._defaultOrder.
While we don't have Full Text Indexes in the emailaddress table, we'll be trying to match the text only against the beginning of an email address.
Return all non-merged Persons with at least one email address whose name, displayname or email address match <text>.
If text is an empty string, all persons with at least one email address will be returned.
The results will be ordered using the default ordering specified in Person._defaultOrder.
If exclude_inactive_accounts is True, any accounts whose account_status is any of INACTIVE_ACCOUNT_STATUSES will not be in the returned set.
If must_have_email is True, only people with one or more email addresses are returned.
While we don't have Full Text Indexes in the emailaddress table, we'll be trying to match the text only against the beginning of an email address.
If created_before or created_after are not None, they are used to restrict the search to the dates provided.
Return all non-merged Persons and Teams whose name, displayname or email address match <text>.
The results will be ordered using the default ordering specified in Person._defaultOrder.
While we don't have Full Text Indexes in the emailaddress table, we'll be trying to match the text only against the beginning of an email address.
Name
A short unique name, beginning with a lower-case letter or number, and containing only letters, numbers, dots, hyphens, or plus signs.
Display Name
Your name as you would like it displayed throughout Launchpad. Most people use their full name here.
Team Description
Obsolete. Use description.
Subscription period
Number of days a new subscription lasts before expiring. You can customize the length of an individual subscription when approving it. Leave this empty or set to 0 for subscriptions to never expire.
Self renewal period
Number of days members can renew their own membership. The number can be from 1 to 3650 (10 years).
Membership policy
Obsolete: use membership_policy
Return the latest projects registered in Launchpad.
The supplied user determines which objects are visible.
If the quantity is not specified or is a value that is not 'None' then the set of projects returned is limited to that value (the default quantity is 5). If quantity is 'None' then all projects are returned. For the web service it is not possible to specify the quantity, so all projects are returned, latest first.
Search through the Registry database for products that match the query terms. text is a piece of text in the title / summary / description fields of product.
This call eager loads data appropriate for web API; caution may be needed for other callers.
Create and return a brand new Product.
See IProduct for a description of the parameters.
Name
At least one lowercase letter or number, followed by letters, numbers, dots, hyphens or pluses. Keep this name short; it is used in URLs as shown above.
Display Name
The name of the project as it would appear in a paragraph.
Title
The project title. Should be just a few words.
Summary
A short paragraph to introduce the project's work.
Description
Details about the project's work, highlights, goals, and how to contribute. Use plain text, paragraphs are preserved and URLs are linked in pages. Don't repeat the Summary.
Part of
Project group. This is an overarching initiative that includes several related projects. For example, the Mozilla Project produces Firefox, Thunderbird and Gecko. This information is used to group those projects in a coherent way. If you make this project part of a group, the group preferences and decisions around bug tracking, translation and security policy will apply to this project.
Homepage URL
The project home page. Please include the http://
Screenshots URL
The full URL for screenshots of this project, if available. Please include the http://
Download URL
The full URL where downloads for this project are located, if available. Please include the http://
Freshmeat Project
The Freshmeat project name for this project, if it is in freshmeat. [DEPRECATED]
Wiki URL
The full URL of this project's wiki, if it has one. Please include the http://
Sourceforge Project
The SourceForge project name for this project, if it is in sourceforge.
Programming Languages
A comma delimited list of programming languages used for this project.
Project reviewed
Whether or not this project has been reviewed. If you looked at the project and how it uses Launchpad, you reviewed it.
Description of additional licences
Description of licences that do not appear in the list above.
Registrant
This person registered the project in Launchpad.
Bug Supervisor
The Launchpad id of the person or team (preferred) responsible for bug management.
Driver
This person or team will be able to set feature goals for and approve bug targeting or backporting for ANY major series in this project. You might want to leave this blank and just appoint a team for each specific series, rather than having one project team that does it all.
Return the first entry of the queue ready to be imported.
| param target: | IPerson, IProduct, IProductSeries, IDistribution, IDistroSeries or ISourcePackage the import entries are attached to or None to get all entries available. |
|---|
Return all entries this import queue has.
| arg target: | IPerson, IProduct, IProductSeries, IDistribution, IDistroSeries or ISourcePackage the import entries are attached to or None to get all entries available. |
|---|---|
| arg import_status: | |
| RosettaImportStatus entry. | |
| arg file_extensions: | |
| Sequence of filename suffixes to match, usually 'po' or 'pot'. | |
If any of target, status or file_extension are given, the returned entries are filtered based on those values.
List Product`s and `DistroSeries with pending imports.
| arg status: | Filter by RosettaImportStatus. |
|---|
All returned items will implement IHasTranslationImports.
Creation date
When the token was created.
Expiry date
When the token should expire or was revoked.
Date last used
When the token was last used.
Description
A short description of the token.
Owner
The person who created the token.
Revoked by
The person who revoked the token, if any.
Scopes
A list of scopes granted by the token.
Target
The target for which the token was issued.
Description
A short description of the token.
Target archive
The archive that has this dependency.
Target snap base
The snap base that has this dependency.
All IBinaryPackagePublishingHistory target to this archive.
| param name: | binary name filter (exact match or SQL LIKE controlled by 'exact_match' argument). |
|---|---|
| param version: | binary version filter (always exact match). |
| param status: | PackagePublishingStatus filter, can be a list. |
| param distroarchseries: | |
| IDistroArchSeries filter, can be a list. | |
| param pocket: | PackagePublishingPocket filter. |
| param exact_match: | |
| either or not filter source names by exact matching. | |
| param created_since_date: | |
| Only return publications created on or after this date. | |
| param ordered: | Normally publications are ordered by binary package name and then ID order (creation order). If this parameter is False then the results will be unordered. This will make the operation much quicker to return results if you don't care about ordering. |
| param order_by_date: | |
| Order publications by descending creation date and then by descending ID. This is suitable for applications that need to catch up with publications since their last run. | |
| param include_removed: | |
| If True, include publications that have been removed from disk as well as those that have not. | |
| param only_unpublished: | |
| If True, only include publications that have never been published to disk. | |
| param component_name: | |
| component filter. Only return binaries that are in this component. | |
| return: | A collection containing BinaryPackagePublishingHistory. |
Package Publishing Status
The status of this publishing record
Ordered
Return ordered results by default, but specifying False will return results more quickly.
The pocket into which this entry is published
Created Since Date
Return entries whose date_created is greater than or equal to this date.
Order by creation date
Return newest results first. This is recommended for applications that need to catch up with publications since their last run.
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.
| param build_state: | |
|---|---|
| optional BuildStatus value for filtering build records; | |
| param name: | optional string for filtering build source package name. Sub-string matching is allowed via SQL LIKE. |
| param pocket: | optional PackagePublishingPocket value for filtering build records; |
| param arch_tag: | optional string for filtering build source packages by their architecture tag; |
| param user: | optional IPerson corresponding to the user performing the request. It will filter out build records for which the user have no 'view' permission. |
| param binary_only: | |
| optional boolean indicating whether only BinaryPackageBuild objects should be returned, or more general PackageBuild objects (which may include, for example, SourcePackageRecipeBuild objects. | |
| return: | 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). |
Build status
The status of this build record
The pocket into which this entry is published
Return IArchivePermission for the person's queue admin components.
| param person: | An IPerson. |
|---|---|
| return: | A list of IArchivePermission records. |
Return the IArchivePermission records applicable to the person.
| param person: | An IPerson |
|---|---|
| return: | A list of IArchivePermission records. |
Package Publishing Status
The status of this publishing record
The pocket into which this entry is published
Created Since Date
Return entries whose date_created is greater than or equal to this date.
Exact Match
Whether or not to filter source names by exact matching.
Order by creation date
Return newest results first. This is recommended for applications that need to catch up with publications since their last run. If not specified, results are ordered by source package name (lexicographically), then by descending version and then descending ID.
The package set based permissions for a given source and uploader.
| param sourcepackagename: | |
|---|---|
| the source package name; can be either a string or a ISourcePackageName. | |
| param person: | An IPerson for whom you want to find out which package sets they have access to. |
| raises NoSuchSourcePackageName: | |
| if a source package with the given name could not be found. | |
| return: | ArchivePermission records for the package sets that include the given source package name and to which the given person may upload. |
Return the IArchiveDependency object for the given dependency.
| param dependency: | |
|---|---|
| is an IArchive object. | |
| return: | IArchiveDependency or None if a corresponding object could not be found. |
True if the person is allowed to upload the given source package.
If the source package name is included by any package set with an explicit permission then only such explicit permissions will be considered.
| param sourcepackagename: | |
|---|---|
| the source package name; can be either a string or a ISourcePackageName. | |
| param person: | An IPerson for whom you want to find out which package sets they have access to. |
| param distroseries: | |
| The IDistroSeries for which to check permissions. If none is supplied then currentseries in the archive's distribution is assumed. | |
| raises NoSuchSourcePackageName: | |
| if a source package with the given name could not be found. | |
| return: | True if the person is allowed to upload the source package. |
Return IArchivePermission records for the component's uploaders.
| param component_name: | |
|---|---|
| An IComponent or textual name for the component. | |
| return: | A list of IArchivePermission records. |
All package set based permissions for the given source.
This method is meant to aid the process of "debugging" package set based archive permission since It allows the listing of permissions for the given source package in this archive (irrespective of the principal).
| param sourcepackagename: | |
|---|---|
| the source package name; can be either a string or a ISourcePackageName. | |
| param direct_permissions: | |
| If set only package sets that directly include the given source will be considered. | |
| raises NoSuchSourcePackageName: | |
| if a source package with the given name could not be found. | |
| return: | ArchivePermission records for the package sets that include the given source package name and apply to the archive in question. |
The ArchivePermission records for uploaders to the package set.
| param packageset: | |
|---|---|
| An IPackageset. | |
| param direct_permissions: | |
| If True, only consider permissions granted directly for the package set at hand. Otherwise, include any uploaders for package sets that include this one. | |
| return: | ArchivePermission records for all the uploaders who are authorized to upload to the named source package set. |
Return a dictionary containing a summary of the build statuses.
Only information for sources belonging to the current archive will be returned. See IPublishingSet.getBuildStatusSummariesForSourceIdsAndArchive() for details.
| param source_ids: | |
|---|---|
| A list of source publishing history record ids. | |
| type source_ids: | |
| list | |
| return: | A dict consisting of the overall status summaries for the given ids that belong in the archive. |
The ArchivePermission records for the person's package sets.
| param person: | An IPerson for whom you want to find out which package sets they have access to. |
|---|---|
| return: | ArchivePermission records for all the package sets that 'person' is allowed to upload to. |
Return IArchivePermission records for the package's uploaders.
| param source_package_name: | |
|---|---|
| An ISourcePackageName or textual name for the source package. | |
| return: | A list of IArchivePermission records. |
The pocket into which this entry is published
Return a dictionary containing the build counters for an archive.
This is necessary currently because the IArchive.failed_builds etc. counters are not in use.
The returned dictionary contains the follwoing keys and values:
- 'total': total number of builds (includes SUPERSEDED);
- 'pending': number of builds in BUILDING or NEEDSBUILD state;
- 'failed': number of builds in FAILEDTOBUILD, MANUALDEPWAIT, CHROOTWAIT and FAILEDTOUPLOAD state;
- 'succeeded': number of SUCCESSFULLYBUILT builds.
- 'superseded': number of SUPERSEDED builds.
| param include_needsbuild: | |
|---|---|
| Indicates whether to include builds with the status NEEDSBUILD in the pending and total counts. This is useful in situations where a build that hasn't started isn't considered a build by the user. | |
| type include_needsbuild: | |
| bool | |
| return: | a dictionary with the 4 keys specified above. |
| rtype: | dict. |
Return IArchivePermission records for authorized queue admins.
| param component_name: | |
|---|---|
| An IComponent or textual name for the component. | |
| return: | A list of IArchivePermission records. |
Revoke permission for the person to administer distroseries queues.
The supplied person will lose permission to administer the distroseries queue for packages in the supplied component.
| param person: | An IPerson whose permission should be revoked. |
|---|---|
| param component: | |
| An IComponent or textual component name. | |
Add permission for a person to upload to a component.
| param person: | An IPerson whom should be given permission. |
|---|---|
| param component: | |
| An IComponent or textual component name. | |
| return: | An IArchivePermission which is the newly-created permission. |
| raises InvalidComponent: | |
| if this archive is a PPA and the component is not 'main'. | |
Synchronise (copy) named sources into this archive from another.
DEPRECATED: syncSource and syncSources are deprecated, and will be removed entirely in the future. Use the asynchronous copyPackage method instead, and poll getPublishedSources if you need to await completion.
It will copy the most recent PUBLISHED versions of the named sources to the destination archive if necessary.
This operation will only succeeds when all requested packages are synchronised between the archives. If any of the requested copies cannot be performed, the whole operation will fail. There will be no partial changes of the destination archive.
If the source or target distribution has a development series alias, then it may be used as the source or target distroseries name respectively; but note that this will always be resolved to the true development series of that distribution, which may not match the alias in the respective published archives.
| param source_names: | |
|---|---|
| a list of string names of packages to copy. | |
| param from_archive: | |
| the source archive from which to copy. | |
| param to_pocket: | |
| the target pocket (as a string). | |
| param to_series: | |
| the target distroseries (as a string). | |
| param from_series: | |
| the source distroseries (as a string). | |
| param include_binaries: | |
| optional boolean, controls whether or not the published binaries for each given source should also be copied along with the source. | |
| param person: | the IPerson who requests the sync. |
| raises NoSuchSourcePackageName: | |
| if the source name is invalid | |
| raises PocketNotFound: | |
| if the pocket name is invalid | |
| raises NoSuchDistroSeries: | |
| if the distro series name is invalid | |
| raises CannotCopy: | |
| if there is a problem copying. | |
Distroseries name
The distro series to copy packages from.
Include Binaries
Whether or not to copy binaries already built for this source
Distroseries name
The distro series to copy packages into.
Revoke permission for the person to upload to the component.
| param person: | An IPerson whose permission should be revoked. |
|---|---|
| param component: | |
| An IComponent or textual component name. | |
Revoke upload permissions for a person.
| param person: | An IPerson for whom you want to revoke permission. |
|---|---|
| param packageset: | |
| An IPackageset. | |
| param explicit: | The value of the 'explicit' flag for the permission to be revoked. |
Create a new subscribtion to this archive.
Create an ArchiveSubscriber record which allows an IPerson to access a private repository.
| param subscriber: | |
|---|---|
| An IPerson who is allowed to access the repository for this archive. | |
| param registrant: | |
| An IPerson who created this subscription. | |
| param date_expires: | |
| When the subscription should expire; None if it should not expire (default). | |
| param description: | |
| An option textual description of the subscription being created. | |
| return: | The IArchiveSubscriber that was created. |
Description
Free text describing this subscription.
Date of Expiration
The timestamp when the subscription will expire.
Subscriber
The person who is subscribed.
Add a package set based permission for a person.
| param person: | An IPerson for whom you want to add permission. |
|---|---|
| param packageset: | |
| An IPackageset. | |
| param explicit: | True if the package set in question requires specialist skills for proper handling. |
| return: | The new ArchivePermission, or the existing one if it already exists. |
Revoke permission for the person to upload the package.
| param person: | An IPerson whose permission should be revoked. |
|---|---|
| param source_package_name: | |
| An ISourcePackageName or textual package name. | |
Add permission for a person to administer a distroseries queue.
The supplied person will gain permission to administer the distroseries queue for packages in the supplied component.
| param person: | An IPerson whom should be given permission. |
|---|---|
| param component: | |
| An IComponent or textual component name. | |
| return: | An IArchivePermission which is the newly-created permission. |
Synchronise (copy) a single named source into this archive.
DEPRECATED: syncSource and syncSources are deprecated, and will be removed entirely in the future. Use the asynchronous copyPackage method instead, and poll getPublishedSources if you need to await completion.
Copy a specific version of a named source to the destination archive if necessary.
If the source distribution has a development series alias, then it may be used as the source distroseries name; but note that this will always be resolved to the true development series of that distribution, which may not match the alias in the published source archive.
| param source_name: | |
|---|---|
| a string name of the package to copy. | |
| param version: | the version of the package to copy. |
| param from_archive: | |
| the source archive from which to copy. | |
| param to_pocket: | |
| the target pocket (as a string). | |
| param to_series: | |
| the target distroseries (as a string). | |
| param include_binaries: | |
| optional boolean, controls whether or not the published binaries for each given source should also be copied along with the source. | |
| param person: | the IPerson who requests the sync. |
| raises NoSuchSourcePackageName: | |
| if the source name is invalid | |
| raises PocketNotFound: | |
| if the pocket name is invalid | |
| raises NoSuchDistroSeries: | |
| if the distro series name is invalid | |
| raises CannotCopy: | |
| if there is a problem copying. | |
Include Binaries
Whether or not to copy binaries already built for this source
Add permisson for a person to upload a package to this archive.
| param person: | An IPerson whom should be given permission. |
|---|---|
| param source_package_name: | |
| An ISourcePackageName or textual package name. | |
| return: | An IArchivePermission which is the newly-created permission. |
Authorized size
Maximum size, in MiB, allowed for the archive.
Description
A short description of the archive. URLs are allowed and will be rendered as links.
Display name
A short title for the archive.
External dependencies
Newline-separated list of repositories to be used to retrieve any external build-dependencies when building packages in the archive, in the format: deb http[s]://[user:pass@]<host>[/path] %(series)s[-pocket] [components] The series variable is replaced with the series name of the context build. NOTE: This is for migration of OEM PPAs only!
Name
At least one lowercase letter or number, followed by letters, numbers, dots, hyphens or pluses. Keep this name short; it is used in URLs.
Owner
The archive owner.
Private
Restrict access to the archive to its owner and subscribers. This can only be changed if the archive has never had any sources published.
Reference
A string to uniquely identify the archive.
Relative build score
A delta to apply to all build scores for the archive. Builds with a higher score will build sooner.
Require virtualized builders
Only build the archive's packages on virtual builders.
Archive signing key fingerprint
A OpenPGP signing key fingerprint (40 chars) for this PPA or None if there is no signing key available.
Suppress subscription notifications
Whether subscribers to private PPAs get emails about their subscriptions. Has no effect on a public PPA.
Authorized size
Maximum size, in MiB, allowed for the archive.
Description
A short description of the archive. URLs are allowed and will be rendered as links.
Display name
A short title for the archive.
External dependencies
Newline-separated list of repositories to be used to retrieve any external build-dependencies when building packages in the archive, in the format: deb http[s]://[user:pass@]<host>[/path] %(series)s[-pocket] [components] The series variable is replaced with the series name of the context build. NOTE: This is for migration of OEM PPAs only!
Name
At least one lowercase letter or number, followed by letters, numbers, dots, hyphens or pluses. Keep this name short; it is used in URLs.
Owner
The archive owner.
Private
Restrict access to the archive to its owner and subscribers. This can only be changed if the archive has never had any sources published.
Relative build score
A delta to apply to all build scores for the archive. Builds with a higher score will build sooner.
Require virtualized builders
Only build the archive's packages on virtual builders.
Archive signing key fingerprint
A OpenPGP signing key fingerprint (40 chars) for this PPA or None if there is no signing key available.
Suppress subscription notifications
Whether subscribers to private PPAs get emails about their subscriptions. Has no effect on a public PPA.
Archive
The archive that this permission is for.
Date Created
The timestamp when the permission was created.
Distro series
The distro series that this permission is for (only for pocket permissions).
Explicit
Set this flag for package sets with high-profile packages requiring specialist skills for proper handling.
Person
The person or team being granted the permission.
The pocket that this permission is for.
Archive
The archive that this permission is for.
Date Created
The timestamp when the permission was created.
Distro series
The distro series that this permission is for (only for pocket permissions).
Explicit
Set this flag for package sets with high-profile packages requiring specialist skills for proper handling.
Person
The person or team being granted the permission.
The pocket that this permission is for.
Archive
The archive for this subscription.
Date Created
The timestamp when the subscription was created.
Date of Expiration
The timestamp when the subscription will expire.
Description
Free text describing this subscription.
Registrant
The person who registered this subscription.
Status
The status of this subscription.
Subscriber
The person who is subscribed.
Date of Expiration
The timestamp when the subscription will expire.
Description
Free text describing this subscription.
Status
The status of this subscription.
Restore the build record to its initial state.
Build record loses its history, is moved to NEEDSBUILD and a new non-scored BuildQueue entry is created for it.
Archive
The Archive context for this build.
Build Log URL
A URL for the build log. None if there is no log available.
Builder
The builder assigned to this job.
Status
The current status of the job.
Can Be Cancelled
Whether or not this build record can be cancelled.
Can Be Rescored
Whether or not this build record can be rescored manually.
Can Be Retried
Whether or not this build record can be retried.
Changes File URL
The URL for the changes file for this build. Will be None if the build was imported by Gina.
Source publication
The current source publication for this build.
Date finished
The actual build start time. Set when the build is dispatched the first time and not changed in subsequent build attempts.
Date finished
The timestamp when the build farm job was finished.
Date created
The timestamp when the build farm job was created.
Dependencies
Debian-like dependency line that must be satisfied before attempting to build this request.
Distribution
Shortcut for its distribution.
The build targeted pocket.
Upload Log URL
A URL for failed upload logs.Will be None if there was no failure.
Build Log URL
A URL for the build log. None if there is no log available.
Status
The current status of the job.
Changes File URL
The URL for the changes file for this build. Will be None if the build was imported by Gina.
Dependencies
Debian-like dependency line that must be satisfied before attempting to build this request.
Distribution
Shortcut for its distribution.
The build targeted pocket.
Upload Log URL
A URL for failed upload logs.Will be None if there was no failure.
Get detailed download counts for this binary.
| param start_date: | |
|---|---|
| The optional first date to return. | |
| param end_date: | The optional last date to return. |
Get the download count of this binary package in this archive.
This is currently only meaningful for PPAs.
Get the daily download counts for this binary.
| param start_date: | |
|---|---|
| The optional first date to return. | |
| param end_date: | The optional last date to return. |
Delete this source and its binaries.
| param removed_by: | |
|---|---|
| IPerson responsible for the removal. | |
| param removal_comment: | |
| optional text describing the removal reason. | |
Archive
The context archive for this publication.
Build
The build that produced this binary package.
Publication Creator
The IPerson who created this publication.
Date Created
The date on which this record was created
Date Made Pending
The date on which this record was set as pending removal
Date Published
The date on which this record was published
Date Removed
The date on which this record was removed from the published set
Date Superseded
The date on which this record was marked superseded
Display Name
Text representation of the current record.
Distro Arch Series
The distroarchseries being published into
The pocket into which this entry is published
Removal Comment
Reason why this publication is going to be removed.
Removed By
The Person responsible for the removal
Scheduled Deletion Date
The date on which this record is scheduled for deletion
Source Package Name
The source package name that built this binary.
Source Package Version
The source package version that built this binary.
Status
The status of this publishing record
Date Created
The date on which this record was created
Date Made Pending
The date on which this record was set as pending removal
Date Published
The date on which this record was published
Date Removed
The date on which this record was removed from the published set
Date Superseded
The date on which this record was marked superseded
Display Name
Text representation of the current record.
Distro Arch Series
The distroarchseries being published into
Removal Comment
Reason why this publication is going to be removed.
Removed By
The Person responsible for the removal
Scheduled Deletion Date
The date on which this record is scheduled for deletion
Status
The status of this publishing record
Can this branch be deleted in its current state.
A branch is considered deletable if it has no revisions and is not linked to any bugs, specs, productseries, or code imports.
Return a public URL for the branch using the given protocol.
| param scheme: | a protocol name accepted by the public code-hosting API. (As a legacy issue, 'sftp' is also accepted). |
|---|
Return true if the reviewer is a trusted reviewer.
The reviewer is trusted if they are either own the branch, or are in the team that owns the branch, or they are in the review team for the branch.
Link a bug to this branch.
| param bug: | IBug to link. |
|---|---|
| param registrant: | |
| IPerson linking the bug. | |
Subscribe this person to the branch.
| param person: | The Person to subscribe. |
|---|---|
| param notification_level: | |
| The kinds of branch changes that cause notification. | |
| param max_diff_lines: | |
| The maximum number of lines of diff that may appear in a notification. | |
| param code_review_level: | |
| The kinds of code review activity that cause notification. | |
| param subscribed_by: | |
| The person who is subscribing the subscriber. Most often the subscriber themselves. | |
| return: | new or existing BranchSubscription. |
Unlink an ISpecification to a branch.
| param spec: | ISpecification to unlink. |
|---|---|
| param user: | IPerson unlinking the spec. |
Set the target of the branch to be project or source_package.
Only one of project or source_package can be set, and if neither is set, the branch gets moved into the junk namespace of the branch owner.
| raise: | BranchTargetError if both project and source_package are set, or if either the project or source_package fail to be adapted to an IBranchTarget. |
|---|
Unlink a bug to this branch.
| param bug: | IBug to unlink. |
|---|---|
| param user: | IPerson unlinking the bug. |
Link an ISpecification to a branch.
| param spec: | ISpecification to link. |
|---|---|
| param registrant: | |
| IPerson unlinking the spec. | |
Remove the person's subscription to this branch.
| param person: | The person or team to unsubscribe from the branch. |
|---|---|
| param unsubscribed_by: | |
| The person doing the unsubscribing. | |
Create a new BranchMergeProposal with this branch as the source.
Both the target_branch and the prerequisite_branch, if it is there, must be branches with the same target as the source branch.
Personal branches (a.k.a. junk branches) cannot specify landing targets.
Commit message
Message to use when committing this merge.
Needs review
If True the proposal needs review.Otherwise, it will be work in progress.
Initial comment
Registrant's initial description of proposal.
Bazaar Identity
The bzr branch path as accessed by Launchpad. If the branch is associated with a product as the primary development focus, then the result should be lp:product. If the branch is related to a series, then lp:product/series. Otherwise the result is lp:~user/product/branch-name.
Dependent Branches
A collection of the merge proposals that are dependent on this branch.
Description
A short description of the changes in this branch.
Display name
The branch unique_name.
Keep branch confidential
Make this branch visible only to its subscribers.
Information Type
The type of information contained in this branch.
Landing Candidates
A collection of the merge proposals where this branch is the target branch.
Landing Targets
A collection of the merge proposals where this branch is the source branch.
Last scanned revision ID
The head revision ID of the branch when last successfully scanned.
Name
Keep very short, unique, and descriptive, because it will be used in URLs. Examples: main, devel, release-1.0, gnome-vfs.
Owner
Either yourself or an exclusive team you are a member of. This controls who can modify the branch.
Branch is confidential
This branch is visible only to its subscribers.
Project
The project this branch belongs to.
Review Team
The reviewer of a branch is the person or exclusive team that is responsible for reviewing proposals and merging into this branch.
Revision count
The revision number of the tip of the branch.
Unique name
Unique name of the branch, including the owner and project names.
Branch URL
The external location where the Bazaar branch is hosted. It is None when the branch is hosted by Launchpad.
Whiteboard
Notes on the current status of the branch.
Description
A short description of the changes in this branch.
Keep branch confidential
Make this branch visible only to its subscribers.
Name
Keep very short, unique, and descriptive, because it will be used in URLs. Examples: main, devel, release-1.0, gnome-vfs.
Review Team
The reviewer of a branch is the person or exclusive team that is responsible for reviewing proposals and merging into this branch.
Branch URL
The external location where the Bazaar branch is hosted. It is None when the branch is hosted by Launchpad.
Whiteboard
Notes on the current status of the branch.
Return the CodeReviewComment with the specified ID.
| raises WrongBranchMergeProposal: | |
|---|---|
| if the comment with this ID is not on this merge proposal. | |
Create an ICodeReviewComment associated with this merge proposal.
| param owner: | The person who the message is from. |
|---|---|
| param subject: | The subject line to use for the message. |
| param content: | The text to use for the message content. If unspecified, the text of the merge proposal is used. |
| param parent: | The previous CodeReviewComment in the thread. If unspecified, the root message is used. |
| param previewdiff_id: | |
| the inline comments PreviewDiff ID context. | |
| param inline_comments: | |
| a dictionary containing the draft inline comments keyed by the diff line number. | |
Set the state of the merge proposal to the specified status.
| param status: | The new status of the merge proposal. |
|---|---|
| param user: | The user making the change. |
| param revision_id: | |
| The revision id to provide to the underlying status change method. | |
Set the specified person as a reviewer.
If they are not already a reviewer, a vote is created. Otherwise, the details are updated.
The email address for this proposal.
Any emails sent to this address will resultin comments being added.
Commit message
The commit message that should be used when merging the source branch.
Date merged
The date that the source branch was merged into the target branch
Description
A detailed description of the changes that are being addressed by the branch being proposed to be merged.
Merge reporter
The user that marked the branch as merged.
Merged revision ID
The revision ID on the target branch which contains the merge from the source branch (currently Git only).
Merged revision number
The revision number on the target branch which contains the merge from the source branch (Bazaar only).
Prerequisite branch
The branch that the source branch branched from. If this branch is the same as the target branch, then leave this field blank.
Prerequisite Git branch path
The path of the Git branch that the source branch branched from. If this branch is the same as the target branch, then leave this field blank.
Prerequisite Git repository
The Git repository containing the branch that the source branch branched from. If this branch is the same as the target branch, then leave this field blank.
Proposal is confidential
If True, this proposal is visible only to subscribers.
Status
The current state of the proposal.
Person
The person who registered the merge proposal.
Review person or team
The person that accepted (or rejected) the code for merging.
Source branch
The branch that has code to land.
Source Git branch path
The path of the Git branch that has code to land.
Source Git repository
The Git repository that has code to land.
Superseded by
The branch merge proposal that supersedes this one.
Supersedes
The branch merge proposal that this one supersedes.
Target branch
The branch that the source branch will be merged into.
Target Git branch path
The path of the Git branch that the source branch will be merged into.
Target Git repository
The Git repository that the source branch will be merged into.
Commit message
The commit message that should be used when merging the source branch.
Description
A detailed description of the changes that are being addressed by the branch being proposed to be merged.
Generated Diff Size Limit
Diffs greater than the specified number of lines will not be sent to the subscriber. The subscriber will still receive an email with the new revision details even if the diff is larger than the specified number of lines.
Notification Level
Attribute notifications are sent when branch details are changed such as lifecycle status and name. Revision notifications are generated when new branch revisions are found due to the branch being updated through either pushes to the hosted branches or the mirrored branches being updated.
Person
Enter the launchpad id, or email address of the person you wish to subscribe to this branch. If you are unsure, use the "Choose..." option to find the person in Launchpad. You can only subscribe someone who is a registered user of the system.
Code review Level
Control the kind of review activity that triggers notifications.
Subscribed by
The person who created this subscription.
Generated Diff Size Limit
Diffs greater than the specified number of lines will not be sent to the subscriber. The subscriber will still receive an email with the new revision details even if the diff is larger than the specified number of lines.
Notification Level
Attribute notifications are sent when branch details are changed such as lifecycle status and name. Revision notifications are generated when new branch revisions are found due to the branch being updated through either pushes to the hosted branches or the mirrored branches being updated.
Code review Level
Control the kind of review activity that triggers notifications.
Date Changed
The date on which this activity occurred.
Message
Additional information about what changed.
New Value
The value after the change.
Old Value
The value before the change.
Person
The person's Launchpad ID or email address.
What Changed
The property of the bug that changed.
A file attachment to an IBug.
Launchpadlib example of accessing content of an attachment:
for attachment in bug.attachments:
buffer = attachment.data.open()
for line in buffer:
print line
buffer.close()
Launchpadlib example of accessing metadata about an attachment:
attachment = bug.attachments[0] print "title:", attachment.title print "ispatch:", attachment.type
For information about the file-like object returned by attachment.data.open() see lazr.restfulclient's documentation of the HostedFile object.
Details about the message associated with an attachment can be found on the "message" attribute:
message = attachment.message
print "subject:", message.subject.encode('utf-8')
print "owner:", message.owner.display_name.encode('utf-8')
print "created:", message.date_created
Title
A short and descriptive description of the attachment
Attachment Type
The type of the attachment, for example Patch or Unspecified.
Title
A short and descriptive description of the attachment
Attachment Type
The type of the attachment, for example Patch or Unspecified.
Return a list of all IBugNominations for this bug.
The list is ordered by IBugNominations.target.bugtargetdisplayname.
| param target: | An IProduct or IDistribution. Only nominations for this target are returned. |
|---|---|
| param nominations: | |
| The list of nominations to search through. If none is given, the bug's nominations are looked through. This can be useful when having to call this method multiple times, to avoid getting the list of nominations each time. | |
Return the IBugNomination for the target.
If no nomination is found, a NotFoundError is raised.
| param nomination_target: | |
|---|---|
| An IDistroSeries or IProductSeries. | |
Is this bug eligible for expiration and was it last updated more than X days ago?
If days_old is None the default number of days without activity is used.
Returns True or False.
Can this bug nominated for this target?
| nomination_target: | |
|---|---|
| An IDistroSeries or IProductSeries. | |
Returns True or False.
Subscribe person to the bug.
| param person: | the subscriber. |
|---|---|
| param subscribed_by: | |
| the person who created the subscription. | |
| param suppress_notify: | |
| a flag to suppress notify call. | |
| param level: | The BugNotificationLevel for the new subscription. |
| return: | an IBugSubscription. |
Associate a branch with this bug.
| param branch: | The branch being linked to. |
|---|---|
| param registrant: | |
| The user linking the branch. | |
Unlink a branch from this bug.
| param branch: | The branch being unlinked from. |
|---|---|
| param user: | The user unlinking the branch. |
Nominate a bug for an IDistroSeries or IProductSeries.
| owner: | An IPerson. |
|---|---|
| target: | An IDistroSeries or IProductSeries. |
This method creates and returns a BugNomination. (See lp.bugs.model.bugnomination.BugNomination.)
Attach a file to this bug.
| owner: | An IPerson. |
|---|---|
| data: | A file-like object, or a bytes. |
| description: | A brief description of the attachment. |
| comment: | An IMessage or string. |
| filename: | A string. |
| is_patch: | A boolean. |
Create a new bug task on this bug.
| raises IllegalTarget: | |
|---|---|
| if the bug task cannot be added to the bug. | |
Target
The software in which this bug should be fixed.
Bug System
You can register new bug trackers from the Launchpad Bugs home page.
Remote Bug
The bug number of this bug in the remote bug tracker.
Description
A detailed description of the problem, including the steps required to reproduce it.
Information Type
The type of information contained in this bug report.
Nickname
A short and unique name. Add one only if you often need to retype the URL but have trouble remembering the bug number.
This bug report should be private
Private bug reports are visible only to their subscribers.
Tags
Space-separated keywords for classifying this bug report.
Summary
A one-line summary of the problem.
Who Made Private
The person who set this bug private.
Description
A detailed description of the problem, including the steps required to reproduce it.
Nickname
A short and unique name. Add one only if you often need to retype the URL but have trouble remembering the bug number.
This bug report should be private
Private bug reports are visible only to their subscribers.
Tags
Space-separated keywords for classifying this bug report.
Summary
A one-line summary of the problem.
An entity which can be linked to bugs.
Examples include an ISpecification.
A nomination for a bug to be fixed in a specific series.
A nomination can apply to an IDistroSeries or an IProductSeries.
Decline this bug for fixing in a series.
| decliner: | The IPerson that declines this nomination. |
|---|
The status is set to DECLINED.
If called on a nomination that is in APPROVED state, a BugNominationStatusError is raised. If the nomination was already DECLINED, this method is a noop.
Approve this bug for fixing in a series.
| approver: | The IPerson that approves this nomination and that will own the created bugtasks. |
|---|
The status is set to APPROVED and the appropriate IBugTask(s) are created for the nomination target.
A nomination in any state can be approved. If the nomination is /already/ approved, this method is a noop.
Date Submitted
The date on which this nomination was submitted.
Date Decided
The date on which this nomination was approved or declined.
Person
The person's Launchpad ID or email address.
Subscribed by
The person who created this subscription.
Bug notification level
The volume and type of bug notifications this subscription will generate.
Find all tags
If enabled, all tags must match, else at least one tag must match.
Bug notification level
The volume and type of bug notifications this subscription will generate.
Find all tags
If enabled, all tags must match, else at least one tag must match.
An entity on which a bug can be reported.
Examples include an IDistribution, an IDistroSeries and an IProduct.
Search the IBugTasks reported on this entity.
| search_params: | a BugTaskSearchParams object |
|---|
Return an iterable of matching results.
Note: milestone is currently ignored for all IBugTargets except IProduct.
Status upstream
Indicates the status of any remote watches associated with the bug. Possible values include: pending_bugwatch, hide_upstream, resolved_upstream, and open_upstream.
Tags
String or list of strings for tags to search. To exclude, prepend a '-', e.g. '-unwantedtag'
Status
Show only bugs with the given status value or list of values.
Tags combination
Search for any or all of the tags specified.
Component
Distribution package archive grouping. E.g. main, universe, multiverse
Importance
Show only bugs with the given importance or list of importances.
Information Type
Show only bugs with the given information type or list of information types.
Milestone
Show only bug tasks targeted to this milestone.
After reporting a bug, I can expect the following.
This message of acknowledgement will be displayed to anyone after reporting a bug.
Helpful guidelines for reporting a bug
These guidelines will be shown to everyone reporting a bug and should be text or a bulleted list with your particular requirements, if any.
After reporting a bug, I can expect the following.
This message of acknowledgement will be displayed to anyone after reporting a bug.
Helpful guidelines for reporting a bug
These guidelines will be shown to everyone reporting a bug and should be text or a bulleted list with your particular requirements, if any.
Remote Bug Details
Select the bug watch that represents this task in the relevant bug tracker. If none of the bug watches represents this particular bug task, leave it as (None). Linking the remote bug watch with the task in this way means that a change in the remote bug status will change the status of this bug task in Launchpad.
Date Assigned
The date on which this task was assigned to someone.
Date Closed
The date on which this task was marked Fix Released, Invalid, Won't Fix, Expired or Opinion.
Date Confirmed
The date on which this task was marked Confirmed.
Date Created
The date on which this task was created.
Date Fix Committed
The date on which this task was marked Fix Committed.
Date Fix Released
The date on which this task was marked Fix Released.
Date In Progress
The date on which this task was marked In Progress.
Date Incomplete
The date on which this task was marked Incomplete.
Date left closed
The date on which this task was last reopened.
Date left new
The date on which this task was marked with a status higher than New.
Date Triaged
The date on which this task was marked Triaged.
Target
The software in which this bug should be fixed.
Remote Bug Details
Select the bug watch that represents this task in the relevant bug tracker. If none of the bug watches represents this particular bug task, leave it as (None). Linking the remote bug watch with the task in this way means that a change in the remote bug status will change the status of this bug task in Launchpad.
Target
The software in which this bug should be fixed.
The software component in the remote bug tracker.
Most bug trackers organize bug reports by the software 'component' they affect. This class provides a mapping of this upstream component to the corresponding source package in the distro.
Distribution Source Package
The distribution source package object that should be linked to this component.
Is Visible?
Should the component be shown in the Launchpad web interface?
Name
The name of a software component as shown in Launchpad.
Distribution Source Package
The distribution source package object that should be linked to this component.
Is Visible?
Should the component be shown in the Launchpad web interface?
Name
The name of a software component as shown in Launchpad.
A collection of components in a remote bug tracker.
Some bug trackers organize sets of components into higher level groups, such as Bugzilla's 'product'.
Name
The name of the bug tracker product.
Name
The name of the bug tracker product.
A remote bug system.
Launchpadlib example: What bug tracker is used for a distro source package?
product = source_package.upstream_product
if product:
tracker = product.bug_tracker
if not tracker:
project = product.project_group
if project:
tracker = project.bug_tracker
if tracker:
print "%s at %s" %(tracker.bug_tracker_type, tracker.base_url)
Retrieve a given component group registered with the bug tracker.
| param component_group_name: | |
|---|---|
| Name of the component group to retrieve. | |
Location
The top-level URL for the bug tracker, or an upstream email address. This must be accurate so that Launchpad can link to external bug reports.
Location aliases
A list of URLs or email addresses that all lead to the same bug tracker, or commonly seen typos, separated by whitespace.
Contact details
The contact details for the external bug tracker (so that, for example, its administrators can be contacted about a security breach).
Name
A URL-friendly name for the bug tracker, such as "mozilla-bugs".
Summary
A brief introduction or overview of this bug tracker instance.
Title
A descriptive label for this tracker to show in listings.
Location
The top-level URL for the bug tracker, or an upstream email address. This must be accurate so that Launchpad can link to external bug reports.
Location aliases
A list of URLs or email addresses that all lead to the same bug tracker, or commonly seen typos, separated by whitespace.
Contact details
The contact details for the external bug tracker (so that, for example, its administrators can be contacted about a security breach).
Name
A URL-friendly name for the bug tracker, such as "mozilla-bugs".
Summary
A brief introduction or overview of this bug tracker instance.
Title
A descriptive label for this tracker to show in listings.
Bug System
You can register new bug trackers from the Launchpad Bugs home page.
Remote Bug
The bug number of this bug in the remote bug tracker.
Bug System
You can register new bug trackers from the Launchpad Bugs home page.
Remote Bug
The bug number of this bug in the remote bug tracker.
Build Log URL
A URL for the build log. None if there is no log available.
Builder
The builder assigned to this job.
Status
The current status of the job.
Date finished
The actual build start time. Set when the build is dispatched the first time and not changed in subsequent build attempts.
Date finished
The timestamp when the build farm job was finished.
Date created
The timestamp when the build farm job was created.
Dependencies
Debian-like dependency line that must be satisfied before attempting to build this request.
Build Log URL
A URL for the build log. None if there is no log available.
Status
The current status of the job.
Dependencies
Debian-like dependency line that must be satisfied before attempting to build this request.
Build-worker information and state.
Builder instance represents a single builder worker machine within the Launchpad Auto Build System. It should specify a 'processor' on which the machine is based and is able to build packages for; a URL, by which the machine is accessed through an XML-RPC interface; name, title for entity identification and browsing purposes; an LP-like owner which has unrestricted access to the instance; the build worker machine status representation, including the field/properties: virtualized, builderok, status, failnotes and currentjob.
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.
| param build_state: | |
|---|---|
| optional BuildStatus value for filtering build records; | |
| param name: | optional string for filtering build source package name. Sub-string matching is allowed via SQL LIKE. |
| param pocket: | optional PackagePublishingPocket value for filtering build records; |
| param arch_tag: | optional string for filtering build source packages by their architecture tag; |
| param user: | optional IPerson corresponding to the user performing the request. It will filter out build records for which the user have no 'view' permission. |
| param binary_only: | |
| optional boolean indicating whether only BinaryPackageBuild objects should be returned, or more general PackageBuild objects (which may include, for example, SourcePackageRecipeBuild objects. | |
| return: | 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). |
Build status
The status of this build record
The pocket into which this entry is published
Publicly Visible
Whether or not to present the builder publicly.
Clean status
The readiness of the worker to take a job. Only internal build infrastructure bots need to or should write to this.
Date clean status changed
The date the builder's clean status last changed.
Failure Notes
The reason for a builder not being ok
Failure Count
Number of consecutive failures for this builder.
Manual Mode
The auto-build system does not dispatch jobs automatically for worker in manual mode.
Name
Builder Worker Name used for reference purposes
Owner
Builder owner, a Launchpad member which will be responsible for this device.
Title
The builder worker title. Should be just a few words.
URL
The URL to the build machine, used as a unique identifier. Includes protocol, host and port only, e.g.: http://farm.com:8221/
Version
The version of launchpad-buildd on the worker.
Virtualized
Whether or not the builder is a virtual Xen instance.
VM host
The machine hostname hosting the virtual buildd-worker, e.g.: foobar-host.ppa
VM reset protocol
The protocol version for resetting the VM.
Publicly Visible
Whether or not to present the builder publicly.
Failure Notes
The reason for a builder not being ok
Failure Count
Number of consecutive failures for this builder.
Manual Mode
The auto-build system does not dispatch jobs automatically for worker in manual mode.
Name
Builder Worker Name used for reference purposes
Owner
Builder owner, a Launchpad member which will be responsible for this device.
Title
The builder worker title. Should be just a few words.
URL
The URL to the build machine, used as a unique identifier. Includes protocol, host and port only, e.g.: http://farm.com:8221/
Version
The version of launchpad-buildd on the worker.
Virtualized
Whether or not the builder is a virtual Xen instance.
VM host
The machine hostname hosting the virtual buildd-worker, e.g.: foobar-host.ppa
VM reset protocol
The protocol version for resetting the VM.
Source snap channels for builds
A dictionary mapping snap names to channels to use when building charm recipes that specify this base. The special '_byarch' key may have a mapping of architecture names to mappings of snap names to channels, which if present override the channels declared at the top level when building for those architectures.
Processors
The architectures that the charm base supports.
Registrant
The person who registered this base.
Source snap channels for builds
A dictionary mapping snap names to channels to use when building charm recipes that specify this base. The special '_byarch' key may have a mapping of architecture names to mappings of snap names to channels, which if present override the channels declared at the top level when building for those architectures.
Archive
The Archive context for this build.
Build Log URL
A URL for the build log. None if there is no log available.
Builder
The builder assigned to this job.
Status
The current status of the job.
Can be cancelled
Whether this build record can be cancelled.
Can be rescored
Whether this build record can be rescored manually.
Can be retried
Whether this build record can be retried.
Source snap channels to use for this build.
A dictionary mapping snap names to channels to use for this build. Currently only 'charmcraft', 'core', 'core18', 'core20', and 'core22' keys are supported.
Date finished
The actual build start time. Set when the build is dispatched the first time and not changed in subsequent build attempts.
Date finished
The timestamp when the build farm job was finished.
Date created
The timestamp when the build farm job was created.
Dependencies
Debian-like dependency line that must be satisfied before attempting to build this request.
Distribution
Shortcut for its distribution.
Distribution series
Shortcut for its distribution series.
The build targeted pocket.
Revision ID
The revision ID of the branch used for this build, if available.
Store upload error message
The error message, if any, from the last attempt to upload this charm recipe build to Charmhub.
Store revision
The revision assigned to this charm recipe build by Charmhub.
Upload Log URL
A URL for failed upload logs.Will be None if there was no failure.
Build Log URL
A URL for the build log. None if there is no log available.
Status
The current status of the job.
Source snap channels to use for this build.
A dictionary mapping snap names to channels to use for this build. Currently only 'charmcraft', 'core', 'core18', 'core20', and 'core22' keys are supported.
Dependencies
Debian-like dependency line that must be satisfied before attempting to build this request.
Distribution
Shortcut for its distribution.
Distribution series
Shortcut for its distribution series.
The build targeted pocket.
Upload Log URL
A URL for failed upload logs.Will be None if there was no failure.
Automatically build when branch changes
Whether this charm recipe is built automatically when its branch changes.
Source snap channels for automatic builds
A dictionary mapping snap names to channels to use when building this charm recipe. Currently only 'charmcraft', 'core', 'core18', 'core20', and 'core22' keys are supported.
Build path
Subdirectory within the branch containing metadata.yaml.
All builds of this charm recipe.
All builds of this charm recipe, sorted in descending order of finishing (or starting if not completed successfully).
Can upload to Charmhub
Whether everything is set up to allow uploading builds of this charm recipe to Charmhub.
Completed builds of this charm recipe.
Completed builds of this charm recipe, sorted in descending order of finishing.
Description
A description of the charm recipe.
Git branch
The Git branch containing a charm recipe.
Information type
The type of information contained in this charm recipe.
Charm recipe name
The name of the charm recipe.
Owner
The owner of this charm recipe.
Pending builds of this charm recipe.
Pending builds of this charm recipe, sorted in descending order of creation.
Private
Whether this charm recipe is private.
Registrant
The person who registered this charm recipe.
Require virtualized builders
Only build this charm recipe on virtual builders.
Store channels
Channels to release this charm to after uploading it to the store. A channel is defined by a combination of an optional track, a risk, and an optional branch, e.g. '2.1/stable/fix-123', '2.1/stable', 'stable/fix-123', or 'stable'.
Registered store name
The registered name of this charm in the store.
Automatically upload to store
Whether builds of this charm recipe are automatically uploaded to the store.
Automatically build when branch changes
Whether this charm recipe is built automatically when its branch changes.
Source snap channels for automatic builds
A dictionary mapping snap names to channels to use when building this charm recipe. Currently only 'charmcraft', 'core', 'core18', 'core20', and 'core22' keys are supported.
Build path
Subdirectory within the branch containing metadata.yaml.
Description
A description of the charm recipe.
Git branch
The Git branch containing a charm recipe.
Information type
The type of information contained in this charm recipe.
Charm recipe name
The name of the charm recipe.
Owner
The owner of this charm recipe.
Private
Whether this charm recipe is private.
Require virtualized builders
Only build this charm recipe on virtual builders.
Store channels
Channels to release this charm to after uploading it to the store. A channel is defined by a combination of an optional track, a risk, and an optional branch, e.g. '2.1/stable/fix-123', '2.1/stable', 'stable/fix-123', or 'stable'.
Registered store name
The registered name of this charm in the store.
Automatically upload to store
Whether builds of this charm recipe are automatically uploaded to the store.
Request that an import be tried soon.
This method will schedule an import to happen soon for this branch.
The import must be in the Reviewed state, if not then a CodeImportNotInReviewedState error will be thrown. If using the API then a status code of 400 will result.
If the import is already running then a CodeImportAlreadyRunning error will be thrown. If using the API then a status code of 400 will result.
The two cases can be distinguished over the API by seeing if the exception names appear in the body of the response.
If used over the API and the request has already been made then this method will silently do nothing. If called internally then the error_if_already_requested parameter controls whether a CodeImportAlreadyRequested exception will be thrown in that situation.
| return: | None |
|---|
Branch
The Bazaar branch produced by the import system.
Module
The path to import within the repository. Usually, it is the name of the project.
Repository
The CVSROOT. Example: :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome
Git repository
The Git repository produced by the import system.
Type of RCS
The revision control system to import from.
Review Status
Only reviewed imports are processed.
Type of target RCS
The revision control system to import to.
URL
The URL of the VCS branch.
DB ID
The tracking number for this comment.
A reference to a vote on a IBranchMergeProposal.
There is at most one reference to a vote for each reviewer on a given branch merge proposal.
Change a pending review into a review for claimant.
Pending team reviews can be claimed by members of that team. This allows reviews to be moved of the general team todo list, and onto a personal todo list.
| param claimant: | The person claiming the team review. |
|---|---|
| raises ClaimReviewFailed: | |
| If the claimant already has a personal review, if the reviewer is not a team, if the claimant is not in the reviewer team, or if the review is not pending. | |
Reassign a pending review to someone else.
Pending reviews can be reassigned to someone else.
| param reviewer: | The person to assign the pending review to. |
|---|---|
| raises ReviewNotPending: | |
| If the review is not pending. | |
| raises ReassignReviewFailed: | |
| If the reviewer is an individual and already has a personal review. | |
Review type
Lowercase keywords describing the type of review.
Reviewer
A person who you want to review this.
Review type
Lowercase keywords describing the type of review.
Reviewer
A person who you want to review this.
A Commercial Subscription for a Product.
If the product has a licence which does not qualify for free hosting, a subscription needs to be purchased.
Date Created
The date the first subscription was applied.
Expiration Date
The expiration date of the subscription.
Date Modified
The date the subscription was modified.
Beginning of Subscription
The date the subscription starts.
Active
Whether this subscription is active.
Product which has commercial subscription
Project for which this commercial subscription is applied.
Purchaser
Person who purchased the voucher.
Registrant
Person who redeemed the voucher.
Expiration Date
The expiration date of the subscription.
Date Modified
The date the subscription was modified.
Beginning of Subscription
The date the subscription starts.
Title
A description of the CVE issue. This will be updated regularly from the CVE database.
Display Name
A very brief name describing the ref and state.
CVE Sequence Number
Should take the form XXXX-XXXX, all digits.
Current CVE State
Whether or not the vulnerability has been reviewed and assigned a full CVE number, or is still considered a Candidate, or is deprecated.
Title
A title for the CVE
URL
Return a URL to the site that has the CVE data for this CVE reference.
Title
A description of the CVE issue. This will be updated regularly from the CVE database.
Display Name
A very brief name describing the ref and state.
CVE Sequence Number
Should take the form XXXX-XXXX, all digits.
Current CVE State
Whether or not the vulnerability has been reviewed and assigned a full CVE number, or is still considered a Candidate, or is deprecated.
Title
A title for the CVE
URL
Return a URL to the site that has the CVE data for this CVE reference.
An operating system distribution.
Launchpadlib example: retrieving the current version of a package in a particular distroseries.
ubuntu = launchpad.distributions["ubuntu"]
archive = ubuntu.main_archive
series = ubuntu.current_series
print(archive.getPublishedSources(exact_match=True,
source_name="apport",
distro_series=series)[0].source_package_version)
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.
| param build_state: | |
|---|---|
| optional BuildStatus value for filtering build records; | |
| param name: | optional string for filtering build source package name. Sub-string matching is allowed via SQL LIKE. |
| param pocket: | optional PackagePublishingPocket value for filtering build records; |
| param arch_tag: | optional string for filtering build source packages by their architecture tag; |
| param user: | optional IPerson corresponding to the user performing the request. It will filter out build records for which the user have no 'view' permission. |
| param binary_only: | |
| optional boolean indicating whether only BinaryPackageBuild objects should be returned, or more general PackageBuild objects (which may include, for example, SourcePackageRecipeBuild objects. | |
| return: | 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). |
Build status
The status of this build record
The pocket into which this entry is published
Search the IBugTasks reported on this entity.
| search_params: | a BugTaskSearchParams object |
|---|
Return an iterable of matching results.
Note: milestone is currently ignored for all IBugTargets except IProduct.
Status upstream
Indicates the status of any remote watches associated with the bug. Possible values include: pending_bugwatch, hide_upstream, resolved_upstream, and open_upstream.
Tags
String or list of strings for tags to search. To exclude, prepend a '-', e.g. '-unwantedtag'
Status
Show only bugs with the given status value or list of values.
Tags combination
Search for any or all of the tags specified.
Component
Distribution package archive grouping. E.g. main, universe, multiverse
Importance
Show only bugs with the given importance or list of importances.
Information Type
Show only bugs with the given information type or list of information types.
Milestone
Show only bug tasks targeted to this milestone.
Search for source packages that correspond to the given text.
This method just decorates the result of searchSourcePackageCaches() to return DistributionSourcePackages.
Location
The country in which this mirror is based.
Content
Choose "CD Image" if this mirror contains CD images of this distribution. Choose "Archive" if this is a mirror of packages for this distribution.
Return entries in the translation import queue for this entity.
| arg import_status: | |
|---|---|
| RosettaImportStatus DB Schema entry. | |
| arg file_extension: | |
| String with the file type extension, usually 'po' or 'pot'. | |
If one of both of 'import_status' or 'file_extension' are given, the returned entries are filtered based on those values.
Filename extension
Show only entries with this filename suffix
Status
Show only entries with this status
Return the series with the name or version given.
| param name_or_version: | |
|---|---|
| The IDistroSeries.name or IDistroSeries.version. | |
Return all the subscriptions with the specified levels.
| return: | A sequence of IStructuralSubscription. |
|---|
Return the distribution archive with the given name.
Only distribution archives are considered -- PPAs will not be found.
| param name: | The name of the archive, e.g. 'partner' |
|---|
Add a bug subscription filter for this structure.
This method is used to create a new IBugSubscriptionFilter for the target. It will initially allow all notifications to be sent.
| subscriber: | The IPerson who will be subscribed. If omitted, subscribed_by will be used. |
|---|---|
| subscribed_by: | The IPerson creating the subscription. |
| return: | The new bug subscription filter. |
Remove a subscription to bugs from this structure.
This will delete all associated filters.
| subscriber: | The IPerson who will be unsubscribed. If omitted, unsubscribed_by will be used. |
|---|---|
| unsubscribed_by: | |
| The IPerson removing the subscription. | |
Add a bug subscription for this structure.
This method is used to create a new IStructuralSubscription for the target. This initially has a single filter which will allow all notifications will be sent.
| subscriber: | The IPerson who will be subscribed. If omitted, subscribed_by will be used. |
|---|---|
| subscribed_by: | The IPerson creating the subscription. |
| return: | The new bug subscription. |
Active
Whether or not this item is active.
After reporting a bug, I can expect the following.
This message of acknowledgement will be displayed to anyone after reporting a bug.
Helpful guidelines for reporting a bug
These guidelines will be shown to everyone reporting a bug and should be text or a bulleted list with your particular requirements, if any.
Bug Supervisor
The Launchpad id of the person or team (preferred) responsible for bug management.
Current series
The current development series of this distribution. Note that all maintainerships refer to the current series. When people ask about the state of packages in the distribution, we should interpret that query in the context of the currentseries.
Date created
The date this distribution was registered.
Default traversal policy
The type of object that /{distro}/{name} URLs for this distribution resolve to.
Description
Details about the distributions's work, highlights, goals, and how to contribute. Use plain text, paragraphs are preserved and URLs are linked in pages. Don't repeat the Summary.
Alias for development series
If set, an alias for the current development series in this distribution.
Display Name
The displayable name of the distribution.
Web site URL
The distro's web site URL.
Driver
The person or team responsible for decisions about features and bugs that will be targeted for any series in this distribution. Note that you can also specify a driver on each series whose permissions will be limited to that specific series.
Homepage Content
The content of this distribution's home page. Edit this and it will be displayed for all the world to see. It is NOT a wiki so you cannot undo changes.
Icon
A small image of exactly 14x14 pixels and at most 5kb in size, that can be used to identify this distribution. The icon will be displayed everywhere we list the distribution and link to it.
Logo
An image of exactly 64x64 pixels that will be displayed in the heading of all pages related to this distribution. It should be no bigger than 50kb in size.
Members
The distro's members team.
Mirror Administrator
The person or team that has the rights to review and mark this distribution's mirrors as official.
Brand
A large image of exactly 192x192 pixels, that will be displayed on this distribution's home page in Launchpad. It should be no bigger than 100kb in size.
Name
The distro's name.
OCI Project Administrator
The person or team that has the rights to manage OCI Projects for this distribution.
Official Bug Tags
The list of bug tags defined as official.
Owner
The restricted team, moderated team, or person who maintains the distribution information in Launchpad.
Redirect the default traversal
If true, the default traversal is for migration and redirects to a different canonical URL.
Redirect release pocket uploads
Redirect release pocket uploads to proposed pocket
Registrant
The distro's registrant.
Summary
A short paragraph to introduce the goals and highlights of the distribution.
Title
The distro's title.
VCS
Version control system for this distribution's code.
Active
Whether or not this item is active.
After reporting a bug, I can expect the following.
This message of acknowledgement will be displayed to anyone after reporting a bug.
Helpful guidelines for reporting a bug
These guidelines will be shown to everyone reporting a bug and should be text or a bulleted list with your particular requirements, if any.
Bug Supervisor
The Launchpad id of the person or team (preferred) responsible for bug management.
Current series
The current development series of this distribution. Note that all maintainerships refer to the current series. When people ask about the state of packages in the distribution, we should interpret that query in the context of the currentseries.
Date created
The date this distribution was registered.
Default traversal policy
The type of object that /{distro}/{name} URLs for this distribution resolve to.
Description
Details about the distributions's work, highlights, goals, and how to contribute. Use plain text, paragraphs are preserved and URLs are linked in pages. Don't repeat the Summary.
Alias for development series
If set, an alias for the current development series in this distribution.
Display Name
The displayable name of the distribution.
Web site URL
The distro's web site URL.
Driver
The person or team responsible for decisions about features and bugs that will be targeted for any series in this distribution. Note that you can also specify a driver on each series whose permissions will be limited to that specific series.
Homepage Content
The content of this distribution's home page. Edit this and it will be displayed for all the world to see. It is NOT a wiki so you cannot undo changes.
Icon
A small image of exactly 14x14 pixels and at most 5kb in size, that can be used to identify this distribution. The icon will be displayed everywhere we list the distribution and link to it.
Logo
An image of exactly 64x64 pixels that will be displayed in the heading of all pages related to this distribution. It should be no bigger than 50kb in size.
Members
The distro's members team.
Mirror Administrator
The person or team that has the rights to review and mark this distribution's mirrors as official.
Brand
A large image of exactly 192x192 pixels, that will be displayed on this distribution's home page in Launchpad. It should be no bigger than 100kb in size.
Name
The distro's name.
OCI Project Administrator
The person or team that has the rights to manage OCI Projects for this distribution.
Official Bug Tags
The list of bug tags defined as official.
Owner
The restricted team, moderated team, or person who maintains the distribution information in Launchpad.
Redirect the default traversal
If true, the default traversal is for migration and redirects to a different canonical URL.
Redirect release pocket uploads
Redirect release pocket uploads to proposed pocket
Summary
A short paragraph to introduce the goals and highlights of the distribution.
Title
The distro's title.
VCS
Version control system for this distribution's code.
Return this mirror's overall freshness.
For ARCHIVE mirrors, the overall freshness is the worst freshness of all of this mirror's content objects (MirrorDistroArchSeries, MirrorDistroSeriesSource or MirrorCDImageDistroSeriess).
For RELEASE mirrors, the overall freshness is either UPTODATE, if the mirror contains all ISO images that it should or UNKNOWN if it doesn't contain one or more ISO images.
Content
Choose "CD Image" if this mirror contains CD images of this distribution. Choose "Archive" if this is a mirror of packages for this distribution.
Location
The country in which this mirror is based.
Country DNS Mirror
Whether this is a country mirror in DNS.
Date Created
The date on which this mirror was registered.
Date reviewed
The date on which this mirror was last reviewed by a mirror admin.
Organisation
The name of the organization hosting this mirror.
Distribution
The distribution that is mirrored
FTP URL
HTTP URL
Name
A short and unique name for this mirror.
Owner
The person who is set as the current administrator of thismirror.
Reviewer
The person who last reviewed this mirror.
Rsync URL
e.g.: rsync://archive.ubuntu.com/ubuntu/
Status
The current status of a mirror's registration.
Whiteboard
Notes on the current status of the mirror (only visible to admins and the mirror's registrant).
Content
Choose "CD Image" if this mirror contains CD images of this distribution. Choose "Archive" if this is a mirror of packages for this distribution.
Location
The country in which this mirror is based.
Country DNS Mirror
Whether this is a country mirror in DNS.
Organisation
The name of the organization hosting this mirror.
FTP URL
HTTP URL
Name
A short and unique name for this mirror.
Owner
The person who is set as the current administrator of thismirror.
Rsync URL
e.g.: rsync://archive.ubuntu.com/ubuntu/
Status
The current status of a mirror's registration.
Whiteboard
Notes on the current status of the mirror (only visible to admins and the mirror's registrant).
Represents a source package in a distribution.
Create IDistributionSourcePackages by invoking IDistribution.getSourcePackage().
Return all the subscriptions with the specified levels.
| return: | A sequence of IStructuralSubscription. |
|---|
Search the IBugTasks reported on this entity.
| search_params: | a BugTaskSearchParams object |
|---|
Return an iterable of matching results.
Note: milestone is currently ignored for all IBugTargets except IProduct.
Status upstream
Indicates the status of any remote watches associated with the bug. Possible values include: pending_bugwatch, hide_upstream, resolved_upstream, and open_upstream.
Tags
String or list of strings for tags to search. To exclude, prepend a '-', e.g. '-unwantedtag'
Status
Show only bugs with the given status value or list of values.
Tags combination
Search for any or all of the tags specified.
Component
Distribution package archive grouping. E.g. main, universe, multiverse
Importance
Show only bugs with the given importance or list of importances.
Information Type
Show only bugs with the given information type or list of information types.
Milestone
Show only bug tasks targeted to this milestone.
Returns all branches with the given lifecycle status.
| param status: | A list of statuses to filter with. |
|---|---|
| param visible_by_user: | |
| Normally the user who is asking. | |
| param modified_since: | |
| If set, filters the branches being returned to those that have been modified since the specified date/time. | |
| param eager_load: | |
| If True load related objects for the whole collection. | |
| returns: | A list of IBranch. |
Returns all merge proposals of a given status.
| param status: | A list of statuses to filter with. |
|---|---|
| param visible_by_user: | |
| Normally the user who is asking. | |
| param eager_load: | |
| If True, load related objects for the whole collection. | |
| returns: | A list of IBranchMergeProposal. |
Add a bug subscription filter for this structure.
This method is used to create a new IBugSubscriptionFilter for the target. It will initially allow all notifications to be sent.
| subscriber: | The IPerson who will be subscribed. If omitted, subscribed_by will be used. |
|---|---|
| subscribed_by: | The IPerson creating the subscription. |
| return: | The new bug subscription filter. |
Add a bug subscription for this structure.
This method is used to create a new IStructuralSubscription for the target. This initially has a single filter which will allow all notifications will be sent.
| subscriber: | The IPerson who will be subscribed. If omitted, subscribed_by will be used. |
|---|---|
| subscribed_by: | The IPerson creating the subscription. |
| return: | The new bug subscription. |
Create a new code import.
| param registrant: | |
|---|---|
| The IPerson to record as the registrant of the import. | |
| param branch_name: | |
| The name of the branch or repository to create. | |
| param rcs_type: | The type of the foreign VCS. |
| param target_rcs_type: | |
| The type of the branch or repository to create (Bazaar or Git). | |
| param url: | The URL to import from if the VCS type uses a single URL (i.e. isn't CVS). |
| param cvs_root: | The CVSROOT for a CVS import. |
| param cvs_module: | |
| The module to import for a CVS import. | |
| param owner: | Who should own the created branch or repository, or None for it to be the same as the registrant, or the caller over the API. |
| returns: | An instance of ICodeImport. |
Remove a subscription to bugs from this structure.
This will delete all associated filters.
| subscriber: | The IPerson who will be unsubscribed. If omitted, unsubscribed_by will be used. |
|---|---|
| unsubscribed_by: | |
| The IPerson removing the subscription. | |
After reporting a bug, I can expect the following.
This message of acknowledgement will be displayed to anyone after reporting a bug.
Helpful guidelines for reporting a bug
These guidelines will be shown to everyone reporting a bug and should be text or a bulleted list with your particular requirements, if any.
Official Bug Tags
The list of bug tags defined as official.
After reporting a bug, I can expect the following.
This message of acknowledgement will be displayed to anyone after reporting a bug.
Helpful guidelines for reporting a bug
These guidelines will be shown to everyone reporting a bug and should be text or a bulleted list with your particular requirements, if any.
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.
| param build_state: | |
|---|---|
| optional BuildStatus value for filtering build records; | |
| param name: | optional string for filtering build source package name. Sub-string matching is allowed via SQL LIKE. |
| param pocket: | optional PackagePublishingPocket value for filtering build records; |
| param arch_tag: | optional string for filtering build source packages by their architecture tag; |
| param user: | optional IPerson corresponding to the user performing the request. It will filter out build records for which the user have no 'view' permission. |
| param binary_only: | |
| optional boolean indicating whether only BinaryPackageBuild objects should be returned, or more general PackageBuild objects (which may include, for example, SourcePackageRecipeBuild objects. | |
| return: | 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). |
Build status
The status of this build record
The pocket into which this entry is published
Architecture Tag
The architecture tag, or short piece of text that identifies this architecture. All binary packages in the archive will use this tag in their filename. Please get it correct. It should really never be changed!
Build chroot URL
The URL to the current build chroot for this distroarchseries.
Display name
The display name of this distroarchseries.
Is Nominated Arch Independent
True if this distroarchseries is the NominatedArchIndep one.
Main Archive
The main archive of the distroarchseries.
Official Support
Indicate whether or not this port has official support from the vendor of the distribution.
Package Count
A cache of the number of packages published in the RELEASE pocket of this port.
PPA support available
Indicate whether or not this port has support for building PPA packages.
Title
The title of this distroarchseries.
Architecture Tag
The architecture tag, or short piece of text that identifies this architecture. All binary packages in the archive will use this tag in their filename. Please get it correct. It should really never be changed!
Display name
The display name of this distroarchseries.
Is Nominated Arch Independent
True if this distroarchseries is the NominatedArchIndep one.
Main Archive
The main archive of the distroarchseries.
Official Support
Indicate whether or not this port has official support from the vendor of the distribution.
Package Count
A cache of the number of packages published in the RELEASE pocket of this port.
Title
The title of this distroarchseries.
A filter for packages to be included in or excluded from a DAS.
Since package sets can include other package sets, a single package set is flexible enough for this. However, one might reasonably want to either include some packages ("this architecture is obsolescent or experimental and we only want to build a few packages for it") or exclude some packages ("this architecture can't handle some packages so we want to make them go away centrally").
Creator
The user who created this filter.
Date created
The time when this filter was created.
Date last modified
The time when this filter was last modified.
Distro arch series
The distro arch series that this filter is for.
Package set
The package set to be included in or excluded from this distro arch series.
Sense
Whether the filter represents packages to include or exclude from the distro arch series.
Comment text
The comment text for the related distro series difference.
Source package name
Name of the source package that this comment is for.
Removes this difference from the blocklist and adds a comment on this difference.
The status will be updated based on the versions.
| param commenter: | |
|---|---|
| The requestor IPerson. | |
| param comment: | The comment string. |
| return: | The created DistroSeriesDifferenceComment object. |
Blocklists this version or all versions of this source package and adds a comment on this difference.
| param commenter: | |
|---|---|
| The requestor IPerson. | |
| param comment: | The comment string. |
| param all: | Indicates whether all versions of this package should be blocklisted or just the current (default). |
| return: | The created DistroSeriesDifferenceComment object. |
Requests IPackageDiffs for the derived and parent version.
| raises DistroSeriesDifferenceError: | |
|---|---|
| When package diffs cannot be requested. | |
Base version
The common base version of the package for differences with different versions in the parent and derived series.
Derived series
The distribution series which identifies the derived series with the difference.
Package diff status
The status of the diff between the base version and the derived version.
Package diff url
The url for the diff between the base version and the derived version.
Parent package diff status
The status of the diff between the base version and the parent version.
Parent package diff url
The url for the diff between the base version and the parent version.
Parent series
The distribution series which identifies the parent series with the difference.
Parent source version
The version of the most recent source publishing in the parent series.
Source version
The version of the most recent source publishing in the derived series.
Distro series difference status.
The current status of this difference.
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.
| param build_state: | |
|---|---|
| optional BuildStatus value for filtering build records; | |
| param name: | optional string for filtering build source package name. Sub-string matching is allowed via SQL LIKE. |
| param pocket: | optional PackagePublishingPocket value for filtering build records; |
| param arch_tag: | optional string for filtering build source packages by their architecture tag; |
| param user: | optional IPerson corresponding to the user performing the request. It will filter out build records for which the user have no 'view' permission. |
| param binary_only: | |
| optional boolean indicating whether only BinaryPackageBuild objects should be returned, or more general PackageBuild objects (which may include, for example, SourcePackageRecipeBuild objects. | |
| return: | 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). |
Build status
The status of this build record
The pocket into which this entry is published
Search the IBugTasks reported on this entity.
| search_params: | a BugTaskSearchParams object |
|---|
Return an iterable of matching results.
Note: milestone is currently ignored for all IBugTargets except IProduct.
Status upstream
Indicates the status of any remote watches associated with the bug. Possible values include: pending_bugwatch, hide_upstream, resolved_upstream, and open_upstream.
Tags
String or list of strings for tags to search. To exclude, prepend a '-', e.g. '-unwantedtag'
Status
Show only bugs with the given status value or list of values.
Tags combination
Search for any or all of the tags specified.
Component
Distribution package archive grouping. E.g. main, universe, multiverse
Importance
Show only bugs with the given importance or list of importances.
Information Type
Show only bugs with the given information type or list of information types.
Milestone
Show only bug tasks targeted to this milestone.
Get package upload records for this distribution series.
| param status: | Filter results by this PackageUploadStatus, or list of statuses. |
|---|---|
| param created_since_date: | |
| If specified, only returns items uploaded since the timestamp supplied. | |
| param archive: | Filter results for this IArchive. |
| param pocket: | Filter results by this PackagePublishingPocket or a list of PackagePublishingPocket. |
| param custom_type: | |
| Filter results by this PackageUploadCustomFormat. | |
| param name: | Filter results by this file name or package name. |
| param version: | Filter results by this version number string. |
| param exact_match: | |
| If 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. | |
| return: | A result set containing IPackageUpload. |
Package Upload Status
Return only items that have this status.
Archive
Return only items for this archive.
Exact match
Whether to filter name and version by exact matching.
Created Since Timestamp
Return items that are more recent than this timestamp.
Return only items targeted to this pocket
Custom Type
Return only items with custom files of this type.
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.
Return an iterator over all its translation templates.
The returned templates are either obsolete or current.
| return: | A sequence of IPOTemplate. |
|---|
Return entries in the translation import queue for this entity.
| arg import_status: | |
|---|---|
| RosettaImportStatus DB Schema entry. | |
| arg file_extension: | |
| String with the file type extension, usually 'po' or 'pot'. | |
If one of both of 'import_status' or 'file_extension' are given, the returned entries are filtered based on those values.
Filename extension
Show only entries with this filename suffix
Status
Show only entries with this status
Return all the subscriptions with the specified levels.
| return: | A sequence of IStructuralSubscription. |
|---|
Add a bug subscription filter for this structure.
This method is used to create a new IBugSubscriptionFilter for the target. It will initially allow all notifications to be sent.
| subscriber: | The IPerson who will be subscribed. If omitted, subscribed_by will be used. |
|---|---|
| subscribed_by: | The IPerson creating the subscription. |
| return: | The new bug subscription filter. |
Initialize this series from parents.
This method performs checks and then creates a job to populate the new distroseries.
| param parents: | The list of parent ids this series will derive from. |
|---|---|
| param architectures: | |
| The architectures to copy to the derived series. If not specified, all of the architectures are copied. | |
| param archindep_archtag: | |
| The architecture tag used to build architecture-independent packages. If not specified, one from the parents' will be used. | |
| param packagesets: | |
| The packagesets to copy to the derived series. If not specified, all of the packagesets are copied. | |
| param rebuild: | Whether binaries will be copied to the derived series. If it's true, they will not be, and if it's false, they will be. |
| param overlays: | A list of booleans indicating, for each parent, if the parent/child relationship should be an overlay. |
| param overlay_pockets: | |
| The list of pockets names to use for overlay relationships. | |
| param overlay_components: | |
| The list of components names to use for overlay relationships. | |
Name
Only letters, numbers, and simple punctuation are allowed.
Date Targeted
Example: 2005-11-24
Summary
A summary of the features and status of this milestone.
Code name
An alternative name for the milestone.
Remove a subscription to bugs from this structure.
This will delete all associated filters.
| subscriber: | The IPerson who will be unsubscribed. If omitted, unsubscribed_by will be used. |
|---|---|
| unsubscribed_by: | |
| The IPerson removing the subscription. | |
Add a bug subscription for this structure.
This method is used to create a new IStructuralSubscription for the target. This initially has a single filter which will allow all notifications will be sent.
| subscriber: | The IPerson who will be subscribed. If omitted, subscribed_by will be used. |
|---|---|
| subscribed_by: | The IPerson creating the subscription. |
| return: | The new bug subscription. |
Active
Whether or not this series is stable and supported, or under current development. This excludes series which are experimental or obsolete.
Advertise by-hash directories
Advertise by-hash directories with a flag in the Release file so that apt uses them by default. Only effective if publish_by_hash is also set.
Enabled architectures
All architectures in this series with the 'enabled' flag set.
After reporting a bug, I can expect the following.
This message of acknowledgement will be displayed to anyone after reporting a bug.
Helpful guidelines for reporting a bug
These guidelines will be shown to everyone reporting a bug and should be text or a bulleted list with your particular requirements, if any.
Email changes to
The mailing list or other email address that Launchpad should notify about new uploads.
Description
A detailed description of this series, with information on the architectures covered, the availability of security updates and any other relevant information.
Display name
The series displayname.
Distribution
The distribution for which this is a series.
Driver
The person or team responsible for decisions about features and bugs that will be targeted to this series of the distribution.
Series full name
The series full name, e.g. Ubuntu Warty
Include long descriptions in Packages rather than in Translation-en
If True, write long descriptions to the per-architecture Packages files; if False, write them to a Translation-en file common across architectures instead. Using a common file reduces the bandwidth footprint of enabling multiarch on clients, which requires downloading Packages files for multiple architectures.
Compression types to use for published index files
A list of compression types to use for published index files (Packages, Sources, etc.).
Request a full language pack export
Whether next language pack generation will be a full export. This information is useful when update packs are too big and want to merge all those changes in the base pack.
Name
The name of this series.
Official Bug Tags
The list of bug tags defined as official.
Owning team of the derived series
This attribute mirrors the owner of the distribution.
Parent series
The series from which this one was branched.
Publish by-hash directories
Publish archive index files in by-hash directories so that apt can retrieve them based on their hash, avoiding race conditions between InRelease and other files during mirror updates.
Summary
A single paragraph that explains the goals of of this series and the intended users. For example: "The 2.0 series of Apache represents the current stable series, and is recommended for all new deployments".
Supported
Whether or not this series is currently supported.
Title
The title of this series. It should be distinctive and designed to look good at the top of a page.
Version
The version string for this series.
Active
Whether or not this series is stable and supported, or under current development. This excludes series which are experimental or obsolete.
Advertise by-hash directories
Advertise by-hash directories with a flag in the Release file so that apt uses them by default. Only effective if publish_by_hash is also set.
After reporting a bug, I can expect the following.
This message of acknowledgement will be displayed to anyone after reporting a bug.
Helpful guidelines for reporting a bug
These guidelines will be shown to everyone reporting a bug and should be text or a bulleted list with your particular requirements, if any.
Email changes to
The mailing list or other email address that Launchpad should notify about new uploads.
Description
A detailed description of this series, with information on the architectures covered, the availability of security updates and any other relevant information.
Display name
The series displayname.
Distribution
The distribution for which this is a series.
Driver
The person or team responsible for decisions about features and bugs that will be targeted to this series of the distribution.
Series full name
The series full name, e.g. Ubuntu Warty
Include long descriptions in Packages rather than in Translation-en
If True, write long descriptions to the per-architecture Packages files; if False, write them to a Translation-en file common across architectures instead. Using a common file reduces the bandwidth footprint of enabling multiarch on clients, which requires downloading Packages files for multiple architectures.
Compression types to use for published index files
A list of compression types to use for published index files (Packages, Sources, etc.).
Request a full language pack export
Whether next language pack generation will be a full export. This information is useful when update packs are too big and want to merge all those changes in the base pack.
Name
The name of this series.
Publish by-hash directories
Publish archive index files in by-hash directories so that apt can retrieve them based on their hash, avoiding race conditions between InRelease and other files during mirror updates.
Summary
A single paragraph that explains the goals of of this series and the intended users. For example: "The 2.0 series of Apache represents the current stable series, and is recommended for all new deployments".
Supported
Whether or not this series is currently supported.
Title
The title of this series. It should be distinctive and designed to look good at the top of a page.
Version
The version string for this series.
A document containing the answer to a commonly asked question.
The answer can be in the document itself or can be hosted on a separate web site and referred to by URL.
Commit SHA-1
The full SHA-1 object name of the commit object referenced by this reference.
Dependent landings
A collection of the merge proposals that are dependent on this reference.
Landing candidates
A collection of the merge proposals where this reference is the target.
Landing targets
A collection of the merge proposals where this reference is the source.
Path
The full path of this reference, e.g. refs/heads/master.
Repository
The Git repository containing this reference.
Date last repacked
The date that this repository was last repacked.
Date last scanned
The date when pack statistics were last updated for this repository.
Default branch
The full path to the default branch for this repository, e.g. refs/heads/master.
Dependent landings
A collection of the merge proposals that are dependent on this repository.
Description
A short description of this repository.
Display name
Display name of the repository.
HTTPS URL
An HTTPS URL for this repository, or None in the case of private repositories.
Git identity
If this is the default repository for some target, then this is 'lp:' plus a shortcut version of the path via that target. Otherwise it is simply 'lp:' plus the unique name.
SSH URL
A git+ssh:// URL for this repository.
Information type
The type of information contained in this repository.
Landing candidates
A collection of the merge proposals where this repository is the target.
Landing targets
A collection of the merge proposals where this repository is the source.
Loose object count
The number of loose objects for this repository.
Name
The repository name. Keep very short, unique, and descriptive, because it will be used in URLs.
Owner
The owner of this Git repository. This controls who can modify the repository.
Owner default
Whether this repository is the default for its owner and target.
Pack count
The number of packs for this repository.
Private
This repository is visible only to its subscribers.
Registrant
The person who registered this Git repository.
Repository type
The way this repository is hosted: directly on Launchpad, or imported from somewhere else.
Review Team
The reviewer of a repository is the person or exclusive team that is responsible for reviewing proposals and merging into this repository.
Target default
Whether this repository is the default for its target.
Unique name
Unique name of the repository, including the owner and project names.
Default branch
The full path to the default branch for this repository, e.g. refs/heads/master.
Description
A short description of this repository.
Review Team
The reviewer of a repository is the person or exclusive team that is responsible for reviewing proposals and merging into this repository.
Generated Diff Size Limit
Diffs greater than the specified number of lines will not be sent to the subscriber. The subscriber will still receive an email with the new revision details even if the diff is larger than the specified number of lines.
Notification Level
Attribute notifications are sent when repository details are changed such as lifecycle status and name. Revision notifications are generated when new revisions are found.
Person
Enter the launchpad id, or email address of the person you wish to subscribe to this repository. If you are unsure, use the "Choose..." option to find the person in Launchpad. You can only subscribe someone who is a registered user of the system.
Code review Level
Control the kind of review activity that triggers notifications.
Subscribed by
The person who created this subscription.
Generated Diff Size Limit
Diffs greater than the specified number of lines will not be sent to the subscriber. The subscriber will still receive an email with the new revision details even if the diff is larger than the specified number of lines.
Notification Level
Attribute notifications are sent when repository details are changed such as lifecycle status and name. Revision notifications are generated when new revisions are found.
Code review Level
Control the kind of review activity that triggers notifications.
Search the IBugTasks reported on this entity.
| search_params: | a BugTaskSearchParams object |
|---|
Return an iterable of matching results.
Note: milestone is currently ignored for all IBugTargets except IProduct.
Status upstream
Indicates the status of any remote watches associated with the bug. Possible values include: pending_bugwatch, hide_upstream, resolved_upstream, and open_upstream.
Tags
String or list of strings for tags to search. To exclude, prepend a '-', e.g. '-unwantedtag'
Status
Show only bugs with the given status value or list of values.
Tags combination
Search for any or all of the tags specified.
Component
Distribution package archive grouping. E.g. main, universe, multiverse
Importance
Show only bugs with the given importance or list of importances.
Information Type
Show only bugs with the given information type or list of information types.
Milestone
Show only bug tasks targeted to this milestone.
An entity that has a translation import queue.
Examples include ProductSeries, SourcePackage, DistroSeries, and Person.
Return entries in the translation import queue for this entity.
| arg import_status: | |
|---|---|
| RosettaImportStatus DB Schema entry. | |
| arg file_extension: | |
| String with the file type extension, usually 'po' or 'pot'. | |
If one of both of 'import_status' or 'file_extension' are given, the returned entries are filtered based on those values.
Filename extension
Show only entries with this filename suffix
Status
Show only entries with this status
Plural form expression
The expression that relates a number of items to the appropriate plural form.
Number of plural forms
The number of plural forms this language has.
Text direction
The direction of text in this language.
Visible
Whether this language is visible by default.
Plural form expression
The expression that relates a number of items to the appropriate plural form.
Number of plural forms
The number of plural forms this language has.
Text direction
The direction of text in this language.
Visible
Whether this language is visible by default.
Build Log URL
A URL for the build log. None if there is no log available.
Builder
The builder assigned to this job.
Status
The current status of the job.
Can be cancelled
Whether this build record can be cancelled.
Can be rescored
Whether this build record can be rescored manually.
Date finished
The actual build start time. Set when the build is dispatched the first time and not changed in subsequent build attempts.
Date finished
The timestamp when the build farm job was finished.
Date created
The timestamp when the build farm job was created.
Dependencies
Debian-like dependency line that must be satisfied before attempting to build this request.
Distribution
Shortcut for its distribution.
Distribution series
Shortcut for its distribution series.
Upload Log URL
A URL for failed upload logs.Will be None if there was no failure.
Build Log URL
A URL for the build log. None if there is no log available.
Status
The current status of the job.
Dependencies
Debian-like dependency line that must be satisfied before attempting to build this request.
Distribution
Shortcut for its distribution.
Distribution series
Shortcut for its distribution series.
Upload Log URL
A URL for failed upload logs.Will be None if there was no failure.
All builds of this live filesystem.
All builds of this live filesystem, sorted in descending order of finishing (or starting if not completed successfully).
Completed builds of this live filesystem.
Completed builds of this live filesystem, sorted in descending order of finishing.
Distro Series
The series for which the image should be built.
Binary file retention period
Keep binary files attached to builds of this live filesystem for at least this many days. If unset, disable pruning.
Name
The name of the live filesystem image.
Owner
The owner of this live filesystem image.
Pending builds of this live filesystem.
Pending builds of this live filesystem, sorted in descending order of creation.
Registrant
The person who registered this live filesystem image.
Relative build score
A delta to apply to all build scores for the live filesystem. Builds with a higher score will build sooner.
Require virtualized builders
Only build this live filesystem image on virtual builders.
Distro Series
The series for which the image should be built.
Binary file retention period
Keep binary files attached to builds of this live filesystem for at least this many days. If unset, disable pruning.
Name
The name of the live filesystem image.
Owner
The owner of this live filesystem image.
Relative build score
A delta to apply to all build scores for the live filesystem. Builds with a higher score will build sooner.
Require virtualized builders
Only build this live filesystem image on virtual builders.
Return all the subscriptions with the specified levels.
| return: | A sequence of IStructuralSubscription. |
|---|
Search the IBugTasks reported on this entity.
| search_params: | a BugTaskSearchParams object |
|---|
Return an iterable of matching results.
Note: milestone is currently ignored for all IBugTargets except IProduct.
Status upstream
Indicates the status of any remote watches associated with the bug. Possible values include: pending_bugwatch, hide_upstream, resolved_upstream, and open_upstream.
Tags
String or list of strings for tags to search. To exclude, prepend a '-', e.g. '-unwantedtag'
Status
Show only bugs with the given status value or list of values.
Tags combination
Search for any or all of the tags specified.
Component
Distribution package archive grouping. E.g. main, universe, multiverse
Importance
Show only bugs with the given importance or list of importances.
Information Type
Show only bugs with the given information type or list of information types.
Milestone
Show only bug tasks targeted to this milestone.
Add a bug subscription filter for this structure.
This method is used to create a new IBugSubscriptionFilter for the target. It will initially allow all notifications to be sent.
| subscriber: | The IPerson who will be subscribed. If omitted, subscribed_by will be used. |
|---|---|
| subscribed_by: | The IPerson creating the subscription. |
| return: | The new bug subscription filter. |
Add a bug subscription for this structure.
This method is used to create a new IStructuralSubscription for the target. This initially has a single filter which will allow all notifications will be sent.
| subscriber: | The IPerson who will be subscribed. If omitted, subscribed_by will be used. |
|---|---|
| subscribed_by: | The IPerson creating the subscription. |
| return: | The new bug subscription. |
Create a new ProductRelease.
| param owner: | IPerson object who manages the release. |
|---|---|
| param datereleased: | |
| Date of the product release. | |
| param changelog: | |
| Detailed changes in each version. | |
| param release_notes: | |
| Overview of changes in each version. | |
| returns: | IProductRelease object. |
Date released
The date this release was published. Before release, this should have an estimated release date.
Changelog
A description of every change in the release.
Release notes
A description of important new features (though the changelog below might repeat some of this information).
Remove a subscription to bugs from this structure.
This will delete all associated filters.
| subscriber: | The IPerson who will be unsubscribed. If omitted, unsubscribed_by will be used. |
|---|---|
| unsubscribed_by: | |
| The IPerson removing the subscription. | |
Code name
An alternative name for the milestone.
Date Targeted
Example: 2005-11-24
Active
Whether or not this object should be shown in web forms for targeting.
Name
Only letters, numbers, and simple punctuation are allowed.
Official Bug Tags
The list of bug tags defined as official.
Summary
A summary of the features and status of this milestone.
Code name
An alternative name for the milestone.
Date Targeted
Example: 2005-11-24
Active
Whether or not this object should be shown in web forms for targeting.
Name
Only letters, numbers, and simple punctuation are allowed.
Summary
A summary of the features and status of this milestone.
Template is active
If unchecked, people can no longer change the template's translations.
Description
Please provide a brief description of the content of this translation template, for example, telling translators if this template contains strings for end-users or other developers.
Include translations for this template in language packs?
Check this box if this template is part of a language pack so its translations should be exported that way.
Template name
The name of this PO template, for example 'evolution-2.2'. Each translation template has a unique name in its package. It's important to get this correct, because Launchpad will recommend alternative translations based on the name.
Owner
The owner of the template in Launchpad can edit the template and change it's status, and can also upload new versions of the template when a new release is made or when the translation strings have been changed during development.
Priority
A number that describes how important this template is. Often there are multiple templates, and you can use this as a way of indicating which are more important and should be translated first. Pick any number - higher priority templates will generally be listed first.
Translation domain
The translation domain for a translation template. Used with PO file format when generating MO files for inclusion in language pack or MO tarball exports.
Template is active
If unchecked, people can no longer change the template's translations.
Description
Please provide a brief description of the content of this translation template, for example, telling translators if this template contains strings for end-users or other developers.
Include translations for this template in language packs?
Check this box if this template is part of a language pack so its translations should be exported that way.
Template name
The name of this PO template, for example 'evolution-2.2'. Each translation template has a unique name in its package. It's important to get this correct, because Launchpad will recommend alternative translations based on the name.
Owner
The owner of the template in Launchpad can edit the template and change it's status, and can also upload new versions of the template when a new release is made or when the translation strings have been changed during development.
Priority
A number that describes how important this template is. Often there are multiple templates, and you can use this as a way of indicating which are more important and should be translated first. Pick any number - higher priority templates will generally be listed first.
Translation domain
The translation domain for a translation template. Used with PO file format when generating MO files for inclusion in language pack or MO tarball exports.
Archive
The archive for this upload.
Copy source archive
The archive from which this package was copied, if any.
Custom file URLs
Librarian URLs for all the custom files attached to this upload.
Date created
The date this package upload was done.
Series
The distroseries targeted by this upload.
The pocket
The pocket targeted by this upload.
Queue status
The status of this upload.
Date created
The date this package upload was done.
Series
The distroseries targeted by this upload.
The pocket
The pocket targeted by this upload.
Get source package names not included by another package set.
Which source package names included by this package are not included by the other_package_set?
Please note: this method was mainly introduced in order to facilitate the listing of source package names via the LP web services API. It returns string names as opposed to ISourcePackageName instances.
| param other_package_set: | |
|---|---|
| the other package set | |
| param direct_inclusion: | |
| if this flag is set to True only directly included sources will be considered. | |
| return: | A (potentially empty) sequence of string source package names. |
Get all package sets that are included by this one.
Return all package sets that are directly or indirectly included by this one.
| param direct_inclusion: | |
|---|---|
| if this flag is set to True only sets directly included by this one will be considered. | |
| return: | A (potentially empty) sequence of IPackageset instances. |
Get all package sets that include this one.
Return all package sets that directly or indirectly include this one.
| param direct_inclusion: | |
|---|---|
| if this flag is set to True only sets directly including this one will be considered. | |
| return: | A (potentially empty) sequence of IPackageset instances. |
Get all source names associated with this package set.
This method returns the source package names that are directly or indirectly associated with the package set at hand. Indirect associations may be defined through package set successors.
Please note: this method was mainly introduced in order to facilitate the listing of source package names via the LP web services API. It returns string names as opposed to ISourcePackageName instances.
| param direct_inclusion: | |
|---|---|
| if this flag is set to True only sources directly included by this package set will be considered. | |
| return: | A (potentially empty) sequence of string source package names. |
Get all other package sets in this set's PackagesetGroup.
Returns all package sets that are related to this one, but not this one itself.
| return: | A (potentially empty) sequence of IPackageset instances. |
|---|
Get source package names also included by another package set.
What source package names does this package set have in common with the other_package_set?
Please note: this method was mainly introduced in order to facilitate the listing of source package names via the LP web services API. It returns string names as opposed to ISourcePackageName instances.
| param other_package_set: | |
|---|---|
| the other package set | |
| param direct_inclusion: | |
| if this flag is set to True only directly included sources will be considered. | |
| return: | A (potentially empty) sequence of string source package names. |
Add the named package sets as subsets to this package set.
Any passed source package names will become directly associated with the package set at hand.
This function is idempotent in the sense that package subsets that are already directly associated with a package set will be ignored.
This method facilitates the addition of package subsets via the LP web services API. It takes string names as opposed to IPackageset instances.
| param names: | an iterable with string package set names |
|---|
Add the named source packages to this package set.
Any passed source package names will become directly associated with the package set at hand.
This function is idempotent in the sense that source package names that are already directly associated with a package set will be ignored.
This method facilitates the addition of source package names to package sets via the LP web services API. It takes string names as opposed to ISourcePackageName instances. Non-existing source package names will be ignored.
| param names: | an iterable with string source package names |
|---|
Remove the named source packages from this package set.
Only source package names directly included by this package set can be removed. Any others will be ignored.
This method facilitates the removal of source package names from package sets via the LP web services API. It takes string names as opposed to ISourcePackageName instances.
| param names: | an iterable with string source package names |
|---|
Remove the named package subsets from this package set.
Only package subsets directly included by this package set can be removed. Any others will be ignored.
This method facilitates the removal of package subsets via the LP web services API. It takes string names as opposed to IPackageset instances.
| param names: | an iterable with string package set names |
|---|
Date Created
The creation date/time for the package set at hand.
Description
The description for the package set at hand.
Distribution series
The distroseries to which this package set is related.
Person
The person who owns this package set.
Build score
Build score bonus for packages in this package set.
Description
The description for the package set at hand.
Person
The person who owns this package set.
Build score
Build score bonus for packages in this package set.
Return private archive URLs that this person can see.
For each of the private archives (PPAs) that this person can see, return a URL that includes the HTTP basic auth data. The URL returned is suitable for including in a sources.list file.
Return the packages for which this person is a bug subscriber.
Returns a list of IDistributionSourcePackage's, ordered alphabetically (A to Z) by name.
Return entries in the translation import queue for this entity.
| arg import_status: | |
|---|---|
| RosettaImportStatus DB Schema entry. | |
| arg file_extension: | |
| String with the file type extension, usually 'po' or 'pot'. | |
If one of both of 'import_status' or 'file_extension' are given, the returned entries are filtered based on those values.
Filename extension
Show only entries with this filename suffix
Status
Show only entries with this status
Returns merge proposals where a person was asked to review.
This does not include merge proposals that were requested from teams that the person is part of. If status is not passed then it will return proposals that are in the "Needs Review" state.
| param status: | A list of statuses to filter with. |
|---|---|
| param visible_by_user: | |
| Normally the user who is asking. | |
| returns: | A list of IBranchMergeProposal. |
Search the IBugTasks reported on this entity.
| search_params: | a BugTaskSearchParams object |
|---|
Return an iterable of matching results.
Note: milestone is currently ignored for all IBugTargets except IProduct.
Status upstream
Indicates the status of any remote watches associated with the bug. Possible values include: pending_bugwatch, hide_upstream, resolved_upstream, and open_upstream.
Tags
String or list of strings for tags to search. To exclude, prepend a '-', e.g. '-unwantedtag'
Status
Show only bugs with the given status value or list of values.
Tags combination
Search for any or all of the tags specified.
Component
Distribution package archive grouping. E.g. main, universe, multiverse
Importance
Show only bugs with the given importance or list of importances.
Information Type
Show only bugs with the given information type or list of information types.
Milestone
Show only bug tasks targeted to this milestone.
Returns all branches with the given lifecycle status.
| param status: | A list of statuses to filter with. |
|---|---|
| param visible_by_user: | |
| Normally the user who is asking. | |
| param modified_since: | |
| If set, filters the branches being returned to those that have been modified since the specified date/time. | |
| param eager_load: | |
| If True load related objects for the whole collection. | |
| returns: | A list of IBranch. |
Returns all merge proposals of a given status.
| param status: | A list of statuses to filter with. |
|---|---|
| param visible_by_user: | |
| Normally the user who is asking. | |
| param eager_load: | |
| If True, load related objects for the whole collection. | |
| returns: | A list of IBranchMergeProposal. |
Return a PPA with the given name if it exists.
| param name: | A string with the exact name of the ppa being looked up. |
|---|---|
| raises: | NoSuchPPA if a suitable PPA could not be found. |
| return: | a PPA IArchive record corresponding to the name. |
Return the people whose membership on this team match :status:.
If no orderby is provided, Person.sortingColumns is used.
Get a text line that is suitable to be used for a sources.list entry.
It will create a new IArchiveAuthToken if one doesn't already exist.
It raises Unauthorized if the context user does not have a valid subscription for the target archive or the caller is not context user itself.
Create a SourcePackageRecipe owned by this person.
| param name: | the name to use for referring to the recipe. |
|---|---|
| param description: | |
| A description of the recipe. | |
| param recipe_text: | |
| The text of the recipe. | |
| param distroseries: | |
| The distroseries to use. | |
| param registrant: | |
| The person who created this recipe. | |
| param daily_build_archive: | |
| The archive to use for daily builds. | |
| param build_daily: | |
| If True, build this recipe daily (if changed). | |
| return: | a SourcePackageRecipe. |
Accept an invitation to become a member of the given team.
There must be a TeamMembership for this person and the given team with the INVITED status. The status of this TeamMembership will be changed to APPROVED.
Create a PPA.
| param distribution: | |
|---|---|
| The distribution that this archive is for. | |
| param name: | The name of the new PPA to create. |
| param displayname: | |
| The displayname for the new PPA. | |
| param description: | |
| The description for the new PPA. | |
| param private: | Whether or not to create a private PPA. Defaults to False, which means the PPA will be public. |
| param suppress_subscription_notifications: | |
| Whether or not to suppress emails to new subscribers about their subscriptions. Only meaningful for private PPAs. | |
| raises: | PPACreationError if an error is encountered |
| return: | a PPA IArchive record. |
Join the given team if its membership_policy is not RESTRICTED.
Join the given team according to the policies and defaults of that team:
If may_subscribe_to_list is True, then also attempt to subscribe to the team's mailing list, depending on the list status and the person's auto-subscribe settings.
| param requester: | |
|---|---|
| The person who requested the membership on behalf of a team or None when a person requests the membership for themselves. | |
| param may_subscribe_to_list: | |
| If True, also try subscribing to the team mailing list. | |
Leave the given team.
This is a convenience method for retractTeamMembership() that allows a user to leave the given team, or to cancel a PENDING membership request.
| param team: | The team to leave. |
|---|
Decline an invitation to become a member of the given team.
There must be a TeamMembership for this person and the given team with the INVITED status. The status of this TeamMembership will be changed to INVITATION_DECLINED.
Add the given person as a member of this team.
| param person: | If the given person is already a member of this team we'll simply change its membership status. Otherwise a new TeamMembership is created with the given status. |
|---|---|
| param reviewer: | The user who made the given person a member of this team. |
| param comment: | String that will be assigned to the proponent_comment, reviewer_comment, or acknowledger comment. |
| param status: | TeamMembershipStatus value must be either Approved, Proposed or Admin. If the new member is a team, the status will be changed to Invited unless the user is also an admin of that team. |
| param force_team_add: | |
| If the person is actually a team and force_team_add is False, the team will actually be invited to join this one. Otherwise the team is added as if it were a person. | |
| param may_subscribe_to_list: | |
| If the person is not a team, and may_subscribe_to_list is True, then the person may be subscribed to the team's mailing list, depending on the list status and the person's auto-subscribe settings. | |
| return: | A tuple containing a boolean indicating when the membership status changed and the current TeamMembershipStatus. This depends on the desired status passed as an argument, the membership policy and the user's privileges. |
Retract this team's membership in the given team.
If there's a membership entry for this team on the given team and its status is either APPROVED, ADMIN, PENDING, or INVITED, the status is changed and the relevant entries in TeamParticipation.
APPROVED and ADMIN status are changed to DEACTIVATED. PENDING status is changed to DECLINED. INVITED status is changes to INVITATION_DECLINED.
| param team: | The team to leave. |
|---|---|
| param user: | The user making the retraction. |
| param comment: | An optional explanation about why the change was made. |
Default PPA
The PPA named 'ppa' owned by this person.
Confirmed emails of this person.
Confirmed emails are the ones in the VALIDATED state
Description
Details about interests and goals. Use plain text, paragraphs are preserved and URLs are linked.
Display Name
Your name as you would like it displayed throughout Launchpad. Most people use their full name here.
Homepage Content
Obsolete. Use description.
Karma
The cached total karma for this person.
Logo
An image of exactly 64x64 pixels that will be displayed in the heading of all pages related to you. Traditionally this is a logo, a small picture or a personal mascot. It should be no bigger than 50kb in size.
Mailing List Auto-subscription Policy
This attribute determines whether a person is automatically subscribed to a team's mailing list when the person joins said team.
Active TeamMemberships for this object's members.
Active TeamMemberships are the ones with the ADMIN or APPROVED status. The results are ordered using Person.sortingColumns.
Mugshot
A large image of exactly 192x192 pixels, that will be displayed on your home page in Launchpad. Traditionally this is a great big picture of your grinning face. Make the most of it! It should be no bigger than 100kb in size.
Name
A short unique name, beginning with a lower-case letter or number, and containing only letters, numbers, dots, hyphens, or plus signs.
Open membership invitations.
All TeamMemberships which represent an invitation (to join a team) sent to this person.
All participants of this team.
List of all direct and indirect people and teams who, one way or another, are a part of this team. If you want a method to check if a given person is a member of a team, you should probably look at IPerson.inTeam().
PPAs for this person.
PPAs owned by the context person ordered by name.
Preferred email address
The preferred email address for this person. The one we'll use to communicate with them.
This team is private
Private teams are visible only to their members.
All subteams of this team.
A subteam is any team that is a member (either directly or indirectly) of this team. As an example, let's say we have this hierarchy of teams:
In this case, both 'Rosetta pt Translators' and 'Rosetta pt_BR Translators' are subteams of the 'Rosetta Translators' team, and all members of both subteams are considered members of "Rosetta Translators".
All superteams of this team.
A superteam is any team that this team is a member of. For example, let's say we have this hierarchy of teams, and we are the "Rosetta pt_BR Translators":
In this case, we will return both 'Rosetta pt Translators' and 'Rosetta Translators', because we are member of both of them.
Visibility
Anyone can see a public team's data. Only team members can see private team data.
Description
Details about interests and goals. Use plain text, paragraphs are preserved and URLs are linked.
Display Name
Your name as you would like it displayed throughout Launchpad. Most people use their full name here.
Homepage Content
Obsolete. Use description.
Logo
An image of exactly 64x64 pixels that will be displayed in the heading of all pages related to you. Traditionally this is a logo, a small picture or a personal mascot. It should be no bigger than 50kb in size.
Mailing List Auto-subscription Policy
This attribute determines whether a person is automatically subscribed to a team's mailing list when the person joins said team.
Mugshot
A large image of exactly 192x192 pixels, that will be displayed on your home page in Launchpad. Traditionally this is a great big picture of your grinning face. Make the most of it! It should be no bigger than 100kb in size.
Name
A short unique name, beginning with a lower-case letter or number, and containing only letters, numbers, dots, hyphens, or plus signs.
Visibility
Anyone can see a public team's data. Only team members can see private team data.
An object that might be a project, a project group, or a distribution.
This is a polymorphic object served by the pillar set. Check the individual object to see what type it is.
Active
Whether or not this item is active.
Active
Whether or not this item is active.
An object for searching across projects, project groups, and distros.
Projects, project groups, and distributions are collectively known as "pillars". This object lets you do a combined search across all types of pillars. It also gives you access to pillars that have been flagged by administrators as "featured" pillars.
Return Projects/Project groups/Distros matching :text:.
If :limit: is None, the default batch size will be used.
The results are ordered descending by rank.
Users can spoil their votes?
Allow users to leave the ballot blank (i.e. cast a vote for "None of the above")
The unique name of this poll
A short unique name, beginning with a lower-case letter or number, and containing only letters, numbers, dots, hyphens, or plus signs.
Users can spoil their votes?
Allow users to leave the ballot blank (i.e. cast a vote for "None of the above")
The unique name of this poll
A short unique name, beginning with a lower-case letter or number, and containing only letters, numbers, dots, hyphens, or plus signs.
A diff generated to show actual diff between two branches.
This diff will be used primarily for branch merge proposals where we are trying to determine the effective changes of landing the source branch on the target branch.
Date Created
When this diff was created.
DB ID
The tracking number for this diff.
Title
PreviewDiff title.
A Product.
The Launchpad Registry describes the open source world as ProjectGroups and Products. Each ProjectGroup may be responsible for several Products. For example, the Mozilla Project has Firefox, Thunderbird and The Mozilla App Suite as Products, among others.
Search the IBugTasks reported on this entity.
| search_params: | a BugTaskSearchParams object |
|---|
Return an iterable of matching results.
Note: milestone is currently ignored for all IBugTargets except IProduct.
Status upstream
Indicates the status of any remote watches associated with the bug. Possible values include: pending_bugwatch, hide_upstream, resolved_upstream, and open_upstream.
Tags
String or list of strings for tags to search. To exclude, prepend a '-', e.g. '-unwantedtag'
Status
Show only bugs with the given status value or list of values.
Tags combination
Search for any or all of the tags specified.
Component
Distribution package archive grouping. E.g. main, universe, multiverse
Importance
Show only bugs with the given importance or list of importances.
Information Type
Show only bugs with the given information type or list of information types.
Milestone
Show only bug tasks targeted to this milestone.
Return basic timeline data useful for creating a diagram.
The number of milestones returned per series is limited.
Return entries in the translation import queue for this entity.
| arg import_status: | |
|---|---|
| RosettaImportStatus DB Schema entry. | |
| arg file_extension: | |
| String with the file type extension, usually 'po' or 'pot'. | |
If one of both of 'import_status' or 'file_extension' are given, the returned entries are filtered based on those values.
Filename extension
Show only entries with this filename suffix
Status
Show only entries with this status
Return all the subscriptions with the specified levels.
| return: | A sequence of IStructuralSubscription. |
|---|
Returns all branches with the given lifecycle status.
| param status: | A list of statuses to filter with. |
|---|---|
| param visible_by_user: | |
| Normally the user who is asking. | |
| param modified_since: | |
| If set, filters the branches being returned to those that have been modified since the specified date/time. | |
| param eager_load: | |
| If True load related objects for the whole collection. | |
| returns: | A list of IBranch. |
Returns all merge proposals of a given status.
| param status: | A list of statuses to filter with. |
|---|---|
| param visible_by_user: | |
| Normally the user who is asking. | |
| param eager_load: | |
| If True, load related objects for the whole collection. | |
| returns: | A list of IBranchMergeProposal. |
Add a bug subscription filter for this structure.
This method is used to create a new IBugSubscriptionFilter for the target. It will initially allow all notifications to be sent.
| subscriber: | The IPerson who will be subscribed. If omitted, subscribed_by will be used. |
|---|---|
| subscribed_by: | The IPerson creating the subscription. |
| return: | The new bug subscription filter. |
Remove a subscription to bugs from this structure.
This will delete all associated filters.
| subscriber: | The IPerson who will be unsubscribed. If omitted, unsubscribed_by will be used. |
|---|---|
| unsubscribed_by: | |
| The IPerson removing the subscription. | |
Add a bug subscription for this structure.
This method is used to create a new IStructuralSubscription for the target. This initially has a single filter which will allow all notifications will be sent.
| subscriber: | The IPerson who will be subscribed. If omitted, subscribed_by will be used. |
|---|---|
| subscribed_by: | The IPerson creating the subscription. |
| return: | The new bug subscription. |
Create a new code import.
| param registrant: | |
|---|---|
| The IPerson to record as the registrant of the import. | |
| param branch_name: | |
| The name of the branch or repository to create. | |
| param rcs_type: | The type of the foreign VCS. |
| param target_rcs_type: | |
| The type of the branch or repository to create (Bazaar or Git). | |
| param url: | The URL to import from if the VCS type uses a single URL (i.e. isn't CVS). |
| param cvs_root: | The CVSROOT for a CVS import. |
| param cvs_module: | |
| The module to import for a CVS import. | |
| param owner: | Who should own the created branch or repository, or None for it to be the same as the registrant, or the caller over the API. |
| returns: | An instance of ICodeImport. |
Creates a new IProductSeries for this IProduct.
| param owner: | The registrant of this series. |
|---|---|
| param name: | The unique name of this series. |
| param summary: | The summary of the purpose and focus of development of this series. |
| param branch: | The bazaar branch that contains the code for this series. |
| param releasefileglob: | |
| The public URL pattern where release files can be automatically downloaded from and linked to this series. | |
Name
The name of the series is a short, unique name that identifies it, being used in URLs. It must be all lowercase, with no special characters. For example, '2.0' or 'trunk'.
Summary
A single paragraph that explains the goals of of this series and the intended users. For example: "The 2.0 series of Apache represents the current stable series, and is recommended for all new deployments".
Branch
The Bazaar branch for this series. Leave blank if this series is not maintained in Bazaar.
Release URL pattern
A URL pattern that matches releases that are part of this series. Launchpad automatically scans this site to import new releases. Example: http://ftp.gnu.org/gnu/emacs/emacs-21.*.tar.gz
Active
Whether or not this item is active.
Brand
A large image of exactly 192x192 pixels, that will be displayed on this project's home page in Launchpad. It should be no bigger than 100kb in size.
After reporting a bug, I can expect the following.
This message of acknowledgement will be displayed to anyone after reporting a bug.
Helpful guidelines for reporting a bug
These guidelines will be shown to everyone reporting a bug and should be text or a bulleted list with your particular requirements, if any.
Bug Supervisor
The Launchpad id of the person or team (preferred) responsible for bug management.
Commercial subscriptions
An object which contains the timeframe and the voucher code of a subscription.
Commercial subscription is due
Whether the project's licensing requires a new commercial subscription to use launchpad.
Date Created
The date this project was created in Launchpad.
Next suggest packaging date
Obsolete. The date to resume Ubuntu package suggestions.
Description
Details about the project's work, highlights, goals, and how to contribute. Use plain text, paragraphs are preserved and URLs are linked in pages. Don't repeat the Summary.
Development focus
The series that represents the master or trunk branch. The Bazaar URL lp:<project> points to the development focus series branch.
Display Name
The name of the project as it would appear in a paragraph.
Download URL
The full URL where downloads for this project are located, if available. Please include the http://
Driver
This person or team will be able to set feature goals for and approve bug targeting or backporting for ANY major series in this project. You might want to leave this blank and just appoint a team for each specific series, rather than having one project team that does it all.
Freshmeat Project
The Freshmeat project name for this project, if it is in freshmeat. [DEPRECATED]
Homepage URL
The project home page. Please include the http://
Icon
A small image of exactly 14x14 pixels and at most 5kb in size, that can be used to identify this project. The icon will be displayed next to the project name everywhere in Launchpad that we refer to the project and link to it.
Information Type
The type of data contained in this item.
Is Permitted
Whether the project's licensing qualifies for free hosting or the project has an up-to-date subscription.
Licence approved
The project is legitimate and its licence appears valid. Not applicable to 'Other/Proprietary'.
Description of additional licences
Description of licences that do not appear in the list above.
Logo
An image of exactly 64x64 pixels that will be displayed in the heading of all pages related to this project. It should be no bigger than 50kb in size.
Name
At least one lowercase letter or number, followed by letters, numbers, dots, hyphens or pluses. Keep this name short; it is used in URLs as shown above.
Official Bug Tags
The list of bug tags defined as official.
Maintainer
The restricted team, moderated team, or person who maintains the project information in Launchpad.
Product is confidential
This product is visible only to those with access grants.
Private bugs (obsolete; always False)
Replaced by bug_sharing_policy.
Programming Languages
A comma delimited list of programming languages used for this project.
Part of
Project group. This is an overarching initiative that includes several related projects. For example, the Mozilla Project produces Firefox, Thunderbird and Gecko. This information is used to group those projects in a coherent way. If you make this project part of a group, the group preferences and decisions around bug tracking, translation and security policy will apply to this project.
Project reviewed
Whether or not this project has been reviewed. If you looked at the project and how it uses Launchpad, you reviewed it.
Qualifies for free hosting
Whether the project's licensing qualifies it for free use of launchpad.
Registrant
This person registered the project in Launchpad.
Remote bug tracker project id
Some bug trackers host multiple projects at the same URL and require an identifier for the specific project.
Notes for the project reviewer
Notes on the project's licence, editable only by reviewers (Admins and Commercial Admins).
Screenshots URL
The full URL for screenshots of this project, if available. Please include the http://
Security contact
Security contact (obsolete; always None)
Sourceforge Project
The SourceForge project name for this project, if it is in sourceforge.
Summary
A short paragraph to introduce the project's work.
Title
The project title. Should be just a few words.
Translation focus
Project series that translators should focus on.
VCS
Version control system for this project's code.
Wiki URL
The full URL of this project's wiki, if it has one. Please include the http://
Active
Whether or not this item is active.
Brand
A large image of exactly 192x192 pixels, that will be displayed on this project's home page in Launchpad. It should be no bigger than 100kb in size.
After reporting a bug, I can expect the following.
This message of acknowledgement will be displayed to anyone after reporting a bug.
Helpful guidelines for reporting a bug
These guidelines will be shown to everyone reporting a bug and should be text or a bulleted list with your particular requirements, if any.
Bug Supervisor
The Launchpad id of the person or team (preferred) responsible for bug management.
Commercial subscriptions
An object which contains the timeframe and the voucher code of a subscription.
Next suggest packaging date
Obsolete. The date to resume Ubuntu package suggestions.
Description
Details about the project's work, highlights, goals, and how to contribute. Use plain text, paragraphs are preserved and URLs are linked in pages. Don't repeat the Summary.
Development focus
The series that represents the master or trunk branch. The Bazaar URL lp:<project> points to the development focus series branch.
Display Name
The name of the project as it would appear in a paragraph.
Download URL
The full URL where downloads for this project are located, if available. Please include the http://
Driver
This person or team will be able to set feature goals for and approve bug targeting or backporting for ANY major series in this project. You might want to leave this blank and just appoint a team for each specific series, rather than having one project team that does it all.
Freshmeat Project
The Freshmeat project name for this project, if it is in freshmeat. [DEPRECATED]
Homepage URL
The project home page. Please include the http://
Icon
A small image of exactly 14x14 pixels and at most 5kb in size, that can be used to identify this project. The icon will be displayed next to the project name everywhere in Launchpad that we refer to the project and link to it.
Information Type
The type of data contained in this item.
Licence approved
The project is legitimate and its licence appears valid. Not applicable to 'Other/Proprietary'.
Description of additional licences
Description of licences that do not appear in the list above.
Logo
An image of exactly 64x64 pixels that will be displayed in the heading of all pages related to this project. It should be no bigger than 50kb in size.
Name
At least one lowercase letter or number, followed by letters, numbers, dots, hyphens or pluses. Keep this name short; it is used in URLs as shown above.
Official Bug Tags
The list of bug tags defined as official.
Maintainer
The restricted team, moderated team, or person who maintains the project information in Launchpad.
Programming Languages
A comma delimited list of programming languages used for this project.
Part of
Project group. This is an overarching initiative that includes several related projects. For example, the Mozilla Project produces Firefox, Thunderbird and Gecko. This information is used to group those projects in a coherent way. If you make this project part of a group, the group preferences and decisions around bug tracking, translation and security policy will apply to this project.
Project reviewed
Whether or not this project has been reviewed. If you looked at the project and how it uses Launchpad, you reviewed it.
Remote bug tracker project id
Some bug trackers host multiple projects at the same URL and require an identifier for the specific project.
Notes for the project reviewer
Notes on the project's licence, editable only by reviewers (Admins and Commercial Admins).
Screenshots URL
The full URL for screenshots of this project, if available. Please include the http://
Sourceforge Project
The SourceForge project name for this project, if it is in sourceforge.
Summary
A short paragraph to introduce the project's work.
Translation focus
Project series that translators should focus on.
VCS
Version control system for this project's code.
Wiki URL
The full URL of this project's wiki, if it has one. Please include the http://
A specific release (i.e. version) of a product.
For example: Mozilla 1.7.2 or Apache 2.0.48.
Delete this release.
This method must not be used if this release has any release files associated with it.
Add file to the library and link to this IProductRelease.
The signature file will also be added if available.
| param filename: | Name of the file being uploaded. |
|---|---|
| param file_content: | |
| io.BytesIO or binary file object. | |
| param content_type: | |
| A MIME content type string. | |
| param uploader: | The person who uploaded the file. |
| param signature_filename: | |
| Name of the uploaded gpg signature file. | |
| param signature_content: | |
| io.BytesIO or binary file object. | |
| param file_type: | |
| An UpstreamFileType enum value. | |
| param description: | |
| Info about the file. | |
| returns: | IProductReleaseFile object. |
| raises: | InvalidFilename if the filename is invalid or a duplicate of a file previously added to the release. |
Description
A detailed description of the file contents
Changelog
A description of every change in the release.
Date Created
The date this project release was created in Launchpad.
Date released
The date this release was published. Before release, this should have an estimated release date.
Project release files
A list of files for this release.
Milestone for this release
A release requires a corresponding milestone that is not attached to another release.
The registrant of this release.
The person or who registered this release.
Release notes
A description of important new features (though the changelog below might repeat some of this information).
Version
The specific version number assigned to this release. Letters and numbers are acceptable, for releases like "1.2rc3".
Changelog
A description of every change in the release.
Date released
The date this release was published. Before release, this should have an estimated release date.
Milestone for this release
A release requires a corresponding milestone that is not attached to another release.
The registrant of this release.
The person or who registered this release.
Release notes
A description of important new features (though the changelog below might repeat some of this information).
Upload date
The date this file was uploaded
Description
A detailed description of the file contents
File
The file contents.
Project release
The parent product release.
File signature
The file signature.
Description
A detailed description of the file contents
Project release
The parent product release.
Return basic timeline data useful for creating a diagram.
The number of milestones returned is limited.
Return all the subscriptions with the specified levels.
| return: | A sequence of IStructuralSubscription. |
|---|
Search the IBugTasks reported on this entity.
| search_params: | a BugTaskSearchParams object |
|---|
Return an iterable of matching results.
Note: milestone is currently ignored for all IBugTargets except IProduct.
Status upstream
Indicates the status of any remote watches associated with the bug. Possible values include: pending_bugwatch, hide_upstream, resolved_upstream, and open_upstream.
Tags
String or list of strings for tags to search. To exclude, prepend a '-', e.g. '-unwantedtag'
Status
Show only bugs with the given status value or list of values.
Tags combination
Search for any or all of the tags specified.
Component
Distribution package archive grouping. E.g. main, universe, multiverse
Importance
Show only bugs with the given importance or list of importances.
Information Type
Show only bugs with the given information type or list of information types.
Milestone
Show only bug tasks targeted to this milestone.
Return entries in the translation import queue for this entity.
| arg import_status: | |
|---|---|
| RosettaImportStatus DB Schema entry. | |
| arg file_extension: | |
| String with the file type extension, usually 'po' or 'pot'. | |
If one of both of 'import_status' or 'file_extension' are given, the returned entries are filtered based on those values.
Filename extension
Show only entries with this filename suffix
Status
Show only entries with this status
Return an iterator over all its translation templates.
The returned templates are either obsolete or current.
| return: | A sequence of IPOTemplate. |
|---|
Add a bug subscription filter for this structure.
This method is used to create a new IBugSubscriptionFilter for the target. It will initially allow all notifications to be sent.
| subscriber: | The IPerson who will be subscribed. If omitted, subscribed_by will be used. |
|---|---|
| subscribed_by: | The IPerson creating the subscription. |
| return: | The new bug subscription filter. |
Add a bug subscription for this structure.
This method is used to create a new IStructuralSubscription for the target. This initially has a single filter which will allow all notifications will be sent.
| subscriber: | The IPerson who will be subscribed. If omitted, subscribed_by will be used. |
|---|---|
| subscribed_by: | The IPerson creating the subscription. |
| return: | The new bug subscription. |
Name
Only letters, numbers, and simple punctuation are allowed.
Date Targeted
Example: 2005-11-24
Summary
A summary of the features and status of this milestone.
Code name
An alternative name for the milestone.
Remove a subscription to bugs from this structure.
This will delete all associated filters.
| subscriber: | The IPerson who will be unsubscribed. If omitted, unsubscribed_by will be used. |
|---|---|
| unsubscribed_by: | |
| The IPerson removing the subscription. | |
Active
Whether or not this series is stable and supported, or under current development. This excludes series which are experimental or obsolete.
Branch
The Bazaar branch for this series. Leave blank if this series is not maintained in Bazaar.
After reporting a bug, I can expect the following.
This message of acknowledgement will be displayed to anyone after reporting a bug.
Helpful guidelines for reporting a bug
These guidelines will be shown to everyone reporting a bug and should be text or a bulleted list with your particular requirements, if any.
Display Name
Display name. In this case we have removed the underlying database field, and this attribute just returns the name.
Release manager
The person or team responsible for decisions about features and bugs that will be targeted to this series. If you don't nominate someone here, then the owners and drivers of the project and project group will automatically have those permissions.
Name
The name of the series is a short, unique name that identifies it, being used in URLs. It must be all lowercase, with no special characters. For example, '2.0' or 'trunk'.
Official Bug Tags
The list of bug tags defined as official.
Owner
Project owner, either a valid Person or Team
Release URL pattern
A URL pattern that matches releases that are part of this series. Launchpad automatically scans this site to import new releases. Example: http://ftp.gnu.org/gnu/emacs/emacs-21.*.tar.gz
Summary
A single paragraph that explains the goals of of this series and the intended users. For example: "The 2.0 series of Apache represents the current stable series, and is recommended for all new deployments".
Title
The product series title. Should be just a few words.
Active
Whether or not this series is stable and supported, or under current development. This excludes series which are experimental or obsolete.
Branch
The Bazaar branch for this series. Leave blank if this series is not maintained in Bazaar.
After reporting a bug, I can expect the following.
This message of acknowledgement will be displayed to anyone after reporting a bug.
Helpful guidelines for reporting a bug
These guidelines will be shown to everyone reporting a bug and should be text or a bulleted list with your particular requirements, if any.
Display Name
Display name. In this case we have removed the underlying database field, and this attribute just returns the name.
Release manager
The person or team responsible for decisions about features and bugs that will be targeted to this series. If you don't nominate someone here, then the owners and drivers of the project and project group will automatically have those permissions.
Name
The name of the series is a short, unique name that identifies it, being used in URLs. It must be all lowercase, with no special characters. For example, '2.0' or 'trunk'.
Owner
Project owner, either a valid Person or Team
Release URL pattern
A URL pattern that matches releases that are part of this series. Launchpad automatically scans this site to import new releases. Example: http://ftp.gnu.org/gnu/emacs/emacs-21.*.tar.gz
Summary
A single paragraph that explains the goals of of this series and the intended users. For example: "The 2.0 series of Apache represents the current stable series, and is recommended for all new deployments".
Title
The product series title. Should be just a few words.
Return all the subscriptions with the specified levels.
| return: | A sequence of IStructuralSubscription. |
|---|
Search the IBugTasks reported on this entity.
| search_params: | a BugTaskSearchParams object |
|---|
Return an iterable of matching results.
Note: milestone is currently ignored for all IBugTargets except IProduct.
Status upstream
Indicates the status of any remote watches associated with the bug. Possible values include: pending_bugwatch, hide_upstream, resolved_upstream, and open_upstream.
Tags
String or list of strings for tags to search. To exclude, prepend a '-', e.g. '-unwantedtag'
Status
Show only bugs with the given status value or list of values.
Tags combination
Search for any or all of the tags specified.
Component
Distribution package archive grouping. E.g. main, universe, multiverse
Importance
Show only bugs with the given importance or list of importances.
Information Type
Show only bugs with the given information type or list of information types.
Milestone
Show only bug tasks targeted to this milestone.
Returns all branches with the given lifecycle status.
| param status: | A list of statuses to filter with. |
|---|---|
| param visible_by_user: | |
| Normally the user who is asking. | |
| param modified_since: | |
| If set, filters the branches being returned to those that have been modified since the specified date/time. | |
| param eager_load: | |
| If True load related objects for the whole collection. | |
| returns: | A list of IBranch. |
Returns all merge proposals of a given status.
| param status: | A list of statuses to filter with. |
|---|---|
| param visible_by_user: | |
| Normally the user who is asking. | |
| param eager_load: | |
| If True, load related objects for the whole collection. | |
| returns: | A list of IBranchMergeProposal. |
Add a bug subscription filter for this structure.
This method is used to create a new IBugSubscriptionFilter for the target. It will initially allow all notifications to be sent.
| subscriber: | The IPerson who will be subscribed. If omitted, subscribed_by will be used. |
|---|---|
| subscribed_by: | The IPerson creating the subscription. |
| return: | The new bug subscription filter. |
Add a bug subscription for this structure.
This method is used to create a new IStructuralSubscription for the target. This initially has a single filter which will allow all notifications will be sent.
| subscriber: | The IPerson who will be subscribed. If omitted, subscribed_by will be used. |
|---|---|
| subscribed_by: | The IPerson creating the subscription. |
| return: | The new bug subscription. |
Remove a subscription to bugs from this structure.
This will delete all associated filters.
| subscriber: | The IPerson who will be unsubscribed. If omitted, unsubscribed_by will be used. |
|---|---|
| unsubscribed_by: | |
| The IPerson removing the subscription. | |
Active
Whether or not this item is active.
After reporting a bug, I can expect the following.
This message of acknowledgement will be displayed to anyone after reporting a bug.
If I’m reporting a bug, I should include, if possible
These guidelines will be shown to anyone reporting a bug.
Bug Tracker
The bug tracker the projects in this project group use.
Date Created
The date this project group was created in Launchpad.
Description
Details about the project group's work, goals, and how to contribute. Use plain text, paragraphs are preserved and URLs are linked in pages. Don't repeat the Summary.
Display Name
Appropriately capitalised, and typically ending in "Project". Examples: the Apache Project, the Mozilla Project, the Gimp Project.
Driver
This is a project group-wide appointment. Think carefully here! This person or team will be able to set feature goals and approve bug targeting and backporting for ANY series in ANY project in this group. You can also appoint drivers at the level of a specific project or series. So you may just want to leave this space blank, and instead let the individual projects and series have drivers.
Freshmeat Project Name
The Freshmeat project name for this project group, if it is in Freshmeat. [DEPRECATED]
Homepage Content
The content of this project group's home page. Edit this and it will be displayed for all the world to see. It is NOT a wiki so you cannot undo changes.
Homepage URL
The project group home page. Please include the http://
Icon
A small image of exactly 14x14 pixels and at most 5kb in size, that can be used to identify this project group. The icon will be displayed in Launchpad everywhere that we link to this project group. For example in listings or tables of active project groups.
Logo
An image of exactly 64x64 pixels that will be displayed in the heading of all pages related to this project group. It should be no bigger than 50kb in size.
Brand
A large image of exactly 192x192 pixels, that will be displayed on this project group's home page in Launchpad. It should be no bigger than 100kb in size.
Name
A unique name, used in URLs, identifying the project group. All lowercase, no special characters. Examples: apache, mozilla, gimp.
Official Bug Tags
The list of bug tags defined as official.
Maintainer
The restricted team, moderated team, or person who maintains the project group information in Launchpad.
Registrant
Project group registrant. Must be a valid Launchpad Person.
Reviewed
Whether or not this project group has been reviewed.
SourceForge Project Name
The SourceForge project name for this project group, if it is in SourceForge.
Project Group Summary
A short paragraph to introduce the project group's work.
Title
The full name of the project group, which can contain spaces, special characters, etc.
Wiki URL
The URL of this project group's wiki, if it has one. Please include the http://
Active
Whether or not this item is active.
After reporting a bug, I can expect the following.
This message of acknowledgement will be displayed to anyone after reporting a bug.
If I’m reporting a bug, I should include, if possible
These guidelines will be shown to anyone reporting a bug.
Bug Tracker
The bug tracker the projects in this project group use.
Description
Details about the project group's work, goals, and how to contribute. Use plain text, paragraphs are preserved and URLs are linked in pages. Don't repeat the Summary.
Display Name
Appropriately capitalised, and typically ending in "Project". Examples: the Apache Project, the Mozilla Project, the Gimp Project.
Driver
This is a project group-wide appointment. Think carefully here! This person or team will be able to set feature goals and approve bug targeting and backporting for ANY series in ANY project in this group. You can also appoint drivers at the level of a specific project or series. So you may just want to leave this space blank, and instead let the individual projects and series have drivers.
Freshmeat Project Name
The Freshmeat project name for this project group, if it is in Freshmeat. [DEPRECATED]
Homepage Content
The content of this project group's home page. Edit this and it will be displayed for all the world to see. It is NOT a wiki so you cannot undo changes.
Homepage URL
The project group home page. Please include the http://
Icon
A small image of exactly 14x14 pixels and at most 5kb in size, that can be used to identify this project group. The icon will be displayed in Launchpad everywhere that we link to this project group. For example in listings or tables of active project groups.
Logo
An image of exactly 64x64 pixels that will be displayed in the heading of all pages related to this project group. It should be no bigger than 50kb in size.
Brand
A large image of exactly 192x192 pixels, that will be displayed on this project group's home page in Launchpad. It should be no bigger than 100kb in size.
Name
A unique name, used in URLs, identifying the project group. All lowercase, no special characters. Examples: apache, mozilla, gimp.
Maintainer
The restricted team, moderated team, or person who maintains the project group information in Launchpad.
Reviewed
Whether or not this project group has been reviewed.
SourceForge Project Name
The SourceForge project name for this project group, if it is in SourceForge.
Project Group Summary
A short paragraph to introduce the project group's work.
Title
The full name of the project group, which can contain spaces, special characters, etc.
Wiki URL
The URL of this project group's wiki, if it has one. Please include the http://
Return all the subscriptions with the specified levels.
| return: | A sequence of IStructuralSubscription. |
|---|
Search the IBugTasks reported on this entity.
| search_params: | a BugTaskSearchParams object |
|---|
Return an iterable of matching results.
Note: milestone is currently ignored for all IBugTargets except IProduct.
Status upstream
Indicates the status of any remote watches associated with the bug. Possible values include: pending_bugwatch, hide_upstream, resolved_upstream, and open_upstream.
Tags
String or list of strings for tags to search. To exclude, prepend a '-', e.g. '-unwantedtag'
Status
Show only bugs with the given status value or list of values.
Tags combination
Search for any or all of the tags specified.
Component
Distribution package archive grouping. E.g. main, universe, multiverse
Importance
Show only bugs with the given importance or list of importances.
Information Type
Show only bugs with the given information type or list of information types.
Milestone
Show only bug tasks targeted to this milestone.
Add a bug subscription filter for this structure.
This method is used to create a new IBugSubscriptionFilter for the target. It will initially allow all notifications to be sent.
| subscriber: | The IPerson who will be subscribed. If omitted, subscribed_by will be used. |
|---|---|
| subscribed_by: | The IPerson creating the subscription. |
| return: | The new bug subscription filter. |
Add a bug subscription for this structure.
This method is used to create a new IStructuralSubscription for the target. This initially has a single filter which will allow all notifications will be sent.
| subscriber: | The IPerson who will be subscribed. If omitted, subscribed_by will be used. |
|---|---|
| subscribed_by: | The IPerson creating the subscription. |
| return: | The new bug subscription. |
Create a new ProductRelease.
| param owner: | IPerson object who manages the release. |
|---|---|
| param datereleased: | |
| Date of the product release. | |
| param changelog: | |
| Detailed changes in each version. | |
| param release_notes: | |
| Overview of changes in each version. | |
| returns: | IProductRelease object. |
Date released
The date this release was published. Before release, this should have an estimated release date.
Changelog
A description of every change in the release.
Release notes
A description of important new features (though the changelog below might repeat some of this information).
Remove a subscription to bugs from this structure.
This will delete all associated filters.
| subscriber: | The IPerson who will be unsubscribed. If omitted, unsubscribed_by will be used. |
|---|---|
| unsubscribed_by: | |
| The IPerson removing the subscription. | |
Code name
An alternative name for the milestone.
Date Targeted
Example: 2005-11-24
Active
Whether or not this object should be shown in web forms for targeting.
Name
Only letters, numbers, and simple punctuation are allowed.
Official Bug Tags
The list of bug tags defined as official.
Summary
A summary of the features and status of this milestone.
Code name
An alternative name for the milestone.
Date Targeted
Example: 2005-11-24
Active
Whether or not this object should be shown in web forms for targeting.
Name
Only letters, numbers, and simple punctuation are allowed.
Summary
A summary of the features and status of this milestone.
Name
The name of the service, used to generate the url.
Name
The name of the service, used to generate the url.
Source snap channels for builds
A dictionary mapping snap names to channels to use when building snaps that specify this base. The special '_byarch' key may have a mapping of architecture names to mappings of snap names to channels, which if present override the channels declared at the top level when building for those architectures.
Is default?
Whether this base is the default for snaps that do not specify a base.
Processors
The architectures that the snap base supports.
Registrant
The person who registered this base.
Source snap channels for builds
A dictionary mapping snap names to channels to use when building snaps that specify this base. The special '_byarch' key may have a mapping of architecture names to mappings of snap names to channels, which if present override the channels declared at the top level when building for those architectures.
Build Log URL
A URL for the build log. None if there is no log available.
Builder
The builder assigned to this job.
Status
The current status of the job.
Can be cancelled
Whether this build record can be cancelled.
Can be rescored
Whether this build record can be rescored manually.
Can be retried
Whether this build record can be retried.
Source snap channels to use for this build.
A dictionary mapping snap names to channels to use for this build. Currently only 'core', 'core18', 'core20', 'core22', and 'snapcraft' keys are supported.
Date finished
The actual build start time. Set when the build is dispatched the first time and not changed in subsequent build attempts.
Date finished
The timestamp when the build farm job was finished.
Date created
The timestamp when the build farm job was created.
Dependencies
Debian-like dependency line that must be satisfied before attempting to build this request.
Distribution
Shortcut for its distribution.
Distribution series
Shortcut for its distribution series.
The pocket for which to build.
The package stream within the source archive and distribution series to use when building the snap package. If the source archive is a PPA, then the PPA's archive dependencies will be used to select the pocket in the distribution's primary archive.
Revision ID
The revision ID of the branch used for this build, if available.
Store upload error message
The error message, if any, from the last attempt to upload this snap build to the store. (Deprecated; use store_upload_error_messages instead.)
Store upload error messages
A list of dict(message, link) where message is an error description and link, if any, is an external link to extra details, from the last attempt to upload this snap build to the store.
Store revision
The revision assigned to this package by the store.
Store URL
The URL to use for managing this package in the store.
Upload Log URL
A URL for failed upload logs.Will be None if there was no failure.
Build Log URL
A URL for the build log. None if there is no log available.
Status
The current status of the job.
Source snap channels to use for this build.
A dictionary mapping snap names to channels to use for this build. Currently only 'core', 'core18', 'core20', 'core22', and 'snapcraft' keys are supported.
Dependencies
Debian-like dependency line that must be satisfied before attempting to build this request.
Distribution
Shortcut for its distribution.
Distribution series
Shortcut for its distribution series.
Upload Log URL
A URL for failed upload logs.Will be None if there was no failure.
Allow external network access
Allow access to external network resources via a proxy. Resources hosted on Launchpad itself are always allowed.
Automatically build when branch changes
Whether this snap package is built automatically when the branch containing its snap/snapcraft.yaml, build-aux/snap/snapcraft.yaml, snapcraft.yaml, or .snapcraft.yaml recipe changes.
Source archive for automatic builds
The archive from which automatic builds of this snap package should be built.
Source snap channels for automatic builds
A dictionary mapping snap names to channels to use when building this snap package. Currently only 'core', 'core18', 'core20', 'core22', and 'snapcraft' keys are supported.
Pocket for automatic builds
The package stream within the source archive and distribution series to use when building the snap package. If the source archive is a PPA, then the PPA's archive dependencies will be used to select the pocket in the distribution's primary archive.
Bazaar branch
A Bazaar branch containing a snap/snapcraft.yaml, build-aux/snap/snapcraft.yaml, snapcraft.yaml, or .snapcraft.yaml recipe at the top level.
Build source tarball
Whether builds of this snap package should also build a tarball containing all source code, including external dependencies.
All builds of this snap package.
All builds of this snap package, sorted in descending order of finishing (or starting if not completed successfully).
Can upload to store
Whether everything is set up to allow uploading builds of this snap package to the store.
Completed builds of this snap package.
Completed builds of this snap package, sorted in descending order of finishing.
Description
A description of the snap package.
Distro Series
The series for which the snap package should be built. If not set, Launchpad will infer an appropriate series from snapcraft.yaml.
Git branch path
The path of the Git branch containing a snap/snapcraft.yaml, build-aux/snap/snapcraft.yaml, snapcraft.yaml, or .snapcraft.yaml recipe at the top level.
Git branch
The Git branch containing a snap/snapcraft.yaml, build-aux/snap/snapcraft.yaml, snapcraft.yaml, or .snapcraft.yaml recipe at the top level.
Git repository
A Git repository with a branch containing a snap/snapcraft.yaml, build-aux/snap/snapcraft.yaml, snapcraft.yaml, or .snapcraft.yaml recipe at the top level.
Git repository URL
The URL of a Git repository with a branch containing a snap/snapcraft.yaml, build-aux/snap/snapcraft.yaml, snapcraft.yaml, or .snapcraft.yaml recipe at the top level.
Information type
The type of information contained in this Snap recipe.
Snap recipe name
The name of the snap build recipe.
Owner
The owner of this snap package.
Pending builds of this snap package.
Pending builds of this snap package, sorted in descending order of creation.
Private
Whether or not this snap is private.
Processors
The architectures for which the snap package should be built.
Registrant
The person who registered this snap package.
Require virtualized builders
Only build this snap package on virtual builders.
Store channels
Channels to release this snap package to after uploading it to the store. A channel is defined by a combination of an optional track, a risk, and an optional branch, e.g. '2.1/stable/fix-123', '2.1/stable', 'stable/fix-123', or 'stable'.
Registered store package name
The registered name of this snap package in the store.
Store series
The series in which this snap package should be published in the store.
Automatically upload to store
Whether builds of this snap package are automatically uploaded to the store.
Allow external network access
Allow access to external network resources via a proxy. Resources hosted on Launchpad itself are always allowed.
Automatically build when branch changes
Whether this snap package is built automatically when the branch containing its snap/snapcraft.yaml, build-aux/snap/snapcraft.yaml, snapcraft.yaml, or .snapcraft.yaml recipe changes.
Source archive for automatic builds
The archive from which automatic builds of this snap package should be built.
Source snap channels for automatic builds
A dictionary mapping snap names to channels to use when building this snap package. Currently only 'core', 'core18', 'core20', 'core22', and 'snapcraft' keys are supported.
Pocket for automatic builds
The package stream within the source archive and distribution series to use when building the snap package. If the source archive is a PPA, then the PPA's archive dependencies will be used to select the pocket in the distribution's primary archive.
Bazaar branch
A Bazaar branch containing a snap/snapcraft.yaml, build-aux/snap/snapcraft.yaml, snapcraft.yaml, or .snapcraft.yaml recipe at the top level.
Build source tarball
Whether builds of this snap package should also build a tarball containing all source code, including external dependencies.
Description
A description of the snap package.
Distro Series
The series for which the snap package should be built. If not set, Launchpad will infer an appropriate series from snapcraft.yaml.
Git branch path
The path of the Git branch containing a snap/snapcraft.yaml, build-aux/snap/snapcraft.yaml, snapcraft.yaml, or .snapcraft.yaml recipe at the top level.
Git branch
The Git branch containing a snap/snapcraft.yaml, build-aux/snap/snapcraft.yaml, snapcraft.yaml, or .snapcraft.yaml recipe at the top level.
Information type
The type of information contained in this Snap recipe.
Snap recipe name
The name of the snap build recipe.
Owner
The owner of this snap package.
Private
Whether or not this snap is private.
Require virtualized builders
Only build this snap package on virtual builders.
Store channels
Channels to release this snap package to after uploading it to the store. A channel is defined by a combination of an optional track, a risk, and an optional branch, e.g. '2.1/stable/fix-123', '2.1/stable', 'stable/fix-123', or 'stable'.
Registered store package name
The registered name of this snap package in the store.
Store series
The series in which this snap package should be published in the store.
Automatically upload to store
Whether builds of this snap package are automatically uploaded to the store.
Can infer distro series?
True if inferring a distro series from snapcraft.yaml is supported for this snappy series.
Registrant
The person who registered this snappy series.
Usable distro series
The distro series that can be used for this snappy series.
Can infer distro series?
True if inferring a distro series from snapcraft.yaml is supported for this snappy series.
Usable distro series
The distro series that can be used for this snappy series.
Return entries in the translation import queue for this entity.
| arg import_status: | |
|---|---|
| RosettaImportStatus DB Schema entry. | |
| arg file_extension: | |
| String with the file type extension, usually 'po' or 'pot'. | |
If one of both of 'import_status' or 'file_extension' are given, the returned entries are filtered based on those values.
Filename extension
Show only entries with this filename suffix
Status
Show only entries with this status
Search the IBugTasks reported on this entity.
| search_params: | a BugTaskSearchParams object |
|---|
Return an iterable of matching results.
Note: milestone is currently ignored for all IBugTargets except IProduct.
Status upstream
Indicates the status of any remote watches associated with the bug. Possible values include: pending_bugwatch, hide_upstream, resolved_upstream, and open_upstream.
Tags
String or list of strings for tags to search. To exclude, prepend a '-', e.g. '-unwantedtag'
Status
Show only bugs with the given status value or list of values.
Tags combination
Search for any or all of the tags specified.
Component
Distribution package archive grouping. E.g. main, universe, multiverse
Importance
Show only bugs with the given importance or list of importances.
Information Type
Show only bugs with the given information type or list of information types.
Milestone
Show only bug tasks targeted to this milestone.
Get the official branches for this package.
This operation returns a {Pocket-name : IBranch} dict.
| return: | A {Pocket-name : IBranch} dict. |
|---|
Returns all branches with the given lifecycle status.
| param status: | A list of statuses to filter with. |
|---|---|
| param visible_by_user: | |
| Normally the user who is asking. | |
| param modified_since: | |
| If set, filters the branches being returned to those that have been modified since the specified date/time. | |
| param eager_load: | |
| If True load related objects for the whole collection. | |
| returns: | A list of IBranch. |
Get the official branch for this package in the given pocket.
| param pocket: | A PackagePublishingPocket. |
|---|---|
| return: | An IBranch. |
Returns all merge proposals of a given status.
| param status: | A list of statuses to filter with. |
|---|---|
| param visible_by_user: | |
| Normally the user who is asking. | |
| param eager_load: | |
| If True, load related objects for the whole collection. | |
| returns: | A list of IBranchMergeProposal. |
Return an iterator over all its translation templates.
The returned templates are either obsolete or current.
| return: | A sequence of IPOTemplate. |
|---|
Set the official branch for the given pocket of this package.
| param pocket: | A PackagePublishingPocket. |
|---|---|
| param branch: | The branch to set as the official branch. |
| param registrant: | |
| The individual who created this link. | |
| return: | None |
Create a new code import.
| param registrant: | |
|---|---|
| The IPerson to record as the registrant of the import. | |
| param branch_name: | |
| The name of the branch or repository to create. | |
| param rcs_type: | The type of the foreign VCS. |
| param target_rcs_type: | |
| The type of the branch or repository to create (Bazaar or Git). | |
| param url: | The URL to import from if the VCS type uses a single URL (i.e. isn't CVS). |
| param cvs_root: | The CVSROOT for a CVS import. |
| param cvs_module: | |
| The module to import for a CVS import. | |
| param owner: | Who should own the created branch or repository, or None for it to be the same as the registrant, or the caller over the API. |
| returns: | An instance of ICodeImport. |
After reporting a bug, I can expect the following.
This message of acknowledgement will be displayed to anyone after reporting a bug.
Helpful guidelines for reporting a bug
These guidelines will be shown to everyone reporting a bug and should be text or a bulleted list with your particular requirements, if any.
Display name
A displayname, constructed, for this package
Distribution
The distribution for this source package.
Distribution Series
The DistroSeries for this SourcePackage
Name
The text name of this source package.
Official Bug Tags
The list of bug tags defined as official.
Project series
The registered project series that this source package is based on. This series may be the same as the one that earlier versions of this source packages were based on.
After reporting a bug, I can expect the following.
This message of acknowledgement will be displayed to anyone after reporting a bug.
Helpful guidelines for reporting a bug
These guidelines will be shown to everyone reporting a bug and should be text or a bulleted list with your particular requirements, if any.
Return all resulted IBinaryPackagePublishingHistory.
Follow the build record and return every PUBLISHED or PENDING binary publishing record for any DistroArchSeries in this DistroSeries and in the same IArchive and Pocket, ordered by architecture tag.
| return: | a list with all corresponding publishing records. |
|---|
URLs for this source publication's uploaded source files.
| param include_meta: | |
|---|---|
| Return a list of dicts with keys url, size, and sha256 for each URL instead of a simple list. | |
| return: | A collection of URLs for this source. |
URL of the debdiff file between this and the supplied version.
| param to_version: | |
|---|---|
| The version of the source package for which you want to get the diff to. | |
| return: | A URL to the librarian file containing the diff. |
URLs for this source publication's binary files.
| return: | A collection of URLs for this source. |
|---|
The .changes file URL for this source publication.
| return: | the .changes file URL for this source (a string). |
|---|
Return a list of IBuild objects in this publishing context.
The builds are ordered by DistroArchSeries.architecturetag.
| return: | a list of IBuilds. |
|---|
Delete this source and its binaries.
| param removed_by: | |
|---|---|
| IPerson responsible for the removal. | |
| param removal_comment: | |
| optional text describing the removal reason. | |
Publication Creator
The IPerson who created this publication.
Display Name
Text representation of the current record.
Package Creator
The IPerson who created the source package.
Package Maintainer
The IPerson who maintains the source package.
Package Signer
The IPerson who signed the source package.
Package upload
The Package Upload that caused the creation of this publication.
The pocket into which this entry is published
Publication sponsor
The IPerson who sponsored the creation of this publication.
Package Publishing Status
The status of this publishing record
Display Name
Text representation of the current record.
Package Publishing Status
The status of this publishing record
Archive
The Archive context for this build.
Build Log URL
A URL for the build log. None if there is no log available.
Builder
The builder assigned to this job.
Status
The current status of the job.
Can be cancelled
Whether this build record can be cancelled.
Can be rescored
Whether this build record can be rescored manually.
Date finished
The actual build start time. Set when the build is dispatched the first time and not changed in subsequent build attempts.
Date finished
The timestamp when the build farm job was finished.
Date created
The timestamp when the build farm job was created.
Dependencies
Debian-like dependency line that must be satisfied before attempting to build this request.
Distribution
Shortcut for its distribution.
Distribution series
Shortcut for its distribution series.
The build targeted pocket.
Upload Log URL
A URL for failed upload logs.Will be None if there was no failure.
Build Log URL
A URL for the build log. None if there is no log available.
Status
The current status of the job.
Dependencies
Debian-like dependency line that must be satisfied before attempting to build this request.
Distribution
Shortcut for its distribution.
Distribution series
Shortcut for its distribution series.
The build targeted pocket.
Upload Log URL
A URL for failed upload logs.Will be None if there was no failure.
An ISourcePackageRecipe describes how to build a source package.
More precisely, it describes how to combine a number of branches into a debianized source tree.
Request that the recipe be built in to the specified archive.
| param archive: | The IArchive which you want the build to end up in. |
|---|---|
| param requester: | |
| the person requesting the build. | |
| param pocket: | the pocket that should be targeted. |
| raises: | various specific upload errors if the requestor is not able to upload to the archive. |
Built daily
Automatically build each day, if the source has changed.
All builds of this recipe.
All builds of this recipe, sorted in descending order of finishing (or starting if notcompleted successfully).
The completed builds of this recipe.
Completed builds of this recipe, sorted in descending order of finishing (or starting if notcompleted successfully).
deb-version template
The template that will be used to generate a deb version.
Description
A short description of the recipe.
Default distribution series
If built daily, these are the distribution versions that the recipe will be built for.
Name
The name of the recipe is part of the URL and needs to be unique for the given owner.
Owner
The person or team who can edit this recipe.
The pending builds of this recipe.
Pending builds of this recipe, sorted in descending order of creation.
Built daily
Automatically build each day, if the source has changed.
Description
A short description of the recipe.
Name
The name of the recipe is part of the URL and needs to be unique for the given owner.
Owner
The person or team who can edit this recipe.
Unlink a branch from this bug.
| param branch: | The branch being unlinked from. |
|---|---|
| param user: | The user unlinking the branch. |
Associate a branch with this bug.
| param branch: | The branch being linked to. |
|---|---|
| param registrant: | |
| The user linking the branch. | |
Information Type
The type of information contained in this specification.
Subscribed by
The person creating the subscription.
Subscriber
The person subscribed.
Return all the subscriptions with the specified levels.
| return: | A sequence of IStructuralSubscription. |
|---|
Add a bug subscription filter for this structure.
This method is used to create a new IBugSubscriptionFilter for the target. It will initially allow all notifications to be sent.
| subscriber: | The IPerson who will be subscribed. If omitted, subscribed_by will be used. |
|---|---|
| subscribed_by: | The IPerson creating the subscription. |
| return: | The new bug subscription filter. |
Add a bug subscription for this structure.
This method is used to create a new IStructuralSubscription for the target. This initially has a single filter which will allow all notifications will be sent.
| subscriber: | The IPerson who will be subscribed. If omitted, subscribed_by will be used. |
|---|---|
| subscribed_by: | The IPerson creating the subscription. |
| return: | The new bug subscription. |
Remove a subscription to bugs from this structure.
This will delete all associated filters.
| subscriber: | The IPerson who will be unsubscribed. If omitted, unsubscribed_by will be used. |
|---|---|
| unsubscribed_by: | |
| The IPerson removing the subscription. | |
A group of people and other teams.
Launchpadlib example of getting the date a user joined a team:
def get_join_date(team, user):
team = launchpad.people[team]
members = team.members_details
for member in members:
if member.member.name == user:
return member.date_joined
return None
Implementation notes:
Return private archive URLs that this person can see.
For each of the private archives (PPAs) that this person can see, return a URL that includes the HTTP basic auth data. The URL returned is suitable for including in a sources.list file.
Return the packages for which this person is a bug subscriber.
Returns a list of IDistributionSourcePackage's, ordered alphabetically (A to Z) by name.
Return entries in the translation import queue for this entity.
| arg import_status: | |
|---|---|
| RosettaImportStatus DB Schema entry. | |
| arg file_extension: | |
| String with the file type extension, usually 'po' or 'pot'. | |
If one of both of 'import_status' or 'file_extension' are given, the returned entries are filtered based on those values.
Filename extension
Show only entries with this filename suffix
Status
Show only entries with this status
Returns merge proposals where a person was asked to review.
This does not include merge proposals that were requested from teams that the person is part of. If status is not passed then it will return proposals that are in the "Needs Review" state.
| param status: | A list of statuses to filter with. |
|---|---|
| param visible_by_user: | |
| Normally the user who is asking. | |
| returns: | A list of IBranchMergeProposal. |
Search the IBugTasks reported on this entity.
| search_params: | a BugTaskSearchParams object |
|---|
Return an iterable of matching results.
Note: milestone is currently ignored for all IBugTargets except IProduct.
Status upstream
Indicates the status of any remote watches associated with the bug. Possible values include: pending_bugwatch, hide_upstream, resolved_upstream, and open_upstream.
Tags
String or list of strings for tags to search. To exclude, prepend a '-', e.g. '-unwantedtag'
Status
Show only bugs with the given status value or list of values.
Tags combination
Search for any or all of the tags specified.
Component
Distribution package archive grouping. E.g. main, universe, multiverse
Importance
Show only bugs with the given importance or list of importances.
Information Type
Show only bugs with the given information type or list of information types.
Milestone
Show only bug tasks targeted to this milestone.
Returns all branches with the given lifecycle status.
| param status: | A list of statuses to filter with. |
|---|---|
| param visible_by_user: | |
| Normally the user who is asking. | |
| param modified_since: | |
| If set, filters the branches being returned to those that have been modified since the specified date/time. | |
| param eager_load: | |
| If True load related objects for the whole collection. | |
| returns: | A list of IBranch. |
Returns all merge proposals of a given status.
| param status: | A list of statuses to filter with. |
|---|---|
| param visible_by_user: | |
| Normally the user who is asking. | |
| param eager_load: | |
| If True, load related objects for the whole collection. | |
| returns: | A list of IBranchMergeProposal. |
Return a PPA with the given name if it exists.
| param name: | A string with the exact name of the ppa being looked up. |
|---|---|
| raises: | NoSuchPPA if a suitable PPA could not be found. |
| return: | a PPA IArchive record corresponding to the name. |
Return the people whose membership on this team match :status:.
If no orderby is provided, Person.sortingColumns is used.
Get a text line that is suitable to be used for a sources.list entry.
It will create a new IArchiveAuthToken if one doesn't already exist.
It raises Unauthorized if the context user does not have a valid subscription for the target archive or the caller is not context user itself.
Create a SourcePackageRecipe owned by this person.
| param name: | the name to use for referring to the recipe. |
|---|---|
| param description: | |
| A description of the recipe. | |
| param recipe_text: | |
| The text of the recipe. | |
| param distroseries: | |
| The distroseries to use. | |
| param registrant: | |
| The person who created this recipe. | |
| param daily_build_archive: | |
| The archive to use for daily builds. | |
| param build_daily: | |
| If True, build this recipe daily (if changed). | |
| return: | a SourcePackageRecipe. |
Accept an invitation to become a member of the given team.
There must be a TeamMembership for this person and the given team with the INVITED status. The status of this TeamMembership will be changed to APPROVED.
Create a PPA.
| param distribution: | |
|---|---|
| The distribution that this archive is for. | |
| param name: | The name of the new PPA to create. |
| param displayname: | |
| The displayname for the new PPA. | |
| param description: | |
| The description for the new PPA. | |
| param private: | Whether or not to create a private PPA. Defaults to False, which means the PPA will be public. |
| param suppress_subscription_notifications: | |
| Whether or not to suppress emails to new subscribers about their subscriptions. Only meaningful for private PPAs. | |
| raises: | PPACreationError if an error is encountered |
| return: | a PPA IArchive record. |
Join the given team if its membership_policy is not RESTRICTED.
Join the given team according to the policies and defaults of that team:
If may_subscribe_to_list is True, then also attempt to subscribe to the team's mailing list, depending on the list status and the person's auto-subscribe settings.
| param requester: | |
|---|---|
| The person who requested the membership on behalf of a team or None when a person requests the membership for themselves. | |
| param may_subscribe_to_list: | |
| If True, also try subscribing to the team mailing list. | |
Leave the given team.
This is a convenience method for retractTeamMembership() that allows a user to leave the given team, or to cancel a PENDING membership request.
| param team: | The team to leave. |
|---|
Decline an invitation to become a member of the given team.
There must be a TeamMembership for this person and the given team with the INVITED status. The status of this TeamMembership will be changed to INVITATION_DECLINED.
Add the given person as a member of this team.
| param person: | If the given person is already a member of this team we'll simply change its membership status. Otherwise a new TeamMembership is created with the given status. |
|---|---|
| param reviewer: | The user who made the given person a member of this team. |
| param comment: | String that will be assigned to the proponent_comment, reviewer_comment, or acknowledger comment. |
| param status: | TeamMembershipStatus value must be either Approved, Proposed or Admin. If the new member is a team, the status will be changed to Invited unless the user is also an admin of that team. |
| param force_team_add: | |
| If the person is actually a team and force_team_add is False, the team will actually be invited to join this one. Otherwise the team is added as if it were a person. | |
| param may_subscribe_to_list: | |
| If the person is not a team, and may_subscribe_to_list is True, then the person may be subscribed to the team's mailing list, depending on the list status and the person's auto-subscribe settings. | |
| return: | A tuple containing a boolean indicating when the membership status changed and the current TeamMembershipStatus. This depends on the desired status passed as an argument, the membership policy and the user's privileges. |
Retract this team's membership in the given team.
If there's a membership entry for this team on the given team and its status is either APPROVED, ADMIN, PENDING, or INVITED, the status is changed and the relevant entries in TeamParticipation.
APPROVED and ADMIN status are changed to DEACTIVATED. PENDING status is changed to DECLINED. INVITED status is changes to INVITATION_DECLINED.
| param team: | The team to leave. |
|---|---|
| param user: | The user making the retraction. |
| param comment: | An optional explanation about why the change was made. |
Default PPA
The PPA named 'ppa' owned by this person.
Confirmed emails of this person.
Confirmed emails are the ones in the VALIDATED state
Subscription period
Number of days a new subscription lasts before expiring. You can customize the length of an individual subscription when approving it. Leave this empty or set to 0 for subscriptions to never expire.
Self renewal period
Number of days members can renew their own membership. The number can be from 1 to 3650 (10 years).
Description
Details about interests and goals. Use plain text, paragraphs are preserved and URLs are linked.
Display Name
Your name as you would like it displayed throughout Launchpad. Most people use their full name here.
Homepage Content
Obsolete. Use description.
Karma
The cached total karma for this person.
Logo
An image of exactly 64x64 pixels that will be displayed in the heading of all pages related to you. Traditionally this is a logo, a small picture or a personal mascot. It should be no bigger than 50kb in size.
Mailing List Auto-subscription Policy
This attribute determines whether a person is automatically subscribed to a team's mailing list when the person joins said team.
Active TeamMemberships for this object's members.
Active TeamMemberships are the ones with the ADMIN or APPROVED status. The results are ordered using Person.sortingColumns.
Membership policy
The policies that describe who can be a member. The choice of policy reflects the need to build a community (inclusive) versus the need to control Launchpad projects, branches, and PPAs (exclusive).
Mugshot
A large image of exactly 192x192 pixels, that will be displayed on your home page in Launchpad. Traditionally this is a great big picture of your grinning face. Make the most of it! It should be no bigger than 100kb in size.
Name
A short unique name, beginning with a lower-case letter or number, and containing only letters, numbers, dots, hyphens, or plus signs.
Open membership invitations.
All TeamMemberships which represent an invitation (to join a team) sent to this person.
All participants of this team.
List of all direct and indirect people and teams who, one way or another, are a part of this team. If you want a method to check if a given person is a member of a team, you should probably look at IPerson.inTeam().
PPAs for this person.
PPAs owned by the context person ordered by name.
Preferred email address
The preferred email address for this person. The one we'll use to communicate with them.
This team is private
Private teams are visible only to their members.
All subteams of this team.
A subteam is any team that is a member (either directly or indirectly) of this team. As an example, let's say we have this hierarchy of teams:
In this case, both 'Rosetta pt Translators' and 'Rosetta pt_BR Translators' are subteams of the 'Rosetta Translators' team, and all members of both subteams are considered members of "Rosetta Translators".
Membership policy
Obsolete: use membership_policy
All superteams of this team.
A superteam is any team that this team is a member of. For example, let's say we have this hierarchy of teams, and we are the "Rosetta pt_BR Translators":
In this case, we will return both 'Rosetta pt Translators' and 'Rosetta Translators', because we are member of both of them.
Team Description
Obsolete. Use description.
Visibility
Anyone can see a public team's data. Only team members can see private team data.
Subscription period
Number of days a new subscription lasts before expiring. You can customize the length of an individual subscription when approving it. Leave this empty or set to 0 for subscriptions to never expire.
Self renewal period
Number of days members can renew their own membership. The number can be from 1 to 3650 (10 years).
Description
Details about interests and goals. Use plain text, paragraphs are preserved and URLs are linked.
Display Name
Your name as you would like it displayed throughout Launchpad. Most people use their full name here.
Homepage Content
Obsolete. Use description.
Logo
An image of exactly 64x64 pixels that will be displayed in the heading of all pages related to you. Traditionally this is a logo, a small picture or a personal mascot. It should be no bigger than 50kb in size.
Mailing List Auto-subscription Policy
This attribute determines whether a person is automatically subscribed to a team's mailing list when the person joins said team.
Membership policy
The policies that describe who can be a member. The choice of policy reflects the need to build a community (inclusive) versus the need to control Launchpad projects, branches, and PPAs (exclusive).
Mugshot
A large image of exactly 192x192 pixels, that will be displayed on your home page in Launchpad. Traditionally this is a great big picture of your grinning face. Make the most of it! It should be no bigger than 100kb in size.
Name
A short unique name, beginning with a lower-case letter or number, and containing only letters, numbers, dots, hyphens, or plus signs.
Membership policy
Obsolete: use membership_policy
Team Description
Obsolete. Use description.
Visibility
Anyone can see a public team's data. Only team members can see private team data.
TeamMembership for Users.
This table includes direct team members only. Indirect memberships are handled by the TeamParticipation table.
Set this membership's expiration date.
The given date must be None or in the future and the given user must be allowed to change this membership's expiration date as per the rules defined in canChangeExpirationDate().
Set the status of this membership.
The user and comment are stored in last_changed_by and last_change_comment and may also be stored in proposed_by (and proponent_comment), reviewed_by (and reviewer_comment) or acknowledged_by (and acknowledger_comment), depending on the state transition.
The given status must be different than the current status.
Return True if the status got changed, otherwise False.
Date joined
The date in which this membership was made active for the first time.
Name
The name of the series is a short, unique name that identifies it, being used in URLs. It must be all lowercase, with no special characters. For example, '2.0' or 'trunk'.
Series URI
foo
Name
The name of the series is a short, unique name that identifies it, being used in URLs. It must be all lowercase, with no special characters. For example, '2.0' or 'trunk'.
Series URI
foo
Transition to a new status if possible.
| param new_status: | |
|---|---|
| Status to transition to. | |
| param user: | The user that is doing the transition. |
Error output
Output from most recent import attempt.
Path
The path to this file inside the source tree. Includes the filename.
Uploader
The person that uploaded this file to Launchpad.
Path
The path to this file inside the source tree. Includes the filename.
Date first sent
Timestamp of the first delivery attempt.
Date scheduled
Timestamp of the next delivery attempt.
Date sent
Timestamp of the last delivery attempt.
Error message
Details of the error encountered by the most recent delivery attempt.
Pending
Whether a delivery attempt is in progress.
Successful
Whether the most recent delivery attempt succeeded, or null if no attempts have been made yet.
Webhook
The webhook that this delivery is for.
Active
Deliver details of subscribed events.
Registrant
The person who created this webhook.
Target
The object for which this webhook receives events.
Active
Deliver details of subscribed events.