fuburake 0.9.0.26 → 0.9.5.29

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    MjkzN2Q0NjdhMWFiODRiNTUzZWM2NGFlNTAzODM5MmEwNjNiMGMzNA==
+    YTMzZGE3MTBlNDg2YTNhZDliZWRiYzJjYWUzZWNlNTA5MmZhYzNmNA==
   data.tar.gz: !binary |-
-    MWMwYmY4NzQyNmJjMDliZWNiODRiMWNmNzNhYzYyNWViYTcxMWRiNA==
+    MjY0ZDE1MzdmYzU0ODkzZTAzYWY1OTExMjNjOTQzZWVhNWZmYzZkYw==
 !binary "U0hBNTEy":
   metadata.gz: !binary |-
-    N2FiM2JhM2Q4ZjJjNmEwY2IzMmZiYjZjY2MyZGQ2ZmEyMzVjZGE0NzNkNDdj
-    ODc5N2E0OGVhNmM1MzY0MDM5ZTI4MDM1M2YxMGIyMGU5NDJlZjBhZmNmYzE5
-    NWYxZThkZDNiNDkwM2MzNGIzZWVmOWQxZWFhNGUxOWZiZDI1OWY=
+    ZDRjYTU3Y2ExNjY5YzU1MjIyMWQ2YjM0MjhkYjQ5ZjU0YjQzNTE4NjQxNjk2
+    MjJjNDA1MjU3MjQzZjU5YWU1NDYwZDUzMTY4MjIyODhjNzIzZTBkOWY1YTFh
+    YzgzNWRjMzQ5ZjZmNDNkYzNmMjU2MGZlZjhmMjA3N2RhYTZkMjc=
   data.tar.gz: !binary |-
-    OWIyZmFjMjVjZjcyYmJkYWI0MDcwYjkzYmI0NWE0NzYzMzQyOWU5MmM1MWY0
-    N2I1NDdhNTFkNTFjNjMwZWFhYzgxZDAyYTgyOWM4Mzc4MDYyYzljZjExYjRk
-    NTRmYzBlMDgzZGJkNmNlZWU4ZWIzNDdhMzFlNmFlYmJjODNjZDk=
+    YzZiYzE4ZmE2NDYzZjQzZThlN2M2ODljOTdkZmUzYzZkYTBmMWIzZmNiMTkx
+    M2E0ZDkwYTdmMmQzYjViOGVkNWNkNjZhNjRmYTY4MGQ5MDk3NDE4ZGE2YjRm
+    ZDg3NzJiODFjYzI3ZmU5YzIxM2MyZTcyNWNhM2EzYjNkYzhjYTM=

data/lib/fubudocs.rb

@@ -1,15 +1,15 @@
 namespace :docs do
-	desc "Tries to run a documentation project hosted in FubuWorld"
+	desc "Runs a documentation project hosted in FubuWorld"
 	task :run do
 		sh "fubudocs run -o"
 	end
 	
-	desc "Tries to run the documentation projects in this solution in a 'watched' mode in Firefox"
+	desc "Runs the documentation projects in this solution in a 'watched' mode in Firefox"
 	task :run_firefox do
 		sh "fubudocs run --watched --browser Firefox"
 	end
 	
-	desc "Tries to run the documentation projects in this solution in a 'watched' mode in Firefox"
+	desc "Runs the documentation projects in this solution in a 'watched' mode in Firefox"
 	task :run_chrome do
 		sh "fubudocs run --watched --browser Chrome"
 	end
@@ -23,4 +23,143 @@ namespace :docs do
 	task :snippets do
 		sh "fubudocs snippets"
 	end
