visionmedia-release 0.0.2

data/History.rdoc

@@ -0,0 +1,4 @@
+
+=== 0.0.1 / 2009-03-05
+
+* Initial release

data/Manifest

@@ -0,0 +1,14 @@
+bin/re
+History.rdoc
+Manifest
+Rakefile
+README.rdoc
+release.gemspec
+spec/fixtures/bar/version.rb
+spec/fixtures/foo.rb
+spec/release_spec.rb
+spec/spec_helper.rb
+tasks/docs.rake
+tasks/gemspec.rake
+tasks/spec.rake
+Todo.rdoc

data/README.rdoc

@@ -0,0 +1,62 @@
+
+= Release
+
+Github release management system.
+
+== Description
+
+Tired of altering versions?, committing, tagging, pushing, and 
+pushing tags to Github manually? Never fear, release is here!
+
+== Features
+
+* Bump version levels [major, minor, (tiny | patch)]
+* Commit with default release message (or alter)
+* Tag and push to github
+* Run rake-tasks before releasing
+* All in a single command! 
+
+== Examples
+
+Bump patch (tiny), auto-locates version.rb
+  $ re bump
+
+Bump major with custom commit message (VERSION is replaced with release version)
+  $ re bump major -m 'Release VERSION, check it out!'
+
+Run rake tasks before releasing (defaults to manifest,gemspec)
+  $ re bump minor -r manifest,gemspec,email
+
+Specific version file
+  $ re bump --file bin/re
+
+== Limitations
+
+* Currently supports 'n.n.n' format only
+* Auto-locates version.rb (specify a specific file with --file switch)
+
+== License:
+
+(The MIT License)
+
+Copyright (c) 2009 TJ Holowaychuk <tj@vision-media.ca>
+
+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, an d/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,15 @@
+
+require 'rubygems'
+require 'rake'
+require 'echoe'
+load './bin/re'
+
+Echoe.new("release", program(:version)) do |p|
+  p.author = "TJ Holowaychuk"
+  p.email = "tj@vision-media.ca"
+  p.summary = "Github release management system"
+  p.url = "http://github.com/visionmedia/release"
+  p.runtime_dependencies = []
+end
+
+Dir['tasks/**/*.rake'].sort.each { |f| load f }

data/Todo.rdoc

@@ -0,0 +1,13 @@
+
+== Major:
+
+* Specs
+* Open history / changelog in EDITOR before release
+
+== Minor:
+
+* Nothing
+
+== Brainstorming:
+
+* Nothing

data/bin/re

@@ -0,0 +1,68 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'commander'
+
+program :name, 'release'
+program :version, '0.0.2'
+program :description, 'Github release management'
+
+def sh command
+  system command
+end
+
+def extract_version_from file
+  raise "version cannot find version file #{file}" unless file 
+  contents = File.read file
+  version = $~.captures if contents =~ /(\d+)\.(\d+)\.(\d+)/
+  raise "failed to locate version within #{file}. Must be format 'n.n.n'." unless version.length == 3
+  version.map { |v| v.to_i }
+end
+
+def bump_version file, level
+  version = extract_version_from file 
+  levels = { :major => 0, :minor => 1, :patch => 2, :tiny => 2 }
+  version[levels[level.to_sym]] += 1
+  version
+end
+
+def replace_version file, level
+  version = bump_version(file, level).join '.'
+  contents = File.read file
+  contents.sub! /\d+\.\d+\.\d+/, version
+  File.open(file, 'w+') do |file|
+    file.write contents
+  end
+  version
+end
+
+def locate_version_file
+  Dir['lib/*/**/*.rb'].grep(/version/).first
+end
+
+command :bump do |c|
+  c.syntax = 're bump [level] [options]'
+  c.summary = 'Bump the version <level>, defaults to patch.'
+  c.description = 'Bump the version by major, minor, or patch (tiny) levels, defaults to patch.'
+  c.example 'Bump patch level, running several rake tasks first', 're bump --rake manifest,gemspec'
+  c.example 'Custom message, VERSION replaced with actual version', 're bump major --message \'Release of App VERSION\''
+  c.option '-f', '--file FILE', 'File containing the version, otherwise searches lib/ for version.rb'
+  c.option '-m', '--message MESSAGE', String, 'Message defaults to \'- Release VERSION\''
+  c.option '-r', '--rake TASKS', Array, 'Defaults to manifest,gemspec to build manifest / gemspec before releasing'
+  c.option '-R', '--no-rake', 'Disable rake tasks'
+  c.when_called do |args, o|
+    # Defaults
+    level = args.shift || 'patch'
+    o.rake = o.rake || %w( manifest gemspec )
+    o.file = o.file || locate_version_file
+    o.message = o.message || '- Release VERSION'
+    
+    # Release
+    say "... bumping #{level} level in #{o.file}"
+    version = replace_version o.file, level
+    o.rake.each { |task| sh "rake #{task}" } if o.no_rake
+    sh "git commit -a -m '#{ o.message.sub('VERSION', version) }'"
+    sh "git tag #{version} && git push && git push --tags"
+    say "... release #{version} complete"
+  end
+end

