mercurial/registrar.py

43075:57875cf423c9

#
# We still add the official API to the registrar module for consistency with
# the other items extensions want might to register.
configitem = configitems.getitemregister

class _funcregistrarbase(object):
    """Base of decorator to register a function for specific purpose

    This decorator stores decorated functions into own dict 'table'.

    In this case:

    - 'barfunc' is stored as 'bar' in '_table' of an instance 'keyword' above
    - 'barfunc.__doc__' becomes ":bar: Explanation of bar keyword"
    """
    def __init__(self, table=None):
        if table is None:
            self._table = {}
        else:
            self._table = table

        return self._docformat % (decl, doc)

    def _extrasetup(self, name, func):
        """Execute exra setup for registered function, if needed
        """

class command(_funcregistrarbase):
    """Decorator to register a command function to table

    This class receives a command table as its argument. The table should

    CATEGORY_REMOTE_REPO_MANAGEMENT = 'remote'
    CATEGORY_COMMITTING = 'commit'
    CATEGORY_CHANGE_MANAGEMENT = 'management'
    CATEGORY_CHANGE_ORGANIZATION = 'organization'
    CATEGORY_FILE_CONTENTS = 'files'
    CATEGORY_CHANGE_NAVIGATION  = 'navigation'
    CATEGORY_WORKING_DIRECTORY = 'wdir'
    CATEGORY_IMPORT_EXPORT = 'import'
    CATEGORY_MAINTENANCE = 'maintenance'
    CATEGORY_HELP = 'help'
    CATEGORY_MISC = 'misc'
    CATEGORY_NONE = 'none'

    def _doregister(self, func, name, options=(), synopsis=None,
                    norepo=False, optionalrepo=False, inferrepo=False,
                    intents=None, helpcategory=None, helpbasic=False):
        func.norepo = norepo
        func.optionalrepo = optionalrepo
        func.inferrepo = inferrepo
        func.intents = intents or set()
        func.helpcategory = helpcategory

            self._table[name] = func, list(options), synopsis
        else:
            self._table[name] = func, list(options)
        return func

INTENT_READONLY = b'readonly'

class revsetpredicate(_funcregistrarbase):
    """Decorator to register revset predicate

    Usage::

    extension, if an instance named as 'revsetpredicate' is used for
    decorating in extension.

    Otherwise, explicit 'revset.loadpredicate()' is needed.
    """
    _getname = _funcregistrarbase._parsefuncdecl
    _docformat = "``%s``\n    %s"

    def _extrasetup(self, name, func, safe=False, takeorder=False, weight=1):
        func._safe = safe
        func._takeorder = takeorder
        func._weight = weight

class filesetpredicate(_funcregistrarbase):
    """Decorator to register fileset predicate

    Usage::

    extension, if an instance named as 'filesetpredicate' is used for
    decorating in extension.

    Otherwise, explicit 'fileset.loadpredicate()' is needed.
    """
    _getname = _funcregistrarbase._parsefuncdecl
    _docformat = "``%s``\n    %s"

    def _extrasetup(self, name, func, callstatus=False, weight=1):
        func._callstatus = callstatus
        func._weight = weight

class _templateregistrarbase(_funcregistrarbase):
    """Base of decorator to register functions as template specific one
    """
    _docformat = ":%s: %s"

class templatekeyword(_templateregistrarbase):
    """Decorator to register template keyword

    Usage::

    """

    def _extrasetup(self, name, func, requires=()):
        func._requires = requires

class templatefilter(_templateregistrarbase):
    """Decorator to register template filer

    Usage::

    Otherwise, explicit 'templatefilters.loadkeyword()' is needed.
    """

    def _extrasetup(self, name, func, intype=None):
        func._intype = intype

class templatefunc(_templateregistrarbase):
    """Decorator to register template function

    Usage::

    extension, if an instance named as 'templatefunc' is used for
    decorating in extension.

    Otherwise, explicit 'templatefuncs.loadfunction()' is needed.
    """
    _getname = _funcregistrarbase._parsefuncdecl

    def _extrasetup(self, name, func, argspec=None, requires=()):
        func._argspec = argspec
        func._requires = requires

class internalmerge(_funcregistrarbase):
    """Decorator to register in-process merge tool

    Usage::

    extension, if an instance named as 'internalmerge' is used for
    decorating in extension.

    Otherwise, explicit 'filemerge.loadinternalmerge()' is needed.
    """
    _docformat = "``:%s``\n    %s"

    # merge type definitions:
    nomerge = None
    mergeonly = 'mergeonly'  # just the full merge, no premerge
    fullmerge = 'fullmerge'  # both premerge and merge

    def _extrasetup(self, name, func, mergetype,
                    onfailure=None, precheck=None,
                    binary=False, symlink=False):
        func.mergetype = mergetype
        func.onfailure = onfailure
        func.precheck = precheck

        binarycap = binary or mergetype == self.nomerge

43076:2372284d9457

#
# We still add the official API to the registrar module for consistency with
# the other items extensions want might to register.
configitem = configitems.getitemregister


class _funcregistrarbase(object):
    """Base of decorator to register a function for specific purpose

    This decorator stores decorated functions into own dict 'table'.

    In this case:

    - 'barfunc' is stored as 'bar' in '_table' of an instance 'keyword' above
    - 'barfunc.__doc__' becomes ":bar: Explanation of bar keyword"
    """

    def __init__(self, table=None):
        if table is None:
            self._table = {}
        else:
            self._table = table

        return self._docformat % (decl, doc)

    def _extrasetup(self, name, func):
        """Execute exra setup for registered function, if needed
        """


class command(_funcregistrarbase):
    """Decorator to register a command function to table

    This class receives a command table as its argument. The table should

    CATEGORY_REMOTE_REPO_MANAGEMENT = 'remote'
    CATEGORY_COMMITTING = 'commit'
    CATEGORY_CHANGE_MANAGEMENT = 'management'
    CATEGORY_CHANGE_ORGANIZATION = 'organization'
    CATEGORY_FILE_CONTENTS = 'files'
    CATEGORY_CHANGE_NAVIGATION = 'navigation'
    CATEGORY_WORKING_DIRECTORY = 'wdir'
    CATEGORY_IMPORT_EXPORT = 'import'
    CATEGORY_MAINTENANCE = 'maintenance'
    CATEGORY_HELP = 'help'
    CATEGORY_MISC = 'misc'
    CATEGORY_NONE = 'none'

    def _doregister(
        self,
        func,
        name,
        options=(),
        synopsis=None,
        norepo=False,
        optionalrepo=False,
        inferrepo=False,
        intents=None,
        helpcategory=None,
        helpbasic=False,
    ):
        func.norepo = norepo
        func.optionalrepo = optionalrepo
        func.inferrepo = inferrepo
        func.intents = intents or set()
        func.helpcategory = helpcategory

            self._table[name] = func, list(options), synopsis
        else:
            self._table[name] = func, list(options)
        return func


