wycats-merb-core 0.9.8

data/CONTRIBUTORS

@@ -0,0 +1,94 @@
+Use merb? Say thanks the following people:
+
+Aaron Wheeler
+Abhay Kumar
+Adam Jacob
+Andy C
+Antti Tarvainen
+Ben Burkert
+Ben Chiu
+Ben Griffiths
+Bradly Feeley
+Brandon Dimcheff
+Brian Mitchell
+Bryan Ray
+Carl Lerche
+Charles Jolley
+Coda Hale
+Cory ODaniel
+Daniel Neighman
+Daniel Schierbeck
+Daniel Siemssen
+David James
+Diego Scataglini
+Dirkjan Bussink
+Dudley Flanders
+Ezra Zygmuntowicz
+Fabien Franzen
+Flea
+Gabe
+Geoffrey Grosenbach
+Goh Toh Chye
+Grant Hollingworth
+Guillaume Maury
+Hampton Catlin
+Ho-Sheng Hsiao
+Jack Dempsey
+James Herdman
+James Whiteman
+Janne Asmala
+Jaroslaw Zabiello
+Jonas Nicklas
+Jonathan Younger
+Josh Nichols
+Kyle Drake
+Lance Carlson
+Loren Segal
+Lori Holden
+Martin Grund
+Mason Browne
+Matt Aimonetti
+Matt Todd
+Matthew Ford
+Matthew Windwer
+Matthijs Langenberg
+Max Aller
+Max Lapshin
+Michael D'Auria
+Michael D. Ivey
+Michael Holub
+Michael Latta
+Michael S. Klishin
+Michael Sheakoski
+Mirko Froehlich
+Nathan Weizenbaum
+Oliver Jakubiec
+Paul Barry
+Paul Boone
+Paul Carey
+Ray Morgan
+Rich Cavanaugh
+Ross Lawley
+Shalon Wood
+Shay Arnett
+Simon Jefford
+Sindre Aarsaether
+StarTrader
+Steve Tooke
+Thomas Reynolds
+Tim Kofol
+Wayne E. Seguin
+Wayne Larsen
+Wesley Beary
+Will Prater
+William Smith
+Wilson Bilkovich
+Yehuda Katz
+Zach Holt
+brainopia
+jonas
+jonuts
+macournoyer
+mde
+rick
+wvl

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Engine Yard Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/PUBLIC_CHANGELOG