data/release.gemspec

@@ -0,0 +1,33 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{release}
+  s.version = "0.0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["TJ Holowaychuk"]
+  s.date = %q{2009-03-05}
+  s.default_executable = %q{re}
+  s.description = %q{Github release management system}
+  s.email = %q{tj@vision-media.ca}
+  s.executables = ["re"]
+  s.extra_rdoc_files = ["bin/re", "README.rdoc", "tasks/docs.rake", "tasks/gemspec.rake", "tasks/spec.rake"]
+  s.files = ["bin/re", "History.rdoc", "Manifest", "Rakefile", "README.rdoc", "release.gemspec", "spec/fixtures/bar/version.rb", "spec/fixtures/foo.rb", "spec/release_spec.rb", "spec/spec_helper.rb", "tasks/docs.rake", "tasks/gemspec.rake", "tasks/spec.rake", "Todo.rdoc"]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/visionmedia/release}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Release", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{release}
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{Github release management system}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/spec/fixtures/bar/version.rb

@@ -0,0 +1,6 @@
+
+module Bar
+  def version
+    '22.23.148'
+  end
+end

data/spec/fixtures/foo.rb

@@ -0,0 +1,6 @@
+
+module Foo
+  def version
+    '0.0.1'
+  end
+end

data/spec/release_spec.rb

