hoe 2.7.0 → 2.8.0

data/History.txt

@@ -1,3 +1,14 @@
+=== 2.8.0 / 2010-12-08
+
+* 6 minor enhancements:
+
+  * Added PRE=a.1 variable to package and release tasks. (ged)
+  * Added compiler plugin to support rake-compiler. (tenderlove)
+  * Added known_plugins task and updated included and 3rd party plugins doco
+  * Added racc/rex plugin!
+  * Extended sow's Rakefile template to dynamically include installed plugins
+  * Turned off rubyforge plugin by default. (tenderlove's whining)
+
 === 2.7.0 / 2010-11-15
 
 * 2 minor enhancements:

data/Manifest.txt

@@ -7,6 +7,7 @@ Rakefile
 bin/sow
 lib/hoe.rb
 lib/hoe/clean.rb
+lib/hoe/compiler.rb
 lib/hoe/debug.rb
 lib/hoe/deps.rb
 lib/hoe/flay.rb
@@ -17,6 +18,7 @@ lib/hoe/inline.rb
 lib/hoe/newb.rb
 lib/hoe/package.rb
 lib/hoe/publish.rb
+lib/hoe/racc.rb
 lib/hoe/rake.rb
 lib/hoe/rcov.rb
 lib/hoe/rubyforge.rb

data/README.txt

@@ -150,15 +150,18 @@ Again, this must be done before the Hoe spec, or it won't be useful.
 === Plug-ins Provided:
 
 * Hoe::Clean
+* Hoe::Compiler
 * Hoe::Debug
 * Hoe::Deps
 * Hoe::Flay
 * Hoe::Flog
+* Hoe::GemPreludeSucks
 * Hoe::Gemcutter
 * Hoe::Inline
 * Hoe::Newb
 * Hoe::Package
 * Hoe::Publish
+* Hoe::Racc
 * Hoe::RCov
 * Hoe::RubyForge
 * Hoe::Signing
@@ -166,10 +169,16 @@ Again, this must be done before the Hoe spec, or it won't be useful.
 
 === Known 3rd-Party Plugins:
 
-* Hoe::Seattlerb - minitest support, 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
+* hoe-bundler   - Generates a Gemfile based on a Hoe's declared dependencies.
+* hoe-debugging - A Hoe plugin to help you debug your codes.
+* hoe-doofus    - A Hoe plugin that helps me keep from messing up gem releases.
+* hoe-gemcutter - Adds gemcutter release automation to Hoe.
+* hoe-gemspec   - Generate a prerelease gemspec based on a Hoe spec.
+* hoe-git       - A set of Hoe plugins for tighter Git integration.
+* hoe-hg        - A Hoe plugin for Mercurial integration.
+* hoe-rubygems  - A Hoe plugin with additional RubyGems tasks.
+* hoe-seattlerb - Minitest, email announcements, release branching.
+* hoe-yard      - A Hoe plugin for generating YARD documentation.
 
 === Writing Plugins:
 

data/Rakefile

@@ -24,6 +24,19 @@ task :plugins do
     gsub(/module/, '*')
 end
 
+task :known_plugins do
+  dep         = Gem::Dependency.new(/^hoe-/, Gem::Requirement.default)
+  fetcher     = Gem::SpecFetcher.fetcher
+  spec_tuples = fetcher.find_matching dep
+
+  max = spec_tuples.map { |(tuple, source)| tuple.first.size }.max
+
+  spec_tuples.each do |(tuple, source)|
+    spec = Gem::SpecFetcher.fetcher.fetch_spec(tuple, URI.parse(source))
+    puts "* %-#{max}s - %s (%s)" % [spec.name, spec.summary, spec.authors.first]
+  end
+end
+
 [:redocs, :docs].each do |t|
   task t do
     cp "Hoe.pdf", "doc"

data/lib/hoe.rb

@@ -41,10 +41,10 @@ require 'hoe/rake'
 # == Extending Hoe
 #
 # Hoe can be extended via its plugin system. Hoe searches out all
-# installed files matching <tt>'hoe/*.rb'</tt> and loads them. Those files are
-# expected to define a module matching the file name. The module must
-# define a define task method and can optionally define an initialize
-# method. Both methods must be named to match the file. eg
+# installed files matching <tt>'hoe/*.rb'</tt> and loads them. Those
+# files are expected to define a module matching the file name. The
+# module must define a define task method and can optionally define an
+# initialize method. Both methods must be named to match the file. eg
 #
 #   module Hoe::Blah
 #     def initialize_blah # optional
@@ -58,10 +58,10 @@ require 'hoe/rake'
 
 class Hoe
   # duh
-  VERSION = '2.7.0'
+  VERSION = '2.8.0'
 
   @@plugins = [:clean, :debug, :deps, :flay, :flog, :newb, :package,
-               :publish, :rcov, :rubyforge, :gemcutter, :signing, :test]
+               :publish, :rcov, :gemcutter, :signing, :test]
 
   ##
   # Used to add extra flags to RUBY_FLAGS.

