Recently in Seattle.rb Category

Hoe is a simple rake/rubygems helper for project Rakefiles. It generates all the usual tasks for projects including rdoc generation, testing, packaging, and deployment.

Tasks Provided:

• announce - Create news email file and post to rubyforge.
• audit - Run ZenTest against the package.
• check_manifest - Verify the manifest.
• clean - Clean up all the extras.
• config_hoe - Create a fresh ~/.hoerc file.
• debug_gem - Show information about the gem.
• default - Run the default tasks.
• docs - Build the docs HTML Files
• email - Generate email announcement file.
• gem - Build the gem file hoe-1.5.0.gem
• generate_key - Generate a key for signing your gems.
• install_gem - Install the package as a gem.
• multi - Run the test suite using multiruby.
• package - Build all the packages
• post_blog - Post announcement to blog.
• post_news - Post announcement to rubyforge.
• publish_docs - Publish RDoc to RubyForge.
• release - Package and upload the release to rubyforge.
• ridocs - Generate ri locally for testing.
• test - Run the test suite.
• test_deps - Show which test files fail when run alone.

See class rdoc for help. Hint: ri Hoe

Changes:

1.5.1 / 2008-03-04

• 2 Minor Enhancements:

  • Removed install/uninstall tasks. Too buggy. Gems do a better job.
  • Added cleaning of rbc files to default list

• 5 Bug Fixes:

  • Correctly deal with errors intuiting history and readme files. Thanks Aaron!
  • Fixed rdoc title. Thanks, Sander!
  • Fixed sow to match new Rakefile and History format. Thanks, me!
  • Moved test/unit to the front for rake test. Fixes use of miniunit.
  • Renamed shadowed variable.

• http://rubyforge.org/projects/seattlerb/

• http://seattlerb.rubyforge.org/hoe/
• ryand-ruby@zenspider.com

Does anyone have an opinion on this? Removing the install/uninstall commands would not prevent the tarball/zip from being created, it just wouldn't have a handy dandy install command.

Does anyone (sane) not use rubygems yet? And no, I don't consider foaming-at-the-mouth rpm fanatics as sane.

I'm sitting next to Phil Hagelberg, author of BusScheme and he's working on it right now and he is not on the bus!

Lies I tell you! All Lies!

ZenTest provides 4 different tools and 1 library: zentest, unit_diff, autotest, multiruby, and Test::Rails.

ZenTest scans your target and unit-test code and writes your missing code based on simple naming rules, enabling XP at a much quicker pace. ZenTest only works with Ruby and Test::Unit.

unit_diff is a command-line filter to diff expected results from actual results and allow you to quickly see exactly what is wrong.

autotest is a continous testing facility meant to be used during development. As soon as you save a file, autotest will run the corresponding dependent tests.

multiruby runs anything you want on multiple versions of ruby. Great for compatibility checking!

Test::Rails helps you build industrial-strength Rails code.

Changes:

3.9.1 / 2008-01-31

• 1 bug fix:

  • OMG I'm so dumb... fixed memory leak.

• http://www.zenspider.com/ZSS/Products/ZenTest/

• http://rubyforge.org/projects/zentest/
• ryand-ruby@zenspider.com

ZenTest provides 4 different tools and 1 library: zentest, unit_diff, autotest, multiruby, and Test::Rails.

ZenTest scans your target and unit-test code and writes your missing code based on simple naming rules, enabling XP at a much quicker pace. ZenTest only works with Ruby and Test::Unit.

unit_diff is a command-line filter to diff expected results from actual results and allow you to quickly see exactly what is wrong.

autotest is a continous testing facility meant to be used during development. As soon as you save a file, autotest will run the corresponding dependent tests.

multiruby runs anything you want on multiple versions of ruby. Great for compatibility checking!

Test::Rails helps you build industrial-strength Rails code.

Changes:

3.9.0 / 2008-01-30

• 15 minor enhancements:

  • Added Wilson's patch to allow unit_diff to work with mspec. Adding rspec next.
  • Minor overhaul for autotest:
  • Added -f flag to start up without testing.
  • Added -q flag to autotest to make it extra quiet. Patch by Aaron Patterson.
  • Added ability to set test execution order, defaults to :random. EVIL!
  • Added completedre and failedresults_re to help subclasses like rspec.
  • Added deprecation warnings for hooks. Deprecated :run.
  • Added find_directories accessor, defaults to ['.']
  • Added sleep accessor, defaults to 1 second.
  • Changed findfiles to order files in the same order as finddirectories.
  • Changed how autodiscover works with $:, added lib to the front.
  • Cleaned out nearly every @ and use accessor methods instead. You should too.
  • Made test_mappings ordered.
  • Removed @files, adding @findorder and @knownfiles.
  • Renamed testsforfile to testfilesfor.
  • testfilesfor now only returns known files.

• http://www.zenspider.com/ZSS/Products/ZenTest/

• http://rubyforge.org/projects/zentest/
• ryand-ruby@zenspider.com

As of this writing there are 197 authors creating 325 hoe'd projects, approximately 12.5% of all gems! Holy crap that is just awesome and I'm glad that people have benefitted from it.

I wrote 15 of them. I also apparently wrote 22 others, because those projects didn't specify their author or email values. Instead, it defaulted to mine. Why did it default to mine? Because I wrote hoe to make my Rakefiles as skinny as possible. I also did it because I thought it was funny that I wrote 37 (11%!) projects instead of 15 (only 3%)! I'm so prolific!

Well, it got boring and man do I hate boring.

