pith 0.2.0 → 0.2.1

data/lib/pith/input/abstract.rb~

@@ -1,74 +0,0 @@
-require "pathname"
-
-module Pith
-  module Input
-
-    class Abstract
-
-      def initialize(project, path)
-        @project = project
-        @path = path
-      end
-
-      attr_reader :project, :path
-
-      # Public: Get the file-system location of this input.
-      #
-      # Returns a fully-qualified Pathname.
-      #
-      def file
-        project.input_dir + path
-      end
-
-      def output_file
-        project.output_dir + output_path
-      end
-
-      # Public: Generate a corresponding output file.
-      #
-      def build
-        return false if ignorable? || uptodate?
-        logger.info("%-14s%s" % ["--(#{type})-->", output_path])
-        generate_output 
-      end
-
-      # Public: Resolve a reference relative to this input.
-      #
-      # ref - a String referencing another asset
-      #
-      # A ref starting with "/" is resolved relative to the project root;
-      # anything else is resolved relative to this input.
-      #
-      # Returns a fully-qualified Pathname of the asset.
-      #
-      def resolve_path(ref)
-        ref = ref.to_str
-        if ref[0,1] == "/"
-          Pathname(ref[1..-1])
-        else
-          path.parent + ref
-        end
-      end
-
-      # Consider whether this input can be ignored.
-      #
-      # Returns true if it can.
-      #
-      def ignorable?
-        path.to_s.split("/").any? { |component| component.to_s[0,1] == "_" }
-      end
-
-      protected
-        
-      def default_title
-        path.to_s.sub(/\..*/, '').tr('_-', ' ').capitalize
-      end
-
-      def logger
-        project.logger
-      end
-
-    end
-
-  end
-end

data/lib/pith/input/base.rb~

@@ -1,74 +0,0 @@
-require "pathname"
-
-module Pith
-  module Input
-
-    class Abstract
-
-      def initialize(project, path)
-        @project = project
-        @path = path
-      end
-
-      attr_reader :project, :path
-
-      # Public: Get the file-system location of this input.
-      #
-      # Returns a fully-qualified Pathname.
-      #
-      def file
-        project.input_dir + path
-      end
-
-      # Public: Get the file-system location of the corresponding output file.
-      #
-      # Returns a fully-qualified Pathname.
-      #
-      def output_file
-        project.output_dir + output_path
-      end
-
-      # Public: Generate an output file.
-      #
-      def build
-        return false if ignorable? || uptodate?
-        logger.info("%-16s%s" % ["--(#{type})-->", output_path])
-        generate_output 
-      end
-
-      # Public: Resolve a reference relative to this input.
-      #
-      # ref - a String referencing another asset
-      #
-      # A ref starting with "/" is resolved relative to the project root;
-      # anything else is resolved relative to this input.
-      #
-      # Returns a fully-qualified Pathname of the asset.
-      #
-      def resolve_path(ref)
-        ref = ref.to_str
-        if ref[0,1] == "/"
-          Pathname(ref[1..-1])
-        else
-          path.parent + ref
-        end
-      end
-
-      # Consider whether this input can be ignored.
-      #
-      # Returns true if it can.
-      #
-      def ignorable?
-        path.to_s.split("/").any? { |component| component.to_s[0,1] == "_" }
-      end
-
-      protected
-
-      def logger
-        project.logger
-      end
-
-    end
-
-  end
-end

data/lib/pith/input/resource.rb

@@ -1,39 +0,0 @@
-require "fileutils"
-require "pith/input/abstract"
-
-module Pith
-  module Input
-
-    # Represents a non-template input.
-    #
-    class Resource < Abstract
-
-      def output_path
-        path
-      end
-
-      def uptodate?
-        FileUtils.uptodate?(output_file, [file])
-      end
-
-      # Copy this input verbatim into the output directory
-      #
-      def generate_output
-        output_file.parent.mkpath
-        FileUtils.copy(file, output_file)
-      end
-
-      # Render this input, for inclusion within templates
-      #
-      def render(context, locals = {})
-        file.read
-      end
-
-      def meta
-        {}
-      end
-
-    end
-
-  end
-end

