launchpad - Integration with Launchpad.net (project hosting service)

Version 2.4.0dev1
Branch lp:bzr
Home page https://launchpad.net/bzr
Owner bzr
GNU/Linux Yes
Windows Yes
Mac OS X Yes

Launchpad.net integration plugin for Bazaar.

This plugin provides facilities for working with Bazaar branches that are hosted on Launchpad (http://launchpad.net). It provides a directory service for referring to Launchpad branches using the “lp:” prefix. For example, lp:bzr refers to the Bazaar’s main development branch and lp:~username/project/branch-name can be used to refer to a specific branch.

This plugin provides a bug tracker so that “bzr commit –fixes lp:1234” will record that revision as fixing Launchpad’s bug 1234.

The plugin also provides the following commands:

launchpad-login: Show or set the Launchpad user ID launchpad-open: Open a Launchpad branch page in your web browser lp-propose-merge: Propose merging a branch on Launchpad register-branch: Register a branch with launchpad.net launchpad-mirror: Ask Launchpad to mirror a branch now

launchpad-login

Purpose

Show or set the Launchpad user ID.

Usage

bzr launchpad-login [NAME]

Options

--usage Show usage message and options.
--no-check Don’t check that the user name is valid.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

Description

When communicating with Launchpad, some commands need to know your Launchpad user ID. This command can be used to set or show the user ID that Bazaar will use for such communication.

Examples

Show the Launchpad ID of the current user:

bzr launchpad-login

Set the Launchpad ID of the current user to ‘bob’:

bzr launchpad-login bob

Aliases

lp-login

launchpad-mirror

Purpose

Ask Launchpad to mirror a branch now.

Usage

bzr launchpad-mirror [LOCATION]

Options

--usage Show usage message and options.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

Aliases

lp-mirror

launchpad-open

Purpose

Open a Launchpad branch page in your web browser.

Usage

bzr launchpad-open [LOCATION]

Options

--usage Show usage message and options.
--dry-run Do not actually open the browser. Just say the URL we would use.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

Aliases

lp-open

lp-find-proposal

Purpose

Find the proposal to merge this revision.

Usage

bzr lp-find-proposal

Options

--usage Show usage message and options.
-r ARG, --revision=ARG
 See “help revisionspec” for details.
-v, --verbose Display more information.
-q, --quiet Only display errors and warnings.
-h, --help Show help message.

Description

Finds the merge proposal(s) that discussed landing the specified revision. This works only if the selected branch was the merge proposal target, and if the merged_revno is recorded for the merge proposal. The proposal(s) are opened in a web browser.

Any revision involved in the merge may be specified– the revision in which the merge was performed, or one of the revisions that was merged.

So, to find the merge proposal that reviewed line 1 of README:

bzr lp-find-proposal -r annotate:README:1

lp-propose-merge

Purpose

Propose merging a branch on Launchpad.

Usage

bzr lp-propose-merge [SUBMIT_BRANCH]

Options

--staging Propose the merge on staging.
-v, --verbose Display more information.
-R ARG, --review=ARG
 Requested reviewer and optional type.
-q, --quiet Only display errors and warnings.
--usage Show usage message and options.
-m ARG, --message=ARG
 Commit message.
--approve Mark the proposal as approved immediately.
-h, --help Show help message.

Description

This will open your usual editor to provide the initial comment. When it has created the proposal, it will open it in your default web browser.

The branch will be proposed to merge into SUBMIT_BRANCH. If SUBMIT_BRANCH is not supplied, the remembered submit branch will be used. If no submit branch is remembered, the development focus will be used.

By default, the SUBMIT_BRANCH’s review team will be requested to review the merge proposal. This can be overriden by specifying –review (-R). The parameter the launchpad account name of the desired reviewer. This may optionally be followed by ‘=’ and the review type. For example:

bzr lp-propose-merge –review jrandom –review review-team=qa

This will propose a merge, request “jrandom” to perform a review of unspecified type, and request “review-team” to perform a “qa” review.

Aliases

lp-submit, lp-propose

register-branch

Purpose

Register a branch with launchpad.net.

Usage

bzr register-branch [PUBLIC_URL]

Options

--dry-run Prepare the request but don’t actually send it.
-v, --verbose Display more information.
--author=ARG Branch author’s email address, if not yourself.
--branch-description=ARG
 Longer description of the purpose or contents of the branch.
-q, --quiet Only display errors and warnings.
--project=ARG Launchpad project short name to associate with the branch.
--link-bug=ARG The bug this branch fixes.
--branch-name=ARG
 Short name for the branch; by default taken from the last component of the url.
--usage Show usage message and options.
--branch-title=ARG
 One-sentence description of the branch.
-h, --help Show help message.

Description

This command lists a bzr branch in the directory of branches on launchpad.net. Registration allows the branch to be associated with bugs or specifications.

Before using this command you must register the project to which the branch belongs, and create an account for yourself on launchpad.net.

arguments:
public_url: The publicly visible url for the branch to register.
This must be an http or https url (which Launchpad can read from to access the branch). Local file urls, SFTP urls, and bzr+ssh urls will not work. If no public_url is provided, bzr will use the configured public_url if there is one for the current branch, and otherwise error.
example:
bzr register-branch http://foo.com/bzr/fooproject.mine
–project fooproject