rb: Add rubydocs crazy fun task

Author: p0deje

rake-tasks/crazy_fun/mappings/ruby.rb

@@ -8,6 +8,7 @@ def add_all(fun)
     fun.add_mapping "ruby_test", RubyTest.new
     fun.add_mapping "ruby_test", AddTestDependencies.new
 
+    fun.add_mapping "rubydocs", RubyDocs.new
     fun.add_mapping "rubygem",  RubyGem.new
   end
 
@@ -105,6 +106,28 @@ def handle(fun, dir, args)
     end
   end
 
+  class RubyDocs < Tasks
+    def handle(fun, dir, args)
+      files = args[:files] || raise("no :files specified for rubydocs")
+      output_dir = args[:output_dir] || raise("no :output_dir specified for rubydocs")
+      readme = args[:readme] || raise("no :readme specified for rubydocs")
+
+      desc 'Generate Ruby API docs'
+      t = task "//#{dir}:docs" do |t|
+        yard_args = %w[doc --verbose]
+        yard_args += ["--output-dir", output_dir]
+        yard_args += ["--readme", readme]
+
+        ruby :command => "yard",
+             :args    => yard_args,
+             :files   => files,
+             :gemfile => "build/rb/Gemfile"
+      end
+
+      add_dependencies t, dir, args[:deps]
+    end
+  end # RubyDocs
+
   class RubyGem
     def handle(fun, dir, args)
       raise "no :gemspec for rubygem" unless args[:gemspec]

rb/build.desc

@@ -17,6 +17,16 @@ rubygem(
   ]
 )
 
+rubydocs(
+  files = [
+    "build/rb/lib/**/*.rb",
+    "build/rb/CHANGES"
+  ],
+  readme = "rb/README.md",
+  output_dir = "build/docs/api/rb",
+  deps = [ "//rb:gem:build" ]
+)
+
 ruby_library(name = "common",
   srcs = [
     "lib/selenium/webdriver/common/**/*.rb",

rb/selenium-webdriver.gemspec

@@ -31,4 +31,5 @@ Gem::Specification.new do |s|
   s.add_development_dependency "rack", ["~> 1.0"]
   s.add_development_dependency "ci_reporter", ["~> 1.6", ">= 1.6.2"]
   s.add_development_dependency "webmock", ["~> 1.7", ">= 1.7.5"]
+  s.add_development_dependency "yard", ["~> 0.8.7"]
 end