data/lib/hoe/compiler.rb

@@ -0,0 +1,44 @@
+##
+# rake-compiler plugin for hoe c-extensions.
+#
+# This plugin is for extconf.rb based projects that want to use
+# rake-compiler to deal with packaging binary gems. It expects a
+# standard extconf setup, namely that your extconf.rb and c source is
+# located in: ext/project-name.
+#
+# === Tasks Provided:
+#
+# compile::     Compile your c-extension.
+
+module Hoe::Compiler
+
+  ##
+  # Optional: Defines what tasks need to be compile first. [default: test]
+
+  attr_accessor :compile_tasks
+
+  ##
+  # Initialize variables for compiler plugin.
+
+  def initialize_compiler
+    self.compile_tasks = [:multi, :test]
+    self.spec_extras   = { :extensions => ["ext/#{self.name}/extconf.rb"] }
+
+    extra_dev_deps << ["rake-compiler", "~> 0.7"]
+  end
+
+  ##
+  # Define tasks for compiler plugin.
+
+  def define_compiler_tasks
+    require "rake/extensiontask"
+
+    Rake::ExtensionTask.new self.name, spec do |ext|
+      ext.lib_dir = File.join(*["lib", self.name, ENV["FAT_DIR"]].compact)
+    end
+
+    compile_tasks.each do |t|
+      task t => :compile
+    end
+  end
+end

data/lib/hoe/package.rb

@@ -38,6 +38,8 @@ module Hoe::Package
 
   def define_package_tasks
     Gem::PackageTask.new spec do |pkg|
+      prerelease_version
+
       pkg.need_tar = @need_tar
       pkg.need_zip = @need_zip
     end
@@ -47,13 +49,14 @@ module Hoe::Package
       install_gem Dir['pkg/*.gem'].first
     end
 
-    desc 'Package and upload the release.'
+    desc 'Package and upload; Requires VERSION=x.y.z (optional PRE=a.1)'
     task :release => [:prerelease, :release_to, :postrelease]
 
     # no doco, invisible hook
     task :prerelease do
-      abort "Fix your version before you release" if
-        spec.version.version =~ /borked/
+      prerelease_version
+
+      abort "Fix your version before you release" if spec.version =~ /borked/
     end
 
     # no doco, invisible hook
@@ -79,4 +82,15 @@ module Hoe::Package
     version = "--version '#{version}'" if     version
     sh "#{sudo}#{gem_cmd} install #{local} #{name} #{version}"
   end
+
+  def prerelease_version # :nodoc:
+    pre = ENV['PRERELEASE'] || ENV['PRE']
+    if pre then
+      spec.version.version << "." << pre if pre
+
+      abort "ERROR: You should format PRE like pre or alpha.1 or something" if
+        (Gem::VERSION < "1.4"  and pre !~ /^[a-z]+(\.\d+)?$/) or
+        (Gem::VERSION >= "1.4" and pre !~ /^[a-z]+(\.?\d+)?$/)
+    end
+  end
 end

data/lib/hoe/racc.rb

