jgarber-capistrano-deepmodules 0.2

data/README

@@ -0,0 +1,27 @@
+This plugin allows your Capistrano to deploy git repositories those have
+multiple-level nested submodules in them.
+
+By default Capistrano issues git submodule init && git submodule update
+commands only at the repository root, those initializion first-level 
+submodules. But if those submodules has their own submodules, your application
+will fail as they will stay uninitialized. This plugin fixes it and 
+automatically checks for all included submodules (and their submodules, and 
+their, etc) and initializes them, too.
+
+Usage is very simple - just install this gem and add following requirement to 
+your deployment scenario:
+
+require 'capistrano/deepmodules'
+
+Also make sure that you're using remote cache to deploy your code as current
+only remote cache strategy is supported:
+
+set :deploy_via, :remote_cache
+
+I see no reason not to use it, especially on large codebases with a lot of
+submodules, so currently this plugin does not support other strategies. If
+you need such support - drop me a note and I'll if it's plausible.
+
+And you don't need to set :git_enable_submodules parameter in your scenario -
+it doesn't affect operations if this plugin as it pays no attention to it.
+If you want to disable submodules - just comment out 'require' line.

data/capistrano-deepmodules.gemspec

@@ -0,0 +1,21 @@
+Gem::Specification.new do |s|
+  s.name = 'capistrano-deepmodules'
+  s.version = "0.2"
+  s.date     = "2009-03-01"
+  s.summary = "Capistrano plugin to deploy Git repos with nested submodules."
+  s.description = %{This plugin allows you to easily deploy git repositories with
+  submodules nested at more then one level.%}
+  s.has_rdoc = false
+  
+  s.files = ['lib/capistrano/deepmodules.rb',
+    'capistrano-deepmodules.gemspec',
+    'README'
+  ]
+
+  s.require_path = 'lib'
+
+  s.author = "Oleg Ivanov"
+  s.email = "morhekil@morhekil.net"
+  s.homepage = "http://speakmy.name"
+  s.rubyforge_project = 'capistrano-deepmodules'
+end

data/lib/capistrano/deepmodules.rb

@@ -0,0 +1,68 @@
+require 'capistrano/recipes/deploy/scm/git'
+require 'capistrano/recipes/deploy/strategy/remote_cache'
+
+unless Capistrano::Configuration.respond_to?(:instance)
+  abort "capistrano/deepmodules requires Capistrano 2"
+end
+
+module Capistrano
+  module Deploy
+    
+    module SCM
+      class Git < Base
+
+        # Simple interface to submodule commands
+        def submodule(subcmd)
+          "#{command} submodule #{subcmd}"
+        end
+    
+      end
+    end
+
+
+    module Strategy
+
+      class RemoteCache < Remote
+        # Executes the SCM command for this strategy and writes the REVISION
+        # mark file to each host.
+        # We're overriding default deploy! method to inject a call to deep
+        # update the nested modules
+        def deploy!
+          update_repository_cache
+          update_submodules(repository_cache)
+          copy_repository_cache
+        end
+
+        private
+
+          # Inits and updates submodules in the repository at the path given 
+          # via the argument, then recursively descends into all found 
+          # submodule and updated them and all their down-levels, too
+          def update_submodules(dir)
+            logger.trace "updating submodule at #{dir}"
+
+            submodules = Array.new
+            run("cd #{dir} && #{source.submodule('status')}") do |state, stream, text|
+              # parsing the output of "git submodule status" command
+              # and collecting paths of all submodules into an array
+              submodules += text.split(/\n/).collect do |submodule|
+                $~[1] if submodule.rstrip =~ /.\w{40} ([^()]+)($| \(.*\)$)/
+              end
+            end
+
+            if submodules.size > 0 then
+              # init and update submodules if they were found
+              scm_run("cd #{dir} && "+
+                "#{source.submodule('init')} && "+
+                "#{source.submodule('update')} "
+              )
+              # and descend into them to repeat the process recursively
+              submodules.each { |submodule| update_submodules("#{dir}/#{submodule}") }
+            end
+
+          end
+      end
+
+    end
+  end
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification 
+name: jgarber-capistrano-deepmodules
+version: !ruby/object:Gem::Version 
+  version: "0.2"
+platform: ruby
+authors: 
+- Oleg Ivanov
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-03-01 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: This plugin allows you to easily deploy git repositories with submodules nested at more then one level.%
+email: morhekil@morhekil.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/capistrano/deepmodules.rb
+- capistrano-deepmodules.gemspec
+- README
+has_rdoc: false
+homepage: http://speakmy.name
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: capistrano-deepmodules
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Capistrano plugin to deploy Git repos with nested submodules.
+test_files: []
+