sentia-capistrano-gitflow 1.4.3

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/Gemfile

@@ -0,0 +1,3 @@
+source :rubygems
+
+gemspec

data/README.rdoc

@@ -0,0 +1,111 @@
+= gitflow: a Capistrano recipe for git deployment using tags in a multistage environment.
+
+The best thing about this recipe is that there is almost nothing to learn -- your cap deploy process barely changes.
+Gitflow simply adds some tagging/logging/workflow magic.
+
+    # BEFORE
+    $ cap deploy              # 'master' goes to staging
+    $ cap production deploy   # 'master' goes to production
+
+    # AFTER
+    $ cap deploy                                                          
+    # 'master' goes to staging; tag staging-YYYY-MM-DD.X created
+
+    $ cap production deploy
+    # deploys latest staging tag, or if last tag is a production tag then that, to production
+    # displays a commit log of what will be pushed to production, requests confirmation before deploying
+    # tag 'staging-YYYY-MM-DD-X' goes to production
+    # tag 'production-YYYY-MM-DD-X' created; points to staging-YYYY-MM-DD-X
+
+    # BONUS
+    $ cap gitflow:commit_log              
+    # displays a commit log pushed to staging
+    
+    $ cap production gitflow:commit_log   
+    # displays a commit log of what will be pushed to production
+
+== INSTALLATION
+
+First, install the gem:
+
+    gem install capistrano-gitflow
+
+Then update config/deploy.rb
+
+    require 'capistrano/ext/multistage'
+    require 'capistrano/gitflow' # needs to come after multistage
+
+More info at: http://rubygems.org/gems/capistrano-gitflow
+
+== DETAILS
+
+After experimenting with several workflows for deployment in git, I've finally found one I really like.
+
+* You can push to staging at any time; every staging push is automatically tagged with a unique tag.
+* You can only push a staging tag to production. This helps to enforce QA of all pushes to production.
+
+=== PUSH TO STAGING
+
+Whenever you want to push the currently checked-out code to staging, just do:
+
+    cap staging deploy
+
+gitflow will automatically:
+
+* create a unique tag in the format of 'staging-YYYY-MM-DD.X'
+* configure multistage to use that tag for the deploy
+* push the code and tags to the remote "origin"
+* and run the normal deploy task for the staging stage.
+
+=== PUSH TO PRODUCTION:
+
+Whenever you want to push code to production, just do:
+
+    cap production deploy
+
+gitflow will automatically:
+
+* determine the last staging tag created, show a commit log of last-production-tag..last-staging-tag
+* (alternatively, specify the tag to push to production via `-s tag=staging-YYYY-MM-DD-X-user-description`
+* prompt for confirmation of deploy
+* alias the staging tag to a production tag like: production-2008-09-08.2
+* configure multistage to use that tag for the deploy
+* push the code and tags to the remote "origin"
+* and run the normal deploy task for the production stage.
+
+=== NOTES:
+
+* you may need to wipe out the cached-copy on the remote server that cap uses when switching to this workflow; I have seen situations where the cached copy cannot cleanly checkout to the new branch/tag. it's safe to try without wiping it out first, it will fail gracefully.
+* if your stages already have a "set :branch, 'my-staging-branch'" call in your configs, remove it. This workflow configures it automatically.
+
+== CREDIT
+
+Originally created by Alan Pinstein.
+
+Gemified and hacked by Josh Nichols.
+
+== LICENSE
+
+MIT licensed.
+
+Copyright (c) 2009-2011 Alan Pinstein <apinstein@mac.com>
+
+Copyright (c) 2010-2011 Josh Nichols
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,30 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "sentia-capistrano-gitflow"
+    gem.summary = %Q{Capistrano recipe for a deployment workflow based on git tags. This gem was originally created by Joshua Nichols and modified by Mario Visic at Sentia Australia. }
+    gem.description = %Q{Capistrano recipe for a deployment workflow based on git tags. This gem was originally created by Joshua Nichols and modified by Mario Visic at Sentia Australia.}
+    gem.email = "mario.visic@sentia.com.au"
+    gem.homepage = "https://github.com/Sentia/git-deployment"
+    gem.authors = ["Joshua Nichols", "Mario Visic"]
+    gem.add_dependency "capistrano"
+    gem.add_dependency "stringex"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "gitflow #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+1.4.3

data/lib/sentia/capistrano/gitflow.rb

@@ -0,0 +1,198 @@
+require 'capistrano'
+require File.join(File.dirname(__FILE__), 'gitflow', 'natcmp')
+require 'stringex'
+
+module Capistrano
+  class Gitflow
+    def self.load_into(capistrano_configuration)
+      capistrano_configuration.load do
+        before "deploy:update_code", "gitflow:calculate_tag"
+        before "gitflow:calculate_tag", "gitflow:verify_up_to_date"
+
+        namespace :gitflow do
+          def last_tag_matching(pattern)
+            # search for most recent (chronologically) tag matching the passed pattern, then get the name of that tag.
+            last_tag = `git describe --exact-match --match '#{pattern}' \`git log --tags='#{pattern}*' --format="%H" -1\``.chomp
+            return nil if last_tag == ''
+            return last_tag
+          end
+
+          def last_staging_tag()
+            last_tag_matching('staging-*')
+          end
+
+          def next_staging_tag
+            hwhen = Date.today.strftime('%Y%m%d')
+            who   = `whoami`.chomp.to_url
+
+            last_staging_tag = last_tag_matching("staging-#{hwhen}-*")
+            new_tag_serial = if last_staging_tag && last_staging_tag =~ /staging-[0-9]{8}\-([0-9]*)/
+                               $1.to_i + 1
+                             else
+                               1
+                             end
+            new_tag_serial = new_tag_serial.to_s.rjust(2, '0') # Pad with a leading zero
+
+            "#{stage}-#{hwhen}-#{new_tag_serial}-#{who}"
+          end
+
+          def last_production_tag()
+            last_tag_matching('production-*')
+          end
+
+          def using_git?
+            fetch(:scm, :git).to_sym == :git
+          end
+
+          task :verify_up_to_date do
+            if using_git?
+              set :local_branch, `git branch --no-color 2> /dev/null | sed -e '/^[^*]/d'`.gsub(/\* /, '').chomp
+              set :local_sha, `git log --pretty=format:%H HEAD -1`.chomp
+              set :origin_sha, `git log --pretty=format:%H #{local_branch} -1`
+              unless local_branch == '(no branch)' || local_sha == origin_sha
+                abort """
+Your #{local_branch} branch is not up to date with origin/#{local_branch}.
+Please make sure you have pulled and pushed all code before deploying:
+
+    git pull origin #{local_branch}
+    # run tests, etc
+    git push origin #{local_branch}
+
+    """
+              end
+            end
+          end
+
+          desc "Calculate the tag to deploy"
+          task :calculate_tag do
+            if using_git?
+              # make sure we have any other deployment tags that have been pushed by others so our auto-increment code doesn't create conflicting tags
+              `git fetch`
+
+              if respond_to?("tag_#{stage}")
+                send "tag_#{stage}"
+
+                system "git push origin #{branch}"
+                if $? != 0
+                  abort "git push failed"
+                end
+              else
+                  puts "Will deploy tag: #{local_branch}"
+                  set :branch, local_branch
+              end
+            end
+          end
+
+          desc "Show log between most recent staging tag (or given tag=XXX) and last production release."
+          task :commit_log do
+            from_tag = if stage == :production
+                         last_production_tag
+                       elsif stage == :staging
+                         last_staging_tag
+                       else
+                         abort "Unsupported stage #{stage}"
+                       end
+
+            # no idea how to properly test for an optional cap argument a la '-s tag=x'
+            to_tag = capistrano_configuration[:tag]
+            to_tag ||= begin 
+                         puts "Calculating 'end' tag for :commit_log for '#{stage}'"
+                         to_tag = if stage == :production
+                                    last_staging_tag
+                                  elsif stage == :staging
+                                    'master'
+                                  else
+                                    abort "Unsupported stage #{stage}"
+                                  end
+                       end
+
+
+            # use custom compare command if set
+            if ENV['git_log_command'] && ENV['git_log_command'].strip != ''
+                command = "git #{ENV['git_log_command']} #{from_tag}..#{to_tag}"
+            else
+                # default compare command
+                # be awesome for github
+                if `git config remote.origin.url` =~ /git@github.com:(.*)\/(.*).git/
+                    command = "open https://github.com/#{$1}/#{$2}/compare/#{from_tag}...#{to_tag}"
+                else
+                    command = "git log #{from_tag}..#{to_tag}"
+                end
+            end
+            puts "Displaying commits from #{from_tag} to #{to_tag} via:\n#{command}"
+            system command
+
+            puts ""
+          end
+
+          desc "Mark the current code as a staging/qa release"
+          task :tag_staging do
+            current_sha = `git log --pretty=format:%H HEAD -1`
+            last_staging_tag_sha = if last_staging_tag
+                                     `git log --pretty=format:%H #{last_staging_tag} -1`
+                                   end
+
+            if last_staging_tag_sha == current_sha
+              puts "Not re-tagging staging because latest tag (#{last_staging_tag}) already points to HEAD"
+              new_staging_tag = last_staging_tag
+            else
+              new_staging_tag = next_staging_tag
+              puts "Tagging current branch for deployment to staging as '#{new_staging_tag}'"
+              system "git tag -a -m 'tagging current code for deployment to staging' #{new_staging_tag}"
+            end
+
+            set :branch, new_staging_tag
+          end
+
+          desc "Push the approved tag to production. Pass in tag to deploy with '-s tag=staging-YYYY-MM-DD-X-feature'."
+          task :tag_production do
+            promote_to_production_tag = capistrano_configuration[:tag] || last_staging_tag
+
+            unless promote_to_production_tag && promote_to_production_tag =~ /staging-.*/
+              abort "Couldn't find a staging tag to deploy; use '-s tag=staging-YYYY-MM-DD.X'"
+            end
+            unless last_tag_matching(promote_to_production_tag)
+              abort "Staging tag #{promote_to_production_tag} does not exist."
+            end
+
+            promote_to_production_tag =~ /^staging-(.*)$/
+            new_production_tag = "production-#{$1}"
+
+            if new_production_tag == last_production_tag
+              puts "Not re-tagging #{last_production_tag} because it already exists"
+              really_deploy = Capistrano::CLI.ui.ask("Do you really want to deploy #{last_production_tag}? [y/N]").to_url
+
+             exit(1) unless really_deploy =~ /^[Yy]$/
+            else
+              puts "Preparing to promote staging tag '#{promote_to_production_tag}' to '#{new_production_tag}'"
+              gitflow.commit_log
+              unless capistrano_configuration[:tag]
+                really_deploy = Capistrano::CLI.ui.ask("Do you really want to deploy #{new_production_tag}? [y/N]").to_url
+
+                exit(1) unless really_deploy =~ /^[Yy]$/
+              end
+              puts "Promoting staging tag #{promote_to_production_tag} to production as '#{new_production_tag}'"
+              system "git tag -a -m 'tagging current code for deployment to production' #{new_production_tag} #{promote_to_production_tag}"
+            end
+
+            set :branch, new_production_tag
+          end
+        end
+
+        namespace :deploy do
+          namespace :pending do
+            task :compare do
+              gitflow.commit_log
+            end
+          end
+        end
+
+      end
+
+    end
+  end
+end
+
+if Capistrano::Configuration.instance
+  Capistrano::Gitflow.load_into(Capistrano::Configuration.instance)
+end

data/lib/sentia/capistrano/gitflow/natcmp.rb

@@ -0,0 +1,76 @@
+# natcmp.rb
+#
+# Natural order comparison of two strings
+# e.g. "my_prog_v1.1.0" < "my_prog_v1.2.0" < "my_prog_v1.10.0"
+# which does not follow alphabetically
+#
+# Based on Martin Pool's "Natural Order String Comparison" originally written in C
+# http://sourcefrog.net/projects/natsort/
+#
+# This implementation is Copyright (C) 2003 by Alan Davies
+# <cs96and_AT_yahoo_DOT_co_DOT_uk>
+#
+# This software is provided 'as-is', without any express or implied
+# warranty.  In no event will the authors be held liable for any damages
+# arising from the use of this software.
+#
+# Permission is granted to anyone to use this software for any purpose,
+# including commercial applications, and to alter it and redistribute it
+# freely, subject to the following restrictions:
+#
+# 1. The origin of this software must not be misrepresented; you must not
+#    claim that you wrote the original software. If you use this software
+#    in a product, an acknowledgment in the product documentation would be
+#    appreciated but is not required.
+# 2. Altered source versions must be plainly marked as such, and must not be
+#    misrepresented as being the original software.
+# 3. This notice may not be removed or altered from any source distribution.
+
+class String
+
+# 'Natural order' comparison of two strings
+def String.natcmp(str1, str2, caseInsensitive=false)
+	str1, str2 = str1.dup, str2.dup
+	compareExpression = /^(\D*)(\d*)(.*)$/
+
+	if caseInsensitive
+		str1.downcase!
+		str2.downcase!
+	end
+
+	# Remove all whitespace
+	str1.gsub!(/\s*/, '')
+	str2.gsub!(/\s*/, '')
+
+	while (str1.length > 0) or (str2.length > 0) do
+		# Extract non-digits, digits and rest of string
+		str1 =~ compareExpression
+		chars1, num1, str1 = $1.dup, $2.dup, $3.dup
+
+		str2 =~ compareExpression
+		chars2, num2, str2 = $1.dup, $2.dup, $3.dup
+
+		# Compare the non-digits
+		case (chars1 <=> chars2)
+			when 0 # Non-digits are the same, compare the digits...
+				# If either number begins with a zero, then compare alphabetically,
+				# otherwise compare numerically
+				if (num1[0] != 48) and (num2[0] != 48)
+					num1, num2 = num1.to_i, num2.to_i
+				end
+
+				case (num1 <=> num2)
+					when -1 then return -1
+					when 1 then return 1
+				end
+			when -1 then return -1
+			when 1 then return 1
+		end # case
+
+	end # while
+
+	# Strings are naturally equal
+	return 0
+end
+
+end # class String

data/recipes/gitflow_recipes.rb

@@ -0,0 +1,2 @@
+# Just need to add to LOAD_PATH, so we can require 'gitflow'
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), '..', 'lib')

