metaverse 0.2.rc1 → 0.2.rc2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 728ccb915c07d528cb4aa047d5cbfe124921733a
-  data.tar.gz: 8b29aa1a599b73554f73730be8a66905de367af9
+  metadata.gz: 708f891e0a48058bf390887594a82e99c05bd13e
+  data.tar.gz: 116dce5ac37a3fc4652faea5ed7978bbd89762cb
 SHA512:
-  metadata.gz: eb818e909547acce5e08080770f4675148a9397770fc437fa61fe3edb35db96f6cdae82f2705317ee7dd9b688da6894fca09f46de840c852f0a14078c69eb72d
-  data.tar.gz: 0ded1e37a022419ddc622f0e0497350ed4c06c38d5e8fcd3fe176c13b2e9d1fa006c89a2b04f0cfbe3cfdc603f1c81fdcc83ff5abbec12655e53ab9ce019b5d1
+  metadata.gz: 403699eebdc051b8b59fe60bd93184f19bdc84f548b664e6daec0f273d799d13010628c051d80671062491994ed0aebafbea39bd8c440eaf4eacf2aa5860bc02
+  data.tar.gz: b96456e8d007bc460d197c64f8829c3f03f87b93490aab0b87e6cc137363a97857ffed6d49d15e67b9115d4afc32d5bdadd5808308c1cf35cbf3995808e47298

data/README.md

@@ -5,6 +5,17 @@ Metaverse multirepo management revolves around two main axes of functionality:
 * Workflow related functionality
 * State Management
 
+# Installation
+
+Metaverse requires `rugged` which in turns relies on a bundled `libgit2` which 
+is a Ruby native extension.
+
+### OSX
+
+You need Cmake and pkg-config. If you have brew you can install by running :
+
+`brew install cmake pkg-config`
+
 # 1 - Workflow
 ## Utilities
 ### Checkout