So, in hoe 1.5, author and email are now mandatory values and will warn about needing to set them for the next 3 months. After that it'll start to throw a fit. The cool thing is that you can now use the developer(name, email) method to set both in a nice clean manner. Look at the previous blog post for an example.

If it makes you feel better, I have 13 more Rakefiles to fix. :)

With hoe 1.5, I finally got some changes in that I've wanted for a long long time... No more tweaking my Rakefile back and forth in order to adjust for changes in my history or readme files! Hoe now knows how to read the default structure of the files. As such, it automatically fills in description, summary, url, and changes for you (unless you override it). This takes my Rakefile from this:

require 'rubygems'
require 'hoe'
require './lib/zentest.rb'

Hoe.new("ZenTest", ZenTest::VERSION) do |p|
  p.author = ['Ryan Davis', 'Eric Hodel']

  changes = p.paragraphs_of("History.txt", 0..4).join("\n\n")
  urls, summary, *description = p.paragraphs_of("README.txt", 1, 3, 3..8)

  p.url = urls.gsub(/^\* /, '').split(/\n/)
  p.changes = changes
  p.summary = summary
  p.description = description.join("\n\n")
end

to this:

require 'rubygems'
require 'hoe'
require './lib/zentest.rb'

Hoe.new("ZenTest", ZenTest::VERSION) do |zentest|
  zentest.developer('Ryan Davis', 'ryand-ruby@zenspider.com')
  zentest.developer('Eric Hodel', 'drbrain@segment7.net')
end

Pretty, eh?

Hoe is a simple rake/rubygems helper for project Rakefiles. It generates all the usual tasks for projects including rdoc generation, testing, packaging, and deployment.

Tasks Provided:

• announce - Generate email announcement file and post to rubyforge.
• audit - Run ZenTest against the package
• check_manifest - Verify the manifest
• clean - Clean up all the extras
• config_hoe - Create a fresh ~/.hoerc file
• debug_gem - Show information about the gem.
• default - Run the default tasks
• docs - Build the docs HTML Files
• email - Generate email announcement file.
• gem - Build the gem file only.
• install - Install the package. Uses PREFIX and RUBYLIB
• install_gem - Install the package as a gem
• multi - Run the test suite using multiruby
• package - Build all the packages
• post_blog - Post announcement to blog.
• post_news - Post announcement to rubyforge.
• publish_docs - Publish RDoc to RubyForge
• release - Package and upload the release to rubyforge.
• ridocs - Generate ri locally for testing
• test - Run the test suite. Use FILTER to add to the command line.
• test_deps - Show which test files fail when run alone.
• uninstall - Uninstall the package.

See class rdoc for help. Hint: ri Hoe

Changes:

1.5.0 / 2008-01-30

• 9 Minor Enhancements:

  • Added autopopulation of changes from History.txt.
  • Added autopopulation of urls from History.txt.
  • Added autopopulation of description from History.txt
  • Added autopopulation of summary from description.
  • Added description_sections to declare what sections of readme to use.
  • Added summary_sentences to declare how many sentences you want in summary.
  • Added developer(name, email) to cleanly populate both author/email arrays.
  • author and email now default to "doofus".
  • author and email warn that they'll blow up on 2008-04-01.

• http://rubyforge.org/projects/seattlerb/

• http://seattlerb.rubyforge.org/hoe/
• ryand-ruby@zenspider.com

ruby2ruby provides a means of generating pure ruby code easily from ParseTree's Sexps. This makes making dynamic language processors much easier in ruby than ever before.

Changes:

1.1.8 / 2007-08-21

• 6 minor enhancements:

  • Added super awesome .autotest file. YAY!
  • Removed nil.method_missing... too many ppl bitching about it.
  • Renamed RubyToRuby (the class name) to Ruby2Ruby.
  • Restructured self-translation tests so they were friendlier when dying.
  • Strings are now always one line long only.
  • Fully in sync with ParseTree and ruby_parser.

• 2 bug fixes:

  • Fixed a number of issues/bugs discovered via ruby_parser.
  • Cleaned out some dead code and hacks we don't need anymore.

• http://seattlerb.rubyforge.org/

• http://rubyforge.org/projects/seattlerb

DESCRIPTION:

Hoe is a simple rake/rubygems helper for project Rakefiles. It generates all the usual tasks for projects including rdoc generation, testing, packaging, and deployment.

Tasks Provided:

• announce - Generate email announcement file and post to rubyforge.
• audit - Run ZenTest against the package
• check_manifest - Verify the manifest
• clean - Clean up all the extras
• config_hoe - Create a fresh ~/.hoerc file
• debug_gem - Show information about the gem.
• default - Run the default tasks
• docs - Build the docs HTML Files
• email - Generate email announcement file.
• gem - Build the gem file only.
• install - Install the package. Uses PREFIX and RUBYLIB
• install_gem - Install the package as a gem
• multi - Run the test suite using multiruby
• package - Build all the packages
• post_blog - Post announcement to blog.
• post_news - Post announcement to rubyforge.
• publish_docs - Publish RDoc to RubyForge
• release - Package and upload the release to rubyforge.
• ridocs - Generate ri locally for testing
• test - Run the test suite. Use FILTER to add to the command line.
• test_deps - Show which test files fail when run alone.
• uninstall - Uninstall the package.

Changes:

1.4.0 / 2007-12-20

• 1 Major Enhancement:

  • rake package now supports INLINE=1 and FORCE_PLATFORM=whatever.
  • Supports ruby_inline extensions.
  • Contributed by Luis Lavena. Thanks Luis!

• http://rubyforge.org/projects/seattlerb/

• http://seattlerb.rubyforge.org/hoe/
• ryand-ruby@zenspider.com