Mercurial エクステンションを使う

Mercurial にはエクステンションという便利な仕組みが備わっており、新しいコマンドを追加することができます。

エクステンションは新しい機能を作成するための手段を提供しており、その機能はビルトインコマンドと同じように hg のコマンドラインから直接利用可能です。エクステンションについて詳しくは、 'hg help extensions' (Mercurial 1.3以降) を参照してください。

エクステンションカテゴリ内のページについては CategoryExtension を、インストールとエクステンションの書き方については WritingExtensions を参照してください。

Contents

エクステンションを有効にする
Mercurial とともに配布されているエクステンション
外部提供のエクステンション
参考

1. エクステンションを有効にする

エクステンション "foo" を有効にするには、そのエクステンションが Mercurial とともに配布されているか Python のサーチパスに含まれている場合は、対応するエントリーを hgrc ファイルに追加してください。例:

[extensions]
foo =

エクステンションをフルパスで指定してもかまいません:

[extensions]
myfeature = ~/.hgext/myfeature.py

上位スコープの hgrc で有効になっているエクステンションを特に無効化したい場合は、 ! をパスの前に足してください:

[extensions]
# /path/to/extension/bar.py にある bar エクステンションを無効化
hgext.bar = !/path/to/extension/bar.py
# baz エクステンションのパスを指定しなくても同じこと
hgext.baz = !

たいていのエクステンションは、同じ設定ファイル上の専用セクションで細かい設定ができるようになっています。

2. Mercurial とともに配布されているエクステンション