@@ -31,6 +42,12 @@ Pulls the changes from the main remote in every repo - similar to `git pull orig
 
 Displays the branch at which every repo is.
 
+### Exec
+`meta exec COMMAND`
+
+Runs the specified shell command in every repo's working directory. Also passes
+the ENV used to invoke it to the shell command.
+
 ## Features
 ### New
 `meta feature new FEATURE_NAME`

data/lib/metaverse/base.rb

@@ -3,14 +3,21 @@ require 'colorize'
 require 'yaml'
 require 'metaverse/repo'
 require 'metaverse/iterator'
+require 'metaverse/errors'
+require 'transacted'
 
 module Metaverse
   class Base
     def initialize path
       @logger = Logger.new STDOUT
+      @base_path = path
       read_config "#{path}/.meta.yml"
-      @repos_paths = Metaverse::Iterator.new path, @ignored_repos
-      @repos_paths.build
+      @repos_paths = Metaverse::Iterator.new path, @ignored_repos, @repos_paths
+      if @repos_paths.empty?
+        @repos_paths.build 
+        save_config "#{path}/.meta.yml"
+        puts "Repos cache built.".green
+      end      
       @repos = @repos_paths.map {|repo| Metaverse::Repo.new repo}
     end
 
@@ -20,7 +27,27 @@ module Metaverse
 
 
     def checkout name
-      @repos.each { |repo| repo.checkout name } if check_dirtiness
+      action_options = -> (repo) {
+        {
+          up: -> { repo.checkout name },
+          down: -> { repo.checkout repo.pop_previous_branch }
+        }
+      }
+
+      if check_dirtiness
+        actions = @repos.map {|repo| 
+          puts "\n # #{repo.name}".blue
+          Transacted::Action.new action_options.call(repo)
+        }
+
+        checkout_transaction = Transacted::Transaction.new actions
+        case checkout_transaction.execute
+        when :execution_success then puts "Checkout successful".green
+        when :rollback_success then puts "An error prevented checking out the system. Rolled back successfully".yellow
+        when :rollback_failure then puts "An error was encountered during the checkout. In addition, an error happened while trying to rollback the system. Please fix the state of your system manually.".red
+        end
+      end
+        
     end
 
     def create_state prefix, state
@@ -28,24 +55,46 @@ module Metaverse
         puts "\n # #{repo.name}".blue
         repo.create_state prefix, state
         repo.checkout "#{prefix}/#{state}" if not prefix == "snapshot"
-      }
+      } if check_dirtiness
     end
 
 
-    def load_state prefix, state, remote = nil
-      @repos.each { |repo|
-        puts "\n # #{repo.name}".blue
-        repo.load_state prefix, state, remote
+    def load_state prefix, state, remote = nil, should_create_branch = false
+      action_options = -> (repo) {
+        {
+          up: -> { 
+            puts "\n # #{repo.name}".blue
+            repo.load_state prefix, state, remote, should_create_branch
+          },
+          down: -> { 
+            puts "\n # Rolling back in #{repo.name}".blue
+            puts repo.checkout repo.pop_previous_branch
+          }
+        }
       }
+
+      if check_dirtiness
+        
+        actions = @repos.map { |repo|
+          Transacted::Action.new action_options.call repo
+        }
+
+        load_state_transaction = Transacted::Transaction.new actions
+        case load_state_transaction.execute
+        when :execution_success then puts "Loading state successful".green
+        when :rollback_success then puts "An error prevented loading the state of the system. Rolled back successfully".yellow
+        when :rollback_failure then puts "An error was encountered during the loading of the state. In addition, an error happened while trying to rollback the system. Please fix the state of your system manually.".red
+        end
+      end
     end
 
 
-    def send_state prefix, state, remote
+    def send_state prefix, state, remote, should_clean = false
       @repos.each { |repo|
         puts "\n # #{repo.name}".blue
         is_branch = repo.current_branch.match /refs\/heads\/(.*)/
-        repo.send_state prefix, state, remote, !!is_branch
-      }
+        repo.send_state prefix, state, remote, !!is_branch, should_clean
+      } if check_dirtiness
     end
 
 
@@ -53,7 +102,7 @@ module Metaverse
       @repos.each { |repo|
         puts "\n # #{repo.name}".blue
         repo.update remote
-      }
+      } if check_dirtiness
     end
 
 
@@ -84,14 +133,52 @@ module Metaverse
     end
 
     def read_config path
+      Errors::config_not_found! if not File.exist? path
+
       config = YAML.load File.open(path)
+      @repos_paths = config['repos'] || []
       @origin_remote = config['remotes']['main']
       @own_remote = config['remotes']['own']
       @ignored_repos = config['ignore'] || []
     end
 
+    def save_config path
+      config = {
+        'repos' => @repos_paths.map{ |repo| repo },
+        'remotes'=> {
+          'main' => @origin_remote,
+          'own' => @own_remote
+        },
+        'ignore' => @ignored_repos
+      }
+      File.open(path, 'w') {|f| f.write config.to_yaml }
+    end
+
+    def clear_repos
+      @repos_paths = []
+      save_config "#{@base_path}/.meta.yml"
+      puts "Repos cache cleared.".green
+    end
+
     def pull
-      @repos.each { |repo| repo.pull @origin_remote }
+      @repos.each { |repo|
+        puts "\n # #{repo.name}".blue
+        repo.pull @origin_remote
+      } if check_dirtiness
+    end
+
+    def add_remote name, base_url
+      @repos.each { |repo|
+        puts "\n # #{repo.name}".blue
+        repo.add_remote name, "#{base_url}/#{repo.name}"
+      }
+    end
+
+    def exec env, command
+      @repos.each { |repo|
+        puts "\n # #{repo.name}".blue
+        repo.exec env, command
+      }
     end
   end
 end

data/lib/metaverse/cli.rb

@@ -8,6 +8,12 @@ module Metaverse
       @meta = Base.new Dir.pwd
     end
 
+    desc "reset", "Empties the repos cache"
+    def reset
+      init
+      @meta.clear_repos
+    end
+
     desc "branches", "Displays the branch in which each repo is"
     def branches
       init
@@ -25,34 +31,40 @@ module Metaverse
     end
 
     desc "feature [COMMAND] [FEATURE_NAME]", "Creates a new feature branch or loads a previous one"
+    option :branch, type: :boolean, aliases: '-b'
     def feature command, name, remote = nil
       init
       case command
         when 'new' then @meta.create_state 'feature', name
-        when 'load' then @meta.load_state 'feature', name, remote
+        when 'load' then @meta.load_state 'feature', name, remote, options[:branch]
         when 'send' then @meta.send_state 'feature', name, remote
+        when 'close' then @meta.send_state 'feature', name, remote, true
       end
     end
 
 
     desc "release [COMMAND] [FEATURE_NAME]", "Creates a new release branch or loads a previous one"
+    option :branch, type: :boolean, aliases: '-b'
     def release command, name, remote = nil
       init
       case command
         when 'new' then @meta.create_state 'release', name
-        when 'load' then @meta.load_state 'release', name, remote
+        when 'load' then @meta.load_state 'release', name, remote, options[:branch]
         when 'send' then @meta.send_state 'release', name, remote
+        when 'close' then @meta.send_state 'release', name, remote, true
       end
     end
 
 
     desc "bugfix [COMMAND] [FEATURE_NAME]", "Creates a new bugfix branch or loads a previous one"
+    option :branch, type: :boolean, aliases: '-b'
     def bugfix command, name, remote = nil
       init
       case command
         when 'new' then @meta.create_state 'bugfix', name
-        when 'load' then @meta.load_state 'bugfix', name, remote
+        when 'load' then @meta.load_state 'bugfix', name, remote, options[:branch]
         when 'send' then @meta.send_state 'bugfix', name, remote
+        when 'close' then @meta.send_state 'bugfix', name, remote, true
       end
     end
 
@@ -94,5 +106,19 @@ module Metaverse
       init
       @meta.pull
     end
+
+    desc "remote [COMMAND]", "manages repos remotes such as adding new ones"
+    def remote command, name, url
+      init
+      case command
+      when 'add' then @meta.add_remote name, url
+      end
+    end
+
+    desc "exec [COMMAND]", "runs the specified shell command in every repo"
+    def exec *command
+      init
+      @meta.exec ENV, command.join(' ')
+    end
   end
 end

data/lib/metaverse/errors.rb

@@ -0,0 +1,21 @@
+require 'colorize'
+
+module Metaverse
+  class Errors
+    def self.config_not_found!
+      abort ".meta.yml file was not found in the current working directory. Exiting ...".red
+    end
+
+    def self.ref_not_found ref
+      return Exception.new "Reference '#{ref}' does not exist.".red
+    end
+
+    def self.remote_not_found remote
+      puts "Remote '#{remote}' does not exist. Skipping ...".red
+    end
+
+    def self.remote_exists remote
+      puts "Remote '#{remote}' exists already. Skipping ...".red
+    end
+  end
+end

data/lib/metaverse/iterator.rb

@@ -37,5 +37,9 @@ module Metaverse
     def map &block
       @repos.send(:map, &block)
     end
+
+    def empty?
+      @repos.count == 0
+    end
   end
 end

data/lib/metaverse/repo.rb

@@ -1,4 +1,5 @@
-require 'metaverse/git'
+require 'rugged'
+require 'iniparse'
 
 module Metaverse
   class Repo
@@ -8,6 +9,7 @@ module Metaverse
 
     def initialize path
       load path
+      @previous_branches = []
     end
 
 
@@ -26,16 +28,46 @@ module Metaverse
       File.basename @repo.workdir
     end
 
+    def workdir
+      @repo.workdir
+    end
 
     def checkout ref
-      @repo.checkout ref
+      if @repo.branches[ref].nil?
+        is_reference = false 
+        if Rugged::Reference.valid_name?(ref) and @repo.references[ref].nil?
+          raise Errors::ref_not_found ref
+        end
+      end
+
+      @previous_branches.push current_branch
+      Dir.chdir(@repo.workdir) do
+        `git checkout #{ref}`#TODO: find out what's going on, check out a branch
+      end
     end
 
 
     def current_branch
