/brz/remove-bazaar

# Copyright (C) 2008 Canonical Ltd

#

# This program is free software; you can redistribute it and/or modify

# it under the terms of the GNU General Public License as published by

# the Free Software Foundation; either version 2 of the License, or

# (at your option) any later version.

#

# This program is distributed in the hope that it will be useful,

# but WITHOUT ANY WARRANTY; without even the implied warranty of

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

# GNU General Public License for more details.

#

# You should have received a copy of the GNU General Public License

# along with this program; if not, write to the Free Software

# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

"""Processor of import commands.

This module provides core processing functionality including an abstract class

for basing real processors on. See the processors package for examples.

"""

import sys

import time

from bzrlib import debug

from bzrlib.errors import NotBranchError

from bzrlib.trace import (

    mutter,

    note,

    warning,

    )

import errors

class ImportProcessor(object):

    """Base class for import processors.

    Subclasses should override the pre_*, post_* and *_handler

    methods as appropriate.

    """

    known_params = []

    def __init__(self, bzrdir, params=None, verbose=False, outf=None):

        if outf is None:

            self.outf = sys.stdout

        else:

            self.outf = outf

        self.verbose = verbose

        if params is None:

            self.params = {}

        else:

            self.params = params

            self.validate_parameters()

        self.bzrdir = bzrdir

        if bzrdir is None:

            # Some 'importers' don't need a repository to write to

            self.working_tree = None

            self.branch = None

            self.repo = None

        else:

            try:

                # Might be inside a branch

                (self.working_tree, self.branch) = bzrdir._get_tree_branch()

                self.repo = self.branch.repository

            except NotBranchError:

                # Must be inside a repository

                self.working_tree = None

                self.branch = None

                self.repo = bzrdir.open_repository()

        # Handlers can set this to request exiting cleanly without

        # iterating through the remaining commands

        self.finished = False

    def validate_parameters(self):

        """Validate that the parameters are correctly specified."""

        for p in self.params:

            if p not in self.known_params:

                raise errors.UnknownParameter(p, self.known_params)

    def process(self, command_iter):

        """Import data into Bazaar by processing a stream of commands.

        :param command_iter: an iterator providing commands

        """

        if self.working_tree is not None:

            self.working_tree.lock_write()

        elif self.branch is not None:

            self.branch.lock_write()

        elif self.repo is not None:

            self.repo.lock_write()

        try:

            self._process(command_iter)

        finally:

            # If an unhandled exception occurred, abort the write group

            if self.repo is not None and self.repo.is_in_write_group():

                self.repo.abort_write_group()

            # Release the locks

            if self.working_tree is not None:

                self.working_tree.unlock()

            elif self.branch is not None:

                self.branch.unlock()

            elif self.repo is not None:

                self.repo.unlock()

    def _process(self, command_iter):

        self.pre_process()

        for cmd in command_iter():

            try:

                handler = self.__class__.__dict__[cmd.name + "_handler"]

            except KeyError:

                raise errors.MissingHandler(cmd.name)

            else:

                self.pre_handler(cmd)

                handler(self, cmd)

                self.post_handler(cmd)

            if self.finished:

                break

        self.post_process()

    def note(self, msg, *args):

        """Output a note but timestamp it."""

        msg = "%s %s" % (self._time_of_day(), msg)

        note(msg, *args)

    def warning(self, msg, *args):

        """Output a warning but timestamp it."""

        msg = "%s WARNING: %s" % (self._time_of_day(), msg)

        warning(msg, *args)

    def debug(self, mgs, *args):

        """Output a debug message if the appropriate -D option was given."""

        if "fast-import" in debug.debug_flags:

            msg = "%s DEBUG: %s" % (self._time_of_day(), msg)

            mutter(msg, *args)

    def _time_of_day(self):

        """Time of day as a string."""

        # Note: this is a separate method so tests can patch in a fixed value

        return time.strftime("%H:%M:%S")

    def pre_process(self):

        """Hook for logic at start of processing."""

        pass

    def post_process(self):

        """Hook for logic at end of processing."""

        pass

    def pre_handler(self, cmd):

        """Hook for logic before each handler starts."""

        pass

    def post_handler(self, cmd):

        """Hook for logic after each handler finishes."""

        pass

    def progress_handler(self, cmd):

        """Process a ProgressCommand."""

        raise NotImplementedError(self.progress_handler)

    def blob_handler(self, cmd):

        """Process a BlobCommand."""

        raise NotImplementedError(self.blob_handler)

    def checkpoint_handler(self, cmd):

        """Process a CheckpointCommand."""

        raise NotImplementedError(self.checkpoint_handler)

    def commit_handler(self, cmd):

        """Process a CommitCommand."""

        raise NotImplementedError(self.commit_handler)

    def reset_handler(self, cmd):

        """Process a ResetCommand."""

        raise NotImplementedError(self.reset_handler)

    def tag_handler(self, cmd):

        """Process a TagCommand."""

        raise NotImplementedError(self.tag_handler)

    def feature_handler(self, cmd):

        """Process a FeatureCommand."""

        raise NotImplementedError(self.feature_handler)

class CommitHandler(object):

    """Base class for commit handling.

    Subclasses should override the pre_*, post_* and *_handler

    methods as appropriate.

    """

    def __init__(self, command):

        self.command = command

    def process(self):

        self.pre_process_files()

        for fc in self.command.file_iter():

            try:

                handler = self.__class__.__dict__[fc.name[4:] + "_handler"]

            except KeyError:

                raise errors.MissingHandler(fc.name)

            else:

                handler(self, fc)

        self.post_process_files()

    def note(self, msg, *args):

        """Output a note but add context."""

        msg = "%s (%s)" % (msg, self.command.id)

        note(msg, *args)

    def warning(self, msg, *args):

        """Output a warning but add context."""

        msg = "WARNING: %s (%s)" % (msg, self.command.id)

        warning(msg, *args)

    def mutter(self, msg, *args):

        """Output a mutter but add context."""

        msg = "%s (%s)" % (msg, self.command.id)

        mutter(msg, *args)

    def debug(self, msg, *args):

        """Output a mutter if the appropriate -D option was given."""

        if "fast-import" in debug.debug_flags:

            msg = "%s (%s)" % (msg, self.command.id)

            mutter(msg, *args)

    def pre_process_files(self):

        """Prepare for committing."""

        pass

    def post_process_files(self):

        """Save the revision."""

        pass

    def modify_handler(self, filecmd):

        """Handle a filemodify command."""

        raise NotImplementedError(self.modify_handler)

    def delete_handler(self, filecmd):

        """Handle a filedelete command."""

        raise NotImplementedError(self.delete_handler)

    def copy_handler(self, filecmd):

        """Handle a filecopy command."""

        raise NotImplementedError(self.copy_handler)

    def rename_handler(self, filecmd):

        """Handle a filerename command."""

        raise NotImplementedError(self.rename_handler)

    def deleteall_handler(self, filecmd):

        """Handle a filedeleteall command."""

        raise NotImplementedError(self.deleteall_handler)