#pragma section-numbers 2
= Bitbucket Extension =

'''This extension is not distributed with Mercurial.'''

''Authors: Georg Brandl and Armin Ronacher''

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

== Overview ==

This extension has two purposes:

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


=== 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

=== 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...


== 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 `.hgrc`s, you can also add
{{{
[bb]
ignore_forks = username1/repo, username2/repo, ...
}}}

to make `hg bbforks` ignore these repos.

----
CategoryExtensionsByOthers