-      @repo.head.name
+      branch_name = ''
+
+      Dir.chdir(@repo.workdir) do
+        branch_name = `git branch | sed -n '/\* /s///p'`
+      end
+
+      if branch_name.include? "detached"
+        return /[A-Za-z0-9._-]+(?:\/[A-Za-z0-9._-]+)+/.match(branch_name)[0]
+      end
+
+      branch_name.strip
     end
 
+    def peek_previous_branch
+      @previous_branches.last
+    end
+
+    def pop_previous_branch
+      @previous_branches.pop
+    end
 
     def head
       @repo.head
@@ -68,34 +100,60 @@ module Metaverse
     end
 
 
-    def load_state prefix, state, remote = nil
-      path_prefix = "refs/meta"
-      path_prefix += "/local" if remote.nil?
-      path_prefix += "/remotes/#{remote}" if not remote.nil?
-      ref_name = "/#{prefix}/#{state}"
-      @repo.checkout path_prefix + ref_name
+    def load_state prefix, state, remote = nil, should_create_branch = false
+      ref_name = "refs/meta"
+      ref_name += remote.nil? ? "/local" : "/remotes/#{remote}"
+      ref_name += "/#{prefix}/#{state}"
+      if should_create_branch
+        branch_name = "#{prefix}/#{state}"
+        # TODO: Decide what to do when a branch exists previous. Should we :
+        # - Replace it's ref by the saved state ? ( We lose the previous branch reference)
+        # - Load it as it is ( We may get an inconsistent state since the branch could point to a different commit than the state reference )
+        if @repo.branches[branch_name].nil?
+          puts "Creating branch #{branch_name} based on #{ref_name}"
+          @repo.create_branch branch_name, ref_name
+        end
+        return checkout branch_name
+      end
+      checkout ref_name
     end
 
 
