git-multirepo 1.0.0.beta46 → 1.0.0.beta47

data/lib/multirepo/commands/inspect-command.rb

@@ -1,39 +1,39 @@
-require "multirepo/utility/console"
-require "multirepo/utility/utils"
-
-module MultiRepo
-  class InspectCommand < Command
-    self.command = "inspect"
-    self.summary = "Outputs various information about multirepo-enabled repos. For use in scripting and CI scenarios."
-    
-    def self.options
-      [
-        ['[--version]', 'Outputs the multirepo version that was used to track this revision.'],
-        ['[--tracked]', 'Whether the current revision is tracked by multirepo or not.']
-      ].concat(super)
-    end
-    
-    def initialize(argv)
-      @version = argv.flag?("version")
-      @tracked = argv.flag?("tracked")
-      super
-    end
-    
-    def validate!
-      super
-      unless validate_only_one_flag(@version, @tracked)
-        help! "You can't provide more than one operation modifier (--version, --tracked, etc.)"
-      end
-    end
-    
-    def run
-      ensure_in_work_tree
-      
-      if @version
-        puts MetaFile.new(".").load.version
-      elsif @tracked
-        puts Utils.is_multirepo_tracked(".").to_s
-      end
-    end
-  end
+require "multirepo/utility/console"
+require "multirepo/utility/utils"
+
+module MultiRepo
+  class InspectCommand < Command
+    self.command = "inspect"
+    self.summary = "Outputs various information about multirepo-enabled repos. For use in scripting and CI scenarios."
+    
+    def self.options
+      [
+        ['[--version]', 'Outputs the multirepo version that was used to track this revision.'],
+        ['[--tracked]', 'Whether the current revision is tracked by multirepo or not.']
+      ].concat(super)
+    end
+    
+    def initialize(argv)
+      @version = argv.flag?("version")
+      @tracked = argv.flag?("tracked")
+      super
+    end
+    
+    def validate!
+      super
+      unless validate_only_one_flag(@version, @tracked)
+        help! "You can't provide more than one operation modifier (--version, --tracked, etc.)"
+      end
+    end
+    
+    def run
+      ensure_in_work_tree
+      
+      if @version
+        puts MetaFile.new(".").load.version
+      elsif @tracked
+        puts Utils.is_multirepo_tracked(".").to_s
+      end
+    end
+  end
 end

data/lib/multirepo/commands/install-command.rb