-end
+end
+
+
+
+  class FubuDocs
+    attr_accessor :prefix, :branch, :export_dir
+  
+    def initialize(options)
+		# :host, :include, :nested, :dump
+		@branch = options.fetch(:branch, 'gh-pages')
+		@repository = options[:repository]
+		@prefix = options.fetch(:prefix, 'docs')
+		@export_dir = options.fetch(:dir, 'fubudocs-export')
+		@options = options
+	end
+	
+	def export
+	  cmd = "fubudocs export #{@export_dir}"
+	  if (@options[:host] != nil)
+		cmd += " --host #{@options[:host]}"
+	  end
+
+	  if (@options[:include] != nil)
+		cmd += " -i #{@options[:include]}"
+	  end
+	  
+	  if (@options[:nested] == true)
+		cmd += " -m GhPagesChildFolder"
+	  elsif (@options[:dump] == true)
+	    cmd += " -m HtmlDump"
+	  else
+		cmd += ' -m GhPagesRooted'
+	  end
+	  
+	  sh cmd
+	end
+	
+	def clean
+	  cleanDirectory @export_dir
+	  Dir.delete @export_dir
+	end
+	
+	def create_branch
+	  sh "ripple gitignore #{@export_dir}"
+		  
+	  sh "git clone #{@repository} #{@export_dir}"
+		  
+	  Dir.chdir @export_dir
+		  
+	  sh "git checkout --orphan #{@branch}"
+	  sh "git rm -rf ."
+	  
+	  writeNoJekyll
+	  
+	  sh "git add ."
+	  sh 'git commit -a -m "initial clean slate"'
+	  sh 'git push origin #{@branch}'
+		  
+	  Dir.chdir '..'
+	end
+	
+	def writeNoJekyll
+	  output = File.new( ".nojekyll", "w+" )
+	  output << "Just a marker"
+      output.close
+	end
+	
+	def fetch_existing
+	  Dir.mkdir @export_dir
+		  
+	  # fetch the gh-pages branch from the server
+	  Dir.chdir @export_dir
+	  sh 'git init'
+	  sh "git remote add -t #{@branch} -f origin #{@repository}"
+	  sh "git checkout #{@branch}"	
+	  
+	  # clean the existing content
+	  sleep 0.5 # let the file system try to relax its locks
+	  content_files = FileList['*.*'].exclude('.nojekyll').exclude('CNAME')
+	  content_files.each do |f|
+	    FileUtils.rm_r f
+	  end
+		  
+	  # do the actual export
+	  Dir.chdir '..'
+	end
+	
+	def commit_new
+	  # commit and push the generated docs
+	  Dir.chdir @export_dir
+	  
+	  if !File.exists?('.nojekyll')
+		writeNoJekyll
+	  end
+	  
+	  sh "git add ."
+	  sh 'git commit -a -m "Doc generation version ' + @options[:version] + '"' do |ok, res|
+		if ok
+		  sh "git push origin #{@branch}"
+		  puts "Documentation generation and push to #{@repository}/#{@branch} is successful"
+		else
+		  puts "commit failed, might be because there are no differences in the content"
+		end
+	  end
+
+	  Dir.chdir '..'
+	end
+	
+	def export_tasks
+		initTask = Rake::Task.define_task "#{@prefix}:init_branch" do
+		  clean
+		  create_branch
+		end
+		
+		initTask.add_description "Initializes the #{@branch} branch in git repository #{@repository}"
+		
+		exportTaskName = "#{@prefix}:export"
+		exportTask = Rake::Task.define_task exportTaskName do
+		  clean
+          fetch_existing
+		  export
+		  commit_new
+		end
+		exportTask.add_description "Export the generated documentation to #{@repository}/#{@branch}"
+		#exportTask.enhance [:compile]
+		
+		
+		return exportTaskName
+	end
+	
+	def dump_task
+	  dumpTask = Rake::Task.define_task "#{@prefix}:dump" do
+	    clean
+		@options[:dump] = true
+		export
+	  end
+	  dumpTask.add_description "Export the generated documentation to #{@export_dir} for local usage"
+	end
+  end
+  

data/lib/fuburake.rb

@@ -25,7 +25,8 @@ module FubuRake
 		:integration_test,
 		:compilations,
 		:bottles,
-		:bottles_enabled
+		:bottles_enabled,
+		:doc_exports
 		
 	def initialize
 	    @options = {}
@@ -51,6 +52,12 @@ module FubuRake
 	
 		@bottles << FubuRake::AssemblyBottle.new(project)
 	end
+	
+	def export_docs(options)
+		@doc_exports ||= []
+		
+		@doc_exports << options
+	end
   end
   
   class Solution
@@ -92,6 +99,7 @@ module FubuRake
 	  tasks.defaults ||= []
 	  tasks.ci_steps ||= []
 	  tasks.precompile ||= []
+	  tasks.doc_exports ||= []
 	  
 
 	  enable_docs tasks
@@ -138,6 +146,18 @@ module FubuRake
 		  c.create @options
 		end
 	  end
+	  
+	  tasks.doc_exports.each do |opts|
+	    opts[:version] = @build_number
+		
+		docs = FubuDocs.new(opts)
+		
+		doc_task_name = docs.export_tasks
+		if opts[:include_in_ci]
+		  add_dependency :ci, doc_task_name
+		end
+	  end
+	  
 	end
 	
 	def add_dependency(from, to)
@@ -193,6 +213,12 @@ module FubuRake
 		
 	  end
 	end
+	
+	def dump_html(options)
+	  options[:version] = @build_number
+	  docs = FubuDocs.new(options)
+	  docs.dump_task
+	end
   end
   
   class MvcApp

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fuburake
 version: !ruby/object:Gem::Version
-  version: 0.9.0.26
+  version: 0.9.5.29
 platform: ruby
 authors:
 - Jeremy D. Miller
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-16 00:00:00.000000000 Z
+date: 2013-09-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ripple-cli