Пакет Mercurial поставляется с некоторыми стилями вывода, которые вы можете использовать незамедлительно. Стиль — просто предустановленный шаблон, который кто-то написал и установил где-либо и который может найти Mercurial.

До того как мы рассмотрим встроенные стили, давайте взглянем на обычный вывод.

$ hg log -r1
changeset:   1:6f5ce6bc1898
tag:         mytag
user:        Bryan O'Sullivan <bos@serpentine.com>
date:        Thu Feb 02 14:10:09 2012 +0000
summary:     added line to end of <<hello>> file.

Это информативно, но занимает довольно много места — пять линий на набор изменений. Стиль compact уменьшает это до трех линий, представленных в разреженном виде.

$ hg log --style compact
3[tip]   c19f42cb5b95   2012-02-02 14:10 +0000   bos
  Added tag v0.1 for changeset b94147c22394

2[v0.1]   b94147c22394   2012-02-02 14:10 +0000   bos
  Added tag mytag for changeset 6f5ce6bc1898

1[mytag]   6f5ce6bc1898   2012-02-02 14:10 +0000   bos
  added line to end of <<hello>> file.

0   5b2b97feb76c   2012-02-02 14:10 +0000   bos
  added hello

Стиля changelog показывает выразительность и мощь шаблонного движка в Mercurial. Стиль следует принципам проекта GNU для отображения changelog[web:changelog].

$ hg log --style changelog
2012-02-02  Bryan O'Sullivan  <bos@serpentine.com>

	* .hgtags:
	Added tag v0.1 for changeset b94147c22394
	[c19f42cb5b95] [tip]

	* .hgtags:
	Added tag mytag for changeset 6f5ce6bc1898
	[b94147c22394] [v0.1]

	* goodbye, hello:
	added line to end of <<hello>> file.

	in addition, added a file with the helpful name (at least i hope
	that some might consider it so) of goodbye.
	[6f5ce6bc1898] [mytag]

	* hello:
	added hello
	[5b2b97feb76c]

Вы не будете шокированы, узнав, что стиль вывода Mercurial по умолчанию называется default.

[ui]
style = compact

Все команды Mercurial «похожие на log» позволяют использовать стили и шаблоны: hg incoming, hg log, hg outgoing, и hg tip.

Когда я писал это руководство, только эти команды, поддерживали стили и шаблоны. Поскольку это наиболее важные команды, у которых должен настраиваться вывод, давление со стороны сообщества Mercurial по поводу возможности пользователю добавлять стили и шаблоны для других команд было небольшим.

В самом простом случае шаблон mercurial это фрагмент текста. Часть текста не меняется, в то время как другая часть развёртывается и заменяется новым текстом, в случае необходимости.

Для начала давайте посмотрим, как обычно Mercurial оформляет вывод.

$ hg log -r1
changeset:   1:6f5ce6bc1898
tag:         mytag
user:        Bryan O'Sullivan <bos@serpentine.com>
date:        Thu Feb 02 14:10:09 2012 +0000
summary:     added line to end of <<hello>> file.

Теперь, давайте выполним ту же команду, но с использованием шаблона для изменяющего данный вывод.

$ hg log -r1 --template 'i saw a changeset\n'
i saw a changeset

Приведенный выше пример иллюстрирует простейший шаблон, это просто статичный текст, напечатанный один раз для каждой ревизии. Опция --template команды hg log говорит Mercurial использовать данный текст в качестве шаблона при печати каждой ревизии.

Обратите внимание, что строки шаблона заканчиваются текстом «\n». Это управляющая последовательность, говорящая Mercurial печатать новую строку в конце каждого пункта шаблона. Если вы пропустите этот символ новой строки, Mercurial будет печатать все блоки на одной строке. Смотрите раздел Раздел 11.5, «Escape последовательности»; для более подробной информации о управляющих последовательностях.

Шаблон, который выводит фиксированную строку текста все время не очень полезен, давайте попробуем что-нибудь более сложное.

$ hg log --template 'i saw a changeset: {desc}\n'
i saw a changeset: Added tag v0.1 for changeset b94147c22394
i saw a changeset: Added tag mytag for changeset 6f5ce6bc1898
i saw a changeset: added line to end of <<hello>> file.

in addition, added a file with the helpful name (at least i hope that some might consider it so) of goodbye.
i saw a changeset: added hello

Как видите, строка «{desc}»> в шаблоне заменяется на выходе описанием каждой ревизии. Каждый раз, когда Mercurial читает, текст, заключенный в фигурные скобки («{» и «}»), он будет пытаться заменить фигурные скобки и текст подставляя все, что внутри. Для печати символа фигурной скобки, вы должны экранировать ее, как описано в разделе Раздел 11.5, «Escape последовательности».

Вы можете начать писать простые шаблоны, сразу же с помощью ключевых слов указанных ниже.

Несколько простых экспериментов покажет нам, чего ожидать, когда мы используем эти слова, вы можете увидеть результаты ниже.