data/sentia-capistrano-gitflow.gemspec

@@ -0,0 +1,55 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "sentia-capistrano-gitflow"
+  s.version = "1.4.3"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Joshua Nichols", "Mario Visic"]
+  s.date = "2012-06-04"
+  s.description = "Capistrano recipe for a deployment workflow based on git tags. This gem was originally created by Joshua Nichols and modified by Mario Visic at Sentia Australia."
+  s.email = "mario.visic@sentia.com.au"
+  s.extra_rdoc_files = [
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    "Gemfile",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "lib/sentia/capistrano/gitflow.rb",
+    "lib/sentia/capistrano/gitflow/natcmp.rb",
+    "recipes/gitflow_recipes.rb",
+    "sentia-capistrano-gitflow.gemspec"
+  ]
+  s.homepage = "https://github.com/Sentia/git-deployment"
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.15"
+  s.summary = "Capistrano recipe for a deployment workflow based on git tags. This gem was originally created by Joshua Nichols and modified by Mario Visic at Sentia Australia."
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<sentia-capistrano-gitflow>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_runtime_dependency(%q<capistrano>, [">= 0"])
+      s.add_runtime_dependency(%q<stringex>, [">= 0"])
+    else
+      s.add_dependency(%q<sentia-capistrano-gitflow>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_dependency(%q<capistrano>, [">= 0"])
+      s.add_dependency(%q<stringex>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<sentia-capistrano-gitflow>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    s.add_dependency(%q<capistrano>, [">= 0"])
+    s.add_dependency(%q<stringex>, [">= 0"])
+  end
+end
+

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification
+name: sentia-capistrano-gitflow
+version: !ruby/object:Gem::Version
+  version: 1.4.3
+  prerelease: 
+platform: ruby
+authors:
+- Joshua Nichols
+- Mario Visic
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-06-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sentia-capistrano-gitflow
+  requirement: &70341993681560 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70341993681560
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70341993681040 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.2.9
+  type: :development
+  prerelease: false
+  version_requirements: *70341993681040
+- !ruby/object:Gem::Dependency
+  name: capistrano
+  requirement: &70341993680020 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70341993680020
+- !ruby/object:Gem::Dependency
+  name: stringex
+  requirement: &70341993678260 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70341993678260
+description: Capistrano recipe for a deployment workflow based on git tags. This gem
+  was originally created by Joshua Nichols and modified by Mario Visic at Sentia Australia.
+email: mario.visic@sentia.com.au
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.rdoc
+files:
+- .document
+- Gemfile
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/sentia/capistrano/gitflow.rb
+- lib/sentia/capistrano/gitflow/natcmp.rb
+- recipes/gitflow_recipes.rb
+- sentia-capistrano-gitflow.gemspec
+homepage: https://github.com/Sentia/git-deployment
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: Capistrano recipe for a deployment workflow based on git tags. This gem was
+  originally created by Joshua Nichols and modified by Mario Visic at Sentia Australia.
+test_files: []