@@ -0,0 +1,142 @@
+9/26/2008:
+* For Merb developers, Rakefile features a new implementation of the :install
+  and :uninstall tasks. These will work with Gems directly, without running
+  the intermediate commands on the shell. This means 'sudo' is now explicitly
+  needed when installing gems system-wide; implicit sudo (prompt) is considered   
+  harmful. The new code will write appropriate executable wrappers that feature 
+  local gem loading and minigems usage. All gems in -more and -core now use this
+  new (un)install procedure.
+
+9/25/2008:
+* Merb::Config[:reload_templates] needs to be set explicitly in 
+  config/environments/development.rb - which is true for newly generated apps.
+  Previously Merb.env?(:development) meant that reload_templates was enabled.
+  Since we don't want to depend on Merb.env like that, we're using Merb::Config.
+
+9/24/2008:
+* Kernel#dependency and Kernel#load_dependency will now register the requested
+  dependency on Merb::BootLoader::Dependencies.dependencies. Doing so creates a
+  Gem::Dependency instance, which will be returned from these methods. 
+  Before, an Array of [name, ver] was returned. Working with Gem::Dependency 
+  makes the dependency information more uniform, regardless of the original 
+  version requirements.
+
+9/13/2008:
+* Merb apps will always give priority to gems that are available locally in
+  Merb.root / gems. Because of the specific load order, you will need to use
+  bin/merb to load merb-core from local gems, as detailed below. This is also
+  the case for bin/merb-gen, bin/rake and bin/spec for example. The added 
+  advantage is that your app will be completely independent from system gems.
+
+* Thor tasks 'merb.thor' have been added for newly generated apps; regenerate
+  your app to get them; alternatively these are available on merbivore.com:
+  
+  http://merbivore.com/merb.thor
+  
+* Release 0.9.6 introduced 'merb-gen scripts' which added script/merb and
+  script/merb-gen. However, now that merb.thor provides tasks to manage
+  bundled gems, we can directly extract the correct executables. To follow the
+  standard convention, these will be installed in ./bin instead of ./script.
+  
+  With merb.thor installed, run the following to get started:
+  
+  $ thor merb:tasks:setup # adds bin/thor, bin/rake etc.
+  
+  As soon as you install other gems using merb.thor you'll have the required
+  bin executables available; these are setup so that running them will load
+  merb-core from the local gems dir, not from the system-wide rubygems.
+  
+  To get bin/merb and bin/merb-gen for a fresh application, you can use:
+  
+  $ thor merb:stable -a mongrel # install a full merb stack from stable rubygems
+  
+  Alternatively, you can install from the bleeding edge:
+  
+  $ thor merb:edge --install # install a full merb stack from github
+  $ thor merb:gems:install mongrel # or ebb, thin...
+  
+9/5/2008:
+* Language::English::Inflector is now English::Inflect - be sure to change your
+  custom inflections in config/init.rb. Additionally, the merb-gen template 
+  config/init.rb has been changed to document the features accordingly.
+
+9/2/2008:
+* AbstractController now uniformly uses instance_eval for Procs where previously
+  the controller instance (self) was passed as an argument:
+  - Procs thrown during dispatch 
+  - Procs used as before/after filters
+  - Procs used as conditions to before/after filters
+  
+  This means that code like this:
+  
+  proc { |c| c.a_controller_method }
+  
+  Becomes the following for the cases mentioned:
+  
+  proc { a_controller_method }
+
+8/29/2008:
+* The directory Merb.root / 'framework' is now gone - framework gems are
+  expected to be installed as local gems in Merb.root / 'gems':
+  sudo gem install merb -i ./gems
+* The notion of a frozen application setup (using bundled gems) is now known
+  as a bundled setup; Merb.frozen? => Merb.bundled? By default an app uses
+  bundled gems (the -B or --bundle options to merb), to disable this use
+  the option --no-bundle.
+
+8/27/2008:
+* Merb::Request#protocol now returns valid protocol names: http, not http://.
+
+8/22/2008:
+* controller.cookies['foo'] = { ... } (Hash with options) is now deprecated;
+  use controller.cookies['foo'] = 'bar' for simple cookies without options, or
+  use controller.cookies.set_cookie('foo', 'bar', options) for more control.
+
+8/21/2008:
+* Memcached sessions are now configured by assignment to 
+  Merb::MemcachedSession.store (previously the CACHE constant was used)
+* Added Merb::Config[:ignore_tampered_cookies] option to skip cookie warnings   
+  during development. This defaults to 'on' in the development environment.
+* Merb::Config[:session_store] or Merb::Config[:session_stores] now accept an
+  Array (or String); when an Array is given, multiple session stores will be
+  available to the application.
+* If you have custom session stores (that inherit from Merb::SessionContainer)
+  be sure to require them in your init.rb
+
+8/20/2008:
+* Merb::Config[:session_cookie_domain] is now     
+  Merb::Config[:default_cookie_domain]
+* Merb.registered_session_types is now Merb::Request.registered_session_types
+* When running in :development env, cookie-based sessions won't bother you 
+  by raising TamperedWithCookie anymore.
+
+8/14/2008:
+*  Merb.orm_generator_scope and friends are renamed.
+** Merb.orm_generator_scope => Merb.orm
+** Merb.test_framework_generator_scope => Merb.test_framework
+** Added Merb.template_engine
+
+Merb-gen is updated accordingly. This let us add --haml and similar
+options to merb-gen and plugin generators.
+
+8/10/2008:
+* Modified the way Exceptions are handled in the Dispatcher
+** To rescue all exceptions, supply Exceptions#exception
+** To rescue all Merb-generated exceptions, supply Exceptions#base
+** Exceptions#internal_server_error is no longer a catch-all and should
+   not be used as such.
+
+6/22/2008:
+
+Erubis modified:
+* <%= %> now can take a block, so <%= helper do %>Hello<% end %> now works
+* Erubis buffer is now an ivar (@_erb_buf), which eliminates the need for
+  eval in capture helpers.
+  
+CONSEQUENCE:
+Helpers that take a block should simply return a string, and should not
+use concat. Example:
+  
+  def my_helper(&blk)
+    "My helper says #{capture(&blk)}."
+  end

data/README

