Differences between revisions 7 and 8
⇤ ← Revision 7 as of 2015-11-23 23:37:20 →
Size: 2265
Editor: NathanGoldbaum
Comment:
← Revision 8 as of 2015-11-29 06:57:09 → ⇥
Size: 2367
Editor: rcl
Comment: add section numbering, proper title, etc.
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
#pragma section-numbers 2
= Bitbucket Extension =

'''This extension is not distributed with Mercurial.'''
Line 5: Line 10:
=== Overview === == Overview ==
Line 13: Line 18:
==== Implemented URL schemas ==== === Implemented URL schemas ===
Line 30: Line 35:
==== Implemented commands ==== === Implemented commands ===
Line 47: Line 52:
11 incoming changesets found in bb+http:yarko/sphinxdevel    11 incoming changesets found in bb+http:yarko/sphinxdevel
Line 58: Line 63:
=== Configuration === == Configuration ==

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

BitbucketExtension (last edited 2015-11-29 06:57:09 by rcl)