hgweb: add parents to json-log (issue5074)

Entries prepared in webutil.changelistentry() skip showing parents in the
trivial case when there's only one parent and it's the previous revision. This
doesn't work well for the json-log template, which is supposed to just dump raw
data in an easy-to-parse format, so let's provide all parents as another
keyword: allparents.

Using a lambda function here means that the performance of templates that don't
use allparents won't be affected (see 41957e50e109).

mercurial/hgweb/webutil.py

@@ -1,607 +1,608 b''
 # hgweb/webutil.py - utility library for the web interface.
 #
 # Copyright 21 May 2005 - (c) 2005 Jake Edge <[e-mail]>
 # Copyright 2005-2007 Matt Mackall <[e-mail]>
 #
 # This software may be used and distributed according to the terms of the
 # GNU General Public License version 2 or any later version.
 
 from __future__ import absolute_import
 
 import copy
 import difflib
 import os
 import re
 
 from ..i18n import _
 from ..node import hex, nullid, short
 
 from .common import (
     ErrorResponse,
     HTTP_NOT_FOUND,
     paritygen,
 )
 
 from .. import (
     context,
     error,
     match,
     patch,
     pathutil,
     templatefilters,
     ui as uimod,
     util,
 )
 
 def up(p):
     if p[0] != "/":
         p = "/" + p
     if p[-1] == "/":
         p = p[:-1]
     up = os.path.dirname(p)
     if up == "/":
         return "/"
     return up + "/"
 
 def _navseq(step, firststep=None):
     if firststep:
         yield firststep
         if firststep >= 20 and firststep <= 40:
             firststep = 50
             yield firststep
         assert step > 0
         assert firststep > 0
         while step <= firststep:
             step *= 10
     while True:
         yield 1 * step
         yield 3 * step
         step *= 10
 
 class revnav(object):
 
     def __init__(self, repo):
         """Navigation generation object
 
         :repo: repo object we generate nav for
         """
         # used for hex generation
         self._revlog = repo.changelog
 
     def __nonzero__(self):
         """return True if any revision to navigate over"""
         return self._first() is not None
 
     def _first(self):
         """return the minimum non-filtered changeset or None"""
         try:
             return iter(self._revlog).next()
         except StopIteration:
             return None
 
     def hex(self, rev):
         return hex(self._revlog.node(rev))
 
     def gen(self, pos, pagelen, limit):
         """computes label and revision id for navigation link
 
         :pos: is the revision relative to which we generate navigation.
         :pagelen: the size of each navigation page
         :limit: how far shall we link
 
         The return is:
             - a single element tuple
             - containing a dictionary with a `before` and `after` key
             - values are generator functions taking arbitrary number of kwargs
             - yield items are dictionaries with `label` and `node` keys
         """
         if not self:
             # empty repo
             return ({'before': (), 'after': ()},)
 
         targets = []
         for f in _navseq(1, pagelen):
             if f > limit:
                 break
             targets.append(pos + f)
             targets.append(pos - f)
         targets.sort()
 
         first = self._first()
         navbefore = [("(%i)" % first, self.hex(first))]
         navafter = []
         for rev in targets:
             if rev not in self._revlog:
                 continue
             if pos < rev < limit:
                 navafter.append(("+%d" % abs(rev - pos), self.hex(rev)))
             if 0 < rev < pos:
                 navbefore.append(("-%d" % abs(rev - pos), self.hex(rev)))
 
 
         navafter.append(("tip", "tip"))
 
         data = lambda i: {"label": i[0], "node": i[1]}
         return ({'before': lambda **map: (data(i) for i in navbefore),
                  'after':  lambda **map: (data(i) for i in navafter)},)
 
 class filerevnav(revnav):
 
     def __init__(self, repo, path):
         """Navigation generation object
 
         :repo: repo object we generate nav for
         :path: path of the file we generate nav for
         """
         # used for iteration
         self._changelog = repo.unfiltered().changelog
         # used for hex generation
         self._revlog = repo.file(path)
 
     def hex(self, rev):
         return hex(self._changelog.node(self._revlog.linkrev(rev)))
 
 class _siblings(object):
     def __init__(self, siblings=[], hiderev=None):
         self.siblings = [s for s in siblings if s.node() != nullid]
         if len(self.siblings) == 1 and self.siblings[0].rev() == hiderev:
             self.siblings = []
 
     def __iter__(self):
         for s in self.siblings:
             d = {
                 'node': s.hex(),
                 'rev': s.rev(),
                 'user': s.user(),
                 'date': s.date(),
                 'description': s.description(),
                 'branch': s.branch(),
             }
             if util.safehasattr(s, 'path'):
                 d['file'] = s.path()
             yield d
 
     def __len__(self):
         return len(self.siblings)
 
 def parents(ctx, hide=None):
     if isinstance(ctx, context.basefilectx):
         introrev = ctx.introrev()
         if ctx.changectx().rev() != introrev:
             return _siblings([ctx.repo()[introrev]], hide)
     return _siblings(ctx.parents(), hide)
 
 def children(ctx, hide=None):
     return _siblings(ctx.children(), hide)
 
 def renamelink(fctx):
     r = fctx.renamed()
     if r:
         return [{'file': r[0], 'node': hex(r[1])}]
     return []
 
 def nodetagsdict(repo, node):
     return [{"name": i} for i in repo.nodetags(node)]
 
 def nodebookmarksdict(repo, node):
     return [{"name": i} for i in repo.nodebookmarks(node)]
 
 def nodebranchdict(repo, ctx):
     branches = []
     branch = ctx.branch()
     # If this is an empty repo, ctx.node() == nullid,
     # ctx.branch() == 'default'.
     try:
         branchnode = repo.branchtip(branch)
     except error.RepoLookupError:
         branchnode = None
     if branchnode == ctx.node():
         branches.append({"name": branch})
     return branches
 
 def nodeinbranch(repo, ctx):
     branches = []
     branch = ctx.branch()
     try:
         branchnode = repo.branchtip(branch)
     except error.RepoLookupError:
         branchnode = None
     if branch != 'default' and branchnode != ctx.node():
         branches.append({"name": branch})
     return branches
 
 def nodebranchnodefault(ctx):
     branches = []
     branch = ctx.branch()
     if branch != 'default':
         branches.append({"name": branch})
     return branches
 
 def showtag(repo, tmpl, t1, node=nullid, **args):
     for t in repo.nodetags(node):
         yield tmpl(t1, tag=t, **args)
 
 def showbookmark(repo, tmpl, t1, node=nullid, **args):
     for t in repo.nodebookmarks(node):
         yield tmpl(t1, bookmark=t, **args)
 
 def branchentries(repo, stripecount, limit=0):
     tips = []
     heads = repo.heads()
     parity = paritygen(stripecount)
     sortkey = lambda item: (not item[1], item[0].rev())
 
     def entries(**map):
         count = 0
         if not tips:
             for tag, hs, tip, closed in repo.branchmap().iterbranches():
                 tips.append((repo[tip], closed))
         for ctx, closed in sorted(tips, key=sortkey, reverse=True):
             if limit > 0 and count >= limit:
                 return
             count += 1
             if closed:
                 status = 'closed'
             elif ctx.node() not in heads:
                 status = 'inactive'
             else:
                 status = 'open'
             yield {
                 'parity': parity.next(),
                 'branch': ctx.branch(),
                 'status': status,
                 'node': ctx.hex(),
                 'date': ctx.date()
             }
 
     return entries
 
 def cleanpath(repo, path):
     path = path.lstrip('/')
     return pathutil.canonpath(repo.root, '', path)
 
 def changeidctx(repo, changeid):
     try:
         ctx = repo[changeid]
     except error.RepoError:
         man = repo.manifest
         ctx = repo[man.linkrev(man.rev(man.lookup(changeid)))]
 
     return ctx
 
 def changectx(repo, req):
     changeid = "tip"
     if 'node' in req.form:
         changeid = req.form['node'][0]
         ipos = changeid.find(':')
         if ipos != -1:
             changeid = changeid[(ipos + 1):]
     elif 'manifest' in req.form:
         changeid = req.form['manifest'][0]
 
     return changeidctx(repo, changeid)
 
 def basechangectx(repo, req):
     if 'node' in req.form:
         changeid = req.form['node'][0]
         ipos = changeid.find(':')
         if ipos != -1:
             changeid = changeid[:ipos]
             return changeidctx(repo, changeid)
 
     return None
 
 def filectx(repo, req):
     if 'file' not in req.form:
         raise ErrorResponse(HTTP_NOT_FOUND, 'file not given')
     path = cleanpath(repo, req.form['file'][0])
     if 'node' in req.form:
         changeid = req.form['node'][0]
     elif 'filenode' in req.form:
         changeid = req.form['filenode'][0]
     else:
         raise ErrorResponse(HTTP_NOT_FOUND, 'node or filenode not given')
     try:
         fctx = repo[changeid][path]
     except error.RepoError:
         fctx = repo.filectx(path, fileid=changeid)
 
     return fctx
 
 def commonentry(repo, ctx):
     node = ctx.node()
     return {
         'rev': ctx.rev(),
         'node': hex(node),
         'author': ctx.user(),
         'desc': ctx.description(),
         'date': ctx.date(),
         'extra': ctx.extra(),
         'phase': ctx.phasestr(),
         'branch': nodebranchnodefault(ctx),
         'inbranch': nodeinbranch(repo, ctx),
         'branches': nodebranchdict(repo, ctx),
         'tags': nodetagsdict(repo, node),
         'bookmarks': nodebookmarksdict(repo, node),
         'parent': lambda **x: parents(ctx),
         'child': lambda **x: children(ctx),
     }
 
 def changelistentry(web, ctx, tmpl):
     '''Obtain a dictionary to be used for entries in a changelist.
 
     This function is called when producing items for the "entries" list passed
     to the "shortlog" and "changelog" templates.
     '''
     repo = web.repo
     rev = ctx.rev()
     n = ctx.node()
     showtags = showtag(repo, tmpl, 'changelogtag', n)
     files = listfilediffs(tmpl, ctx.files(), n, web.maxfiles)
 
     entry = commonentry(repo, ctx)
     entry.update(
+        allparents=lambda **x: parents(ctx),
         parent=lambda **x: parents(ctx, rev - 1),
         child=lambda **x: children(ctx, rev + 1),
         changelogtag=showtags,
         files=files,
     )
     return entry
 
 def symrevorshortnode(req, ctx):
     if 'node' in req.form:
         return templatefilters.revescape(req.form['node'][0])
     else:
         return short(ctx.node())
 
 def changesetentry(web, req, tmpl, ctx):
     '''Obtain a dictionary to be used to render the "changeset" template.'''
 
     showtags = showtag(web.repo, tmpl, 'changesettag', ctx.node())
     showbookmarks = showbookmark(web.repo, tmpl, 'changesetbookmark',
                                  ctx.node())
     showbranch = nodebranchnodefault(ctx)
 
     files = []
     parity = paritygen(web.stripecount)
     for blockno, f in enumerate(ctx.files()):
         template = f in ctx and 'filenodelink' or 'filenolink'
         files.append(tmpl(template,
                           node=ctx.hex(), file=f, blockno=blockno + 1,
                           parity=parity.next()))
 
     basectx = basechangectx(web.repo, req)
     if basectx is None:
         basectx = ctx.p1()
 
     style = web.config('web', 'style', 'paper')
     if 'style' in req.form:
         style = req.form['style'][0]
 
     parity = paritygen(web.stripecount)
     diff = diffs(web.repo, tmpl, ctx, basectx, None, parity, style)
 
     parity = paritygen(web.stripecount)
     diffstatsgen = diffstatgen(ctx, basectx)
     diffstats = diffstat(tmpl, ctx, diffstatsgen, parity)
 
     return dict(
         diff=diff,
         symrev=symrevorshortnode(req, ctx),
         basenode=basectx.hex(),
         changesettag=showtags,
         changesetbookmark=showbookmarks,
         changesetbranch=showbranch,
         files=files,
         diffsummary=lambda **x: diffsummary(diffstatsgen),
         diffstat=diffstats,
         archives=web.archivelist(ctx.hex()),
         **commonentry(web.repo, ctx))
 
 def listfilediffs(tmpl, files, node, max):
     for f in files[:max]:
         yield tmpl('filedifflink', node=hex(node), file=f)
     if len(files) > max:
         yield tmpl('fileellipses')
 
 def diffs(repo, tmpl, ctx, basectx, files, parity, style):
 
     def countgen():
         start = 1
         while True:
             yield start
             start += 1
 
     blockcount = countgen()
     def prettyprintlines(diff, blockno):
         for lineno, l in enumerate(diff.splitlines(True)):
             difflineno = "%d.%d" % (blockno, lineno + 1)
             if l.startswith('+'):
                 ltype = "difflineplus"
             elif l.startswith('-'):
                 ltype = "difflineminus"
             elif l.startswith('@'):
                 ltype = "difflineat"
             else:
                 ltype = "diffline"
             yield tmpl(ltype,
                        line=l,
                        lineno=lineno + 1,
                        lineid="l%s" % difflineno,
                        linenumber="% 8s" % difflineno)
 
     if files:
         m = match.exact(repo.root, repo.getcwd(), files)
     else:
         m = match.always(repo.root, repo.getcwd())
 
     diffopts = patch.diffopts(repo.ui, untrusted=True)
     if basectx is None:
         parents = ctx.parents()
         if parents:
             node1 = parents[0].node()
         else:
             node1 = nullid
     else:
         node1 = basectx.node()
     node2 = ctx.node()
 
     block = []
     for chunk in patch.diff(repo, node1, node2, m, opts=diffopts):
         if chunk.startswith('diff') and block:
             blockno = blockcount.next()
             yield tmpl('diffblock', parity=parity.next(), blockno=blockno,
                        lines=prettyprintlines(''.join(block), blockno))
             block = []
         if chunk.startswith('diff') and style != 'raw':
             chunk = ''.join(chunk.splitlines(True)[1:])
         block.append(chunk)
     blockno = blockcount.next()
     yield tmpl('diffblock', parity=parity.next(), blockno=blockno,
                lines=prettyprintlines(''.join(block), blockno))
 
 def compare(tmpl, context, leftlines, rightlines):
     '''Generator function that provides side-by-side comparison data.'''
 
     def compline(type, leftlineno, leftline, rightlineno, rightline):
         lineid = leftlineno and ("l%s" % leftlineno) or ''
         lineid += rightlineno and ("r%s" % rightlineno) or ''
         return tmpl('comparisonline',
                     type=type,
                     lineid=lineid,
                     leftlineno=leftlineno,
                     leftlinenumber="% 6s" % (leftlineno or ''),
                     leftline=leftline or '',
                     rightlineno=rightlineno,
                     rightlinenumber="% 6s" % (rightlineno or ''),
                     rightline=rightline or '')
 
     def getblock(opcodes):
         for type, llo, lhi, rlo, rhi in opcodes:
             len1 = lhi - llo
             len2 = rhi - rlo
             count = min(len1, len2)
             for i in xrange(count):
                 yield compline(type=type,
                                leftlineno=llo + i + 1,
                                leftline=leftlines[llo + i],
                                rightlineno=rlo + i + 1,
                                rightline=rightlines[rlo + i])
             if len1 > len2:
                 for i in xrange(llo + count, lhi):
                     yield compline(type=type,
                                    leftlineno=i + 1,
                                    leftline=leftlines[i],
                                    rightlineno=None,
                                    rightline=None)
             elif len2 > len1:
                 for i in xrange(rlo + count, rhi):
                     yield compline(type=type,
                                    leftlineno=None,
                                    leftline=None,
                                    rightlineno=i + 1,
                                    rightline=rightlines[i])
 
     s = difflib.SequenceMatcher(None, leftlines, rightlines)
     if context < 0:
         yield tmpl('comparisonblock', lines=getblock(s.get_opcodes()))
     else:
         for oc in s.get_grouped_opcodes(n=context):
             yield tmpl('comparisonblock', lines=getblock(oc))
 
 def diffstatgen(ctx, basectx):
     '''Generator function that provides the diffstat data.'''
 
     stats = patch.diffstatdata(util.iterlines(ctx.diff(basectx)))
     maxname, maxtotal, addtotal, removetotal, binary = patch.diffstatsum(stats)
     while True:
         yield stats, maxname, maxtotal, addtotal, removetotal, binary
 
 def diffsummary(statgen):
     '''Return a short summary of the diff.'''
 
     stats, maxname, maxtotal, addtotal, removetotal, binary = statgen.next()
     return _(' %d files changed, %d insertions(+), %d deletions(-)\n') % (
              len(stats), addtotal, removetotal)
 
 def diffstat(tmpl, ctx, statgen, parity):
     '''Return a diffstat template for each file in the diff.'''
 
     stats, maxname, maxtotal, addtotal, removetotal, binary = statgen.next()
     files = ctx.files()
 
     def pct(i):
         if maxtotal == 0:
             return 0
         return (float(i) / maxtotal) * 100
 
     fileno = 0
     for filename, adds, removes, isbinary in stats:
         template = filename in files and 'diffstatlink' or 'diffstatnolink'
         total = adds + removes
         fileno += 1
         yield tmpl(template, node=ctx.hex(), file=filename, fileno=fileno,
                    total=total, addpct=pct(adds), removepct=pct(removes),
                    parity=parity.next())
 
 class sessionvars(object):
     def __init__(self, vars, start='?'):
         self.start = start
         self.vars = vars
     def __getitem__(self, key):
         return self.vars[key]
     def __setitem__(self, key, value):
         self.vars[key] = value
     def __copy__(self):
         return sessionvars(copy.copy(self.vars), self.start)
     def __iter__(self):
         separator = self.start
         for key, value in sorted(self.vars.iteritems()):
             yield {'name': key, 'value': str(value), 'separator': separator}
             separator = '&'
 
 class wsgiui(uimod.ui):
     # default termwidth breaks under mod_wsgi
     def termwidth(self):
         return 80
 
 def getwebsubs(repo):
     websubtable = []
     websubdefs = repo.ui.configitems('websub')
     # we must maintain interhg backwards compatibility
     websubdefs += repo.ui.configitems('interhg')
     for key, pattern in websubdefs:
         # grab the delimiter from the character after the "s"
         unesc = pattern[1]
         delim = re.escape(unesc)
 
         # identify portions of the pattern, taking care to avoid escaped
         # delimiters. the replace format and flags are optional, but
         # delimiters are required.
         match = re.match(
             r'^s%s(.+)(?:(?<=\\\\)|(?<!\\))%s(.*)%s([ilmsux])*$'
             % (delim, delim, delim), pattern)
         if not match:
             repo.ui.warn(_("websub: invalid pattern for %s: %s\n")
                               % (key, pattern))
             continue
 
         # we need to unescape the delimiter for regexp and format
         delim_re = re.compile(r'(?<!\\)\\%s' % delim)
         regexp = delim_re.sub(unesc, match.group(1))
         format = delim_re.sub(unesc, match.group(2))
 
         # the pattern allows for 6 regexp flags, so set them if necessary
         flagin = match.group(3)
         flags = 0
         if flagin:
             for flag in flagin.upper():
                 flags |= re.__dict__[flag]
 
         try:
             regexp = re.compile(regexp, flags)
             websubtable.append((regexp, format))
         except re.error:
             repo.ui.warn(_("websub: invalid regexp for %s: %s\n")
                          % (key, regexp))
     return websubtable