@@ -0,0 +1,91 @@
+##
+# Racc plugin for hoe.
+#
+# === Tasks Provided:
+#
+# lexer            :: Generate lexers for all .rex files in your Manifest.txt.
+# parser           :: Generate parsers for all .y files in your Manifest.txt.
+# .y   -> .rb rule :: Generate a parser using racc.
+# .rex -> .rb rule :: Generate a lexer using rexical.
+
+module Hoe::Racc
+
+  ##
+  # Optional: Defines what tasks need to generate parsers/lexers first.
+  #
+  # Defaults to [:multi, :test, :check_manifest]
+  #
+  # If you have extra tasks that require your parser/lexer to be
+  # built, add their names here in your hoe spec. eg:
+  #
+  #    racc_tasks << :debug
+
+  attr_accessor :racc_tasks
+
+  ##
+  # Optional: Defines what flags to use for racc. default: "-v -l"
+
+  attr_accessor :racc_flags
+
+  ##
+  # Optional: Defines what flags to use for rex. default: "--independent"
+
+  attr_accessor :rex_flags
+
+  ##
+  # Initialize variables for racc plugin.
+
+  def initialize_racc
+    self.racc_tasks = [:multi, :test, :check_manifest]
+
+    # -v = verbose
+    # -l = no-line-convert (they don't ever line up anyhow)
+    self.racc_flags ||= "-v -l"
+    self.rex_flags  ||= "--independent"
+
+    extra_dev_deps << ['racc', '~> 1.4.7']
+  end
+
+  ##
+  # Define tasks for racc plugin
+
+  def define_racc_tasks
+    racc_files   = self.spec.files.find_all { |f| f =~ /\.y$/ }
+    rex_files    = self.spec.files.find_all { |f| f =~ /\.rex$/ }
+
+    parser_files = racc_files.map { |f| f.sub(/\.y$/, ".rb") }
+    lexer_files  = rex_files.map  { |f| f.sub(/\.rex$/, ".rb") }
+
+    self.clean_globs += parser_files
+    self.clean_globs += lexer_files
+
+    rule ".rb" => ".y" do |t|
+      begin
+        sh "racc #{racc_flags} -o #{t.name} #{t.source}"
+      rescue
+        abort "need racc, sudo gem install racc"
+      end
+    end
+
+    rule ".rb" => ".rex" do |t|
+      begin
+        sh "rex #{rex_flags} -o #{t.name} #{t.source}"
+      rescue
+        abort "need rexical, sudo gem install rexical"
+      end
+    end
+
+    desc "build the parser" unless parser_files.empty?
+    task :parser
+
+    desc "build the lexer" unless lexer_files.empty?
+    task :lexer
+
+    task :parser => parser_files
+    task :lexer  => lexer_files
+
+    racc_tasks.each do |t|
+      task t => [:parser, :lexer]
+    end
+  end
+end

data/lib/hoe/rubyforge.rb

@@ -1,5 +1,3 @@
-require 'rubyforge'
-
 ##
 # RubyForge plugin for hoe.
 #
@@ -21,6 +19,8 @@ module Hoe::RubyForge
 
     desc 'Release to rubyforge.'
     task :release_to_rubyforge => [:clean, :package, :release_sanity] do
+      require 'rubyforge'
+
       rf = RubyForge.new.configure
       puts "Logging in"
       rf.login

data/template/Rakefile.erb

@@ -3,7 +3,17 @@
 require 'rubygems'
 require 'hoe'
 
+<%=
+  found = Gem.find_files("hoe/*.rb").map { |f| File.basename(f, ".rb").to_sym }
+  extra = found - Hoe.plugins - [:rake]
+  extra.map { |name| "# Hoe.plugin #{name.inspect}" }.sort.join("\n")
+%>
+
 Hoe.spec '<%= project %>' do
+  # HEY! If you fill these out in ~/.hoe_template/Rakefile.erb then
+  # you'll never have to touch them again!
+  # (delete this comment too, of course)
+
   # developer('<%= XIF %>', '<%= XIF %>@example.com')
 
   # self.rubyforge_name = '<%= project %>x' # if different than '<%= project %>'

metadata

@@ -4,37 +4,44 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 2
-  - 7
+  - 8
   - 0
-  version: 2.7.0
+  version: 2.8.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: 2010-11-15 00:00:00 -08:00
+date: 2010-12-08 00:00:00 -08:00
 default_executable: 
 dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: rubyforge
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 2
-        - 0
-        - 4
-        version: 2.0.4
-  type: :runtime
-  version_requirements: *id001
 - !ruby/object:Gem::Dependency 
   name: rake
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  requirement: &id001 !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
@@ -44,11 +51,11 @@ dependencies:
         - 7
         version: 0.8.7
   type: :runtime
-  version_requirements: *id002
+  version_requirements: *id001
 - !ruby/object:Gem::Dependency 
   name: minitest
   prerelease: false
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  requirement: &id002 !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
@@ -58,7 +65,7 @@ dependencies:
         - 0
         version: 2.0.0
   type: :development
-  version_requirements: *id003
+  version_requirements: *id002
 description: |-
   Hoe is a rake/rubygems helper for project Rakefiles. It helps you
   manage and maintain, and release your project and includes a dynamic
@@ -90,6 +97,7 @@ files:
 - bin/sow
 - lib/hoe.rb
 - lib/hoe/clean.rb
+- lib/hoe/compiler.rb
 - lib/hoe/debug.rb
 - lib/hoe/deps.rb
 - lib/hoe/flay.rb
@@ -100,6 +108,7 @@ files:
 - lib/hoe/newb.rb
 - lib/hoe/package.rb
 - lib/hoe/publish.rb
+- lib/hoe/racc.rb
 - lib/hoe/rake.rb
 - lib/hoe/rcov.rb
 - lib/hoe/rubyforge.rb

metadata.gz.sig

@@ -0,0 +1 @@
+#