@@ -0,0 +1,21 @@
+merb-core is a new branch of Merb (also referred to as merb-next or the 0.9 series) which aims to provide a stable, stripped down API for a future Merb 1.0 release.
+
+This branch is based off the 0.5 release series but with significant rewrites.
+
+Goals of this release:
+
+  * Stabilize the @public interface methods to provide for a more consistent application development experience.
+  * Remove features until nothing except a central application API is left
+  * Improve comments on methods using a standard documentation methodology as described in DOCUMENTATION_STANDARDS
+  * Separate the tests into two sections... "private" and "public"
+    * Public methods are methods tagged with @public that will be part of the standard, stable Merb API
+    * Private methods are implementation methods that might 
+  * Implement a new render API
+  * Build more extensions to regain selected features when needed
+  
+To familiarize yourself with how a merb-core application might look,
+use merb-gen (from merb-more) to generate a few apps:
+$ merb-gen app myapp                   # a "normal" merb app
+$ merb-gen app myapp --flat            # a flattened app
+$ merb-gen app myapp --very-flat       # a single-file app
+

data/Rakefile

@@ -0,0 +1,458 @@
+require "rake"
+require "rake/clean"
+require "rake/gempackagetask"
+require "rake/rdoctask"
+require "rake/testtask"
+require "spec/rake/spectask"
+require "fileutils"
+require "extlib"
+
+def __DIR__
+  File.dirname(__FILE__)
+end
+
+require __DIR__ + "/tools/rakehelp"
+require __DIR__ + "/tools/annotation_extract"
+
+include FileUtils
+
+require "lib/merb-core/version"
+require "lib/merb-core/test/run_specs"
+require 'lib/merb-core/tasks/merb_rake_helper'
+
+##############################################################################
+# Package && release
+##############################################################################
+RUBY_FORGE_PROJECT  = "merb"
+PROJECT_URL         = "http://merbivore.com"
+PROJECT_SUMMARY     = "Merb. Pocket rocket web framework."
+PROJECT_DESCRIPTION = PROJECT_SUMMARY
+
+AUTHOR = "Ezra Zygmuntowicz"
+EMAIL  = "ez@engineyard.com"
+
+GEM_NAME    = "merb-core"
+PKG_BUILD   = ENV['PKG_BUILD'] ? '.' + ENV['PKG_BUILD'] : ''
+GEM_VERSION = Merb::VERSION + PKG_BUILD
+
+RELEASE_NAME    = "REL #{GEM_VERSION}"
+
+require "extlib/tasks/release"
+
+spec = Gem::Specification.new do |s|
+  s.name         = GEM_NAME
+  s.version      = GEM_VERSION
+  s.platform     = Gem::Platform::RUBY
+  s.author       = AUTHOR
+  s.email        = EMAIL
+  s.homepage     = PROJECT_URL
+  s.summary      = PROJECT_SUMMARY
+  s.bindir       = "bin"
+  s.description  = PROJECT_DESCRIPTION
+  s.executables  = %w( merb )
+  s.require_path = "lib"
+  s.files        = %w( LICENSE README Rakefile TODO CHANGELOG PUBLIC_CHANGELOG CONTRIBUTORS ) + Dir["{doc/rdoc,bin,lib}/**/*"]
+
+  # rdoc
+  s.has_rdoc         = true
+  s.extra_rdoc_files = %w( README LICENSE TODO )
+
+  # Dependencies
+  s.add_dependency "extlib", ">= 0.9.6"
+  s.add_dependency "erubis"
+  s.add_dependency "rake"
+  s.add_dependency "json_pure"
+  s.add_dependency "rspec"
+  s.add_dependency "rack"
+  s.add_dependency "mime-types"
+  s.add_dependency "hpricot"
+  s.add_dependency "thor", ">= 0.9.6"
+  # this escalates to "regular" dependencies, comment it out
+  # for now. RubyGems need some love.
+  #s.add_development_dependency "libxml-ruby"
+  #s.add_development_dependency "memcache-client"
+  # Requirements
+  s.requirements << "install the json gem to get faster json parsing"
+  s.required_ruby_version = ">= 1.8.6"
+end
+
+Rake::GemPackageTask.new(spec) do |package|
+  package.gem_spec = spec
+end
+
+desc "Run :package and install the resulting .gem"
+task :install => :clean do
+  Merb::RakeHelper.install(GEM_NAME, :version => GEM_VERSION)
+end
+
+desc "Install Merb with development dependencies"
+task :dev_install => :clean do
+  Merb::RakeHelper.install(GEM_NAME, :version => GEM_VERSION, :development => true)
+end
+
+desc "Run :clean and uninstall the .gem"
+task :uninstall => :clean do
+  Merb::RakeHelper.uninstall(GEM_NAME, :version => GEM_VERSION)
+end
+
+desc "Create a gemspec file"
+task :gemspec do
+  File.open("#{GEM_NAME}.gemspec", "w") do |file|
+    file.puts spec.to_ruby
+  end
+end
+
+CLEAN.include ["**/.*.sw?", "pkg", "lib/*.bundle", "lib/*.so", "*.gem", "doc/rdoc", ".config", "coverage", "cache", "spec/**/*.log"]
+
+desc "Run the specs."
+task :default => :specs
+
+task :merb => [:clean, :rdoc, :package]
+
+##############################################################################
+# Github
+##############################################################################
+namespace :github do
+  desc "Update Github Gemspec"
+  task :update_gemspec do
+    skip_fields = %w(new_platform original_platform)
+    integer_fields = %w(specification_version)
+
+    result = "Gem::Specification.new do |s|\n"
+    spec.instance_variables.each do |ivar|
+      value = spec.instance_variable_get(ivar)
+      name  = ivar.split("@").last
+      next if skip_fields.include?(name) || value.nil? || value == "" || (value.respond_to?(:empty?) && value.empty?)
+      if name == "dependencies"
+        value.each do |d|
+          dep, *ver = d.to_s.split(" ")
+          result <<  "  s.add_dependency #{dep.inspect}, #{ver.join(" ").inspect.gsub(/[()]/, "")}\n"
+        end
+      else
+        case value
+        when Array
+          value =  name != "files" ? value.inspect : value.inspect.split(",").join(",\n")
+        when String
+          value = value.to_i if integer_fields.include?(name)
+          value = value.inspect
+        else
+          value = value.to_s.inspect
+        end
+        result << "  s.#{name} = #{value}\n"
+      end
+    end
+    result << "end"
+    File.open(File.join(File.dirname(__FILE__), "#{spec.name}.gemspec"), "w"){|f| f << result}
+  end
+end
+
+##############################################################################
+# Documentation
+##############################################################################
+task :doc => [:rdoc]
+namespace :doc do
+
+  Rake::RDocTask.new do |rdoc|
+    files = ["README", "LICENSE", "CHANGELOG", "lib/**/*.rb"]
+    rdoc.rdoc_files.add(files)
+    rdoc.main = "README"
+    rdoc.title = "Merb Docs"
+    rdoc.template = __DIR__ + "/tools/allison-2.0.2/lib/allison.rb"
+    rdoc.rdoc_dir = "doc/rdoc"
+    rdoc.options << "--line-numbers" << "--inline-source"
+  end
+
+  desc "run webgen"
+  task :webgen do
+    sh %{cd doc/site; webgen}
+  end
+
+  desc "rdoc to rubyforge"
+  task :rubyforge do
+    sh %{#{sudo} chmod -R 755 doc} unless windows?
+    sh %{/usr/bin/scp -r -p doc/rdoc/* ezmobius@rubyforge.org:/var/www/gforge-projects/merb}
+  end
+
+end
+
+##############################################################################
+# rSpec & rcov
+##############################################################################
+desc "Run :specs, :rcov"
+task :aok => [:specs, :rcov]
+
+def setup_specs(name, spec_cmd='spec', run_opts = "-c")
+  except = []
+  except += Dir["spec/**/memcache*_spec.rb"] if ENV['MEMCACHED'] == 'no'
+  
+  public_globs = ["abstract_controller", "boot_loader",
+                  "controller/*_spec.rb", "core",
+                 "core_ext", "directory_structure", "logger", "rack/*_spec.rb", "reloading",
+                 "request", "router/*_spec.rb", "session/*_spec.rb", "template", "test"].map do |glob|
+    "spec/public/#{glob}"
+  end
+
+  private_globs = ["boot_loader", "config", "core_ext", "dispatch/**/*_spec.rb", "router/*_spec.rb", "vendor"].map do |glob|
+    "spec/private/#{glob}"
+  end
+
+  desc "Run all specs (#{name})"
+  task "specs:#{name}" do
+    globs = public_globs + private_globs
+    run_specs(globs, spec_cmd, ENV['RSPEC_OPTS'] || run_opts, except)
+  end
+  
+  desc "Run private specs (#{name})"
+  task "specs:#{name}:private" do
+    run_specs(private_globs, spec_cmd, ENV['RSPEC_OPTS'] || run_opts)
+  end
+
+  desc "Run public specs (#{name})"
+  task "specs:#{name}:public" do
+    run_specs(public_globs, spec_cmd, ENV['RSPEC_OPTS'] || run_opts)
+  end
+  
+  # With profiling formatter
+  desc "Run all specs (#{name}) with profiling formatter"
+  task "specs:#{name}_profiled" do
+    run_specs("spec/**/*_spec.rb", spec_cmd, "-c -f o")
+  end
+
+  desc "Run private specs (#{name}) with profiling formatter"
+  task "specs:#{name}_profiled:private" do
+    run_specs("spec/private/**/*_spec.rb", spec_cmd, "-c -f o")
+  end
+
+  desc "Run public specs (#{name}) with profiling formatter"
+  task "specs:#{name}_profiled:public" do
+    run_specs("spec/public/**/*_spec.rb", spec_cmd, "-c -f o")
+  end  
+end
+
+setup_specs("mri", "spec")
+setup_specs("jruby", "jruby -S spec")
+
+task "specs"          => ["specs:mri"]
+task "specs:private"  => ["specs:mri:private"]
+task "specs:public"   => ["specs:mri:public"]
+
+desc "Run coverage suite"
+task :rcov do
+  require 'fileutils'
+  FileUtils.rm_rf("coverage") if File.directory?("coverage")
+  FileUtils.mkdir("coverage")
+  path = File.expand_path(Dir.pwd)
+  files = Dir["spec/**/*_spec.rb"]
+  files.each do |spec|
+    puts "Getting coverage for #{File.expand_path(spec)}"
+    command = %{rcov #{File.expand_path(spec)} --aggregate #{path}/coverage/data.data --exclude ".*" --include-file "lib/merb-core(?!\/vendor)"}
+    command += " --no-html" unless spec == files.last
+    `#{command} 2>&1`
+  end
+end
+
+desc "Run a specific spec with TASK=xxxx"
+Spec::Rake::SpecTask.new("spec") do |t|
+  t.spec_opts = ["--colour"]
+  t.libs = ["lib", "server/lib" ]
+  t.spec_files = (ENV["TASK"] || '').split(',').map do |task|
+    "spec/**/#{task}_spec.rb"
+  end
+end
+
+desc "Run all specs output html"
+Spec::Rake::SpecTask.new("specs_html") do |t|
+  t.spec_opts = ["--format", "html"]
+  t.libs = ["lib", "server/lib" ]
+  t.spec_files = Dir["spec/**/*_spec.rb"].sort
+end
+
+STATS_DIRECTORIES = [
+  ['Code', 'lib/'],
+  ['Unit tests', 'spec']
+].collect { |name, dir| [ name, "./#{dir}" ] }.
+  select  { |name, dir| File.directory?(dir) }
+
+desc "Report code statistics (KLOCs, etc) from the application"
+task :stats do
+  require __DIR__ + "/tools/code_statistics"
+  # require "extra/stats"
+  verbose = true
+  CodeStatistics.new(*STATS_DIRECTORIES).to_s
+end
+
+##############################################################################
+# SYNTAX CHECKING
+##############################################################################
+
+task :check_syntax do
+  `find . -name "*.rb" |xargs -n1 ruby -c |grep -v "Syntax OK"`
+  puts "* Done"
+end
+
+##############################################################################
+# Git and SVN
+##############################################################################
+namespace :repo do
+
+  desc "Add new files to repository"
+  task :add do
+    if File.directory?(".git")
+      system "git add *"
+    elsif File.directory?(".svn")
+      system "svn status | grep '^\?' | sed -e 's/? *//' | sed -e 's/ /\ /g' | xargs svn add"
+    end
+  end
+
+  desc "Fetch changes from master repository"
+  task :rebase do
+    if File.directory?(".git")
+      system "git stash ; git svn rebase ; git stash apply"
+    elsif File.directory?(".svn")
+      system "svn update"
+    end
+  end
+
+  desc "commit modified changes to the repository"
+  task :commit do
+    if File.directory?(".git")
+      system "git commit"
+    elsif File.directory?(".svn")
+      system "svn commit"
+    end
+  end
+
+end
+
+def git_log(since_release = nil, log_format = "%an")
+  git_log_query = "git log"
+  git_log_query << " v#{since_release}..HEAD" if since_release
+  git_log_query << " --pretty='format:#{log_format}' --no-merges"
+  puts
+  puts "Running #{git_log_query}"
+  puts
+  `#{git_log_query}`
+end
+
+def contributors(since_release = nil)
+  git_log(since_release).split("\n").uniq.sort
+end
+
+PREVIOUS_RELEASE = '0.9.7'
+namespace :history do
+  namespace :update do
+    desc "updates contributors list"
+    task :contributors do
+      list = contributors.join "\n"
+
+      path = File.join(File.dirname(__FILE__), 'CONTRIBUTORS')
+
+      rm path if File.exists?(path)
+
+      puts "Writing contributors (#{contributors.size} entries)."
+      # windows needs wb
+      File.open(path, "wb") do |io|
+        io << "Use #{RUBY_FORGE_PROJECT}? Say thanks the following people:\n\n"
+        io << list
+      end
+    end
+  end
+
+  
+  namespace :alltime do
+    desc 'shows all-time committers'
+    task :contributors do
+      puts 'All-time contributors (#{contributors.size} total): '
+      puts '=============================='
+      puts
+      puts contributors.join("\n")
+    end
+  end
+  
+  namespace :current_release do
+    desc "show changes since previous release"
+    task :changes do
+      puts git_log(PREVIOUS_RELEASE, "* %s")
+    end
+
+
+    desc 'shows current release committers'
+    task :contributors do
+      puts "Current release contributors (#{contributors.size} total): "
+      puts '=============================='
+      puts
+      puts contributors(PREVIOUS_RELEASE).join("\n")
+    end
+  end
+end
+
+
+# Run specific tests or test files. Searches nested spec directories as well.
+#
+# Based on a technique popularized by Geoffrey Grosenbach
+rule "" do |t|
+  spec_cmd = (RUBY_PLATFORM =~ /java/) ? "jruby -S spec" : "spec"
+  # spec:spec_file:spec_name
+  if /spec:(.*)$/.match(t.name)
+    arguments = t.name.split(':')
+
+    file_name = arguments[1]
+    spec_name = arguments[2..-1]
+
+    spec_filename = "#{file_name}_spec.rb"
+    specs = Dir["spec/**/#{spec_filename}"]
+
+    if path = specs.detect { |f| spec_filename == File.basename(f) }
+      run_file_name = path
+    else
+      puts "No specs found for #{t.name.inspect}"
+      exit
+    end
+
+    example = " -e '#{spec_name}'" unless spec_name.empty?
+
+    sh "#{spec_cmd} #{run_file_name} --colour #{example}"
+  end
+end
+
+##############################################################################
+# Flog
+##############################################################################
+
+namespace :flog do
+  task :worst_methods do
+    require "flog"
+    flogger = Flog.new
+    flogger.flog_files Dir["lib/**/*.rb"]
+    totals = flogger.totals.sort_by {|k,v| v}.reverse[0..10]
+    totals.each do |meth, total|
+      puts "%50s: %s" % [meth, total]
+    end
+  end
+  
+  task :total do
+    require "flog"
+    flogger = Flog.new
+    flogger.flog_files Dir["lib/**/*.rb"]
+    puts "Total: #{flogger.total}"
+  end
+  
+  task :per_method do
+    require "flog"
+    flogger = Flog.new
+    flogger.flog_files Dir["lib/**/*.rb"]
+    methods = flogger.totals.reject { |k,v| k =~ /\#none$/ }.sort_by { |k,v| v }
+    puts "Total Flog:    #{flogger.total}"
+    puts "Total Methods: #{flogger.totals.size}"
+    puts "Flog / Method: #{flogger.total / methods.size}"
+  end
+end
+
+namespace :tools do
+  namespace :tags do
+    desc "Generates Emacs tags using Exuberant Ctags."
+    task :emacs do
+      sh "ctags -e --Ruby-kinds=-f -o TAGS -R lib"
+    end
+  end
+end