mercurial/templates/json/map

@@ -1,183 +1,184 b''
 mimetype = 'application/json'
 filerevision = '"not yet implemented"'
 search = '"not yet implemented"'
 # changelog and shortlog are the same web API but with different
 # number of entries.
 changelog = changelist.tmpl
 shortlog = changelist.tmpl
 changelistentry = '\{
   "node": {node|json},
   "date": {date|json},
   "desc": {desc|utf8|json},
   "bookmarks": [{join(bookmarks%changelistentryname, ", ")}],
   "tags": [{join(tags%changelistentryname, ", ")}],
-  "user": {author|utf8|json}
+  "user": {author|utf8|json},
+  "parents": [{join(allparents%changesetparent, ", ")}]
   }'
 changelistentryname = '{name|utf8|json}'
 changeset = '\{
   "node": {node|json},
   "date": {date|json},
   "desc": {desc|utf8|json},
   "branch": {if(branch, branch%changesetbranch, "default"|json)},
   "bookmarks": [{join(changesetbookmark, ", ")}],
   "tags": [{join(changesettag, ", ")}],
   "user": {author|utf8|json},
   "parents": [{join(parent%changesetparent, ", ")}],
   "phase": {phase|json}
   }'
 changesetbranch = '{name|utf8|json}'
 changesetbookmark = '{bookmark|utf8|json}'
 changesettag = '{tag|utf8|json}'
 changesetparent = '{node|json}'
 manifest = '\{
   "node": {node|json},
   "abspath": {path|json},
   "directories": [{join(dentries%direntry, ", ")}],
   "files": [{join(fentries%fileentry, ", ")}],
   "bookmarks": [{join(bookmarks%name, ", ")}],
   "tags": [{join(tags%name, ", ")}]
   }'
 name = '{name|utf8|json}'
 direntry = '\{
   "abspath": {path|json},
   "basename": {basename|json},
   "emptydirs": {emptydirs|json}
   }'
 fileentry = '\{
   "abspath": {file|json},
   "basename": {basename|json},
   "date": {date|json},
   "size": {size|json},
   "flags": {permissions|json}
   }'
 tags = '\{
   "node": {node|json},
   "tags": [{join(entriesnotip%tagentry, ", ")}]
   }'
 tagentry = '\{
   "tag": {tag|utf8|json},
   "node": {node|json},
   "date": {date|json}
   }'
 bookmarks = '\{
   "node": {node|json},
   "bookmarks": [{join(entries%bookmarkentry, ", ")}]
   }'
 bookmarkentry = '\{
   "bookmark": {bookmark|utf8|json},
   "node": {node|json},
   "date": {date|json}
   }'
 branches = '\{
   "branches": [{join(entries%branchentry, ", ")}]
   }'
 branchentry = '\{
   "branch": {branch|utf8|json},
   "node": {node|json},
   "date": {date|json},
   "status": {status|json}
   }'
 summary = '"not yet implemented"'
 filediff = '\{
   "path": {file|json},
   "node": {node|json},
   "date": {date|json},
   "desc": {desc|utf8|json},
   "author": {author|utf8|json},
   "parents": [{join(parent%changesetparent, ", ")}],
   "children": [{join(child%changesetparent, ", ")}],
   "diff": [{join(diff%diffblock, ", ")}]
   }'
 diffblock = '\{
   "blockno": {blockno|json},
   "lines": [{join(lines, ", ")}]
   }'
 difflineplus = '\{
   "t": "+",
   "n": {lineno|json},
   "l": {line|json}
   }'
 difflineminus = '\{
   "t": "-",
   "n": {lineno|json},
   "l": {line|json}
   }'
 difflineat = '\{
   "t": "@",
   "n": {lineno|json},
   "l": {line|json}
   }'
 diffline = '\{
   "t": "",
   "n": {lineno|json},
   "l": {line|json}
   }'
 filecomparison = '\{
   "path": {file|json},
   "node": {node|json},
   "date": {date|json},
   "desc": {desc|utf8|json},
   "author": {author|utf8|json},
   "parents": [{join(parent%changesetparent, ", ")}],
   "children": [{join(child%changesetparent, ", ")}],
   "leftnode": {leftnode|json},
   "rightnode": {rightnode|json},
   "comparison": [{join(comparison, ", ")}]
   }'
 comparisonblock = '\{
   "lines": [{join(lines, ", ")}]
   }'
 comparisonline = '\{
   "t": {type|json},
   "ln": {leftlineno|json},
   "ll": {leftline|json},
   "rn": {rightlineno|json},
   "rl": {rightline|json}
   }'
 fileannotate = '\{
   "abspath": {file|json},
   "node": {node|json},
   "author": {author|utf8|json},
   "date": {date|json},
   "desc": {desc|utf8|json},
   "parents": [{join(parent%changesetparent, ", ")}],
   "children": [{join(child%changesetparent, ", ")}],
   "permissions": {permissions|json},
   "annotate": [{join(annotate%fileannotation, ", ")}]
   }'
 fileannotation = '\{
   "node": {node|json},
   "author": {author|utf8|json},
   "desc": {desc|utf8|json},
   "abspath": {file|json},
   "targetline": {targetline|json},
   "line": {line|json},
   "lineno": {lineno|json},
   "revdate": {revdate|json}
   }'
 filelog = '"not yet implemented"'
 graph = '"not yet implemented"'
 helptopics = '\{
   "topics": [{join(topics%helptopicentry, ", ")}],
   "earlycommands": [{join(earlycommands%helptopicentry, ", ")}],
   "othercommands": [{join(othercommands%helptopicentry, ", ")}]
   }'
 helptopicentry = '\{
   "topic": {topic|utf8|json},
   "summary": {summary|utf8|json}
   }'
 help = '\{
   "topic": {topic|utf8|json},
   "rawdoc": {doc|utf8|json}
   }'
 filenodelink = ''
 filenolink = ''
 index = '\{
   "entries": [{join(entries%indexentry, ", ")}]
   }'
 indexentry = '\{
   "name": {name|utf8|json},
   "description": {description|utf8|json},
   "contact": {contact|utf8|json},
   "lastchange": {lastchange|json}
   }'

