epubforge 0.0.5

data/lib/action/thor_action.rb

@@ -0,0 +1,149 @@
+module EpubForge
+  module Action
+    module SharedActionInterface
+      def description( str = nil )
+        @description = str if str
+        @description
+      end
+      
+      def keywords( *args )
+        if args.epf_blank?
+          @keywords ||= []
+        else 
+          @keywords = args.map(&:to_s)
+        end
+        
+        @keywords
+      end
+      
+      def usage( str = nil )
+        @usage = str if str
+        @usage
+      end
+      
+      def project_required?
+        @project_required = true if @project_required.nil?
+        @project_required
+      end
+      
+      # Most actions require -- nay, demand! -- a project to act upon.
+      # Add the line 'project_not_required' to the class definition
+      # to keep it from failing out if it can't find an existing project.
+      # Used for things like initializing new projects, or... my imagination
+      # fails me.
+      def project_not_required
+        @project_required = false
+      end
+    end
+    
+    class ThorAction < Thor
+      include Thor::Actions
+      extend SharedActionInterface
+      
+      
+      CLEAR     = Thor::Shell::Color::CLEAR
+      RED       = Thor::Shell::Color::RED
+      BLUE      = Thor::Shell::Color::BLUE
+      YELLOW    = Thor::Shell::Color::YELLOW
+      GREEN     = Thor::Shell::Color::GREEN
+      MAGENTA   = Thor::Shell::Color::MAGENTA
+      ON_YELLOW = Thor::Shell::Color::ON_YELLOW
+      ON_BLUE   = Thor::Shell::Color::ON_BLUE
+      
+      
+      protected
+      def say_error( statement )
+        say( "ERROR : #{statement}", RED + ON_BLUE )
+      end
+      
+      def say_instruction( statement )
+        say( statement, YELLOW )
+      end
+      
+      def say_all_is_well( statement )
+        say( statement, GREEN )
+      end
+      
+      def say_in_warning( statement )
+        warn( statement, RED )
+      end
+      
+      def say_subtly( statement )
+        say( statement, MAGENTA )
+      end
+      
+      def yes_prettily?( statement )
+        yes?( statement, BLUE )
+      end
+      
+      
+      
+      # choices = Array of Arrays(length:2) or Strings.  Can be intermingled freely.
+      # when the user selects a string, returns the string.  For the array,
+      # the user sees the first item, and the programmer gets back the last item
+      def ask_from_menu( statement, choices )
+        choices.map! do |choice|
+          choice.is_a?(String) ? [choice] : choice    # I'm being too clever by half here.  .first/.last still works.
+        end
+        
+        choice_text = ""
+        choices.each_with_index{ |choice,i|
+          choice_text << "\t\t#{i}) #{choice.first}\n" 
+        }
+        
+        selection = ask( "#{statement}\n\tChoices:\n#{choice_text}>>> ", BLUE )
+        choices[selection.to_i].last
+      end
+      
+      def ask_prettily( statement )
+        ask( statement, BLUE )
+      end
+      
+      # hope this doesn't break anything.  Sure enough, it broke a lot of things.
+      # def destination_root=( root )
+      #   @destination_stack ||= []
+      #   @destination_stack << (root ? root.fwf_filepath.expand : '')
+      # end
+
+      # Instead, use these instead of destination_root.  Thor gets strings instead of
+      # filepaths, like it wants, and I get filepaths instead of strings, like I want.
+      def destination_root_filepath
+        self.destination_root.fwf_filepath
+      end
+
+      def destination_root_filepath=(root)
+        self.destination_root = root.to_s
+      end
+      
+      def executable_installed?( name )
+        name = name.to_sym
+        
+        if @executables.nil?
+          @executables = {}
+          for exe, path in (EpubForge.config[:exe_paths] || {})
+            @executables[exe] = path.fwf_filepath
+          end
+        end
+        
+        @executables[name] ||= begin
+          _which = `which #{name}`.strip
+          (_which.length == 0) ? false : _which.fwf_filepath
+        end
+          
+        @executables[name]  
+      end
+      
+      def git_installed?
+        executable_installed?('git')
+      end
+      
+      def ebook_convert_installed?
+        executable_installed?('ebook-convert')
+      end
+      
+      def project_already_gitted?
+        @project.target_dir.join( ".git" ).directory?
+      end
+    end
+  end
+end