-    def send_state prefix, state, remote, is_branch
+    def send_state prefix, state, remote, is_branch, should_clean = false
       refs = ["refs/meta/local/#{prefix}/#{state}"]
-      if (not prefix == 'snapshot') and is_branch and clean_branch prefix, state
-          refs << "#{prefix}/#{state}"
-          update_ref refs[0], @repo.head
+      branch_name = "#{prefix}/#{state}"
+      branch = @repo.branches[branch_name]
+      develop = @repo.branches['develop']
+
+      if branch.nil?
+        Errors::ref_not_found branch_name
+        return false
       end
+
+      if develop.nil?
+        Errors::ref_not_found 'develop'
+        return false
+      end
+
+      if (not prefix == 'snapshot') and is_branch and ahead_of_develop? branch
+          refs << branch_name
+          update_ref refs[0], @repo.branches[branch_name]
+      end
+
+      clean_branch branch if should_clean
+
       Dir.chdir(@repo.workdir) do
         `git push #{remote} #{refs.join(' ')}`
       end
     end
 
 
-    def clean_branch prefix, state
-      target_branch = @repo.branches["#{prefix}/#{state}"]
+    def clean_branch branch
 
-      changed = has_changes? target_branch, @repo.branches['develop']
+      changed = ahead_of_develop? branch
       if not changed
-        @repo.checkout 'develop'
-        @repo.branches.delete target_branch
+        checkout 'develop'
+        @repo.branches.delete branch
       end
       changed
     end
@@ -103,13 +161,17 @@ module Metaverse
     def dirty?
       is_dirty = false
       @repo.status { |file, data|
-        is_dirty = !(data.include? :ignored) or is_dirty
+        next if data == [:ignored]
+        is_dirty = true
       }
       is_dirty
     end
 
 
     def update remote = nil
+      if @repo.remotes[remote].nil?
+        return Errors::remote_not_found remote
+      end
       Dir.chdir(@repo.workdir) do
         `git remote update #{remote}`
       end
@@ -117,10 +179,11 @@ module Metaverse
 
 
     def add_option_to_remote remote, value, key
-      cfg = IniParse.parse(File.read("#{@repo.path}/config"))
+      config_path = "#{@repo.path}config"
+      cfg = IniParse.parse(File.read(config_path))
       if not [*cfg["remote \"#{remote}\""][key]].include? value
         cfg["remote \"#{remote}\""][key] = [*cfg["remote \"#{remote}\""][key], value]
-        cfg.save "#{@path}/config"
+        cfg.save config_path
       end
     end
 
@@ -130,8 +193,28 @@ module Metaverse
     end
 
 
+    def ahead_of_develop? branch
+      has_changes? branch, @repo.branches['develop']
+    end
+
     def pull remote
-      `git pull #{remote}`
+      if @repo.remotes[remote].nil?
+        return Errors::remote_not_found remote
+      end
+      Dir.chdir(@repo.workdir) do
+        `git pull #{remote} #{current_branch}`
+      end
+    end
+
+    def add_remote name, url
+      return Errors::remote_exists name if not @repo.remotes[name].nil?
+      @repo.remotes.create name, url
+    end
+
+    def exec env, command
+      Dir.chdir(@repo.workdir) do
+        system env, command
+      end
     end
   end
 end

data/lib/metaverse/version.rb

@@ -1,3 +1,3 @@
 module Metaverse
-  VERSION = "0.2.rc1"
+  VERSION = "0.2.rc2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: metaverse
 version: !ruby/object:Gem::Version
-  version: 0.2.rc1
+  version: 0.2.rc2
 platform: ruby
 authors:
 - Omar Kamali
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-03-26 00:00:00.000000000 Z
+date: 2015-04-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -115,6 +115,7 @@ files:
 - lib/metaverse.rb
 - lib/metaverse/base.rb
 - lib/metaverse/cli.rb
+- lib/metaverse/errors.rb
 - lib/metaverse/iterator.rb
 - lib/metaverse/repo.rb
 - lib/metaverse/version.rb