comparison mercurial/formatter.py @ 32835:9d76812f9b0b

formatter: document lookuptemplate()

32834:edde2e974ed0

            props['revcache'] = {}
        g = self._t(self._topic, ui=self._ui, cache=self._cache, **props)
        self._out.write(templater.stringify(g))

def lookuptemplate(ui, topic, tmpl):
    # looks like a literal template?
    if '{' in tmpl:
        return tmpl, None

    # perhaps a stock style?

32835:9d76812f9b0b

            props['revcache'] = {}
        g = self._t(self._topic, ui=self._ui, cache=self._cache, **props)
        self._out.write(templater.stringify(g))

def lookuptemplate(ui, topic, tmpl):
    """Find the template matching the given -T/--template spec 'tmpl'

    'tmpl' can be any of the following:

     - a literal template (e.g. '{rev}')
     - a map-file name or path (e.g. 'changelog')
     - a reference to [templates] in config file
     - a path to raw template file

    A map file defines a stand-alone template environment. If a map file
    selected, all templates defined in the file will be loaded, and the
    template matching the given topic will be rendered. No aliases will be
    loaded from user config.
    """

    # looks like a literal template?
    if '{' in tmpl:
        return tmpl, None

    # perhaps a stock style?