tests/test-hgweb-json.t

@@ -1,1118 +1,1180 b''
 #require serve
 
   $ request() {
   >   get-with-headers.py --json localhost:$HGPORT "$1"
   > }
 
   $ hg init test
   $ cd test
   $ mkdir da
   $ echo foo > da/foo
   $ echo foo > foo
   $ hg -q ci -A -m initial
   $ echo bar > foo
   $ hg ci -m 'modify foo'
   $ echo bar > da/foo
   $ hg ci -m 'modify da/foo'
   $ hg bookmark bookmark1
   $ hg up default
   0 files updated, 0 files merged, 0 files removed, 0 files unresolved
   (leaving bookmark bookmark1)
   $ hg mv foo foo-new
   $ hg commit -m 'move foo'
   $ hg tag -m 'create tag' tag1
   $ hg phase --public -r .
   $ echo baz > da/foo
   $ hg commit -m 'another commit to da/foo'
   $ hg tag -m 'create tag2' tag2
   $ hg bookmark bookmark2
   $ hg -q up -r 0
   $ hg -q branch test-branch
   $ echo branch > foo
   $ hg commit -m 'create test branch'
   $ echo branch_commit_2 > foo
   $ hg commit -m 'another commit in test-branch'
   $ hg -q up default
   $ hg merge --tool :local test-branch
   0 files updated, 1 files merged, 0 files removed, 0 files unresolved
   (branch merge, don't forget to commit)
   $ hg commit -m 'merge test-branch into default'
 
   $ hg log -G
   @    changeset:   9:cc725e08502a
   |\   tag:         tip
   | |  parent:      6:ceed296fe500
   | |  parent:      8:ed66c30e87eb
   | |  user:        test
   | |  date:        Thu Jan 01 00:00:00 1970 +0000
   | |  summary:     merge test-branch into default
   | |
   | o  changeset:   8:ed66c30e87eb
   | |  branch:      test-branch
   | |  user:        test
   | |  date:        Thu Jan 01 00:00:00 1970 +0000
   | |  summary:     another commit in test-branch
   | |
   | o  changeset:   7:6ab967a8ab34
   | |  branch:      test-branch
   | |  parent:      0:06e557f3edf6
   | |  user:        test
   | |  date:        Thu Jan 01 00:00:00 1970 +0000
   | |  summary:     create test branch
   | |
   o |  changeset:   6:ceed296fe500
   | |  bookmark:    bookmark2
   | |  user:        test
   | |  date:        Thu Jan 01 00:00:00 1970 +0000
   | |  summary:     create tag2
   | |
   o |  changeset:   5:f2890a05fea4
   | |  tag:         tag2
   | |  user:        test
   | |  date:        Thu Jan 01 00:00:00 1970 +0000
   | |  summary:     another commit to da/foo
   | |
   o |  changeset:   4:93a8ce14f891
   | |  user:        test
   | |  date:        Thu Jan 01 00:00:00 1970 +0000
   | |  summary:     create tag
   | |
   o |  changeset:   3:78896eb0e102
   | |  tag:         tag1
   | |  user:        test
   | |  date:        Thu Jan 01 00:00:00 1970 +0000
   | |  summary:     move foo
   | |
   o |  changeset:   2:8d7c456572ac
   | |  bookmark:    bookmark1
   | |  user:        test
   | |  date:        Thu Jan 01 00:00:00 1970 +0000
   | |  summary:     modify da/foo
   | |
   o |  changeset:   1:f8bbb9024b10
   |/   user:        test
   |    date:        Thu Jan 01 00:00:00 1970 +0000
   |    summary:     modify foo
   |
   o  changeset:   0:06e557f3edf6
      user:        test
      date:        Thu Jan 01 00:00:00 1970 +0000
      summary:     initial
   
 
   $ hg serve -p $HGPORT -d --pid-file=hg.pid -A access.log -E error.log
   $ cat hg.pid >> $DAEMON_PIDS
 
 (Try to keep these in roughly the order they are defined in webcommands.py)
 
 (log is handled by filelog/ and changelog/ - ignore it)
 
 (rawfile/ doesn't use templating - nothing to test)
 
 file/{revision}/{path} shows file revision
 
   $ request json-file/06e557f3edf6/foo
   200 Script output follows
   
   "not yet implemented"
 
 file/{revision} shows root directory info
 
   $ request json-file/cc725e08502a
   200 Script output follows
   
   {
     "abspath": "/",
     "bookmarks": [],
     "directories": [
       {
         "abspath": "/da",
         "basename": "da",
         "emptydirs": ""
       }
     ],
     "files": [
       {
         "abspath": ".hgtags",
         "basename": ".hgtags",
         "date": [
           0.0,
           0
         ],
         "flags": "",
         "size": 92
       },
       {
         "abspath": "foo-new",
         "basename": "foo-new",
         "date": [
           0.0,
           0
         ],
         "flags": "",
         "size": 4
       }
     ],
     "node": "cc725e08502a79dd1eda913760fbe06ed7a9abc7",
     "tags": [
       "tip"
     ]
   }
 
 changelog/ shows information about several changesets
 
   $ request json-changelog
   200 Script output follows
   
   {
     "changeset_count": 10,
     "changesets": [
       {
         "bookmarks": [],
         "date": [
           0.0,
           0
         ],
         "desc": "merge test-branch into default",
         "node": "cc725e08502a79dd1eda913760fbe06ed7a9abc7",
+        "parents": [
+          "ceed296fe500c3fac9541e31dad860cb49c89e45",
+          "ed66c30e87eb65337c05a4229efaa5f1d5285a90"
+        ],
         "tags": [
           "tip"
         ],
         "user": "test"
       },
       {
         "bookmarks": [],
         "date": [
           0.0,
           0
         ],
         "desc": "another commit in test-branch",
         "node": "ed66c30e87eb65337c05a4229efaa5f1d5285a90",
+        "parents": [
+          "6ab967a8ab3489227a83f80e920faa039a71819f"
+        ],
         "tags": [],
         "user": "test"
       },
       {
         "bookmarks": [],
         "date": [
           0.0,
           0
         ],
         "desc": "create test branch",
         "node": "6ab967a8ab3489227a83f80e920faa039a71819f",
+        "parents": [
+          "06e557f3edf66faa1ccaba5dd8c203c21cc79f1e"
+        ],
         "tags": [],
         "user": "test"
       },
       {
         "bookmarks": [
           "bookmark2"
         ],
         "date": [
           0.0,
           0
         ],
         "desc": "create tag2",
         "node": "ceed296fe500c3fac9541e31dad860cb49c89e45",
+        "parents": [
+          "f2890a05fea49bfaf9fb27ed5490894eba32da78"
+        ],
         "tags": [],
         "user": "test"
       },
       {
         "bookmarks": [],
         "date": [
           0.0,
           0
         ],
         "desc": "another commit to da/foo",
         "node": "f2890a05fea49bfaf9fb27ed5490894eba32da78",
+        "parents": [
+          "93a8ce14f89156426b7fa981af8042da53f03aa0"
+        ],
         "tags": [
           "tag2"
         ],
         "user": "test"
       },
       {
         "bookmarks": [],
         "date": [
           0.0,
           0
         ],
         "desc": "create tag",
         "node": "93a8ce14f89156426b7fa981af8042da53f03aa0",
+        "parents": [
+          "78896eb0e102174ce9278438a95e12543e4367a7"
+        ],
         "tags": [],
         "user": "test"
       },
       {
         "bookmarks": [],
         "date": [
           0.0,
           0
         ],
         "desc": "move foo",
         "node": "78896eb0e102174ce9278438a95e12543e4367a7",
+        "parents": [
+          "8d7c456572acf3557e8ed8a07286b10c408bcec5"
+        ],
         "tags": [
           "tag1"
         ],
         "user": "test"
       },
       {
         "bookmarks": [
           "bookmark1"
         ],
         "date": [
           0.0,
           0
         ],
         "desc": "modify da/foo",
         "node": "8d7c456572acf3557e8ed8a07286b10c408bcec5",
+        "parents": [
+          "f8bbb9024b10f93cdbb8d940337398291d40dea8"
+        ],
         "tags": [],
         "user": "test"
       },
       {
         "bookmarks": [],
         "date": [
           0.0,
           0
         ],
         "desc": "modify foo",
         "node": "f8bbb9024b10f93cdbb8d940337398291d40dea8",
+        "parents": [
+          "06e557f3edf66faa1ccaba5dd8c203c21cc79f1e"
+        ],
         "tags": [],
         "user": "test"
       },
       {
         "bookmarks": [],
         "date": [
           0.0,
           0
         ],
         "desc": "initial",
         "node": "06e557f3edf66faa1ccaba5dd8c203c21cc79f1e",
+        "parents": [],
         "tags": [],
         "user": "test"
       }
     ],
     "node": "cc725e08502a79dd1eda913760fbe06ed7a9abc7"
   }
 
 changelog/{revision} shows information starting at a specific changeset
 
   $ request json-changelog/f8bbb9024b10
   200 Script output follows
   
   {
     "changeset_count": 10,
     "changesets": [
       {
         "bookmarks": [],
         "date": [
           0.0,
           0
         ],
         "desc": "modify foo",
         "node": "f8bbb9024b10f93cdbb8d940337398291d40dea8",
+        "parents": [
+          "06e557f3edf66faa1ccaba5dd8c203c21cc79f1e"
+        ],
         "tags": [],
         "user": "test"
       },
       {
         "bookmarks": [],
         "date": [
           0.0,
           0
         ],
         "desc": "initial",
         "node": "06e557f3edf66faa1ccaba5dd8c203c21cc79f1e",
+        "parents": [],
         "tags": [],
         "user": "test"
       }
     ],
     "node": "f8bbb9024b10f93cdbb8d940337398291d40dea8"
   }
 
 shortlog/ shows information about a set of changesets
 
   $ request json-shortlog
   200 Script output follows
   
   {
     "changeset_count": 10,
     "changesets": [
       {
         "bookmarks": [],
         "date": [
           0.0,
           0
         ],
         "desc": "merge test-branch into default",
         "node": "cc725e08502a79dd1eda913760fbe06ed7a9abc7",
+        "parents": [
+          "ceed296fe500c3fac9541e31dad860cb49c89e45",
+          "ed66c30e87eb65337c05a4229efaa5f1d5285a90"
+        ],
         "tags": [
           "tip"
         ],
         "user": "test"
       },
       {
         "bookmarks": [],
         "date": [
           0.0,
           0
         ],
         "desc": "another commit in test-branch",
         "node": "ed66c30e87eb65337c05a4229efaa5f1d5285a90",
+        "parents": [
+          "6ab967a8ab3489227a83f80e920faa039a71819f"
+        ],
         "tags": [],
         "user": "test"
       },
       {
         "bookmarks": [],
         "date": [
           0.0,
           0
         ],
         "desc": "create test branch",
         "node": "6ab967a8ab3489227a83f80e920faa039a71819f",
+        "parents": [
+          "06e557f3edf66faa1ccaba5dd8c203c21cc79f1e"
+        ],
         "tags": [],
         "user": "test"
       },
       {
         "bookmarks": [
           "bookmark2"
         ],
         "date": [
           0.0,
           0
         ],
         "desc": "create tag2",
         "node": "ceed296fe500c3fac9541e31dad860cb49c89e45",
+        "parents": [
+          "f2890a05fea49bfaf9fb27ed5490894eba32da78"
+        ],
         "tags": [],
         "user": "test"
       },
       {
         "bookmarks": [],
         "date": [
           0.0,
           0
         ],
         "desc": "another commit to da/foo",
         "node": "f2890a05fea49bfaf9fb27ed5490894eba32da78",
+        "parents": [
+          "93a8ce14f89156426b7fa981af8042da53f03aa0"
+        ],
         "tags": [
           "tag2"
         ],
         "user": "test"
       },
       {
         "bookmarks": [],
         "date": [
           0.0,
           0
         ],
         "desc": "create tag",
         "node": "93a8ce14f89156426b7fa981af8042da53f03aa0",
+        "parents": [
+          "78896eb0e102174ce9278438a95e12543e4367a7"
+        ],
         "tags": [],
         "user": "test"
       },
       {
         "bookmarks": [],
         "date": [
           0.0,
           0
         ],
         "desc": "move foo",
         "node": "78896eb0e102174ce9278438a95e12543e4367a7",
+        "parents": [
+          "8d7c456572acf3557e8ed8a07286b10c408bcec5"
+        ],
         "tags": [
           "tag1"
         ],
         "user": "test"
       },
       {
         "bookmarks": [
           "bookmark1"
         ],
         "date": [
           0.0,
           0
         ],
         "desc": "modify da/foo",
         "node": "8d7c456572acf3557e8ed8a07286b10c408bcec5",
+        "parents": [
+          "f8bbb9024b10f93cdbb8d940337398291d40dea8"
+        ],
         "tags": [],
         "user": "test"
       },
       {
         "bookmarks": [],
         "date": [
           0.0,
           0
         ],
         "desc": "modify foo",
         "node": "f8bbb9024b10f93cdbb8d940337398291d40dea8",
+        "parents": [
+          "06e557f3edf66faa1ccaba5dd8c203c21cc79f1e"
+        ],
         "tags": [],
         "user": "test"
       },
       {
         "bookmarks": [],
         "date": [
           0.0,
           0
         ],
         "desc": "initial",
         "node": "06e557f3edf66faa1ccaba5dd8c203c21cc79f1e",
+        "parents": [],
         "tags": [],
         "user": "test"
       }
     ],
     "node": "cc725e08502a79dd1eda913760fbe06ed7a9abc7"
   }
 
 changeset/ renders the tip changeset
 
   $ request json-rev
   200 Script output follows
   
   {
     "bookmarks": [],
     "branch": "default",
     "date": [
       0.0,
       0
     ],
     "desc": "merge test-branch into default",
     "node": "cc725e08502a79dd1eda913760fbe06ed7a9abc7",
     "parents": [
       "ceed296fe500c3fac9541e31dad860cb49c89e45",
       "ed66c30e87eb65337c05a4229efaa5f1d5285a90"
     ],
     "phase": "draft",
     "tags": [
       "tip"
     ],
     "user": "test"
   }
 
 changeset/{revision} shows tags
 
   $ request json-rev/78896eb0e102
   200 Script output follows
   
   {
     "bookmarks": [],
     "branch": "default",
     "date": [
       0.0,
       0
     ],
     "desc": "move foo",
     "node": "78896eb0e102174ce9278438a95e12543e4367a7",
     "parents": [
       "8d7c456572acf3557e8ed8a07286b10c408bcec5"
     ],
     "phase": "public",
     "tags": [
       "tag1"
     ],
     "user": "test"
   }
 
 changeset/{revision} shows bookmarks
 
   $ request json-rev/8d7c456572ac
   200 Script output follows
   
   {
     "bookmarks": [
       "bookmark1"
     ],
     "branch": "default",
     "date": [
       0.0,
       0
     ],
     "desc": "modify da/foo",
     "node": "8d7c456572acf3557e8ed8a07286b10c408bcec5",
     "parents": [
       "f8bbb9024b10f93cdbb8d940337398291d40dea8"
     ],
     "phase": "public",
     "tags": [],
     "user": "test"
   }
 
 changeset/{revision} shows branches
 
   $ request json-rev/6ab967a8ab34
   200 Script output follows
   
   {
     "bookmarks": [],
     "branch": "test-branch",
     "date": [
       0.0,
       0
     ],
     "desc": "create test branch",
     "node": "6ab967a8ab3489227a83f80e920faa039a71819f",
     "parents": [
       "06e557f3edf66faa1ccaba5dd8c203c21cc79f1e"
     ],
     "phase": "draft",
     "tags": [],
     "user": "test"
   }
 
 manifest/{revision}/{path} shows info about a directory at a revision
 
   $ request json-manifest/06e557f3edf6/
   200 Script output follows
   
   {
     "abspath": "/",
     "bookmarks": [],
     "directories": [
       {
         "abspath": "/da",
         "basename": "da",
         "emptydirs": ""
       }
     ],
     "files": [
       {
         "abspath": "foo",
         "basename": "foo",
         "date": [
           0.0,
           0
         ],
         "flags": "",
         "size": 4
       }
     ],
     "node": "06e557f3edf66faa1ccaba5dd8c203c21cc79f1e",
     "tags": []
   }
 
 tags/ shows tags info
 
   $ request json-tags
   200 Script output follows
   
   {
     "node": "cc725e08502a79dd1eda913760fbe06ed7a9abc7",
     "tags": [
       {
         "date": [
           0.0,
           0
         ],
         "node": "f2890a05fea49bfaf9fb27ed5490894eba32da78",
         "tag": "tag2"
       },
       {
         "date": [
           0.0,
           0
         ],
         "node": "78896eb0e102174ce9278438a95e12543e4367a7",
         "tag": "tag1"
       }
     ]
   }
 
 bookmarks/ shows bookmarks info
 
   $ request json-bookmarks
   200 Script output follows
   
   {
     "bookmarks": [
       {
         "bookmark": "bookmark1",
         "date": [
           0.0,
           0
         ],
         "node": "8d7c456572acf3557e8ed8a07286b10c408bcec5"
       },
       {
         "bookmark": "bookmark2",
         "date": [
           0.0,
           0
         ],
         "node": "ceed296fe500c3fac9541e31dad860cb49c89e45"
       }
     ],
     "node": "cc725e08502a79dd1eda913760fbe06ed7a9abc7"
   }
 
 branches/ shows branches info
 
   $ request json-branches
   200 Script output follows
   
   {
     "branches": [
       {
         "branch": "default",
         "date": [
           0.0,
           0
         ],
         "node": "cc725e08502a79dd1eda913760fbe06ed7a9abc7",
         "status": "open"
       },
       {
         "branch": "test-branch",
         "date": [
           0.0,
           0
         ],
         "node": "ed66c30e87eb65337c05a4229efaa5f1d5285a90",
         "status": "inactive"
       }
     ]
   }
 
 summary/ shows a summary of repository state
 
   $ request json-summary
   200 Script output follows
   
   "not yet implemented"
 
 filediff/{revision}/{path} shows changes to a file in a revision
 
   $ request json-diff/f8bbb9024b10/foo
   200 Script output follows
   
   {
     "author": "test",
     "children": [],
     "date": [
       0.0,
       0
     ],
     "desc": "modify foo",
     "diff": [
       {
         "blockno": 1,
         "lines": [
           {
             "l": "--- a/foo\tThu Jan 01 00:00:00 1970 +0000\n",
             "n": 1,
             "t": "-"
           },
           {
             "l": "+++ b/foo\tThu Jan 01 00:00:00 1970 +0000\n",
             "n": 2,
             "t": "+"
           },
           {
             "l": "@@ -1,1 +1,1 @@\n",
             "n": 3,
             "t": "@"
           },
           {
             "l": "-foo\n",
             "n": 4,
             "t": "-"
           },
           {
             "l": "+bar\n",
             "n": 5,
             "t": "+"
           }
         ]
       }
     ],
     "node": "f8bbb9024b10f93cdbb8d940337398291d40dea8",
     "parents": [
       "06e557f3edf66faa1ccaba5dd8c203c21cc79f1e"
     ],
     "path": "foo"
   }
 
 comparison/{revision}/{path} shows information about before and after for a file
 
   $ request json-comparison/f8bbb9024b10/foo
   200 Script output follows
   
   {
     "author": "test",
     "children": [],
     "comparison": [
       {
         "lines": [
           {
             "ll": "foo",
             "ln": 1,
             "rl": "bar",
             "rn": 1,
             "t": "replace"
           }
         ]
       }
     ],
     "date": [
       0.0,
       0
     ],
     "desc": "modify foo",
     "leftnode": "06e557f3edf66faa1ccaba5dd8c203c21cc79f1e",
     "node": "f8bbb9024b10f93cdbb8d940337398291d40dea8",
     "parents": [
       "06e557f3edf66faa1ccaba5dd8c203c21cc79f1e"
     ],
     "path": "foo",
     "rightnode": "f8bbb9024b10f93cdbb8d940337398291d40dea8"
   }
 
 annotate/{revision}/{path} shows annotations for each line
 
   $ request json-annotate/f8bbb9024b10/foo
   200 Script output follows
   
   {
     "abspath": "foo",
     "annotate": [
       {
         "abspath": "foo",
         "author": "test",
         "desc": "modify foo",
         "line": "bar\n",
         "lineno": 1,
         "node": "f8bbb9024b10f93cdbb8d940337398291d40dea8",
         "revdate": [
           0.0,
           0
         ],
         "targetline": 1
       }
     ],
     "author": "test",
     "children": [],
     "date": [
       0.0,
       0
     ],
     "desc": "modify foo",
     "node": "f8bbb9024b10f93cdbb8d940337398291d40dea8",
     "parents": [
       "06e557f3edf66faa1ccaba5dd8c203c21cc79f1e"
     ],
     "permissions": ""
   }
 
 filelog/{revision}/{path} shows history of a single file
 
   $ request json-filelog/f8bbb9024b10/foo
   200 Script output follows
   
   "not yet implemented"
 
 (archive/ doesn't use templating, so ignore it)
 
 (static/ doesn't use templating, so ignore it)
 
 graph/ shows information that can be used to render a graph of the DAG
 
   $ request json-graph
   200 Script output follows
   
   "not yet implemented"
 
 help/ shows help topics
 
   $ request json-help
   200 Script output follows
   
   {
     "earlycommands": [
       {
         "summary": "add the specified files on the next commit",
         "topic": "add"
       },
       {
         "summary": "show changeset information by line for each file",
         "topic": "annotate"
       },
       {
         "summary": "make a copy of an existing repository",
         "topic": "clone"
       },
       {
         "summary": "commit the specified files or all outstanding changes",
         "topic": "commit"
       },
       {
         "summary": "diff repository (or selected files)",
         "topic": "diff"
       },
       {
         "summary": "dump the header and diffs for one or more changesets",
         "topic": "export"
       },
       {
         "summary": "forget the specified files on the next commit",
         "topic": "forget"
       },
       {
         "summary": "create a new repository in the given directory",
         "topic": "init"
       },
       {
         "summary": "show revision history of entire repository or files",
         "topic": "log"
       },
       {
         "summary": "merge another revision into working directory",
         "topic": "merge"
       },
       {
         "summary": "pull changes from the specified source",
         "topic": "pull"
       },
       {
         "summary": "push changes to the specified destination",
         "topic": "push"
       },
       {
         "summary": "remove the specified files on the next commit",
         "topic": "remove"
       },
       {
         "summary": "start stand-alone webserver",
         "topic": "serve"
       },
       {
         "summary": "show changed files in the working directory",
         "topic": "status"
       },
       {
         "summary": "summarize working directory state",
         "topic": "summary"
       },
       {
         "summary": "update working directory (or switch revisions)",
         "topic": "update"
       }
     ],
     "othercommands": [
       {
         "summary": "add all new files, delete all missing files",
         "topic": "addremove"
       },
       {
         "summary": "create an unversioned archive of a repository revision",
         "topic": "archive"
       },
       {
         "summary": "reverse effect of earlier changeset",
         "topic": "backout"
       },
       {
         "summary": "subdivision search of changesets",
         "topic": "bisect"
       },
       {
         "summary": "create a new bookmark or list existing bookmarks",
         "topic": "bookmarks"
       },
       {
         "summary": "set or show the current branch name",
         "topic": "branch"
       },
       {
         "summary": "list repository named branches",
         "topic": "branches"
       },
       {
         "summary": "create a changegroup file",
         "topic": "bundle"
       },
       {
         "summary": "output the current or given revision of files",
         "topic": "cat"
       },
       {
         "summary": "show combined config settings from all hgrc files",
         "topic": "config"
       },
       {
         "summary": "mark files as copied for the next commit",
         "topic": "copy"
       },
       {
         "summary": "list tracked files",
         "topic": "files"
       },
       {
         "summary": "copy changes from other branches onto the current branch",
         "topic": "graft"
       },
       {
         "summary": "search for a pattern in specified files and revisions",
         "topic": "grep"
       },
       {
         "summary": "show branch heads",
         "topic": "heads"
       },
       {
         "summary": "show help for a given topic or a help overview",
         "topic": "help"
       },
       {
         "summary": "identify the working directory or specified revision",
         "topic": "identify"
       },
       {
         "summary": "import an ordered set of patches",
         "topic": "import"
       },
       {
         "summary": "show new changesets found in source",
         "topic": "incoming"
       },
       {
         "summary": "output the current or given revision of the project manifest",
         "topic": "manifest"
       },
       {
         "summary": "show changesets not found in the destination",
         "topic": "outgoing"
       },
       {
         "summary": "show aliases for remote repositories",
         "topic": "paths"
       },
       {
         "summary": "set or show the current phase name",
         "topic": "phase"
       },
       {
         "summary": "roll back an interrupted transaction",
         "topic": "recover"
       },
       {
         "summary": "rename files; equivalent of copy + remove",
         "topic": "rename"
       },
       {
         "summary": "redo merges or set/view the merge status of files",
         "topic": "resolve"
       },
       {
         "summary": "restore files to their checkout state",
         "topic": "revert"
       },
       {
         "summary": "print the root (top) of the current working directory",
         "topic": "root"
       },
       {
         "summary": "add one or more tags for the current or given revision",
         "topic": "tag"
       },
       {
         "summary": "list repository tags",
         "topic": "tags"
       },
       {
         "summary": "apply one or more changegroup files",
         "topic": "unbundle"
       },
       {
         "summary": "verify the integrity of the repository",
         "topic": "verify"
       },
       {
         "summary": "output version and copyright information",
         "topic": "version"
       }
     ],
     "topics": [
       {
         "summary": "Configuration Files",
         "topic": "config"
       },
       {
         "summary": "Date Formats",
         "topic": "dates"
       },
       {
         "summary": "Diff Formats",
         "topic": "diffs"
       },
       {
         "summary": "Environment Variables",
         "topic": "environment"
       },
       {
         "summary": "Using Additional Features",
         "topic": "extensions"
       },
       {
         "summary": "Specifying File Sets",
         "topic": "filesets"
       },
       {
         "summary": "Glossary",
         "topic": "glossary"
       },
       {
         "summary": "Syntax for Mercurial Ignore Files",
         "topic": "hgignore"
       },
       {
         "summary": "Configuring hgweb",
         "topic": "hgweb"
       },
       {
         "summary": "Technical implementation topics",
         "topic": "internals"
       },
       {
         "summary": "Merge Tools",
         "topic": "merge-tools"
       },
       {
         "summary": "Specifying Multiple Revisions",
         "topic": "multirevs"
       },
       {
         "summary": "File Name Patterns",
         "topic": "patterns"
       },
       {
         "summary": "Working with Phases",
         "topic": "phases"
       },
       {
         "summary": "Specifying Single Revisions",
         "topic": "revisions"
       },
       {
         "summary": "Specifying Revision Sets",
         "topic": "revsets"
       },
       {
         "summary": "Using Mercurial from scripts and automation",
         "topic": "scripting"
       },
       {
         "summary": "Subrepositories",
         "topic": "subrepos"
       },
       {
         "summary": "Template Usage",
         "topic": "templating"
       },
       {
         "summary": "URL Paths",
         "topic": "urls"
       }
     ]
   }
 
 help/{topic} shows an individual help topic
 
   $ request json-help/phases
   200 Script output follows
   
   {
     "rawdoc": "Working with Phases\n*", (glob)
     "topic": "phases"
   }