@@ -0,0 +1,83 @@
+
+describe "bin/re" do
+  
+  before :each do
+    @input = StringIO.new
+    @output = StringIO.new
+    $terminal = HighLine.new @input, @output
+  end
+  
+  describe "bump" do
+    before :each do
+      @previous_version = extract_version_from(locate_version_file)
+      @bump = get_command :bump
+    end
+    
+    it "should locate version file" do
+      locate_version_file.should include('fixtures/bar/version.rb')
+    end
+   
+    it "should use default rake tasks manifest and gemspec" do
+      @bump.call
+      @output.string.should include('rake manifest')
+      @output.string.should include('rake gemspec')
+    end
+
+    it "should add a commit message" do
+      @bump.call
+      @output.string.should include("git commit -a -m")
+    end
+    
+    it "should push, tag, and push tags" do
+      @bump.call
+      @output.string.should include("git tag")
+      @output.string.should include("git push")
+      @output.string.should include("git push --tags")
+    end
+    
+    it "should bump patch level by default" do
+      @bump.call
+      extract_version_from(locate_version_file)[2].should == @previous_version[2] + 1
+    end
+    
+    it "should bump patch level using tiny" do
+      @bump.call ['tiny']
+      extract_version_from(locate_version_file)[2].should == @previous_version[2] + 1
+    end
+    
+    it "should bump patch level using patch" do
+      @bump.call ['patch']
+      extract_version_from(locate_version_file)[2].should == @previous_version[2] + 1
+    end
+        
+    it "should bump minor level" do
+      @bump.call ['minor']
+      extract_version_from(locate_version_file)[1].should == @previous_version[1] + 1      
+    end
+    
+    it "should bump major level" do
+      @bump.call ['major']
+      extract_version_from(locate_version_file)[0].should == @previous_version[0] + 1      
+    end
+    
+    it "should allow altering of commit message with --message" do
+      run 'bump', '--message', 'New release of VERSION'
+      @output.string.should include('New release of')
+    end
+    
+    # it "should allow altering rake tasks with --rake" do
+    #   run 'bump', '--rake', 'foo,bar'
+    #   @output.string.should include('rake foo')
+    #   @output.string.should include('rake bar')
+    # end
+            
+    # it "should allow you to specify a version file with --file" do
+    #   foo = File.dirname(__FILE__) + '/fixtures/foo.rb'
+    #   previous_version = extract_version_from foo 
+    #   run 'bump', '--file', foo
+    #   extract_version_from(foo)[2].should == previous_version[2] + 1      
+    # end
+    
+  end
+  
+end

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+
+load File.expand_path(File.dirname(__FILE__) + '/../bin/re')
+
+def locate_version_file
+  Dir["#{File.dirname(__FILE__)}/*/**/*.rb"].grep(/version/).first
+end
+
+def sh command
+  say command
+end
+
+def run *args
+  $command_runner = Commander::Runner.new args
+  program :name, 'release'
+  program :version, '0.0.1'
+  program :description, 'Github release management'
+end

data/tasks/docs.rake

@@ -0,0 +1,13 @@
+
+namespace :docs do
+  
+  desc 'Remove rdoc products'
+  task :remove => [:clobber_docs]
+  
+  desc 'Build docs, and open in browser for viewing (specify BROWSER)'
+  task :open do
+    browser = ENV["BROWSER"] || "safari"
+    sh "open -a #{browser} doc/index.html"
+  end
+  
+end

data/tasks/gemspec.rake

@@ -0,0 +1,3 @@
+
+desc 'Build gemspec file'
+task :gemspec => [:build_gemspec]

data/tasks/spec.rake

@@ -0,0 +1,22 @@
+
+require 'spec/rake/spectask'
+  
+desc "Run all specifications"
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.spec_opts = ["--color", "--require", "spec/spec_helper.rb"]
+end
+  
+namespace :spec do
+
+  desc "Run all specifications verbosely"
+  Spec::Rake::SpecTask.new(:verbose) do |t|
+    t.spec_opts = ["--color", "--format", "specdoc", "--require", "spec/spec_helper.rb"]
+  end
+  
+  desc "Run specific specification verbosely (specify SPEC)"
+  Spec::Rake::SpecTask.new(:select) do |t|
+    t.spec_files = [ENV["SPEC"]]
+    t.spec_opts = ["--color", "--format", "specdoc", "--require", "spec/spec_helper.rb"]
+  end
+  
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification 
+name: visionmedia-release
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- TJ Holowaychuk
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-03-05 00:00:00 -08:00
+default_executable: re
+dependencies: []
+
+description: Github release management system
+email: tj@vision-media.ca
+executables: 
+- re
+extensions: []
+
+extra_rdoc_files: 
+- bin/re
+- README.rdoc
+- tasks/docs.rake
+- tasks/gemspec.rake
+- tasks/spec.rake
+files: 
+- bin/re
+- History.rdoc
+- Manifest
+- Rakefile
+- README.rdoc
+- release.gemspec
+- spec/fixtures/bar/version.rb
+- spec/fixtures/foo.rb
+- spec/release_spec.rb
+- spec/spec_helper.rb
+- tasks/docs.rake
+- tasks/gemspec.rake
+- tasks/spec.rake
+- Todo.rdoc
+has_rdoc: true
+homepage: http://github.com/visionmedia/release
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Release
+- --main
+- README.rdoc
+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: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: release
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Github release management system
+test_files: []
+