comparison mercurial/templatekw.py @ 45868:f67741e8264b

templates: define a {onelinesummary} keyword

It is sometimes useful to be able to use the configured
`command-template.oneline-summary` in higher-level templates. For
example, I would like to use it in an internal template that lists
commits in a "review unit" (kind of a pull request). This patch adds
support for that.

We may want to define a way of formatting a context using a
command-specific override (from
`command-templates.oneline-summary.<command>`), but that will have to
be a template function instead. I don't plan to do that, but I'm
mentioning it now in case reviewers would prefer that we use a no-arg
function (i.e. `{onelinesummary()}`) already today to prepare for
that.

Differential Revision: https://phab.mercurial-scm.org/D9314

45867:774b1c0f2507

    if ctx.obsolete():
        return b'obsolete'
    return b''


@templatekeyword(b'path', requires={b'fctx'})
def showpath(context, mapping):
    """String. Repository-absolute path of the current file. (EXPERIMENTAL)"""
    fctx = context.resource(mapping, b'fctx')
    return fctx.path()

45868:f67741e8264b

    if ctx.obsolete():
        return b'obsolete'
    return b''


@templatekeyword(b'onelinesummary', requires={b'ui', b'ctx'})
def showonelinesummary(context, mapping):
    """String. A one-line summary for the ctx (not including trailing newline).
    The default template be overridden in command-templates.oneline-summary."""
    # Avoid cycle:
    # mercurial.cmdutil -> mercurial.templatekw -> mercurial.cmdutil
    from . import cmdutil

    ui = context.resource(mapping, b'ui')
    ctx = context.resource(mapping, b'ctx')
    return cmdutil.format_changeset_summary(ui, ctx)


@templatekeyword(b'path', requires={b'fctx'})
def showpath(context, mapping):
    """String. Repository-absolute path of the current file. (EXPERIMENTAL)"""
    fctx = context.resource(mapping, b'fctx')
    return fctx.path()