# configitems.py - centralized declaration of configuration option

#

#  Copyright 2017 Pierre-Yves David <pierre-yves.david@octobus.net>

#

# 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 functools

import re

from . import (

    encoding,

    error,

)

def loadconfigtable(ui, extname, configtable):

    """update config item known to the ui with the extension ones"""

    for section, items in configtable.items():

        knownitems = ui._knownconfig.setdefault(section, itemregister())

        knownkeys = set(knownitems)

        newkeys = set(items)

        for key in sorted(knownkeys & newkeys):

            msg = "extension '%s' overwrite config item '%s.%s'"

            msg %= (extname, section, key)

            ui.develwarn(msg, config='warn-config')

        knownitems.update(items)

class configitem(object):

    """represent a known config item

    :section: the official config section where to find this item,

       :name: the official name within the section,

    :default: default value for this item,

    :alias: optional list of tuples as alternatives,

    :generic: this is a generic definition, match name using regular expression.

    """

    def __init__(self, section, name, default=None, alias=(),

                 generic=False, priority=0):

        self.section = section

        self.name = name

        self.default = default

        self.alias = list(alias)

        self.generic = generic

        self.priority = priority

        self._re = None

        if generic:

            self._re = re.compile(self.name)

class itemregister(dict):

    """A specialized dictionary that can handle wild-card selection"""

    def __init__(self):

        super(itemregister, self).__init__()

        self._generics = set()

    def update(self, other):

        super(itemregister, self).update(other)

        self._generics.update(other._generics)

    def __setitem__(self, key, item):

        super(itemregister, self).__setitem__(key, item)

        if item.generic:

            self._generics.add(item)

    def get(self, key):

        baseitem = super(itemregister, self).get(key)

        if baseitem is not None and not baseitem.generic:

            return baseitem

        # search for a matching generic item

        generics = sorted(self._generics, key=(lambda x: (x.priority, x.name)))

        for item in generics:

            # we use 'match' instead of 'search' to make the matching simpler

            # for people unfamiliar with regular expression. Having the match

            # rooted to the start of the string will produce less surprising

            # result for user writing simple regex for sub-attribute.

            #

            # For example using "color\..*" match produces an unsurprising

            # result, while using search could suddenly match apparently

            # unrelated configuration that happens to contains "color."

            # anywhere. This is a tradeoff where we favor requiring ".*" on

            # some match to avoid the need to prefix most pattern with "^".

            # The "^" seems more error prone.

            if item._re.match(key):

                return item

        return None

coreitems = {}

def _register(configtable, *args, **kwargs):

    item = configitem(*args, **kwargs)

    section = configtable.setdefault(item.section, itemregister())

    if item.name in section:

        msg = "duplicated config item registration for '%s.%s'"

        raise error.ProgrammingError(msg % (item.section, item.name))

    section[item.name] = item

# special value for case where the default is derived from other values

dynamicdefault = object()

# Registering actual config items

def getitemregister(configtable):

    return functools.partial(_register, configtable)

coreconfigitem = getitemregister(coreitems)

coreconfigitem('alias', '.*',

    default=None,

    generic=True,

)

coreconfigitem('annotate', 'nodates',

    default=False,

)

coreconfigitem('annotate', 'showfunc',

    default=False,

)

coreconfigitem('annotate', 'unified',

    default=None,

)

coreconfigitem('annotate', 'git',

    default=False,

)

coreconfigitem('annotate', 'ignorews',

    default=False,

)

coreconfigitem('annotate', 'ignorewsamount',

    default=False,

)

coreconfigitem('annotate', 'ignoreblanklines',

    default=False,

)

coreconfigitem('annotate', 'ignorewseol',

    default=False,

)

coreconfigitem('annotate', 'nobinary',

    default=False,

)

coreconfigitem('annotate', 'noprefix',

    default=False,

)

coreconfigitem('auth', 'cookiefile',

    default=None,

)

# bookmarks.pushing: internal hack for discovery

coreconfigitem('bookmarks', 'pushing',

    default=list,

)

# bundle.mainreporoot: internal hack for bundlerepo

coreconfigitem('bundle', 'mainreporoot',

    default='',

)

# bundle.reorder: experimental config

coreconfigitem('bundle', 'reorder',

    default='auto',

)

coreconfigitem('censor', 'policy',

    default='abort',

)

coreconfigitem('chgserver', 'idletimeout',

    default=3600,

)

coreconfigitem('chgserver', 'skiphash',

    default=False,

)

coreconfigitem('cmdserver', 'log',

    default=None,

)

coreconfigitem('color', '.*',

    default=None,

    generic=True,

)

coreconfigitem('color', 'mode',

    default='auto',

)

coreconfigitem('color', 'pagermode',

    default=dynamicdefault,

)

coreconfigitem('commands', 'status.relative',

    default=False,

)

coreconfigitem('commands', 'status.skipstates',

    default=[],

)

coreconfigitem('commands', 'status.verbose',

    default=False,

)

