require 'rake/clean' task :default => [:setup, :test] CLEAN.include %w[coverage/ doc/api tags] CLOBBER.include %w[dist] desc "Install gem dependencies" task :setup do sh "bundle check >/dev/null || bundle install", :verbose => false end # SPECS ===================================================================== desc 'Run specs with unit test style output' task :test => FileList['test/*_test.rb'] do |t| suite = t.prerequisites sh "bundle exec bacon -q -I.:lib:test #{suite.join(' ')}", :verbose => false end desc 'Run specs with story style output' task :spec => FileList['test/*_test.rb'] do |t| suite = t.prerequisites sh "bundle exec bacon -I.:lib:test #{suite.join(' ')}", :verbose => false end desc 'Generate test coverage report' task :rcov do sh "rcov -I.:lib:test test/*_test.rb" end # DOC ======================================================================= desc 'Build all documentation' task :doc => %w[doc:api doc:markdown] # requires the hanna gem: # gem install mislav-hanna --source=http://gems.github.com desc 'Build API documentation (doc/api)' task 'doc:api' => 'doc/api/index.html' file 'doc/api/index.html' => FileList['lib/**/*.rb'] do |f| rm_rf 'doc/api' sh((<<-SH).gsub(/[\s\n]+/, ' ').strip) hanna --op doc/api --promiscuous --charset utf8 --fmt html --inline-source --line-numbers --accessor option_accessor=RW --main Rack::Cache --title 'Rack::Cache API Documentation' #{f.prerequisites.join(' ')} SH end CLEAN.include 'doc/api' desc 'Build markdown documentation files' task 'doc:markdown' FileList['doc/*.markdown'].each do |source| dest = "doc/#{File.basename(source, '.markdown')}.html" file dest => [source, 'doc/layout.html.erb'] do |f| puts "markdown: #{source} -> #{dest}" if verbose require 'erb' unless defined? ERB require 'rdiscount' unless defined? RDiscount template = File.read(source) content = Markdown.new(ERB.new(template, 0, "%<>").result(binding), :smart).to_html title = content.match("

(.*)

")[1] rescue '' layout = ERB.new(File.read("doc/layout.html.erb"), 0, "%<>") output = layout.result(binding) File.open(dest, 'w') { |io| io.write(output) } end task 'doc:markdown' => dest CLEAN.include dest end desc 'Publish documentation' task 'doc:publish' => :doc do sh 'rsync -avz doc/ gus@tomayko.com:/src/rack-cache' end desc 'Start the documentation development server (requires thin)' task 'doc:server' do sh 'cd doc && thin --rackup server.ru --port 3035 start' end # PACKAGING ================================================================= if defined?(Gem) # load gemspec $spec = eval(File.read('rack-cache.gemspec')) def package(ext='') "dist/rack-cache-#{$spec.version}" + ext end desc 'Build packages' task :package => %w[.gem .tar.gz].map {|e| package(e)} desc 'Build and install as local gem' task :install => package('.gem') do sh "gem install #{package('.gem')}" end directory 'dist/' file package('.gem') => %w[dist/ rack-cache.gemspec] + $spec.files do |f| sh "gem build rack-cache.gemspec" mv File.basename(f.name), f.name end file package('.tar.gz') => %w[dist/] + $spec.files do |f| sh "git archive --format=tar HEAD | gzip > #{f.name}" end desc 'Upload gem to gemcutter.org' task 'release' => [package('.gem')] do |t| sh "gem push #{package('.gem')}" end end # GEMSPEC =================================================================== file 'rack-cache.gemspec' => FileList['{lib,test}/**','Rakefile'] do |f| # read spec file and split out manifest section spec = File.read(f.name) parts = spec.split(" # = MANIFEST =\n") fail 'bad spec' if parts.length != 3 # determine file list from git ls-files files = `git ls-files`. split("\n").sort.reject{ |file| file =~ /^\./ }. map{ |file| " #{file}" }.join("\n") # piece file back together and write... parts[1] = " s.files = %w[\n#{files}\n ]\n" spec = parts.join(" # = MANIFEST =\n") spec.sub!(/s.date = '.*'/, "s.date = '#{Time.now.strftime("%Y-%m-%d")}'") File.open(f.name, 'w') { |io| io.write(spec) } puts "updated #{f.name}" end