Really Testing with Rails (and Agiledox) at sablog.com

Really Testing with Rails (and Agiledox)

Written by Shanti A. Braford January 18th, 2006in Ruby on Rails.

Agiledox rake task -- add this to your Rakefile document in your Rails root.

CODE:

desc "Generate agiledox-like documentation for tests"
task :agiledox do
tests = FileList['test/**/*_test.rb']
tests.each do |file|
m = %r".*/([^/].*)_test.rb".match(file)
puts m[1]+" should:\n"
test_definitions = File::readlines(file).select {|line| line =~ /.*def test.*/}
test_definitions.each do |definition|
m = %r"test_(should_)?(.*)".match(definition)
puts " - "+m[2].gsub(/_/," ")
end
puts "\n"
end
end

Then run:
> rake agiledox

Assuming you've followed a well-behaved naming structure in your test cases (outlined here), you'll receive output like this:

security_controller should:
- redirect to page stored in session on successful login
- store user object in session on successful login
- redirect to page stored in session after signup
- store user object in session after signup

All this via Ben Griffiths, a former ThoughtWorker. Everytime I come across another ThoughtWorker's blog, usually just randomly, I'm always more and more impressed with their whole organization.

[+] Code hilighting above via the iG:Syntax Hiliter Plugin for WordPress.

You can