ore-tasks 0.2.0 → 0.3.0

data/ChangeLog.md

@@ -1,3 +1,12 @@
+### 0.3.0 / 2010-11-14
+
+* Added ore-core ~> 0.3.0 as a runtime dependency.
+* Added the `version` task, which displays the current version.
+* Added {Ore::Tasks#release_tasks} to explicitly control which tasks
+  are invoked when releasing a new version.
+* Perform `git push` before the release process.
+* Perform `git tag` and `git push --tags` after a successful release.
+
 ### 0.2.0 / 2010-11-07
 
 * Require [ore-core](http://github.com/ruby-ore/ore-core) ~> 0.1.0.

data/README.md

@@ -16,7 +16,7 @@ project.
   [rubygems.org](http://rubygems.org/).
 * Provides optional Git tasks.
 * Provides the `console` task for digging right into your code.
-* **Does not** automatically make changes or add commits to the repository.
+* **Does not** automatically modify or commit changes to your code.
 
 ## Requirements
 
@@ -40,6 +40,7 @@ project.
     rake push             # Builds and pushes a Gem
     rake release          # Builds and Pushes a new Gem / Build, Tags and Pushe...
     rake tag              # Tags a release and pushes the tag
+    rake version          # Displays the current version
 
 ## Copyright
 

data/gemspec.yml

@@ -1,5 +1,5 @@
 name: ore-tasks
-version: 0.2.0
+version: 0.3.0
 summary: Rake tasks for managing and releasing RubyGems using Ore.
 description:
   Simple Rake tasks for managing and releasing a RubyGem project generated
@@ -9,7 +9,9 @@ email: postmodern.mod3@gmail.com
 homepage: http://github.com/ruby-ore/ore-tasks
 has_yard: true
 
-development_dependencies:
+dependencies:
   ore-core: ~> 0.1.0
+
+development_dependencies:
   rspec: ~> 2.0.0
   yard: ~> 0.6.0

data/lib/ore/tasks.rb

@@ -3,14 +3,31 @@ require 'ore/project'
 require 'rake/tasklib'
 
 module Ore
+  #
+  # Defines basic Rake tasks for managing and releasing projects
+  # that use [Ore](http://rubydoc.info/gems/ore-core/file/README.md).
+  #
   class Tasks < Rake::TaskLib
 
+    # The tasks to perform when releasing a new version
+    attr_reader :release_tasks
+
+    #
+    # Initializes the Ore tasks.
+    #
+    # @param [String] root
+    #   The optional root directory for the project.
+    #
     def initialize(root=Dir.pwd)
       @project = Project.find(root)
+      @release_tasks = ['push']
 
       define
     end
 
+    #
+    # Defines the core Ore tasks.
+    #
     def define_core_tasks
       desc "Only builds a Gem"
       task :build do
@@ -43,7 +60,14 @@ module Ore
       end
 
       desc "Builds and Pushes a new Gem"
-      task :release => [:build, :push]
+      task :release do
+        @release_tasks.each { |task| Rake::Task[task].invoke }
+      end
+
+      desc 'Displays the current version'
+      task :version do
+        puts @project.version
+      end
 
       desc "Start IRB with all runtime dependencies loaded"
       task :console, [:script] do |t,args|
@@ -75,18 +99,27 @@ module Ore
       end
     end
 
+    #
+    # Defines the Ore tasks specific to [git](http://www.git-scm.com).
+    #
     def define_git_tasks
-      desc 'Tags a release and pushes the tag'
-      task :tag => :build do
+      task :sync do
         run "git push"
+      end
+
+      desc 'Tags a release and pushes the tag'
+      task :tag do
         run "git tag v#{@project.version}"
         run "git push --tags"
       end
 
-      desc "Build, Tags and Pushes a new Gem"
-      task :release => [:build, :tag, :push]
+      @release_tasks.unshift('sync')
+      @release_tasks.push('tag')
     end
 
+    #
+    # Defines the Ore tasks.
+    #
     def define
       define_core_tasks
 
@@ -96,6 +129,18 @@ module Ore
       end
     end
 
+    #
+    # Runs a program with optional arguments.
+    #
+    # @param [String] program
+    #   The program to run.
+    #
+    # @param [Array<String>] arguments
+    #   Optional arguments.
+    #
+    # @return [true]
+    #   The program was executed successfully.
+    #
     def run(program,*arguments)
       show_command = ([program] + arguments).join(' ')
 

data/ore-tasks.gemspec

@@ -6,5 +6,5 @@ begin
   end
 rescue NameError
   STDERR.puts "The 'ore-tasks.gemspec' file requires Ore."
-  STDERR.puts "Run `gem install ore` to install Ore."
+  STDERR.puts "Run `gem install ore-core` to install Ore."
 end

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 2
+  - 3
   - 0
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors: 
 - Postmodern
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-11-07 00:00:00 -07:00
+date: 2010-11-14 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -30,7 +30,7 @@ dependencies:
         - 1
         - 0
         version: 0.1.0
-  type: :development
+  type: :runtime
   version_requirements: *id001
 - !ruby/object:Gem::Dependency 
   name: rspec