# require 'rake/testtask' # Rake::TestTask.new do |t| # t.libs << 'test' # end # desc "Run tests" # task :default => :test require 'rubygems' require 'rake' require 'rdoc' require 'date' require 'yaml' ############################################################################# # # Helper functions # ############################################################################# def name @name ||= Dir['*.gemspec'].first.split('.').first end def version line = File.read("lib/#{name}.rb")[/^\s*VERSION\s*=\s*.*/] line.match(/.*VERSION\s*=\s*['"](.*)['"]/)[1] end def date Date.today.to_s end def rubyforge_project name end def gemspec_file "#{name}.gemspec" end def gem_file "#{name}-#{version}.gem" end def replace_header(head, header_name) head.sub!(/(\.#{header_name}\s*= ').*'/) { "#{$1}#{send(header_name)}'"} end def normalize_bullets(markdown) markdown.gsub(/\s{2}\*{1}/, "-") end def linkify_prs(markdown) markdown.gsub(/#(\d+)/) do |word| "[#{word}]({{ site.repository }}/issues/#{word.delete("#")})" end end def linkify_users(markdown) markdown.gsub(/(@\w+)/) do |username| "[#{username}](https://github.com/#{username.delete("@")})" end end def linkify(markdown) linkify_users(linkify_prs(markdown)) end def liquid_escape(markdown) markdown.gsub(/(`{[{%].+[}%]}`)/, "{% raw %}\\1{% endraw %}") end def remove_head_from_history(markdown) index = markdown =~ /^##\s+\d+\.\d+\.\d+/ markdown[index..-1] end def converted_history(markdown) remove_head_from_history(liquid_escape(linkify(normalize_bullets(markdown)))) end ############################################################################# # # Standard tasks # ############################################################################# task :default => :test require 'rake/testtask' Rake::TestTask.new(:test) do |test| test.libs << 'lib' << 'test' test.pattern = 'test/**/test_*.rb' test.verbose = true end require 'rdoc/task' Rake::RDocTask.new do |rdoc| rdoc.rdoc_dir = 'rdoc' rdoc.title = "#{name} #{version}" rdoc.rdoc_files.include('README*') rdoc.rdoc_files.include('lib/**/*.rb') end desc "Open an irb session preloaded with this library" task :console do sh "irb -rubygems -r ./lib/#{name}.rb" end ############################################################################# # # Site tasks - http://import.jekyllrb.com # ############################################################################# namespace :site do desc "Generate and view the site locally" task :preview do require "launchy" # Yep, it's a hack! Wait a few seconds for the Jekyll site to generate and # then open it in a browser. Someday we can do better than this, I hope. Thread.new do sleep 4 puts "Opening in browser..." Launchy.open("http://localhost:4000") end # Generate the site in server mode. puts "Running Jekyll..." Dir.chdir("site") do sh "jekyll serve --watch" end end desc "Update normalize.css library to the latest version and minify" task :update_normalize_css do Dir.chdir("site/css") do sh 'curl "http://necolas.github.io/normalize.css/latest/normalize.css" -o "normalize.scss"' sh 'sass "normalize.scss":"normalize.css" --style compressed' sh 'rm "normalize.scss"' end end desc "Commit the local site to the gh-pages branch and publish to GitHub Pages" task :publish => [:history] do sh "git subtree push --prefix site origin gh-pages" end desc "Create a nicely formatted history page for the jekyll site based on the repo history." task :history do if File.exist?("History.markdown") history_file = File.read("History.markdown") front_matter = { "layout" => "docs", "title" => "History", "permalink" => "/docs/history/", "prev_section" => "contributing" } Dir.chdir('site/docs/') do File.open("history.md", "w") do |file| file.write("#{front_matter.to_yaml}---\n\n") file.write(converted_history(history_file)) end end sh "git add site/docs/history.md" sh "git commit -m 'Updated generated history.md file in the site.'" else abort "You seem to have misplaced your History.markdown file. I can haz?" end end namespace :releases do desc "Create new release post" task :new, :version do |t, args| raise "Specify a version: rake site:releases:new['1.2.3']" unless args.version today = Time.new.strftime('%Y-%m-%d') release = args.version.to_s filename = "site/_posts/#{today}-jekyll-import-#{release.split('.').join('-')}-released.markdown" File.open(filename, "wb") do |post| post.puts("---") post.puts("layout: news_item") post.puts("title: 'jekyll-import #{release} Released'") post.puts("date: #{Time.new.strftime('%Y-%m-%d %H:%M:%S %z')}") post.puts("author: ") post.puts("version: #{version}") post.puts("categories: [release]") post.puts("---") post.puts post.puts end puts "Created #{filename}" end end end ############################################################################# # # Packaging tasks # ############################################################################# desc "Create tag v#{version} and build and push #{gem_file} to Rubygems" task :release => :build do unless `git branch` =~ /^\* master$/ puts "You must be on the master branch to release!" exit! end sh "git commit --allow-empty -a -m 'Release #{version}'" sh "git tag v#{version}" sh "git push origin master" sh "git push origin v#{version}" sh "gem push pkg/#{name}-#{version}.gem" end desc "Build #{gem_file} into the pkg directory" task :build => :gemspec do sh "mkdir -p pkg" sh "gem build #{gemspec_file}" sh "mv #{gem_file} pkg" end desc "Generate #{gemspec_file}" task :gemspec do # read spec file and split out manifest section spec = File.read(gemspec_file) head, manifest, tail = spec.split(" # = MANIFEST =\n") # replace name version and date replace_header(head, :name) replace_header(head, :version) replace_header(head, :date) #comment this out if your rubyforge_project has a different name replace_header(head, :rubyforge_project) # determine file list from git ls-files files = `git ls-files`. split("\n"). sort. reject { |file| file =~ /^\./ }. reject { |file| file =~ /^(rdoc|pkg)/ }. map { |file| " #{file}" }. join("\n") # piece file back together and write manifest = " s.files = %w[\n#{files}\n ]\n" spec = [head, manifest, tail].join(" # = MANIFEST =\n") File.open(gemspec_file, 'w') { |io| io.write(spec) } puts "Updated #{gemspec_file}" end