Bitbucket Extension

This extension is not distributed with Mercurial.

Authors: Georg Brandl and Armin Ronacher

Repository: http://bitbucket.org/seanfarley/hgbb

1. Overview

This extension has two purposes:

access bitbucket repositories via short URIs like bb:[name/]repo
conveniently do several bitbucket.org operations on the command line

1.1. Implemented URL schemas

Should be usable everywhere instead of http://bitbucket.org/...:

bb:repo

clones your own "repo" repository, checkout via default method

bb:username/repo

clones the "repo" repository by username, checkout via default method

bb+http:repo

clones your own "repo" repository, checkout via http

bb+http:username/repo

clones the "repo" repository by username, checkout via http

bb+ssh:repo

clones your own "repo" repository, checkout via ssh

bb+ssh:username/repo

clones the "repo" repository by username, checkout via ssh

1.2. Implemented commands

hg bbforks

This command shows the list of registered forks of your repository on bitbucket.

With the -i option, it checks each fork for incoming changesets.

With the -if options, it also prints each incoming changeset shortly.

For example:

sphinx$ hg bbforks -if
using 'birkenfeld/sphinx' as repo name
getting descendants list
looking at bboissin/tonfa-sphinx
looking at yarko/sphinxdevel
11 incoming changesets found in bb+http:yarko/sphinxdevel
2904:4fbf67ecbaa9 2008-11-06 cyt007: image paths with *; latex title espaces;
2905:fa423b494885 2008-11-06 cyt007: updates from Georg
2906:a4622d835db3 2008-11-06 cyt007: reverting as per Georg
...

$/!\$ I'm very interested in discussions how to improve that feature, as well as contributions for further commands...

2. Configuration

Configure your .hgrc to enable the extension by adding following lines:

[extensions]
hgbb = /path/to/hgbb.py

Then, configure your bitbucket user name and other options:

[bb]
username = birkenfeld
default_method = ssh

In individual repository .hgrcs, you can also add

[bb]
ignore_forks = username1/repo, username2/repo, ...

to make hg bbforks ignore these repos.

CategoryExtensionsByOthers