data/lib/pith/input/resource.rb~

@@ -1,41 +0,0 @@
-require "fileutils"
-require "pith/input/abstract"
-
-module Pith
-  module Input
-
-    class Resource < Abstract
-
-      def output_path
-        path
-      end
-      
-      def type
-        "copy"
-      end
-      
-      def uptodate?
-        FileUtils.uptodate?(output_file, [file])
-      end
-      
-      # Copy this input verbatim into the output directory
-      #
-      def generate_output
-        output_file.parent.mkpath
-        FileUtils.copy(file, output_file)
-      end
-
-      # Render this input, for inclusion within templates
-      #
-      def render(context, locals = {})
-        file.read
-      end
-
-      def meta
-        {}
-      end
-      
-    end
-
-  end
-end

data/lib/pith/input/template.rb

@@ -1,159 +0,0 @@
-require "fileutils"
-require "pathname"
-require "pith/exception_ext"
-require "pith/input/abstract"
-require "pith/render_context"
-require "tilt"
-require "yaml"
-
-module Pith
-  module Input
-
-    # Represents an input that should be evaluated as a template.
-    #
-    class Template < Abstract
-
-      def self.can_handle?(path)
-        !!Tilt[path.to_s]
-      end
-
-      def initialize(project, path)
-        raise(ArgumentError, "#{path} is not a template") unless Template.can_handle?(path)
-        super(project, path)
-        determine_pipeline
-        load
-      end
-
-      attr_reader :output_path
-
-      # Check whether output is up-to-date.
-      #
-      # Return true unless output needs to be re-generated.
-      #
-      def uptodate?
-        dependencies && FileUtils.uptodate?(output_file, dependencies)
-      end
-
-      # Generate output for this template
-      #
-      def generate_output
-        output_file.parent.mkpath
-        render_context = RenderContext.new(project)
-        output_file.open("w") do |out|
-          begin
-            out.puts(render_context.render(self))
-          rescue StandardError, SyntaxError => e
-            logger.warn e.summary(:max_backtrace => 5)
-            out.puts "<pre>"
-            out.puts e.summary
-          end
-        end
-        @dependencies = render_context.dependencies
-      end
-
-      # Render this input using Tilt
-      #
-      def render(context, locals = {}, &block)
-        @pipeline.inject(@template_text) do |text, processor|
-          template = processor.new(file.to_s, @template_start_line) { text }
-          template.render(context, locals, &block)
-        end
-      end
-
-      # Public: Get YAML metadata declared in the header of of a template.
-      #
-      # If the first line of the template starts with "---" it is considered to be
-      # the start of a YAML 'document', which is loaded and returned.
-      #
-      # Examples
-      #
-      #   Given input starting with:
-      #
-      #     ---
-      #     published: 2008-09-15
-      #     ...
-      #     OTHER STUFF
-      #
-      #   input.meta
-      #   #=> { "published" => "2008-09-15" }
-      #
-      # Returns a Hash.
-      #
-      def meta
-        @meta
-      end
-
-      # Public: Get page title.
-      #
-      # The default title is based on the input file-name, sans-extension, capitalised,
-      # but can be overridden by providing a "title" in the metadata block.
-      #
-      # Examples
-      #
-      #  input.path.to_s
-      #  #=> "some_page.html.haml"
-      #  input.title
-      #  #=> "Some page"
-      #
-      def title
-        meta["title"] || default_title
-      end
-
-      private
-
-      def default_title
-        path.basename.to_s.sub(/\..*/, '').tr('_-', ' ').capitalize
-      end
-
-      def determine_pipeline
-        @pipeline = []
-        remaining_path = path.to_s
-        while remaining_path =~ /^(.+)\.(.+)$/
-          if Tilt[$2]
-            remaining_path = $1
-            @pipeline << Tilt[$2]
-          else
-            break
-          end
-        end
-        @output_path = Pathname(remaining_path)
-      end
-
-      # Read input file, extracting YAML meta-data header, and template content.
-      #
-      def load
-        file.open do |input|
-          load_meta(input)
-          load_template(input)
-        end
-      end
-
-      def load_meta(input)
-        @meta = {}
-        header = input.gets
-        if header =~ /^---/
-          while line = input.gets
-            break if line =~ /^(---|\.\.\.)/
-            header << line
-          end
-          begin
-            @meta = YAML.load(header)
-          rescue ArgumentError, SyntaxError
-            logger.warn "#{file}:1: badly-formed YAML header"
-          end
-        else
-          input.rewind
-        end
-      end
-
-      def load_template(input)
-        @template_start_line = input.lineno + 1
-        @template_text = input.read
-      end
-
-      attr_accessor :dependencies
-
-    end
-
-  end
-end

