Setup GitHub Pages yardoc.

Author: jdantonio

.gitignore

@@ -1,24 +1,38 @@
+Gemfile.lock
+.rspec-local
 *.gem
-*.rbc
-.rbx/*
-.bundle
-.config
-/.idea
+lib/1.8
+lib/1.9
+lib/2.0
+.rvmrc
+.ruby-version
+.ruby-gemset
+.bundle/*
 .yardoc/*
 yardoc/*
-Gemfile.lock
-InstalledFiles
-_yardoc
+tmp/*
+man/*
+*.tmproj
+rdoc/*
+*.orig
+*.BACKUP.*
+*.BASE.*
+*.LOCAL.*
+*.REMOTE.*
+git_pull.txt
 coverage
-doc/
-lib/bundler/man
-lib/thread_safe/jruby_cache_backend.jar
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp
+critic
 .DS_Store
-*.swp
-test/package.jar
+TAGS
+tmtags
+*.sw?
+.idea
+.rbx/*
+lib/**/*.bundle
+lib/**/*.so
+lib/**/*.jar
+ext/**/*.bundle
+ext/**/*.so
+ext/**/*.jar
+pkg
+*.gem

Rakefile

@@ -1,6 +1,19 @@
 require "bundler/gem_tasks"
 require "rake/testtask"
 
+## safely load all the rake tasks in the `tasks` directory
+def safe_load(file)
+  begin
+    load file
+  rescue LoadError => ex
+    puts "Error loading rake tasks from '#{file}' but will continue..."
+    puts ex.message
+  end
+end
+Dir.glob('tasks/**/*.rake').each do |rakefile|
+  safe_load rakefile
+end
+
 task :default => :test
 
 if defined?(JRUBY_VERSION)

tasks/update_doc.rake

@@ -0,0 +1,45 @@
+require 'yard'
+YARD::Rake::YardocTask.new
+
+root = File.expand_path File.join(File.dirname(__FILE__), '..')
+
+namespace :yard do
+
+  cmd = lambda do |command|
+    puts ">> executing: #{command}"
+    system command or raise "#{command} failed"
+  end
+
+  desc 'Pushes generated documentation to github pages: http://ruby-concurrency.github.io/thread_safe/'
+  task :push => [:setup, :yard] do
+
+    message = Dir.chdir(root) do
+      `git log -n 1 --oneline`.strip
+    end
+    puts "Generating commit: #{message}"
+
+    Dir.chdir "#{root}/yardoc" do
+      cmd.call "git add -A"
+      cmd.call "git commit -m '#{message}'"
+      cmd.call 'git push origin gh-pages'
+    end
+
+  end
+
+  desc 'Setups second clone in ./yardoc dir for pushing doc to github'
+  task :setup do
+
+    unless File.exist? "#{root}/yardoc/.git"
+      cmd.call "rm -rf #{root}/yardoc" if File.exist?("#{root}/yardoc")
+      Dir.chdir "#{root}" do
+        cmd.call 'git clone --single-branch --branch gh-pages [email protected]:ruby-concurrency/thread_safe.git ./yardoc'
+      end
+    end
+    Dir.chdir "#{root}/yardoc" do
+      cmd.call 'git fetch origin'
+      cmd.call 'git reset --hard origin/gh-pages'
+    end
+
+  end
+
+end