coreconfigitem('commands', 'update.check',

    default=None,

    # Deprecated, remove after 4.4 release

    alias=[('experimental', 'updatecheck')]

)

coreconfigitem('commands', 'update.requiredest',

    default=False,

)

coreconfigitem('committemplate', '.*',

    default=None,

    generic=True,

)

coreconfigitem('debug', 'dirstate.delaywrite',

    default=0,

)

coreconfigitem('defaults', '.*',

    default=None,

    generic=True,

)

coreconfigitem('devel', 'all-warnings',

    default=False,

)

coreconfigitem('devel', 'bundle2.debug',

    default=False,

)

coreconfigitem('devel', 'cache-vfs',

    default=None,

)

coreconfigitem('devel', 'check-locks',

    default=False,

)

coreconfigitem('devel', 'check-relroot',

    default=False,

)

coreconfigitem('devel', 'default-date',

    default=None,

)

coreconfigitem('devel', 'deprec-warn',

    default=False,

)

coreconfigitem('devel', 'disableloaddefaultcerts',

    default=False,

)

coreconfigitem('devel', 'warn-empty-changegroup',

    default=False,

)

coreconfigitem('devel', 'legacy.exchange',

    default=list,

)

coreconfigitem('devel', 'servercafile',

    default='',

)

coreconfigitem('devel', 'serverexactprotocol',

    default='',

)

coreconfigitem('devel', 'serverrequirecert',

    default=False,

)

coreconfigitem('devel', 'strip-obsmarkers',

    default=True,

)

coreconfigitem('devel', 'warn-config',

    default=None,

)

coreconfigitem('devel', 'warn-config-default',

    default=None,

)

coreconfigitem('devel', 'user.obsmarker',

    default=None,

)

coreconfigitem('devel', 'warn-config-unknown',

    default=None,

)

coreconfigitem('diff', 'nodates',

    default=False,

)

coreconfigitem('diff', 'showfunc',

    default=False,

)

coreconfigitem('diff', 'unified',

    default=None,

)

coreconfigitem('diff', 'git',

    default=False,

)

coreconfigitem('diff', 'ignorews',

    default=False,

)

coreconfigitem('diff', 'ignorewsamount',

    default=False,

)

coreconfigitem('diff', 'ignoreblanklines',

    default=False,

)

coreconfigitem('diff', 'ignorewseol',

    default=False,

)

coreconfigitem('diff', 'nobinary',

    default=False,

)

coreconfigitem('diff', 'noprefix',

    default=False,

)

coreconfigitem('email', 'bcc',

    default=None,

)

coreconfigitem('email', 'cc',

    default=None,

)

coreconfigitem('email', 'charsets',

    default=list,

)

coreconfigitem('email', 'from',

    default=None,

)

coreconfigitem('email', 'method',

    default='smtp',

)

coreconfigitem('email', 'reply-to',

    default=None,

)

coreconfigitem('experimental', 'archivemetatemplate',

    default=dynamicdefault,

)

coreconfigitem('experimental', 'bundle-phases',

    default=False,

)

coreconfigitem('experimental', 'bundle2-advertise',

    default=True,

)

coreconfigitem('experimental', 'bundle2-output-capture',

    default=False,

)

coreconfigitem('experimental', 'bundle2.pushback',

    default=False,

)

coreconfigitem('experimental', 'bundle2lazylocking',

    default=False,

)

coreconfigitem('experimental', 'bundlecomplevel',

    default=None,

)

coreconfigitem('experimental', 'changegroup3',

    default=False,

)

coreconfigitem('experimental', 'clientcompressionengines',

    default=list,

)

coreconfigitem('experimental', 'copytrace',

    default='on',

)

coreconfigitem('experimental', 'copytrace.movecandidateslimit',

    default=100,

)

coreconfigitem('experimental', 'copytrace.sourcecommitlimit',

    default=100,

)

coreconfigitem('experimental', 'crecordtest',

    default=None,

)

coreconfigitem('experimental', 'editortmpinhg',

    default=False,

)

coreconfigitem('experimental', 'evolution',

    default=list,

)

coreconfigitem('experimental', 'evolution.allowdivergence',

    default=False,

    alias=[('experimental', 'allowdivergence')]

)

coreconfigitem('experimental', 'evolution.allowunstable',

    default=None,

)

coreconfigitem('experimental', 'evolution.createmarkers',

    default=None,

)

coreconfigitem('experimental', 'evolution.exchange',

    default=None,

)

coreconfigitem('experimental', 'evolution.bundle-obsmarker',

    default=False,

)

coreconfigitem('experimental', 'evolution.track-operation',

    default=True,

)

coreconfigitem('experimental', 'maxdeltachainspan',

    default=-1,

)

coreconfigitem('experimental', 'mmapindexthreshold',

    default=None,

)

coreconfigitem('experimental', 'nonnormalparanoidcheck',

    default=False,

)

coreconfigitem('experimental', 'effect-flags',

    default=False,

)

coreconfigitem('experimental', 'exportableenviron',

    default=list,

)

coreconfigitem('experimental', 'extendedheader.index',

    default=None,

)