data/lib/core_extensions/array.rb

@@ -0,0 +1,5 @@
+class Array
+  def epf_blank?
+    length == 0
+  end
+end

data/lib/core_extensions/kernel.rb

@@ -0,0 +1,42 @@
+module Kernel
+  # def puts_nowhere( &block )
+  #   collect_stdout( "/dev/null", &block )
+  # end
+  # 
+  # def collect_stdout( dest, &block )
+  #   @puts_nowhere_keep_old_stdout ||= []
+  #   @puts_nowhere_keep_old_stdout << $stdout 
+  #   if dest.is_a?(String)
+  #       $stdout = File.open( dest, "w" )
+  #     else
+  #       $stdout = dest
+  #     end
+  # 
+  #   $stdout.sync = true
+  # 
+  #   yield
+  # 
+  #   $stdout = @puts_nowhere_keep_old_stdout.pop 
+  # end
+  
+  # yields an alternate reality block where instance methods
+  # are different from what they were.  At the end of the block
+  # it resets the initial values of the instance variables.
+  def with_locals locals = {}, &block
+    old_local_vars = {}
+
+    for k, v in locals
+      var = :"@#{k}"
+      old_local_vars[k] = instance_variable_get(var)
+      instance_variable_set( var, v )
+    end
+
+    yield
+  ensure      # make all as it once was
+    for k, v in old_local_vars
+      var = :"@#{k}"
+      instance_variable_set( var, v )
+    end
+  end
+  
+end

data/lib/core_extensions/nil_class.rb

@@ -0,0 +1,5 @@
+class NilClass
+  def epf_blank?
+    true
+  end
+end

data/lib/core_extensions/object.rb

@@ -0,0 +1,5 @@
+class Object
+  def umethods( regex = /.*/ )
+    (self.methods.sort - Object.new.methods).grep( regex )
+  end
+end

data/lib/core_extensions/string.rb

@@ -0,0 +1,37 @@
+class String
+  TITLE_WORDS_NOT_CAPITALIZED = %W(a an in the for and nor but or yet so also)
+  def epf_blank?
+    self.strip.length == 0  
+  end
+  
+  def epf_camelize
+    gsub(/(?:^|_)(.)/) { $1.upcase }
+  end
+
+  # TODO: Need comprehensive list of characters to be protected.
+  def epf_backhashed_filename
+    self.gsub(" ", "\\ ")  
+  end
+  
+  def epf_underscorize
+    self.downcase.gsub(/\s+/,"_").gsub(/[\W]/,"")
+  end
+  
+  # def fwf_filepath
+  #   EpubForge::FunWith::Files::FilePath.new(self)
+  # end
+  
+  def to_pathname
+    Pathname.new( self )
+  end
+  
+  def epf_deunderscorize_as_title
+    words = self.split("_")
+    
+    words = [words[0].capitalize] + words[1..-1].map{|w| 
+      TITLE_WORDS_NOT_CAPITALIZED.include?(w) ? w : w.capitalize
+    }
+    
+    words.join(" ")
+  end
+end

data/lib/custom_helpers.rb