$ hg log -r1 --template 'author: {author}\n'
author: Bryan O'Sullivan <bos@serpentine.com>
$ hg log -r1 --template 'desc:\n{desc}\n'
desc:
added line to end of <<hello>> file.

in addition, added a file with the helpful name (at least i hope that some might consider it so) of goodbye.
$ hg log -r1 --template 'files: {files}\n'
files: goodbye hello
$ hg log -r1 --template 'file_adds: {file_adds}\n'
file_adds: goodbye
$ hg log -r1 --template 'file_dels: {file_dels}\n'
file_dels: 
$ hg log -r1 --template 'node: {node}\n'
node: 6f5ce6bc18989ecdb1e0ddf5d63d539787a66eb2
$ hg log -r1 --template 'parents: {parents}\n'
parents: 
$ hg log -r1 --template 'rev: {rev}\n'
rev: 1
$ hg log -r1 --template 'tags: {tags}\n'
tags: mytag

Как мы уже отмечали выше, ключевое слово date выводит не человекочитаемый текст, поэтому мы должны обрабатывать его специально. Это связано с использованием фильтров, о которых смотрите в разделе Раздел 11.6, «Фильтрация ключевых слов, чтобы отобразить результат».

$ hg log -r1 --template 'date: {date}\n'
date: 1328191809.00
$ hg log -r1 --template 'date: {date|isodate}\n'
date: 2012-02-02 14:10 +0000

Движок шаблонов Mercurial распознаёт наиболее часто используемые управляющие последовательности в строках. Когда он видит символ обратной косой черты («\»), он читает следующий символ и заменяет 2 символа на один, как описано ниже.

Как указано выше, если вы хотите при развёртывании шаблона использовать символы «\», «{» или «}», вы должны экранировать их.

Некоторые из результатов расширения шаблона не просты в использовании. Mercurial позволяет указать необязательную цепочку фильтров, чтобы изменить результат расширения ключевого слова. Вы уже видели, общий фильтр, isodate, в действии выше, чтобы сделать дату читаемой.

Ниже приведен список наиболее часто используемых фильтров, которые поддерживает Mercurial. Некоторые фильтры могут быть применены к любому тексту, а другие могут быть использованы только в конкретных обстоятельствах. За именем каждого фильтра ниже сначала следует описание, где он может быть использован, а потом описание его действия.

$ hg log -r1 --template '{author}\n'
Bryan O'Sullivan <bos@serpentine.com>
$ hg log -r1 --template '{author|domain}\n'
serpentine.com
$ hg log -r1 --template '{author|email}\n'
bos@serpentine.com
$ hg log -r1 --template '{author|obfuscate}\n' | cut -c-76
&#66;&#114;&#121;&#97;&#110;&#32;&#79;&#39;&#83;&#117;&#108;&#108;&#105;&#11
$ hg log -r1 --template '{author|person}\n'
Bryan O'Sullivan
$ hg log -r1 --template '{author|user}\n'
bos
$ hg log -r1 --template 'looks almost right, but actually garbage: {date}\n'
looks almost right, but actually garbage: 1328191809.00
$ hg log -r1 --template '{date|age}\n'
2 seconds ago
$ hg log -r1 --template '{date|date}\n'
Thu Feb 02 14:10:09 2012 +0000
$ hg log -r1 --template '{date|hgdate}\n'
1328191809 0
$ hg log -r1 --template '{date|isodate}\n'
2012-02-02 14:10 +0000
$ hg log -r1 --template '{date|rfc822date}\n'
Thu, 02 Feb 2012 14:10:09 +0000
$ hg log -r1 --template '{date|shortdate}\n'
2012-02-02
$ hg log -r1 --template '{desc}\n' | cut -c-76
added line to end of <<hello>> file.