名称	ページ	説明
acl	AclExtension	コントロールリストをもとにリポジトリの一部へのコミットアクセスを制御
alias	AliasExtension	コマンドにユーザー定義の別名を (Mercurial 1.3 以降はビルトイン)
bisect	BisectExtension	履歴の2分探索(O(log(n))でバグや機能が入ったリビジョンをサクッと見つける。 (Mercurial 1.0 以降はビルトイン)
bookmarks	BookmarksExtension	Markers on commits that move on commit
bugzilla	BugzillaExtension	Update Bugzilla entries when a bug id is referenced in a changeset
children	ChildrenExtension	Display children revisions
churn	ChurnExtension	Show change statistics for mercurial operations per author
convert	ConvertExtension	他の SCM から Mercurial へリポジトリを変換
color	ColorExtension	カラフルな diff, status, qseries コマンド
extdiff	ExtdiffExtension	外部プログラムで変更内容を比較
fetch	FetchExtension	pull, merge, update は1ステップでどう?
gpg	GpgExtension	GPG を使ったチェンジセットの署名とその検証
graphlog	GraphlogExtension	ASCII アートのリビジョングラフと履歴を並べて表示
hgcia	HgciaExtension	Send notifications to CIA
hgk	HgkExtension	Graphical repository and history browser based on gitk
highlight	HighlightExtension	hgweb のファイルリビジョン表示でシンタックスハイライト
imerge	ImergeExtension	Perform interactive, interruptible merges
inotify	InotifyExtension	linux 2.6 inotify API を用いて status を瞬時に更新
interhg	InterhgExtension	This extension allows you to change changelog and summary text just like InterWiki way
keyword	KeywordExtension	Use CVS like keyword expansion in tracked files
mq	JapaneseMqExtension	Mercurial パッチキュー - 変更内容を一連のパッチとして管理
notify	NotifyExtension	リポジトリの変更を登録メールアドレスへお知らせ
pager	PagerExtension	Allows you to choose a pager
parentrevspec	ParentrevspecExtension	Use `foo^` to refer to the parent of revision `foo`
patchbomb	PatchbombExtension	チェンジセットを一連のパッチ email として送信
purge	PurgeExtension	Purge all files and dirs in the repository that are not being tracked by Mercurial
rebase	RebaseExtension	リビジョンの分岐点を移動
record	RecordExtension	Select working directory changes to commit by hunk à la darcs record
share	ShareExtension	Share repository history between multiple repos
transplant	TransplantExtension	Cherry-picking, rebasing and changeset rewriting
win32mbcs	Win32mbcsExtension	Allow to use shift_jis/big5 filenames on Windows.
win32text	Win32TextExtension	Manage line ending conversion for Windows repositories
zeroconf	ZeroconfExtension	Announce and browser respositories via zeroconf/bonjour

3. 外部提供のエクステンション

エクステンションの一覧は常に更新されています。最新の情報は UsingExtensions (英語) を参照してください。

名称	ページ	説明
activity	ActivityExtension	Create an image representing the activity of the repository
attic	AtticExtension	Easily deal with individual patches
autopager	AutopagerExtension	Invoke pager when output is longer than one screen
bigfiles	BigfilesExtension	Support versions of big files with storage outside hg repo
boundmode	BoundModeExtension	Enables a bound mode (commit command auto-pushes)
casestop	CasestopExtension	Stops case-folding conflicts on commit
changelog	ChangelogExtension	Auto-generate commit message from changelog entry
chart	ChartExtension	Display activity graphs (see also ActivityExtension and ChurnExtension)
commits	CommitsExtension	Commit modified files as multiple changesets at once
collapse	CollapseExtension	Collapse consecutive changesets into one
config	ConfigExtensionCommandLine	Manage config files via command line only
config	ConfigExtension	Manage hgrc files via dialogs and command line
crecord	CrecordExtension	Select graphically which files/hunk/lines to commit
cutehg	CuteHgExtension	A growing set of easy to install and use dialogs for mercurial commands
cvscommit	CvscommitExtension	Push changesets to CVS
defpasswd	DefpasswdExtension	Automatically provide credentials (username/passwords) read from a file.
deps	DepsExtension	Create and manage versioned repository dependencies
digest	DigestExtension	Create and use small digest files for outgoing/bundle
diffstat	DiffstatExtension	Shortcut commands for displaying diffstat
dotlog	DotLogExtension	Yet Another DOT grapher
easycommit	EasycommitExtension	Command-line GUI for committing changes
easymerge	EasymergeExtension	Command-line GUI for merging
fastimport	FastImportExtension	Read a git "fast import" stream and turn it into changesets in a Mercurial repository
filereview	FileReviewExtension	Perform code review for any project using mercurial
fixcase	FixcaseExtension	Fix problems where an external tool has changed the case of a filename
fixutf8	FixUtf8Extension	Fix problems on non-utf8 systems with filenames (Windows never supports utf8 filenames)
foreign	ForeignExtension	Interactively register or delete foreign/unknown files
forest	ForestExtension	Manage a bunch of mercurial repos as a meta repository, with snapshot support thread
ftp	FTPExtension	Manage uploaded snapshots on FTP server
graphviz	GraphvizExtension	Generate DOT language source to visualize changeset tree
group	GroupExtension	Allow to visually regroup a set of changesets
hg-git	HgGit	Push to and pull from a Git server
hgsubversion	HgSubversion	Use Mercurial as a Subversion client
hgtrac	HgTracExtension	Mercurial/Trac Integration Hook (pre/post hooks for Trac/Mercurial)
histedit	HisteditExtension	Edit, fold, drop changesets in the style of `git rebase --interactive`
histpush	HistpushExtension	Record locally which revisions have been pushed
info	InfoExtension	Display basic information about a repository
kerberos	KerberosExtension	Kerberos Authentication over HTTP support
localbranch	LocalbranchExtension	Create clones inside your working directory
makewritable	MakewritableExtension	Interactively removes read-only flags from files
message	MessageExtension	Preset the message used for commit
mbox	MboxExtension	Import patches from unix mailboxes in MQ
nearest	NearestExtension	Display the nearest tag from a given changeset
pbranch	PatchBranchExtension	Collaborative and/or long-term patch development and maintenance
prompt	PromptExtension	Put information about the current repository into a shell prompt
reviewboard	ReviewboardExtension	Post changesets for review to a Review Board server
qct	QctExtension	Provide access to the Qct commit tool
qtimes	QtimesExtension	Save or restore modification times of files affected by patch queue
qup	QupExtension	Move MQ patches to top of unapplied part of series
rcpath	RcpathExtension	Displays Mercurial configuration file paths and names
rdiff	RdiffExtension	Allow diff to work against remote repositories
reposettings	ReposettingsExtension	Allow repo specific configuration from central configuration files
schemes	SchemesExtension	Add shortcuts to urls as url schemes
send	SendExtension	Automatic send of bundle containing changesets missing on remote, like darcs send
sharedrepo	SharedRepoExtension	Let multiple working directories share the same repository
shelve	ShelveExtension	Interactively select changes to set aside
sonichg	SonicHgExtension	Record pushlog data, web interfaces to view pushlog & shortlog with slider, advanced search for pushlog, new file log page, full side-by-side diffs, regex filter, commit syntax warning and more!
tasks	TasksExtension	Manage tasks as collections of contiguous changesets
timestamp	TimestampExtension	Saves and restores file timestamps

4. 参考

ExtensionHitlist

CategoryJapanese

-  ⇤ ← Revision 1 as of 2009-09-04 13:59:01 → 
  Size: 11459
  Editor: YuyaNishihara
  Comment: Partially translated UsingExtensions to Japanese.
+   ← Revision 2 as of 2009-09-12 14:19:33 → ⇥
  Size: 11607
  Editor: YuyaNishihara
  Comment: Updated to UsingExtensions r158.
-Deletions are marked like this.
+Additions are marked like this.
 Line 12:
-エクステンションについて詳しくは、 'hg help extensions' (Mercurial 1.3以降) を参照してください。
+エクステンションについて詳しくは、 '`hg help extensions`' (Mercurial 1.3以降) を参照してください。
 Line 52:
-||'''alias''' ||AliasExtension ||コマンドにユーザー定義の別名を ||
||'''bisect''' ||BisectExtension ||履歴の2分探索(O(log(n))でバグや機能が入ったリビジョンをサクッと見つける。 '''Mercurial 1.0 以降はビルトイン''' ||
+||'''alias''' ||AliasExtension ||コマンドにユーザー定義の別名を ('''Mercurial 1.3 以降はビルトイン''') ||
||'''bisect''' ||BisectExtension ||履歴の2分探索(O(log(n))でバグや機能が入ったリビジョンをサクッと見つける。 ('''Mercurial 1.0 以降はビルトイン''') ||
 Line 70:
-||'''keyword''' ||KeywordExtension ||use CVS like keyword expansion in tracked files ||
+||'''keyword''' ||KeywordExtension ||Use CVS like keyword expansion in tracked files ||
 Line 74:
-||'''parentrevspec''' ||ParentrevspecExtension ||use `foo^` to refer to the parent of revision `foo` ||
+||'''parentrevspec''' ||ParentrevspecExtension ||Use `foo^` to refer to the parent of revision `foo` ||
 Line 103:
-||'''cutehg''' ||CuteHgExtension ||A growing set of easy to install and use dialogs for mercurial commands. ||
+||'''cutehg''' ||CuteHgExtension ||A growing set of easy to install and use dialogs for mercurial commands ||
 Line 113:
+||'''filereview''' ||FileReviewExtension||Perform code review for any project using mercurial ||

Diff for "JapaneseUsingExtensions"

Mercurial エクステンションを使う

1. エクステンションを有効にする

2. Mercurial とともに配布されているエクステンション

3. 外部提供のエクステンション

4. 参考