@@ -1,147 +1,148 @@
-require "terminal-table"
-
-require "multirepo/utility/console"
-require "multirepo/utility/utils"
-require "multirepo/git/repo"
-require "multirepo/logic/performer"
-require "multirepo/commands/checkout-command"
-
-module MultiRepo
-  class InstallCommand < Command
-    self.command = "install"
-    self.summary = "Clones and checks out dependencies as defined in the version-controlled multirepo metadata files and installs git-multirepo's local git hooks."
-    
-    def self.options
-      [
-        ['[--hooks]', 'Only install local git hooks.'],
-        ['[--ci]', 'Perform a continuous-integration-aware install (such as on a CI build server or agent).']
-      ].concat(super)
-    end
-    
-    def initialize(argv)
-      @hooks = argv.flag?("hooks")
-      @ci = argv.flag?("ci")
-      super
-    end
-    
-    def validate!
-      super
-      unless validate_only_one_flag(@hooks, @ci)
-        help! "You can't provide more than one operation modifier (--hooks, --ci, etc.)"
-      end
-    end
-        
-    def run
-      ensure_in_work_tree unless @ci
-      ensure_multirepo_tracked
-      
-      if @hooks
-        Console.log_step("Installing hooks in main repo and all dependencies...")
-        install_hooks_step
-      else
-        Console.log_step("Installing dependencies...")
-        log_ci_info if @ci
-        full_install
-      end
-      
-      Console.log_step("Done!")
-    end
-    
-    def log_ci_info
-      Console.log_warning("Performing continuous-integration-aware install")
-      
-      main_repo = Repo.new(".")
-      main_repo_branch = main_repo.current_branch
-      meta_file = MetaFile.new(".").load
-
-      table = Terminal::Table.new do |t|
-        t.title = "Revision Info"
-        t.add_row ["git-multirepo version", meta_file.version]
-        t.add_separator
-        t.add_row ["Main Repo", commit_info(main_repo.head.commit_id, (main_repo_branch.name rescue nil))]
-        t.add_separator
-        LockFile.new(".").load_entries.each do |lock_entry|
-          branch_name = lock_entry.branch
-          t.add_row [lock_entry.name, commit_info(lock_entry.head, branch_name)]
-        end
-      end
-      puts table
-    end
-
-    def commit_info(commit_id, branch_name)
-      commit_id + (branch_name ? " (on branch #{branch_name})" : "")
-    end
-    
-    def full_install
-      install_dependencies_step
-      install_hooks_step unless @ci
-      update_gitconfigs_step unless @ci
-    end
-    
-    def install_dependencies_step
-      # Read config entries as-is on disk, without prior checkout
-      config_entries = ConfigFile.new(".").load_entries
-      Console.log_substep("Installing #{config_entries.count} dependencies...");
-      
-      # Clone or fetch all configured dependencies to make sure nothing is missing locally
-      Performer.dependencies.each { |d| clone_or_fetch(d) }
-      
-      # Checkout the appropriate branches as specified in the lock file
-      checkout_command = CheckoutCommand.new(CLAide::ARGV.new([]))
-      mode = @ci ? RevisionSelectionMode::AS_LOCK : RevisionSelectionMode::LATEST
-      checkout_command.dependencies_checkout_step(mode)
-    end
-    
-    def install_hooks_step
-      perform_in_main_repo_and_dependencies("Installed git hooks") { |repo| install_hooks(repo) }
-    end
-    
-    def update_gitconfigs_step
-      perform_in_main_repo_and_dependencies("Updated .git/config file") { |repo| update_gitconfig(repo) }
-    end
-    
-    def perform_in_main_repo_and_dependencies(message_prefix, &operation)
-      operation.call(".")
-      Console.log_substep("#{message_prefix} in main repo")
-      
-      multirepo_enabled_dependencies.each do |config_entry|
-        operation.call(config_entry.repo.path)
-        Console.log_substep("#{message_prefix} in multirepo-enabled dependency '#{config_entry.repo.path}'")
-      end
-    end
-    
-    # Repo operations
-    
-    def clone_or_fetch(dependency)
-      if dependency.config_entry.repo.exists?
-        check_repo_validity(dependency)
-        
-        Console.log_substep("Working copy '#{dependency.config_entry.repo.path}' already exists, fetching...")
-        fetch_repo(dependency)
-      else
-        Console.log_substep("Cloning #{dependency.config_entry.url} into '#{dependency.config_entry.repo.path}'")
-        clone_repo(dependency)
-      end
-    end
-    
-    def fetch_repo(dependency)
-      unless dependency.config_entry.repo.fetch
-        raise MultiRepoException, "Could not fetch from remote #{dependency.config_entry.repo.remote('origin').url}"
-      end
-    end
-    
-    def clone_repo(dependency)
-      unless dependency.config_entry.repo.clone(dependency.config_entry.url, dependency.lock_entry.branch)
-        raise MultiRepoException, "Could not clone remote #{dependency.config_entry.url} with branch #{dependency.config_entry.branch}"
-      end
-    end
-    
-    # Validation
-    
-    def check_repo_validity(dependency)
-      unless dependency.config_entry.repo.remote("origin").url == dependency.config_entry.url
-        raise MultiRepoException, "'#{dependency.config_entry.path}' origin URL (#{dependency.config_entry.repo.remote('origin').url}) does not match entry (#{dependency.config_entry.url})!"
-      end
-    end
-  end
+require "terminal-table"
+
+require "multirepo/utility/console"
+require "multirepo/utility/utils"
+require "multirepo/git/repo"
+require "multirepo/logic/performer"
+require "multirepo/commands/checkout-command"
+
+module MultiRepo
+  class InstallCommand < Command
+    self.command = "install"
+    self.summary = "Clones and checks out dependencies as defined in the version-controlled multirepo metadata files and installs git-multirepo's local git hooks."
+    
+    def self.options
+      [
+        ['[--hooks]', 'Only install local git hooks.'],
+        ['[--ci]', 'Perform a continuous-integration-aware install (such as on a CI build server or agent).']
+      ].concat(super)
+    end
+    
+    def initialize(argv)
+      @hooks = argv.flag?("hooks")
+      @ci = argv.flag?("ci")
+      super
+    end
+    
+    def validate!
+      super
+      unless validate_only_one_flag(@hooks, @ci)
+        help! "You can't provide more than one operation modifier (--hooks, --ci, etc.)"
+      end
+    end
+        
+    def run
+      ensure_in_work_tree unless @ci
+      ensure_multirepo_tracked
+      
+      if @hooks
+        Console.log_step("Installing hooks in main repo and all dependencies...")
+        install_hooks_step
+      else
+        Console.log_step("Installing dependencies...")
+        log_ci_info if @ci
+        full_install
+      end
+      
+      Console.log_step("Done!")
+    end
+    
+    def log_ci_info
+      Console.log_warning("Performing continuous-integration-aware install")
+      Console.log_info("Using git-multirepo #{MultiRepo::VERSION}")
+      
+      main_repo = Repo.new(".")
+      main_repo_branch = main_repo.current_branch
+      meta_file = MetaFile.new(".").load
+
+      table = Terminal::Table.new do |t|
+        t.title = "Revision Info"
+        t.add_row ["Tracked Using", "git-multirepo #{meta_file.version}"]
+        t.add_separator
+        t.add_row ["Main Repo", commit_info(main_repo.head.commit_id, (main_repo_branch.name rescue nil))]
+        t.add_separator
+        LockFile.new(".").load_entries.each do |lock_entry|
+          branch_name = lock_entry.branch
+          t.add_row [lock_entry.name, commit_info(lock_entry.head, branch_name)]
+        end
+      end
+      puts table
+    end
+
+    def commit_info(commit_id, branch_name)
+      commit_id + (branch_name ? " (on branch #{branch_name})" : "")
+    end
+    
+    def full_install
+      install_dependencies_step
+      install_hooks_step unless @ci
+      update_gitconfigs_step unless @ci
+    end
+    
+    def install_dependencies_step
+      # Read config entries as-is on disk, without prior checkout
+      config_entries = ConfigFile.new(".").load_entries
+      Console.log_substep("Installing #{config_entries.count} dependencies...");
+      
+      # Clone or fetch all configured dependencies to make sure nothing is missing locally
+      Performer.dependencies.each { |d| clone_or_fetch(d) }
+      
+      # Checkout the appropriate branches as specified in the lock file
+      checkout_command = CheckoutCommand.new(CLAide::ARGV.new([]))
+      mode = @ci ? RevisionSelectionMode::AS_LOCK : RevisionSelectionMode::LATEST
+      checkout_command.dependencies_checkout_step(mode)
+    end
+    
+    def install_hooks_step
+      perform_in_main_repo_and_dependencies("Installed git hooks") { |repo| install_hooks(repo) }
+    end
+    
+    def update_gitconfigs_step
+      perform_in_main_repo_and_dependencies("Updated .git/config file") { |repo| update_gitconfig(repo) }
+    end
+    
+    def perform_in_main_repo_and_dependencies(message_prefix, &operation)
+      operation.call(".")
+      Console.log_substep("#{message_prefix} in main repo")
+      
+      multirepo_enabled_dependencies.each do |config_entry|
+        operation.call(config_entry.repo.path)
+        Console.log_substep("#{message_prefix} in multirepo-enabled dependency '#{config_entry.repo.path}'")
+      end
+    end
+    
+    # Repo operations
+    
+    def clone_or_fetch(dependency)
+      if dependency.config_entry.repo.exists?
+        check_repo_validity(dependency)
+        
+        Console.log_substep("Working copy '#{dependency.config_entry.repo.path}' already exists, fetching...")
+        fetch_repo(dependency)
+      else
+        Console.log_substep("Cloning #{dependency.config_entry.url} into '#{dependency.config_entry.repo.path}'")
+        clone_repo(dependency)
+      end
+    end
+    
+    def fetch_repo(dependency)
+      unless dependency.config_entry.repo.fetch
+        raise MultiRepoException, "Could not fetch from remote #{dependency.config_entry.repo.remote('origin').url}"
+      end
+    end
+    
+    def clone_repo(dependency)
+      unless dependency.config_entry.repo.clone(dependency.config_entry.url, dependency.lock_entry.branch)
+        raise MultiRepoException, "Could not clone remote #{dependency.config_entry.url} with branch #{dependency.config_entry.branch}"
+      end
+    end
+    
+    # Validation
+    
+    def check_repo_validity(dependency)
+      unless dependency.config_entry.repo.remote("origin").url == dependency.config_entry.url
+        raise MultiRepoException, "'#{dependency.config_entry.path}' origin URL (#{dependency.config_entry.repo.remote('origin').url}) does not match entry (#{dependency.config_entry.url})!"
+      end
+    end
+  end
 end

