# subrepo.py - sub-repository classes and factory

#

# Copyright 2009-2010 Matt Mackall <mpm@selenic.com>

#

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

import hashlib

import os

import re

import stat

import subprocess

import sys

import tarfile

import xml.dom.minidom

from .i18n import _

from . import (

    cmdutil,

    encoding,

    error,

    exchange,

    logcmdutil,

    match as matchmod,

    node,

    pathutil,

    phases,

    pycompat,

    scmutil,

    subrepoutil,

    util,

    vfs as vfsmod,

)

from .utils import (

    dateutil,

    procutil,

    stringutil,

)

hg = None

reporelpath = subrepoutil.reporelpath

subrelpath = subrepoutil.subrelpath

_abssource = subrepoutil._abssource

propertycache = util.propertycache

def _expandedabspath(path):

    '''

    get a path or url and if it is a path expand it and return an absolute path

    '''

    expandedpath = util.urllocalpath(util.expandpath(path))

    u = util.url(expandedpath)

    if not u.scheme:

        path = util.normpath(os.path.abspath(u.path))

    return path

def _getstorehashcachename(remotepath):

    '''get a unique filename for the store hash cache of a remote repository'''

    return node.hex(hashlib.sha1(_expandedabspath(remotepath)).digest())[0:12]

class SubrepoAbort(error.Abort):

    """Exception class used to avoid handling a subrepo error more than once"""

    def __init__(self, *args, **kw):

        self.subrepo = kw.pop(r'subrepo', None)

        self.cause = kw.pop(r'cause', None)

        error.Abort.__init__(self, *args, **kw)

def annotatesubrepoerror(func):

    def decoratedmethod(self, *args, **kargs):

        try:

            res = func(self, *args, **kargs)

        except SubrepoAbort as ex:

            # This exception has already been handled

            raise ex

        except error.Abort as ex:

            subrepo = subrelpath(self)

            errormsg = (stringutil.forcebytestr(ex) + ' '

                        + _('(in subrepository "%s")') % subrepo)

            # avoid handling this exception by raising a SubrepoAbort exception

            raise SubrepoAbort(errormsg, hint=ex.hint, subrepo=subrepo,

                               cause=sys.exc_info())

        return res

    return decoratedmethod

def _updateprompt(ui, sub, dirty, local, remote):

    if dirty:

        msg = (_(' subrepository sources for %s differ\n'

                 'use (l)ocal source (%s) or (r)emote source (%s)?'

                 '$$ &Local $$ &Remote')

               % (subrelpath(sub), local, remote))

    else:

        msg = (_(' subrepository sources for %s differ (in checked out '

                 'version)\n'

                 'use (l)ocal source (%s) or (r)emote source (%s)?'

                 '$$ &Local $$ &Remote')

               % (subrelpath(sub), local, remote))

    return ui.promptchoice(msg, 0)

def _sanitize(ui, vfs, ignore):

    for dirname, dirs, names in vfs.walk():

        for i, d in enumerate(dirs):

            if d.lower() == ignore:

                del dirs[i]

                break

        if vfs.basename(dirname).lower() != '.hg':

            continue

        for f in names:

            if f.lower() == 'hgrc':

                ui.warn(_("warning: removing potentially hostile 'hgrc' "

                          "in '%s'\n") % vfs.join(dirname))

                vfs.unlink(vfs.reljoin(dirname, f))

def _auditsubrepopath(repo, path):

    # sanity check for potentially unsafe paths such as '~' and '$FOO'

    if path.startswith('~') or '$' in path or util.expandpath(path) != path:

        raise error.Abort(_('subrepo path contains illegal component: %s')

                          % path)

    # auditor doesn't check if the path itself is a symlink

    pathutil.pathauditor(repo.root)(path)

    if repo.wvfs.islink(path):

        raise error.Abort(_("subrepo '%s' traverses symbolic link") % path)

SUBREPO_ALLOWED_DEFAULTS = {

    'hg': True,

    'git': False,

    'svn': False,

}

def _checktype(ui, kind):

    # subrepos.allowed is a master kill switch. If disabled, subrepos are

    # disabled period.

    if not ui.configbool('subrepos', 'allowed', True):

        raise error.Abort(_('subrepos not enabled'),

                          hint=_("see 'hg help config.subrepos' for details"))

    default = SUBREPO_ALLOWED_DEFAULTS.get(kind, False)

    if not ui.configbool('subrepos', '%s:allowed' % kind, default):

        raise error.Abort(_('%s subrepos not allowed') % kind,

                          hint=_("see 'hg help config.subrepos' for details"))

    if kind not in types:

        raise error.Abort(_('unknown subrepo type %s') % kind)

def subrepo(ctx, path, allowwdir=False, allowcreate=True):

    """return instance of the right subrepo class for subrepo in path"""

    # subrepo inherently violates our import layering rules

    # because it wants to make repo objects from deep inside the stack

    # so we manually delay the circular imports to not break

    # scripts that don't use our demand-loading

    global hg

    from . import hg as h

    hg = h

    repo = ctx.repo()

    _auditsubrepopath(repo, path)

    state = ctx.substate[path]

    _checktype(repo.ui, state[2])

    if allowwdir:

        state = (state[0], ctx.subrev(path), state[2])

    return types[state[2]](ctx, path, state[:2], allowcreate)

def nullsubrepo(ctx, path, pctx):

    """return an empty subrepo in pctx for the extant subrepo in ctx"""

    # subrepo inherently violates our import layering rules

    # because it wants to make repo objects from deep inside the stack

    # so we manually delay the circular imports to not break

    # scripts that don't use our demand-loading

    global hg

    from . import hg as h

    hg = h

    repo = ctx.repo()

    _auditsubrepopath(repo, path)

    state = ctx.substate[path]

    _checktype(repo.ui, state[2])

    subrev = ''

    if state[2] == 'hg':

        subrev = "0" * 40

    return types[state[2]](pctx, path, (state[0], subrev), True)