data/lib/pith/input/template.rb~

@@ -1,126 +0,0 @@
-require "fileutils"
-require "pathname"
-require "pith/input/abstract"
-require "pith/render_context"
-require "tilt"
-require "yaml"
-
-module Pith
-  module Input
-
-    class Template < Abstract
-
-      def self.can_handle?(path)
-        path.to_str =~ /\.([^.]+)$/ && Tilt.registered?($1)
-      end
-      
-      def initialize(project, path)
-        raise(ArgumentError, "#{path} is not a template") unless Template.can_handle?(path)
-        super(project, path)
-        path.to_str =~ /^(.+)\.(.+)$/ || raise("huh?")
-        @output_path = Pathname($1)
-        @type = $2
-        load
-      end
-
-      attr_reader :output_path, :type
-
-      # Check whether output is up-to-date.
-      #
-      # Return true unless output needs to be re-generated.
-      #
-      def uptodate?
-        dependencies && FileUtils.uptodate?(output_file, dependencies)
-      end
-
-      # Generate output for this template
-      #
-      def generate_output
-        output_file.parent.mkpath
-        render_context = RenderContext.new(project)
-        output_file.open("w") do |out|
-          out.puts(render_context.render(self))
-        end
-        @dependencies = render_context.dependencies
-      end
-
-      # Render this input using Tilt
-      #
-      def render(context, locals = {}, &block)
-        @tilt_template.render(context, locals, &block)
-      end
-      
-      # Public: Get YAML metadata declared in the header of of a template.
-      # 
-      # If the first line of the template starts with "---" it is considered to be
-      # the start of a YAML 'document', which is loaded and returned.
-      #
-      # Examples
-      #
-      #   Given input starting with:
-      #
-      #     ---
-      #     published: 2008-09-15
-      #     ...
-      #     OTHER STUFF
-      #
-      #   input.meta
-      #   #=> { "published" => "2008-09-15" }
-      #  
-      # Returns a Hash.
-      #
-      def meta
-        @meta
-      end
-
-      # Public: Get page title.
-      #
-      # The default title is based on the input file-name, sans-extension, capitalised,
-      # but can be overridden by providing a "title" in the metadata block.
-      #
-      # Examples
-      #
-      #  input.path.to_s
-      #  #=> "some_page.html.haml"
-      #  input.title
-      #  #=> "Some page"
-      # 
-      def title
-        meta["title"] || default_title
-      end
-
-      private
-        
-      def default_title
-        path.basename.to_s.sub(/\..*/, '').tr('_-', ' ').capitalize
-      end
-
-      # Read input file, extracting YAML meta-data header, and template content.
-      #
-      def load
-        @meta = {}
-        file.open do |input|
-          header = input.gets
-          if header =~ /^---/
-            while line = input.gets
-              break if line =~ /^(---|\.\.\.)/
-              header << line
-            end
-            begin
-              @meta = YAML.load(header)
-            rescue
-              logger.warn "#{file}:1: badly-formed YAML header"
-            end
-          else
-            input.rewind
-          end
-          @tilt_template = Tilt.new(file, input.lineno + 1) { input.read }
-        end
-      end
-      
-      attr_accessor :dependencies
-
-    end
-
-  end
-end