hoe 2.3.3 → 2.4.0

data.tar.gz.sig

@@ -0,0 +1,2 @@
+=��f�$E�!���@!��(���a��0
��p����(���oI��V��U�噬�§�[���y7�)���211=l�(lߔ��)
+:

data/.autotest

@@ -0,0 +1,7 @@
+# -*- ruby -*-
+
+require 'autotest/restart'
+
+Autotest.add_hook :initialize do |at|
+  at.testlib = "minitest/unit" # FIX: autotest testlib sucks
+end

data/History.txt

@@ -1,3 +1,14 @@
+=== 2.4.0 / 2009-12-08
+
+* 6 minor enhancements:
+
+  * Added Hoe.pdf
+  * Added gemcutter plugin (raggi)
+  * Added newb plugin. (jbarnette)
+  * Improved README.txt
+  * Improved rdoc
+  * Refactored rubyforge task to plugin. (jbarnette)
+
 === 2.3.3 / 2009-08-07
 
 * 6 minor enhancements:

data/Manifest.txt

@@ -1,4 +1,6 @@
+.autotest
 History.txt
+Hoe.pdf
 Manifest.txt
 README.txt
 Rakefile
@@ -9,11 +11,14 @@ lib/hoe/debug.rb
 lib/hoe/deps.rb
 lib/hoe/flay.rb
 lib/hoe/flog.rb
+lib/hoe/gemcutter.rb
 lib/hoe/inline.rb
+lib/hoe/newb.rb
 lib/hoe/package.rb
 lib/hoe/publish.rb
 lib/hoe/rake.rb
 lib/hoe/rcov.rb
+lib/hoe/rubyforge.rb
 lib/hoe/signing.rb
 lib/hoe/test.rb
 template/.autotest.erb
@@ -25,3 +30,4 @@ template/bin/file_name.erb
 template/lib/file_name.rb.erb
 template/test/test_file_name.rb.erb
 test/test_hoe.rb
+test/test_hoe_gemcutter.rb

data/README.txt

@@ -2,8 +2,8 @@
 
 * http://rubyforge.org/projects/seattlerb/
 * http://seattlerb.rubyforge.org/hoe/
-* http://www.zenspider.com/~ryand/hoe.pdf
-* mailto:ryand-ruby@zenspider.com
+* http://seattlerb.rubyforge.org/hoe/Hoe.pdf
+* http://github.com/jbarnette/hoe-plugin-examples
 
 == DESCRIPTION:
 
@@ -12,7 +12,21 @@ rubygems and includes a dynamic plug-in system allowing for easy
 extensibility. Hoe ships with plug-ins for all your usual project
 tasks including rdoc generation, testing, packaging, and deployment.
 
-Plug-ins Provided:
+See class rdoc for help. Hint: `ri Hoe` or any of the plugins listed
+below.
+
+See Also: http://seattlerb.rubyforge.org/hoe/Hoe.pdf
+
+== FEATURES/PROBLEMS:
+
+* Includes a dynamic plug-in system allowing for easy extensibility.
+* Auto-intuits changes, description, summary, and version.
+* Uses a manifest for safe and secure deployment.
+* Provides 'sow' for quick project directory creation.
+* Sow uses a simple ERB templating system allowing you to capture your
+  project patterns.
+
+=== Plug-ins Provided:
 
 * Hoe::Clean
 * Hoe::Debug
@@ -20,27 +34,28 @@ Plug-ins Provided:
 * Hoe::Flay
 * Hoe::Flog
 * Hoe::Inline
+* Hoe::Newb
 * Hoe::Package
 * Hoe::Publish
 * Hoe::RCov
+* Hoe::RubyForge
 * Hoe::Signing
 * Hoe::Test
 
-See class rdoc for help. Hint: ri Hoe
+=== Known 3rd-Party Plugins:
 
-== FEATURES/PROBLEMS:
-
-* Includes a dynamic plug-in system allowing for easy extensibility.
-* Auto-intuits changes, description, summary, and version.
-* Uses a manifest for safe and secure deployment.
-* Provides 'sow' for quick project directory creation.
-* Sow uses a simple ERB templating system allowing you to capture your
-  project patterns
+* Hoe::Seattlerb - email announcements & perforce branching/validation on release.
+* Hoe::Git       - git tagging on release, changelogs, and manifest creation.
+* Hoe::Doofus    - release checklist.
+* Hoe::Debugging - for extensions, run your tests with GDB and Valgrind
 
 == SYNOPSIS:
 
   % sow [group] project
 
+(you can edit a project template in ~/.hoe_template after running sow
+for the first time)
+
 or:
 
   require 'hoe'
@@ -65,7 +80,7 @@ or:
 
 (The MIT License)
 
-Copyright (c) Ryan Davis, Zen Spider Software
+Copyright (c) Ryan Davis, Seattle.rb
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/Rakefile

@@ -16,4 +16,10 @@ Hoe.spec "hoe" do
   pluggable!
 end
 
+[:redocs, :docs].each do |t|
+  task t do
+    cp "Hoe.pdf", "doc"
+  end
+end
+
 # vim: syntax=ruby

data/lib/hoe.rb

@@ -3,7 +3,6 @@
 require 'rubygems'
 require 'rake'
 require 'rake/testtask'
-require 'rubyforge'
 require 'yaml'
 
 require 'hoe/rake'
@@ -59,10 +58,10 @@ require 'hoe/rake'
 
 class Hoe
   # duh
-  VERSION = '2.3.3'
+  VERSION = '2.4.0'
 
-  @@plugins = [:clean, :debug, :deps, :flay, :flog, :package, :publish,
-               :rcov, :signing, :test]
+  @@plugins = [:clean, :debug, :deps, :flay, :flog, :newb, :package,
+               :publish, :rcov, :rubyforge, :gemcutter, :signing, :test]
 
   ##
   # Used to add extra flags to RUBY_FLAGS.
@@ -306,7 +305,7 @@ class Hoe
   def add_dependencies
     hoe_deps = {
       'rake'      => ">= #{RAKEVERSION}",
-      'rubyforge' => ">= #{::RubyForge::VERSION}",
+      'rubyforge' => ">= #{::RubyForge::VERSION}", # TODO: push down
     }
 
     self.extra_deps     = normalize_deps extra_deps
@@ -368,11 +367,12 @@ class Hoe
     end
 
     unless self.version then
-      version = nil
+      version    = nil
+      version_re = /VERSION += +([\"\'])([\d][\d\w\.]+)\1/
 
       spec.files.each do |file|
         next unless File.exist? file
-        version = File.read(file)[/VERSION += +([\"\'])([\d][\d\w\.]+)\1/, 2]
+        version = File.read_utf(file)[version_re, 2]
         break if version
       end
 
@@ -481,7 +481,7 @@ class Hoe
     $plugin_max = self.class.plugins.map { |s| s.to_s.size }.max
 
     self.class.plugins.each do |plugin|
-      warn plugin if $DEBUG
+      warn "define: #{plugin}" if $DEBUG
 
       old_tasks = Rake::Task.tasks.dup
 

data/lib/hoe/gemcutter.rb

@@ -0,0 +1,20 @@
+require 'rake'
+
+class Hoe #:nodoc:
+  module Gemcutter
+    def define_gemcutter_tasks
+      desc "Push gem to gemcutter."
+      task :release_to_gemcutter => [:clean, :package, :release_sanity] do
+        pkg   = "pkg/#{spec.name}-#{spec.version}"
+        gems  = Dir["#{pkg}*.gem"]
+        gems.each do |g|
+          # TODO - once gemcutter supports command invocation, use it.
+          # We could still fail here due to --format executable
+          sh Gem.ruby, "-S", "gem", "push", g
+        end
+      end
+
+      task :release_to => :release_to_gemcutter
+    end
+  end unless defined? Gemcutter # HACK - tests force load twice
+end

data/lib/hoe/newb.rb

@@ -0,0 +1,21 @@
+##
+# Newb plugin for hoe.
+#
+# === Tasks Provided:
+#
+# newb:: Get a new developer up to speed.
+
+module Hoe::Newb
+  # define tasks for the newb plugin
+  def define_newb_tasks
+    desc "Install deps, generate docs, run tests/specs."
+    task :newb => %w(check_extra_deps docs default) do
+      puts <<-END
+
+        GOOD TO GO! Tests are passing, docs are generated,
+        dependencies are installed. Get to hacking.
+
+      END
+    end
+  end
+end

data/lib/hoe/package.rb

@@ -12,7 +12,7 @@ end
 # === Tasks Provided:
 #
 # install_gem::        Install the package as a gem.
-# release::            Package and upload the release to rubyforge.
+# release::            Package and upload the release.
 
 module Hoe::Package
   ##
@@ -57,7 +57,7 @@ module Hoe::Package
     end
 
     # no doco, invisible hook
-    task :release_to => :release_to_rubyforge
+    task :release_to
 
     # no doco, invisible hook
     task :postrelease
@@ -67,26 +67,6 @@ module Hoe::Package
       v = ENV["VERSION"] or abort "Must supply VERSION=x.y.z"
       abort "Versions don't match #{v} vs #{version}" if v != version
     end
-
-    desc 'Release to rubyforge.'
-    task :release_to_rubyforge => [:clean, :package, :release_sanity] do
-      rf = RubyForge.new.configure
-      puts "Logging in"
-      rf.login
-
-      c = rf.userconfig
-      c["release_notes"]   = description if description
-      c["release_changes"] = changes     if changes
-      c["preformatted"]    = true
-
-      pkg   = "pkg/#{name}-#{version}"
-      files = [(@need_tar ? "#{pkg}.tgz" : nil),
-               (@need_zip ? "#{pkg}.zip" : nil),
-               Dir["#{pkg}*.gem"]].flatten.compact
-
-      puts "Releasing #{name} v. #{version}"
-      rf.add_release rubyforge_name, name, version, *files
-    end
   end
 
   ##

data/lib/hoe/rake.rb

@@ -1,7 +1,13 @@
 module Rake
   class Task
+    # Used to name the source of a given task
     attr_accessor :plugin
+    # :stopdoc:
     alias :old_comment :comment
+    # :startdoc:
+
+    ##
+    # Overrides the default #comment to provide the plugin name.
     def comment
       "%-#{$plugin_max}s # %s" % [plugin, old_comment] if old_comment
     end

data/lib/hoe/rubyforge.rb

@@ -0,0 +1,39 @@
+require 'rubyforge'
+
+##
+# RubyForge plugin for hoe.
+#
+# Adds a release dependency that cleans, packages, performs sanity
+# checks, and releases to RubyForge.
+#
+# === Tasks Provided:
+#
+# release_to_rubyforge:: Release to rubyforge when release task is run.
+
+module Hoe::RubyForge
+  def define_rubyforge_tasks # :nodoc:
+
+    # no doco, invisible hook
+    task :release_to => :release_to_rubyforge
+
+    desc 'Release to rubyforge.'
+    task :release_to_rubyforge => [:clean, :package, :release_sanity] do
+      rf = RubyForge.new.configure
+      puts "Logging in"
+      rf.login
+
+      c = rf.userconfig
+      c["release_notes"]   = description if description
+      c["release_changes"] = changes     if changes
+      c["preformatted"]    = true
+
+      pkg   = "pkg/#{name}-#{version}"
+      files = [(@need_tar ? "#{pkg}.tgz" : nil),
+               (@need_zip ? "#{pkg}.zip" : nil),
+               Dir["#{pkg}*.gem"]].flatten.compact
+
+      puts "Releasing #{name} v. #{version}"
+      rf.add_release rubyforge_name, name, version, *files
+    end
+  end
+end

data/template/README.txt.erb

@@ -22,6 +22,15 @@
 
 * <%= XIF %> (sudo gem install, anything else)
 
+== DEVELOPERS:
+
+After checking out the source, run:
+
+  $ rake newb
+
+This task will install any missing dependencies, run the tests/specs,
+and generate the RDoc.
+
 == LICENSE:
 
 (The MIT License)

data/test/test_hoe_gemcutter.rb

@@ -0,0 +1,13 @@
+require "hoe/gemcutter" unless defined? Hoe::Gemcutter
+
+class TestHoeGemcutter < MiniTest::Unit::TestCase
+  include Hoe::Gemcutter
+
+  def test_gemcutter_tasks_defined
+    define_gemcutter_tasks
+    assert Rake::Task[:release_to_gemcutter]
+    assert Rake::Task[:release_to].prerequisites.include?('release_to_gemcutter')
+  end
+
+  # TODO add tests for push once using Gem::Commands::Push (waiting on rubygems release)
+end

metadata

@@ -1,36 +1,57 @@
 --- !ruby/object:Gem::Specification 
 name: hoe
 version: !ruby/object:Gem::Version 
-  version: 2.3.3
+  version: 2.4.0
 platform: ruby
 authors: 
 - Ryan Davis
 autorequire: 
 bindir: bin
-cert_chain: []
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDPjCCAiagAwIBAgIBADANBgkqhkiG9w0BAQUFADBFMRMwEQYDVQQDDApyeWFu
+  ZC1ydWJ5MRkwFwYKCZImiZPyLGQBGRYJemVuc3BpZGVyMRMwEQYKCZImiZPyLGQB
+  GRYDY29tMB4XDTA5MDMwNjE4NTMxNVoXDTEwMDMwNjE4NTMxNVowRTETMBEGA1UE
+  AwwKcnlhbmQtcnVieTEZMBcGCgmSJomT8ixkARkWCXplbnNwaWRlcjETMBEGCgmS
+  JomT8ixkARkWA2NvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALda
+  b9DCgK+627gPJkB6XfjZ1itoOQvpqH1EXScSaba9/S2VF22VYQbXU1xQXL/WzCkx
+  taCPaLmfYIaFcHHCSY4hYDJijRQkLxPeB3xbOfzfLoBDbjvx5JxgJxUjmGa7xhcT
+  oOvjtt5P8+GSK9zLzxQP0gVLS/D0FmoE44XuDr3iQkVS2ujU5zZL84mMNqNB1znh
+  GiadM9GHRaDiaxuX0cIUBj19T01mVE2iymf9I6bEsiayK/n6QujtyCbTWsAS9Rqt
+  qhtV7HJxNKuPj/JFH0D2cswvzznE/a5FOYO68g+YCuFi5L8wZuuM8zzdwjrWHqSV
+  gBEfoTEGr7Zii72cx+sCAwEAAaM5MDcwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAw
+  HQYDVR0OBBYEFEfFe9md/r/tj/Wmwpy+MI8d9k/hMA0GCSqGSIb3DQEBBQUAA4IB
+  AQAY59gYvDxqSqgC92nAP9P8dnGgfZgLxP237xS6XxFGJSghdz/nI6pusfCWKM8m
+  vzjjH2wUMSSf3tNudQ3rCGLf2epkcU13/rguI88wO6MrE0wi4ZqLQX+eZQFskJb/
+  w6x9W1ur8eR01s397LSMexySDBrJOh34cm2AlfKr/jokKCTwcM0OvVZnAutaovC0
+  l1SVZ0ecg88bsWHA0Yhh7NFxK1utWoIhtB6AFC/+trM0FQEB/jZkIS8SaNzn96Rl
+  n0sZEf77FLf5peR8TP/PtmIg7Cyqz23sLM4mCOoTGIy5OcZ8TdyiyINUHtb5ej/T
+  FBHgymkyj/AOSqKRIpXPhjC6
+  -----END CERTIFICATE-----
 
-date: 2009-08-07 00:00:00 -07:00
+date: 2009-12-08 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  name: rubyforge
+  name: rake
   type: :runtime
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.0.4
+        version: 0.8.7
     version: 
 - !ruby/object:Gem::Dependency 
-  name: rake
+  name: rubyforge
   type: :runtime
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 0.8.7
+        version: 2.0.3
     version: 
 description: |-
   Hoe is a rake/rubygems helper for project Rakefiles. It helps generate
@@ -38,21 +59,10 @@ description: |-
   extensibility. Hoe ships with plug-ins for all your usual project
   tasks including rdoc generation, testing, packaging, and deployment.
   
-  Plug-ins Provided:
-  
-  * Hoe::Clean
-  * Hoe::Debug
-  * Hoe::Deps
-  * Hoe::Flay
-  * Hoe::Flog
-  * Hoe::Inline
-  * Hoe::Package
-  * Hoe::Publish
-  * Hoe::RCov
-  * Hoe::Signing
-  * Hoe::Test
+  See class rdoc for help. Hint: `ri Hoe` or any of the plugins listed
+  below.
   
-  See class rdoc for help. Hint: ri Hoe
+  See Also: http://seattlerb.rubyforge.org/hoe/Hoe.pdf
 email: 
 - ryand-ruby@zenspider.com
 executables: 
@@ -64,7 +74,9 @@ extra_rdoc_files:
 - Manifest.txt
 - README.txt
 files: 
+- .autotest
 - History.txt
+- Hoe.pdf
 - Manifest.txt
 - README.txt
 - Rakefile
@@ -75,11 +87,14 @@ files:
 - lib/hoe/deps.rb
 - lib/hoe/flay.rb
 - lib/hoe/flog.rb
+- lib/hoe/gemcutter.rb
 - lib/hoe/inline.rb
+- lib/hoe/newb.rb
 - lib/hoe/package.rb
 - lib/hoe/publish.rb
 - lib/hoe/rake.rb
 - lib/hoe/rcov.rb
+- lib/hoe/rubyforge.rb
 - lib/hoe/signing.rb
 - lib/hoe/test.rb
 - template/.autotest.erb
@@ -91,6 +106,7 @@ files:
 - template/lib/file_name.rb.erb
 - template/test/test_file_name.rb.erb
 - test/test_hoe.rb
+- test/test_hoe_gemcutter.rb
 has_rdoc: true
 homepage: http://rubyforge.org/projects/seattlerb/
 licenses: []
@@ -122,3 +138,4 @@ specification_version: 3
 summary: Hoe is a rake/rubygems helper for project Rakefiles
 test_files: 
 - test/test_hoe.rb
+- test/test_hoe_gemcutter.rb

metadata.gz.sig

@@ -0,0 +1 @@
+�:�F�Zh���,���ڎ(UW�\2<�����=���U�6�Uf�[Q�~+�㪠��-��#�#��S�������KB�s�I�g?_~ܖ�)���c%�[��át9&�������]�G��1\<n�3���n��{U�e��7�K9�6E�ݽK�^~rt�12��"��h 5���3�	֋?�<k�Z�3:�[�y��\��sٟ�"?�|�f�I��S����ԡ&9vF�g"