in addition, added a file with the helpful name (at least i hope that some m
$ hg log -r1 --template '{desc|addbreaks}\n' | cut -c-76
added line to end of <<hello>> file.<br/>
<br/>
in addition, added a file with the helpful name (at least i hope that some m
$ hg log -r1 --template '{desc|escape}\n' | cut -c-76
added line to end of &lt;&lt;hello&gt;&gt; file.

in addition, added a file with the helpful name (at least i hope that some m
$ hg log -r1 --template '{desc|fill68}\n'
added line to end of <<hello>> file.

in addition, added a file with the helpful name (at least i hope
that some might consider it so) of goodbye.
$ hg log -r1 --template '{desc|fill76}\n'
added line to end of <<hello>> file.

in addition, added a file with the helpful name (at least i hope that some
might consider it so) of goodbye.
$ hg log -r1 --template '{desc|firstline}\n'
added line to end of <<hello>> file.
$ hg log -r1 --template '{desc|strip}\n' | cut -c-76
added line to end of <<hello>> file.

in addition, added a file with the helpful name (at least i hope that some m
$ hg log -r1 --template '{desc|tabindent}\n' | expand | cut -c-76
added line to end of <<hello>> file.

        in addition, added a file with the helpful name (at least i hope tha
$ hg log -r1 --template '{node}\n'
6f5ce6bc18989ecdb1e0ddf5d63d539787a66eb2
$ hg log -r1 --template '{node|short}\n'
6f5ce6bc1898

	Примечание
	Если вы попробуете применить фильтр к фрагменту данных, который не может быть обработан, Mercurial напечатает исключение Python. Например, попытка запустить фильтр isodate для ключевого слова desc, будет не очень хорошей идеей.

$ hg log -r1 --template 'description:\n\t{desc|strip|fill68|tabindent}\n'
description:
	added line to end of <<hello>> file.

	in addition, added a file with the helpful name (at least i hope
	that some might consider it so) of goodbye.

Шаблон в командной строке предоставляет простой и быстрый способ для форматирования некоторого вывода. Шаблоны могут стать слишком многословным, хотя, и это полезно, чтобы иметь возможность указать имени шаблон. Файл стиля представляет собой шаблон с именем, хранящийся в файле.

Более того, использование файла стиля открывает силу движка шаблонов Mercurial таким образом, который не представляется возможным с помощью опции командной строки --template.

$ echo 'changeset = "rev: {rev}\n"' > rev
$ hg log -l1 --style ./rev
rev: 3

Чтобы показать, как писать стилевой файл, напишем несколько примеров. Вместо того, чтобы обеспечивать полный стилевой файл и проходить по нему, мы отобразим обычный процесс разработки стилевого файла, начиная с чего-то очень простого, и переходя через набор последовательно более полных примеров.

$ cat broken.style
changeset =

$ hg log -r1 --style broken.style
** unknown exception encountered, please report by visiting
**  http://mercurial.selenic.com/wiki/BugTracker
** Python 2.7.2 (default, Nov  3 2011, 15:14:27) [GCC 4.5.3]
** Mercurial Distributed SCM (version 2.0)
** Extensions loaded: 
Traceback (most recent call last):
  File "/usr/bin/hg-2.7", line 38, in <module>
    mercurial.dispatch.run()
  File "/usr/lib64/python2.7/site-packages/mercurial/dispatch.py", line 27, in run
    sys.exit(dispatch(request(sys.argv[1:])))
  File "/usr/lib64/python2.7/site-packages/mercurial/dispatch.py", line 64, in dispatch
    return _runcatch(req)
  File "/usr/lib64/python2.7/site-packages/mercurial/dispatch.py", line 87, in _runcatch
    return _dispatch(req)
  File "/usr/lib64/python2.7/site-packages/mercurial/dispatch.py", line 684, in _dispatch
    cmdpats, cmdoptions)
  File "/usr/lib64/python2.7/site-packages/mercurial/dispatch.py", line 466, in runcommand
    ret = _runcommand(ui, options, cmd, d)
  File "/usr/lib64/python2.7/site-packages/mercurial/dispatch.py", line 738, in _runcommand
    return checkargs()
  File "/usr/lib64/python2.7/site-packages/mercurial/dispatch.py", line 692, in checkargs
    return cmdfunc()
  File "/usr/lib64/python2.7/site-packages/mercurial/dispatch.py", line 681, in <lambda>
    d = lambda: util.checksignature(func)(ui, *args, **cmdoptions)
  File "/usr/lib64/python2.7/site-packages/mercurial/util.py", line 454, in check
    return func(*args, **kwargs)
  File "/usr/lib64/python2.7/site-packages/mercurial/commands.py", line 3822, in log
    displayer = cmdutil.show_changeset(ui, repo, opts, True)
  File "/usr/lib64/python2.7/site-packages/mercurial/cmdutil.py", line 893, in show_changeset
    t = changeset_templater(ui, repo, patch, opts, mapfile, buffered)
  File "/usr/lib64/python2.7/site-packages/mercurial/cmdutil.py", line 762, in __init__
    cache=defaulttempl)
  File "/usr/lib64/python2.7/site-packages/mercurial/templater.py", line 298, in __init__
    if val[0] in "'\"":
IndexError: string index out of range

$ hg log -r0 --template '{node}'
618e49b7b3328b9f52044186fc5089f37ebce576

$ cat > multiline << EOF
> changeset = "Changed in {node|short}:\n{files}"
> file = "  {file}\n"
> EOF
$ hg log --style multiline
Changed in bb7c31cb2621:
  .bashrc
  .hgrc
  test.c

$ svn log -r9653
------------------------------------------------------------------------
r9653 | sean.hefty | 2006-09-27 14:39:55 -0700 (Wed, 27 Sep 2006) | 5 lines

On reporting a route error, also include the status for the error,
rather than indicating a status of 0 when an error has occurred.

Signed-off-by: Sean Hefty <sean.hefty@intel.com>

------------------------------------------------------------------------

$ cat svn.template
r{rev} | {author|user} | {date|isodate} ({date|rfc822date})

{desc|strip|fill76}

------------------------------------------------------------------------

$ cat svn.style
header = '------------------------------------------------------------------------\n\n'
changeset = svn.template