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