@@ -0,0 +1,60 @@
+module EpubForge
+  module CustomHelpers
+    def ask question, opts = {}
+      opts[:menu] ||= [["Y", "Yes"], ["N", "No"]]
+
+      answer = nil
+
+      while answer.nil?
+        menu_string = opts[:menu].map{ |li| "#{li[0]}):\t#{li[1]}"}.join("\n\t")
+        puts "#{question} :\n\t#{ menu_string }"
+        line = Readline.readline(">> ",true).strip.upcase
+
+        opts[:menu].each{ |li|
+          if li[0].upcase == line.to_s
+            answer = li
+          end
+        }
+    
+        puts "I don't understand that response" if answer.nil?
+      end
+
+      if opts[:return_value]
+        answer[1]
+      else
+        answer[0].upcase
+      end
+    end
+
+    def collect_stdout( dest = StringIO.new, &block )
+              raise ArgumentError.new("No block given.") unless block_given?
+              
+              prior_stdout = $stdout
+              # @epf_prior_stdout_stack ||= []
+              # @epf_prior_stdout_stack << $stdout
+               
+              $stdout = begin
+                          if dest.is_a?( String ) || dest.is_a?( Pathname )
+                            File.open( dest, "a" )
+                          elsif dest.is_a?( IO ) || dest.is_a?( StringIO )
+                            dest
+                          else
+                            raise ArgumentError.new("collect_stdout cannot take a <#{dest.class.name}> as an argument.")
+                          end
+                        end
+            
+              $stdout.sync = true
+              yield
+            
+              $stdout = prior_stdout
+              
+              dest.is_a?( StringIO ) ? dest.string : nil
+            end
+                    # 
+                    # def collect_stdout( *args, &block )
+                    #   yield
+                    # end
+  end
+end
+
+EpubForge.extend( EpubForge::CustomHelpers )

data/lib/epub/assets/asset.rb

@@ -0,0 +1,11 @@
+module EpubForge
+  module Epub
+    module Assets
+      class Asset
+        def media_type
+          MEDIA_TYPES[@ext]
+        end
+      end
+    end
+  end
+end

data/lib/epub/assets/html.rb

@@ -0,0 +1,8 @@
+module EpubForge
+  module Epub
+    module Assets
+      class HTML < Page
+      end
+    end
+  end
+end

data/lib/epub/assets/image.rb

@@ -0,0 +1,18 @@
+module EpubForge
+  module Epub
+    module Assets
+      class Image < Asset
+        attr_reader :ext, :filename, :name
+        def initialize( filename, options = {} )
+          @filename = filename.fwf_filepath
+          @name     = @filename.basename.to_s.split(".")[0..-2].join(".")
+          @ext      = @filename.extname.gsub( /^\./, "" )
+        end
+  
+        def link
+          IMAGES_DIR.join( @name )
+        end
+      end
+    end
+  end
+end

data/lib/epub/assets/markdown.rb

@@ -0,0 +1,8 @@
+module EpubForge
+  module Epub
+    module Assets
+      class Markdown < Page
+      end
+    end
+  end
+end

data/lib/epub/assets/page.rb

@@ -0,0 +1,32 @@
+module EpubForge
+  module Epub
+    module Assets
+      class Page < Asset
+        attr_reader :html, :original_file, :title, :project, :media_type, :dest_extension
+        attr_accessor :section_id, :section_number
+
+        def initialize file, metadata, project
+          raise "NIL" if project.nil?
+        
+          @metadata = metadata
+          @project  = project
+          @original_file = file
+          @dest_extension = "xhtml"
+
+          @html = Utils::Htmlizer.instance.translate( file )
+          @title = File.basename( file ).split(".")[0..-2].map(&:capitalize).join(" : ")
+          @content = ""
+          puts "Initialized #{file} with title [#{@title}]"
+        end
+        
+        def link
+          TEXT_DIR.join( "section#{ sprintf("%04i", @section_number) }.#{@dest_extension}" )
+        end
+        
+        def media_type
+          MEDIA_TYPES[@dest_extension]
+        end
+      end
+    end
+  end
+end

data/lib/epub/assets/stylesheet.rb

@@ -0,0 +1,22 @@
+module EpubForge
+  module Epub
+    module Assets
+      class Stylesheet < Asset
+        attr_accessor :filename, :name, :contents
+        def initialize( filename )
+          @filename = filename.fwf_filepath
+          @name     = @filename.basename
+          @contents = @filename.read
+        end
+      
+        def link
+          STYLE_DIR.join( @name )
+        end
+        
+        def media_type
+          MEDIA_TYPES["css"]
+        end
+      end
+    end
+  end
+end

data/lib/epub/assets/textile.rb

@@ -0,0 +1,8 @@
+module EpubForge
+  module Epub
+    module Assets
+      class Textile < Page
+      end
+    end
+  end
+end