INTENT_READONLY = b'readonly'


class revsetpredicate(_funcregistrarbase):
    """Decorator to register revset predicate

    Usage::

    extension, if an instance named as 'revsetpredicate' is used for
    decorating in extension.

    Otherwise, explicit 'revset.loadpredicate()' is needed.
    """

    _getname = _funcregistrarbase._parsefuncdecl
    _docformat = "``%s``\n    %s"

    def _extrasetup(self, name, func, safe=False, takeorder=False, weight=1):
        func._safe = safe
        func._takeorder = takeorder
        func._weight = weight


class filesetpredicate(_funcregistrarbase):
    """Decorator to register fileset predicate

    Usage::

    extension, if an instance named as 'filesetpredicate' is used for
    decorating in extension.

    Otherwise, explicit 'fileset.loadpredicate()' is needed.
    """

    _getname = _funcregistrarbase._parsefuncdecl
    _docformat = "``%s``\n    %s"

    def _extrasetup(self, name, func, callstatus=False, weight=1):
        func._callstatus = callstatus
        func._weight = weight


class _templateregistrarbase(_funcregistrarbase):
    """Base of decorator to register functions as template specific one
    """

    _docformat = ":%s: %s"


class templatekeyword(_templateregistrarbase):
    """Decorator to register template keyword

    Usage::

    """

    def _extrasetup(self, name, func, requires=()):
        func._requires = requires


class templatefilter(_templateregistrarbase):
    """Decorator to register template filer

    Usage::

    Otherwise, explicit 'templatefilters.loadkeyword()' is needed.
    """

    def _extrasetup(self, name, func, intype=None):
        func._intype = intype


class templatefunc(_templateregistrarbase):
    """Decorator to register template function

    Usage::

    extension, if an instance named as 'templatefunc' is used for
    decorating in extension.

    Otherwise, explicit 'templatefuncs.loadfunction()' is needed.
    """

    _getname = _funcregistrarbase._parsefuncdecl

    def _extrasetup(self, name, func, argspec=None, requires=()):
        func._argspec = argspec
        func._requires = requires


class internalmerge(_funcregistrarbase):
    """Decorator to register in-process merge tool

    Usage::

    extension, if an instance named as 'internalmerge' is used for
    decorating in extension.

    Otherwise, explicit 'filemerge.loadinternalmerge()' is needed.
    """

    _docformat = "``:%s``\n    %s"

    # merge type definitions:
    nomerge = None
    mergeonly = 'mergeonly'  # just the full merge, no premerge
    fullmerge = 'fullmerge'  # both premerge and merge

    def _extrasetup(
        self,
        name,
        func,
        mergetype,
        onfailure=None,
        precheck=None,
        binary=False,
        symlink=False,
    ):
        func.mergetype = mergetype
        func.onfailure = onfailure
        func.precheck = precheck

        binarycap = binary or mergetype == self.nomerge