# subrepo classes need to implement the following abstract class:

class abstractsubrepo(object):

    def __init__(self, ctx, path):

        """Initialize abstractsubrepo part

        ``ctx`` is the context referring this subrepository in the

        parent repository.

        ``path`` is the path to this subrepository as seen from

        innermost repository.

        """

        self.ui = ctx.repo().ui

        self._ctx = ctx

        self._path = path

    def addwebdirpath(self, serverpath, webconf):

        """Add the hgwebdir entries for this subrepo, and any of its subrepos.

        ``serverpath`` is the path component of the URL for this repo.

        ``webconf`` is the dictionary of hgwebdir entries.

        """

        pass

    def storeclean(self, path):

        """

        returns true if the repository has not changed since it was last

        cloned from or pushed to a given repository.

        """

        return False

    def dirty(self, ignoreupdate=False, missing=False):

        """returns true if the dirstate of the subrepo is dirty or does not

        match current stored state. If ignoreupdate is true, only check

        whether the subrepo has uncommitted changes in its dirstate.  If missing

        is true, check for deleted files.

        """

        raise NotImplementedError

    def dirtyreason(self, ignoreupdate=False, missing=False):

        """return reason string if it is ``dirty()``

        Returned string should have enough information for the message

        of exception.

        This returns None, otherwise.

        """

        if self.dirty(ignoreupdate=ignoreupdate, missing=missing):

            return _('uncommitted changes in subrepository "%s"'

                     ) % subrelpath(self)

    def bailifchanged(self, ignoreupdate=False, hint=None):

        """raise Abort if subrepository is ``dirty()``

        """

        dirtyreason = self.dirtyreason(ignoreupdate=ignoreupdate,

                                       missing=True)

        if dirtyreason:

            raise error.Abort(dirtyreason, hint=hint)

    def basestate(self):

        """current working directory base state, disregarding .hgsubstate

        state and working directory modifications"""

        raise NotImplementedError

    def checknested(self, path):

        """check if path is a subrepository within this repository"""

        return False

    def commit(self, text, user, date):

        """commit the current changes to the subrepo with the given

        log message. Use given user and date if possible. Return the

        new state of the subrepo.

        """

        raise NotImplementedError

    def phase(self, state):

        """returns phase of specified state in the subrepository.

        """

        return phases.public

    def remove(self):

        """remove the subrepo

        (should verify the dirstate is not dirty first)

        """

        raise NotImplementedError

    def get(self, state, overwrite=False):

        """run whatever commands are needed to put the subrepo into

        this state

        """

        raise NotImplementedError

    def merge(self, state):

        """merge currently-saved state with the new state."""

        raise NotImplementedError

    def push(self, opts):

        """perform whatever action is analogous to 'hg push'

        This may be a no-op on some systems.

        """

        raise NotImplementedError

    def add(self, ui, match, prefix, uipathfn, explicitonly, **opts):

        return []

        self.ui.warn("%s: %s" % (prefix, _("addremove is not supported")))

        return 1

    def cat(self, match, fm, fntemplate, prefix, **opts):

        return 1

    def status(self, rev2, **opts):

        return scmutil.status([], [], [], [], [], [], [])

    def diff(self, ui, diffopts, node2, match, prefix, **opts):

        pass

    def outgoing(self, ui, dest, opts):

        return 1

    def incoming(self, ui, source, opts):

        return 1

    def files(self):

        """return filename iterator"""

        raise NotImplementedError

    def filedata(self, name, decode):

        """return file data, optionally passed through repo decoders"""

        raise NotImplementedError

    def fileflags(self, name):

        """return file flags"""

        return ''

    def matchfileset(self, expr, badfn=None):

        """Resolve the fileset expression for this repo"""

        return matchmod.nevermatcher(self.wvfs.base, '', badfn=badfn)

    def printfiles(self, ui, m, fm, fmt, subrepos):

        """handle the files command for this subrepo"""

        return 1

    def archive(self, archiver, prefix, match=None, decode=True):

        if match is not None:

            files = [f for f in self.files() if match(f)]

        else:

            files = self.files()

        total = len(files)

        relpath = subrelpath(self)

        progress = self.ui.makeprogress(_('archiving (%s)') % relpath,

                                        unit=_('files'), total=total)

        progress.update(0)

        for name in files:

            flags = self.fileflags(name)

            mode = 'x' in flags and 0o755 or 0o644

            symlink = 'l' in flags

            archiver.addfile(prefix + name, mode, symlink,

                             self.filedata(name, decode))

            progress.increment()

        progress.complete()

        return total

    def walk(self, match):

        '''

        walk recursively through the directory tree, finding all files

        matched by the match function

        '''

    def forget(self, match, prefix, dryrun, interactive):

        return ([], [])

    def removefiles(self, matcher, prefix, uipathfn, after, force, subrepos,

                    dryrun, warnings):

        """remove the matched files from the subrepository and the filesystem,

        possibly by force and/or after the file has been removed from the

        filesystem.  Return 0 on success, 1 on any warning.

        """

        warnings.append(_("warning: removefiles not implemented (%s)")

                        % self._path)

        return 1

    def revert(self, substate, *pats, **opts):

        self.ui.warn(_('%s: reverting %s subrepos is unsupported\n') \

            % (substate[0], substate[2]))

        return []

    def shortid(self, revid):

        return revid

    def unshare(self):

        '''