qa_release_tasks 1.1.0

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 PRIMEDIA
+
+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/README

@@ -0,0 +1,9 @@
+Git Changelog - Show a list of changes by version.
+
+    -l, --limit [LIMIT]              Maximum commits for each version, default is 20
+        --no-limit                   Show all commits for each version
+    -a, --all                        Show all versions
+        --from [VERSION]             Start changelog at this version. Defaults to most recent version.
+        --to [VERSION]               End changelog at this version. Defaults to second most recent version.
+    -h, --help                       Displays this help message
+        --version                    Show version

data/Rakefile

@@ -0,0 +1,75 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+require 'rubygems/specification'
+require 'date'
+require 'spec/rake/spectask'
+
+require 'lib/qa_release_tasks'
+
+GEM = "qa_release_tasks"
+GEM_VERSION = QaReleaseTasks.version
+AUTHORS = "Jason Noble", "Rein Henrichs"
+SUMMARY = "A gem that provides workflow driven rake tasks for git QA branch management"
+
+spec = Gem::Specification.new do |s|
+  s.name = GEM
+  s.version = GEM_VERSION
+  s.platform = Gem::Platform::RUBY
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["README", "LICENSE"]
+  s.summary = SUMMARY
+  s.description = s.summary
+  s.authors = AUTHORS
+  s.executables = ['git-changelog']
+  
+  s.require_path = 'lib'
+  s.autorequire = GEM
+  s.files = %w(LICENSE README Rakefile) + Dir.glob("{bin,lib,spec}/**/*")
+  s.homepage = ""
+end
+
+task :default => :spec
+
+task :make => :make_spec do
+  system("./bin/git-changelog --help > README && ./bin/git-changelog -a --no-limit > HISTORY")
+end
+
+desc "Run specs"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.spec_opts = %w(-fs --color)
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+desc "install the gem locally"
+task :install => [:package] do
+  sh %{sudo gem install pkg/#{GEM}-#{GEM_VERSION}}
+end
+
+desc "create a gemspec file"
+task :make_spec do
+  File.open("#{GEM}.gemspec", "w") do |file|
+    file.puts spec.to_ruby
+  end
+end
+
+namespace :gem do
+  desc "validate the gem like github does"
+  task :validate do
+    require 'rubygems/specification'
+    data = File.read("#{GEM}.gemspec")
+    spec = nil
+
+    if data !~ %r{!ruby/object:Gem::Specification}
+      Thread.new { spec = eval("$SAFE = 3\n#{data}") }.join
+    else
+      spec = YAML.load(data)
+    end
+
+    puts spec
+    puts spec.validate ? "OK" : "FAIL"
+  end
+end

data/bin/git-changelog

@@ -0,0 +1,44 @@
+#!/usr/bin/env ruby -wKU
+require File.join(File.dirname(__FILE__), '../lib/qa_release_tasks')
+require 'optparse'
+
+options = {}
+OptionParser.new do |opts|
+  opts.banner = "Git Changelog - Show a list of changes by version."
+  
+  opts.separator ''
+  
+  opts.on_tail('-h', '--help', 'Displays this help message') do
+    puts opts
+    exit
+  end
+  
+  opts.on_tail("--version", "Show version") do
+    puts 'git changelog version ' + QaReleaseTasks.version
+    exit
+  end
+
+  opts.on('-l', '--limit [LIMIT]', Integer, 'Maximum commits for each version, default is 20') do |limit|
+    options[:limit] = limit || 20
+  end
+  
+  opts.on('--no-limit', 'Show all commits for each version') do
+    options[:limit] = false
+  end
+  
+  opts.on('-a', '--all', 'Show all versions') do
+    options[:all] = true
+  end
+  
+  opts.on('--from [VERSION]',
+          'Start changelog at this version. Defaults to most recent version.') do |from|
+    options[:from] = from
+  end
+  
+  opts.on('--to [VERSION]',
+          'End changelog at this version. Defaults to second most recent version.') do |to|
+    options[:to] = to
+  end
+end.parse!
+
+Git::ReleaseNotes.new(options).annotate!

data/lib/cli.rb

@@ -0,0 +1,49 @@
+module CLI
+  def warn(message)
+    wrap(STDERR){ STDERR.puts "Warning: #{message}" }
+  end
+
+  def error(message)
+    wrap(STDERR){ STDERR.puts "Error: #{message}" }
+    exit 1
+  end
+  
+  def stars(num=50)
+    return "*" * num
+  end
+  
+  def wrap(stream=STDOUT)
+    stream.puts stars
+    yield
+    stream.puts stars
+  end
+
+  def ask(question, default=nil, valid_response=nil, invalid_message=nil)
+    loop do
+      print "#{question}"
+      print " [#{default}]" if default
+      print ": "
+      answer = STDIN.gets.chomp
+      answer = default if default && answer.empty?
+      valid = false
+      valid = true if valid_response.nil?
+      valid = true if valid_response.respond_to?(:include?) && valid_response.include?(answer)
+      valid = true if valid_response.respond_to?(:match) && valid_response.match(answer)
+      if valid
+        return answer
+      else
+        if valid_response.is_a?(Array)
+          puts invalid_message || begin
+            print "Invalid answer, please try again."
+            print " Valid answers include:\n"
+            puts valid_response
+          end
+        elsif valid_response.is_a?(Regexp)
+          puts invalid_message || "Invalid format for answer, please try again."
+        else
+          puts invalid_message || "Invalid answer, please try again."
+        end
+      end
+    end  
+  end
+end

data/lib/git/commands.rb

@@ -0,0 +1,55 @@
+module Git
+  module Commands
+
+    def assert_is_git_repo
+      error "Not a git repository" unless is_git_repo?
+    end
+
+    def is_git_repo?
+      File.directory?('.git')
+    end
+
+    #  figure out what branch the pwd's repo is on
+    def get_branch
+      match = Regexp.new("^# On branch (.*)").match(`git status`)
+      match && match[1]
+    end
+    
+     # e.g. v1.4.3
+    def valid_version_regexp
+      /^v\d+\.\d+\.\d+/
+    end
+
+    # Find all version tags
+    def get_tags
+      version_regexp = valid_version_regexp
+      %x{git tag}.split.grep(version_regexp).sort_by{|v| v.split('.').map{|nbr| nbr[/\d+/].to_i}}.map{|tag| tag.strip}
+    end
+
+    def next_version(options={})
+      latest_tag = get_tags.last
+      return 'v0.0.1' unless latest_tag
+
+      unless latest_tag.match valid_version_regexp
+        warn "invalid version number"
+        return latest_tag
+      end
+
+      major, minor, point = latest_tag.split('.')
+      major = major[1..-1]
+      if options[:major]
+        major.succ!
+        minor, point = '0', '0'
+      elsif options[:minor]
+        minor.succ!
+        point = '0'
+      elsif options[:point]
+        point.succ!
+      else
+        warn "unable to increment version number."
+      end
+
+      'v' + [major, minor, point].join('.')
+    end
+  end
+end

data/lib/git/release_notes.rb

@@ -0,0 +1,42 @@
+module Git
+  class ReleaseNotes
+    require 'enumerator'
+    include CLI
+    include Commands
+    
+    attr_reader :options
+    def initialize(options = {})
+      @options = options
+    end
+
+    def annotate!
+      assert_is_git_repo
+      tags = get_tags.reverse
+      error "No version tags available." if tags.empty?
+      
+      if options[:all]
+        start_index = 0
+        end_index = tags.length - 1
+      else
+        start_tag = options[:from] || ask("Start at which tag?", tags[0], tags)
+        start_index = tags.index(start_tag)   
+        end_tag = options[:to] || ask("End at which tag?", tags[start_index + 1] || tags[start_index], tags)
+        end_index = tags.index(end_tag) + 1 # include end tag
+      end
+      
+      start_index.upto(end_index-1) do |i|
+        start = tags[i]
+        finish = tags[i+1]
+        range = ''
+        range << "refs/tags/#{finish}.." if finish # log until end tag if there is an end tag
+        range << "refs/tags/#{start}"
+        log = `git log --no-merges --pretty=format:"%h  %s" #{range}`.strip.split("\n")
+        next if log.empty?
+        puts "#{start}"
+        puts "=" * start.length
+        puts log
+        puts
+      end
+    end
+  end
+end

data/lib/git/tagger.rb

@@ -0,0 +1,39 @@
+module Git
+  class Tagger
+    include CLI
+    include Commands
+
+    attr_reader :options
+    def initialize(options)
+      @options = options
+    end
+
+    def tag!
+      assert_is_git_repo
+      begin
+        fetch_tags
+        tag_next_version(options)
+        push_tags
+      end
+    end
+
+    private
+    
+    def fetch_tags
+      system("git fetch --tags")
+    end
+
+    def tag_next_version(options={})
+      tag = next_version(options)
+      if options[:update]
+        invalid_message = "Invalid version. Version must be in the format: \"v1.2.3\""
+        tag = ask "Name of new version tag ", tag, valid_version_regexp, invalid_message
+      end
+      system "git tag -am'Tagged by qa_release_tasks gem' #{tag}"
+    end
+
+    def push_tags
+      system "git push --tags"
+    end
+  end
+end

data/lib/qa_release_tasks.rb

@@ -0,0 +1,14 @@
+$:.unshift File.join(File.dirname(__FILE__))
+require 'cli'
+require 'git/commands'
+require 'git/release_notes'
+require 'git/tagger'
+require 'tasks/qa_release'
+
+module QaReleaseTasks
+  VERSION = '1.1.0'
+
+  def self.version
+    VERSION
+  end
+end

data/lib/tasks/qa_release.rake

@@ -0,0 +1,18 @@
+namespace :qa do
+  namespace :release do
+    desc "Create a new minor version release from master."
+    task :new do
+      Git::Tagger.new(:minor => true, :update => true).tag!
+    end
+
+    desc "Create a new point version release from qa branch."
+    task :update do
+      Git::Tagger.new(:point => true).tag!
+    end
+
+    desc "Add release notes for a given tag based on commit summaries"
+    task :notes do
+      Git::ReleaseNotes.new.annotate!
+    end
+  end
+end

data/lib/tasks/qa_release.rb

@@ -0,0 +1,5 @@
+require 'rubygems'
+require 'rake'
+ 
+# Load rake file
+import "#{File.dirname(__FILE__)}/qa_release.rake"

data/spec/qa_release_tasks_spec.rb

@@ -0,0 +1,7 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe "qa_release_tasks" do
+  it "should do nothing" do
+    true.should == true
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+$TESTING=true
+$:.push File.join(File.dirname(__FILE__), '..', 'lib')

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification 
+name: qa_release_tasks
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 1
+  - 1
+  - 0
+  version: 1.1.0
+platform: ruby
+authors: 
+- Jason Noble
+- Rein Henrichs
+autorequire: qa_release_tasks
+bindir: bin
+cert_chain: []
+
+date: 2010-06-21 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: A gem that provides workflow driven rake tasks for git QA branch management
+email: 
+executables: 
+- git-changelog
+extensions: []
+
+extra_rdoc_files: 
+- README
+- LICENSE
+files: 
+- LICENSE
+- README
+- Rakefile
+- bin/git-changelog
+- lib/cli.rb
+- lib/git/commands.rb
+- lib/git/release_notes.rb
+- lib/git/tagger.rb
+- lib/qa_release_tasks.rb
+- lib/tasks/qa_release.rake
+- lib/tasks/qa_release.rb
+- spec/qa_release_tasks_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: A gem that provides workflow driven rake tasks for git QA branch management
+test_files: []
+