data/lib/multirepo/commands/merge-command.rb

@@ -1,226 +1,226 @@
-require "terminal-table"
-
-require "multirepo/utility/console" 
-require "multirepo/logic/node"
-require "multirepo/logic/revision-selector"
-require "multirepo/logic/performer"
-require "multirepo/logic/merge-descriptor"
-
-module MultiRepo
-  class MergeValidationResult
-    ABORT = 0
-    PROCEED = 1
-    MERGE_UPSTREAM = 2
-    
-    attr_accessor :outcome
-    attr_accessor :message
-  end
-  
-  class MergeCommand < Command
-    self.command = "merge"
-    self.summary = "Performs a git merge on all dependencies and the main repo, in the proper order."
-    
-    def self.options
-      [
-        ['<refname>', 'The main repo tag, branch or commit id to merge.'],
-        ['[--latest]', 'Merge the HEAD of each stored dependency branch instead of the commits recorded in the lock file.'],
-        ['[--exact]', 'Merge the exact specified ref for each repo, regardless of what\'s stored in the lock file.']
-      ].concat(super)
-    end
-    
-    def initialize(argv)
-      @ref_name = argv.shift_argument
-      @checkout_latest = argv.flag?("latest")
-      @checkout_exact = argv.flag?("exact")
-      super
-    end
-    
-    def validate!
-      super
-      help! "You must specify a ref to merge" unless @ref_name
-      unless validate_only_one_flag(@checkout_latest, @checkout_exact)
-        help! "You can't provide more than one operation modifier (--latest, --exact, etc.)"
-      end
-    end
-    
-    def run
-      ensure_in_work_tree
-      ensure_multirepo_enabled
-      
-      # Find out the checkout mode based on command-line options
-      mode = RevisionSelector.mode_for_args(@checkout_latest, @checkout_exact)
-      
-      strategy_name = RevisionSelectionMode.name_for_mode(mode)
-      Console.log_step("Merging #{@ref_name} with '#{strategy_name}' strategy...")
-      
-      main_repo = Repo.new(".")
-      
-      # Keep the initial revision because we're going to need to come back to it later
-      initial_revision = main_repo.current_revision
-      
-      begin
-        merge_core(main_repo, initial_revision, mode)
-      rescue MultiRepoException => e
-        # Revert to the initial revision only if necessary
-        unless main_repo.current_revision == initial_revision
-          Console.log_warning("Restoring working copy to #{initial_revision}")
-          main_repo.checkout(initial_revision)
-        end
-        raise e
-      end
-      
-      Console.log_step("Done!")
-    end
-    
-    def merge_core(main_repo, initial_revision, mode)
-      config_file = ConfigFile.new(".")
-      lock_file = LockFile.new(".")
-      
-      # Ensure the main repo is clean
-      raise MultiRepoException, "Main repo is not clean; merge aborted" unless main_repo.clean?
-      
-      # Ensure dependencies are clean
-      unless Utils.dependencies_clean?(config_file.load_entries)
-        raise MultiRepoException, "Dependencies are not clean; merge aborted"
-      end
-      
-      ref_name = @ref_name
-      descriptors = nil
-      loop do
-        # Gather information about the merges that would occur
-        descriptors = build_merge(main_repo, initial_revision, ref_name, mode)
-      
-        # Preview merge operations in the console
-        preview_merge(descriptors, mode, ref_name)
-        
-        # Validate merge operations
-        result = ensure_merge_valid(descriptors)
-        
-        case result.outcome
-        when MergeValidationResult::ABORT
-          raise MultiRepoException, result.message
-        when MergeValidationResult::PROCEED
-          raise MultiRepoException, "Merge aborted" unless Console.ask_yes_no("Proceed?")
-          Console.log_warning(result.message) if result.message
-          break
-        when MergeValidationResult::MERGE_UPSTREAM
-          Console.log_warning(result.message)
-          raise MultiRepoException, "Merge aborted" unless Console.ask_yes_no("Merge upstream instead of local branches?")
-          # TODO: Modify operations!
-          raise MultiRepoException, "Fallback behavior not implemented. Please merge manually."
-          next
-        end
-        
-        raise MultiRepoException, "Merge aborted" unless Console.ask_yes_no("Proceed?")
-      end
-      
-      Console.log_step("Performing merge...")
-      
-      # Merge dependencies and the main repo
-      perform_merges(descriptors)
-    end
-    
-    def build_merge(main_repo, initial_revision, ref_name, mode)
-      # List dependencies prior to checkout so that we can compare them later
-      our_dependencies = Performer.dependencies
-      
-      # Checkout the specified main repo ref to find out which dependency refs to merge
-      Performer.perform_main_repo_checkout(main_repo, ref_name, "Checked out main repo '#{ref_name}' to inspect to-merge dependencies")
-      
-      # List dependencies for the ref we're trying to merge
-      their_dependencies = Performer.dependencies
-      
-      # Checkout the initial revision ASAP
-      Performer.perform_main_repo_checkout(main_repo, initial_revision, "Checked out initial main repo revision '#{initial_revision}'")
-      
-      # Auto-merge would be too complex to implement (due to lots of edge cases)
-      # if the specified ref does not have the same dependencies. Better perform a manual merge.
-      ensure_dependencies_match(our_dependencies, their_dependencies)
-      
-      # Create a merge descriptor for each would-be merge as well as the main repo.
-      # This step MUST be performed in OUR revision for the merge descriptors to be correct!
-      descriptors = build_dependency_merge_descriptors(our_dependencies, their_dependencies, ref_name, mode)
-      descriptors.push(MergeDescriptor.new("Main Repo", main_repo, initial_revision, ref_name))
-      
-      return descriptors
-    end
-    
-    def build_dependency_merge_descriptors(our_dependencies, their_dependencies, ref_name, mode)
-      descriptors = []
-      our_dependencies.zip(their_dependencies).each do |our_dependency, their_dependency|
-        our_revision = our_dependency.config_entry.repo.current_revision
-        
-        their_revision = RevisionSelector.revision_for_mode(mode, ref_name, their_dependency.lock_entry)
-        their_name = their_dependency.config_entry.name
-        their_repo = their_dependency.config_entry.repo
-        
-        descriptor = MergeDescriptor.new(their_name, their_repo, our_revision, their_revision)
-        
-        descriptors.push(descriptor)
-      end
-      return descriptors
-    end
-    
-    def ensure_dependencies_match(our_dependencies, their_dependencies)
-      our_dependencies.zip(their_dependencies).each do |our_dependency, their_dependency|
-        if their_dependency == nil || their_dependency.config_entry.id != our_dependency.config_entry.id
-          raise MultiRepoException, "Dependencies differ, please merge manually"
-        end
-      end
-      
-      if their_dependencies.count > our_dependencies.count
-        raise MultiRepoException, "There are more dependencies in the specified ref, please merge manually"
-      end
-    end
-    
-    def preview_merge(descriptors, mode, ref_name)
-      Console.log_info("Merging would #{message_for_mode(mode, ref_name)}:")
-      
-      table = Terminal::Table.new do |t|
-        descriptors.reverse.each_with_index do |descriptor, index|
-          t.add_row [descriptor.name.bold, descriptor.merge_description, descriptor.upstream_description]
-          t.add_separator unless index == descriptors.count - 1
-        end
-      end
-      puts table
-    end
-    
-    def ensure_merge_valid(descriptors)
-      outcome = MergeValidationResult.new
-      outcome.outcome = MergeValidationResult::PROCEED
-      
-      if descriptors.any? { |d| d.state == TheirState::LOCAL_NO_UPSTREAM }
-        outcome.message = "Some branches are not remote-tracking! Please review the merge operations above."
-      elsif descriptors.any? { |d| d.state == TheirState::LOCAL_UPSTREAM_DIVERGED }
-        outcome.outcome = MergeValidationResult::ABORT
-        outcome.message = "Some upstream branches have diverged. This warrants a manual merge!"
-      elsif descriptors.any? { |d| d.state == TheirState::LOCAL_OUTDATED }
-        outcome.outcome = MergeValidationResult::MERGE_UPSTREAM
-        outcome.message = "Some local branches are outdated."
-      end
-      
-      return outcome
-    end
-    
-    def perform_merges(descriptors)
-      success = true
-      descriptors.each do |descriptor|
-        Console.log_substep("#{descriptor.name} : Merging #{descriptor.their_revision} into #{descriptor.our_revision}...")
-        GitRunner.run_in_working_dir(descriptor.repo.path, "merge #{descriptor.their_revision}", Runner::Verbosity::OUTPUT_ALWAYS)
-        success &= GitRunner.last_command_succeeded
-      end
-      Console.log_warning("Some merge operations failed. Please review the above results.") unless success
-    end
-    
-    def message_for_mode(mode, ref_name)
-      case mode
-      when RevisionSelectionMode::AS_LOCK
-        "merge specific commits as stored in the lock file for main repo revision #{ref_name}"
-      when RevisionSelectionMode::LATEST
-        "merge each branch as stored in the lock file of main repo revision #{ref_name}"
-      when RevisionSelectionMode::EXACT
-        "merge #{ref_name} for each repository, ignoring the contents of the lock file"
-      end
-    end
-  end
+require "terminal-table"
+
+require "multirepo/utility/console" 
+require "multirepo/logic/node"
+require "multirepo/logic/revision-selector"
+require "multirepo/logic/performer"
+require "multirepo/logic/merge-descriptor"
+
+module MultiRepo
+  class MergeValidationResult
+    ABORT = 0
+    PROCEED = 1
+    MERGE_UPSTREAM = 2
+    
+    attr_accessor :outcome
+    attr_accessor :message
+  end
+  
+  class MergeCommand < Command
+    self.command = "merge"
+    self.summary = "Performs a git merge on all dependencies and the main repo, in the proper order."
+    
+    def self.options
+      [
+        ['<refname>', 'The main repo tag, branch or commit id to merge.'],
+        ['[--latest]', 'Merge the HEAD of each stored dependency branch instead of the commits recorded in the lock file.'],
+        ['[--exact]', 'Merge the exact specified ref for each repo, regardless of what\'s stored in the lock file.']
+      ].concat(super)
+    end
+    
+    def initialize(argv)
+      @ref_name = argv.shift_argument
+      @checkout_latest = argv.flag?("latest")
+      @checkout_exact = argv.flag?("exact")
+      super
+    end
+    
+    def validate!
+      super
+      help! "You must specify a ref to merge" unless @ref_name
+      unless validate_only_one_flag(@checkout_latest, @checkout_exact)
+        help! "You can't provide more than one operation modifier (--latest, --exact, etc.)"
+      end
+    end
+    
+    def run
+      ensure_in_work_tree
+      ensure_multirepo_enabled
+      
+      # Find out the checkout mode based on command-line options
+      mode = RevisionSelector.mode_for_args(@checkout_latest, @checkout_exact)
+      
+      strategy_name = RevisionSelectionMode.name_for_mode(mode)
+      Console.log_step("Merging #{@ref_name} with '#{strategy_name}' strategy...")
+      
+      main_repo = Repo.new(".")
+      
+      # Keep the initial revision because we're going to need to come back to it later
+      initial_revision = main_repo.current_revision
+      
+      begin
+        merge_core(main_repo, initial_revision, mode)
+      rescue MultiRepoException => e
+        # Revert to the initial revision only if necessary
+        unless main_repo.current_revision == initial_revision
+          Console.log_warning("Restoring working copy to #{initial_revision}")
+          main_repo.checkout(initial_revision)
+        end
+        raise e
+      end
+      
+      Console.log_step("Done!")
+    end
+    
+    def merge_core(main_repo, initial_revision, mode)
+      config_file = ConfigFile.new(".")
+      lock_file = LockFile.new(".")
+      
+      # Ensure the main repo is clean
+      raise MultiRepoException, "Main repo is not clean; merge aborted" unless main_repo.clean?
+      
+      # Ensure dependencies are clean
+      unless Utils.dependencies_clean?(config_file.load_entries)
+        raise MultiRepoException, "Dependencies are not clean; merge aborted"
+      end
+      
+      ref_name = @ref_name
+      descriptors = nil
+      loop do
+        # Gather information about the merges that would occur
+        descriptors = build_merge(main_repo, initial_revision, ref_name, mode)
+      
+        # Preview merge operations in the console
+        preview_merge(descriptors, mode, ref_name)
+        
+        # Validate merge operations
+        result = ensure_merge_valid(descriptors)
+        
+        case result.outcome
+        when MergeValidationResult::ABORT
+          raise MultiRepoException, result.message
+        when MergeValidationResult::PROCEED
+          raise MultiRepoException, "Merge aborted" unless Console.ask_yes_no("Proceed?")
+          Console.log_warning(result.message) if result.message
+          break
+        when MergeValidationResult::MERGE_UPSTREAM
+          Console.log_warning(result.message)
+          raise MultiRepoException, "Merge aborted" unless Console.ask_yes_no("Merge upstream instead of local branches?")
+          # TODO: Modify operations!
+          raise MultiRepoException, "Fallback behavior not implemented. Please merge manually."
+          next
+        end
+        
+        raise MultiRepoException, "Merge aborted" unless Console.ask_yes_no("Proceed?")
+      end
+      
+      Console.log_step("Performing merge...")
+      
+      # Merge dependencies and the main repo
+      perform_merges(descriptors)
+    end
+    
+    def build_merge(main_repo, initial_revision, ref_name, mode)
+      # List dependencies prior to checkout so that we can compare them later
+      our_dependencies = Performer.dependencies
+      
+      # Checkout the specified main repo ref to find out which dependency refs to merge
+      Performer.perform_main_repo_checkout(main_repo, ref_name, "Checked out main repo '#{ref_name}' to inspect to-merge dependencies")
+      
+      # List dependencies for the ref we're trying to merge
+      their_dependencies = Performer.dependencies
+      
+      # Checkout the initial revision ASAP
+      Performer.perform_main_repo_checkout(main_repo, initial_revision, "Checked out initial main repo revision '#{initial_revision}'")
+      
+      # Auto-merge would be too complex to implement (due to lots of edge cases)
+      # if the specified ref does not have the same dependencies. Better perform a manual merge.
+      ensure_dependencies_match(our_dependencies, their_dependencies)
+      
+      # Create a merge descriptor for each would-be merge as well as the main repo.
+      # This step MUST be performed in OUR revision for the merge descriptors to be correct!
+      descriptors = build_dependency_merge_descriptors(our_dependencies, their_dependencies, ref_name, mode)
+      descriptors.push(MergeDescriptor.new("Main Repo", main_repo, initial_revision, ref_name))
+      
+      return descriptors
+    end
+    
+    def build_dependency_merge_descriptors(our_dependencies, their_dependencies, ref_name, mode)
+      descriptors = []
+      our_dependencies.zip(their_dependencies).each do |our_dependency, their_dependency|
+        our_revision = our_dependency.config_entry.repo.current_revision
+        
+        their_revision = RevisionSelector.revision_for_mode(mode, ref_name, their_dependency.lock_entry)
+        their_name = their_dependency.config_entry.name
+        their_repo = their_dependency.config_entry.repo
+        
+        descriptor = MergeDescriptor.new(their_name, their_repo, our_revision, their_revision)
+        
+        descriptors.push(descriptor)
+      end
+      return descriptors
+    end
+    
+    def ensure_dependencies_match(our_dependencies, their_dependencies)
+      our_dependencies.zip(their_dependencies).each do |our_dependency, their_dependency|
+        if their_dependency == nil || their_dependency.config_entry.id != our_dependency.config_entry.id
+          raise MultiRepoException, "Dependencies differ, please merge manually"
+        end
+      end
+      
+      if their_dependencies.count > our_dependencies.count
+        raise MultiRepoException, "There are more dependencies in the specified ref, please merge manually"
+      end
+    end
+    
+    def preview_merge(descriptors, mode, ref_name)
+      Console.log_info("Merging would #{message_for_mode(mode, ref_name)}:")
+      
+      table = Terminal::Table.new do |t|
+        descriptors.reverse.each_with_index do |descriptor, index|
+          t.add_row [descriptor.name.bold, descriptor.merge_description, descriptor.upstream_description]
+          t.add_separator unless index == descriptors.count - 1
+        end
+      end
+      puts table
+    end
+    
+    def ensure_merge_valid(descriptors)
+      outcome = MergeValidationResult.new
+      outcome.outcome = MergeValidationResult::PROCEED
+      
+      if descriptors.any? { |d| d.state == TheirState::LOCAL_NO_UPSTREAM }
+        outcome.message = "Some branches are not remote-tracking! Please review the merge operations above."
+      elsif descriptors.any? { |d| d.state == TheirState::LOCAL_UPSTREAM_DIVERGED }
+        outcome.outcome = MergeValidationResult::ABORT
+        outcome.message = "Some upstream branches have diverged. This warrants a manual merge!"
+      elsif descriptors.any? { |d| d.state == TheirState::LOCAL_OUTDATED }
+        outcome.outcome = MergeValidationResult::MERGE_UPSTREAM
+        outcome.message = "Some local branches are outdated."
+      end
+      
+      return outcome
+    end
+    
+    def perform_merges(descriptors)
+      success = true
+      descriptors.each do |descriptor|
+        Console.log_substep("#{descriptor.name} : Merging #{descriptor.their_revision} into #{descriptor.our_revision}...")
+        GitRunner.run_as_system(descriptor.repo.path, "merge #{descriptor.their_revision}")
+        success &= GitRunner.last_command_succeeded
+      end
+      Console.log_warning("Some merge operations failed. Please review the above results.") unless success
+    end
+    
+    def message_for_mode(mode, ref_name)
+      case mode
+      when RevisionSelectionMode::AS_LOCK
+        "merge specific commits as stored in the lock file for main repo revision #{ref_name}"
+      when RevisionSelectionMode::LATEST
+        "merge each branch as stored in the lock file of main repo revision #{ref_name}"
+      when RevisionSelectionMode::EXACT
+        "merge #{ref_name} for each repository, ignoring the contents of the lock file"
+      end
+    end
+  end
 end