magneto 0.1.0

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2012 Don Melton
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,44 @@
+# Magneto
+
+Magneto is a static site generator.
+
+## About
+
+Hi, I'm Don Melton. I wrote Magneto to generate [my own website](http://donmelton.com/). Magneto was inspired by [nanoc](http://nanoc.stoneship.org/) and [Jekyll](http://jekyllrb.com/), but it's a much simpler tool with fewer features and less policy.
+
+For example, Magneto is not "blog aware" like some other systems, but it allows you to write a site controller script and plugins which can easily generate blog posts, an index page and a RSS feed. This is how I use it. There may be more work up front compared to other tools, but Magneto gives you very precise control over its behavior and output.
+
+Before using Magneto, realize that it does have limitations due to its simplicity and that its programming interface may change because it's still under development.
+
+## Usage
+
+        magneto [OPTION]...
+
+Source file items, their templates and the site controller script are loaded from the `items` and `templates` directories and from the `script.rb` file, all within the current directory. These are watched for changes and reloaded when automatic regeneration is enabled.
+
+Ruby library files are loaded from the `plugins` directory only once.
+
+The generated site is written to the `output` directory.
+
+Configuration is loaded from `config.yaml` but can be overriden using the following options:
+
+        -c, --config PATH                use specific YAML configuration file
+        -s, --source PATH                use specific source directory
+        -o, --output PATH                use specific output directory
+    
+            --[no-]hidden                include [exclude] hidden source files
+            --[no-]remove                remove [keep] obsolete output
+            --[no-]auto                  enable [disable] automatic regeneration
+    
+        -h, --help                       display this help and exit
+            --version                    output version information and exit
+
+## Dependencies
+
+Magneto doesn't have any dependencies for basic operation.
+
+Enabling automatic regeneration requires installation of the Directory Watcher gem:
+
+        sudo gem install directory_watcher
+
+Using any of the built-in filters could require additional gem installations.

data/bin/magneto

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift File.expand_path(File.dirname(__FILE__) + '/../lib')
+
+require 'magneto'
+
+Magneto.application.run

data/lib/magneto.rb

@@ -0,0 +1,30 @@
+require 'English'
+require 'fileutils'
+require 'optparse'
+require 'rubygems'
+require 'set'
+require 'yaml'
+
+require 'magneto/application'
+require 'magneto/context'
+require 'magneto/core_ext'
+require 'magneto/filter'
+require 'magneto/filters'
+require 'magneto/item'
+require 'magneto/readable'
+require 'magneto/render_context'
+require 'magneto/script_context'
+require 'magneto/site'
+require 'magneto/template'
+
+module Magneto
+
+  VERSION = '0.1.0'
+
+  class << self
+
+    def application
+      @application ||= Application.new
+    end
+  end
+end

data/lib/magneto/application.rb

@@ -0,0 +1,153 @@
+module Magneto
+
+  class Application
+
+    attr_reader :config, :filters, :site
+
+    def initialize
+      super
+      @options = {}
+      @config_path = 'config.yaml'
+      @config = {
+        :source_path        => '.',
+        :output_path        => 'output',
+        :hidden_files       => false,
+        :remove_obsolete    => false,
+        :auto_regeneration  => false
+      }
+      @filters = {}
+      @site = nil
+    end
+
+    def run
+      parse_options
+      load_configuration
+
+      @config.deep_merge! @options
+
+      [:source_path, :output_path].each do |path|
+        @config[path] = File.expand_path(@config[path])
+        @config[path].freeze
+      end
+
+      load_plugins
+      find_filters
+
+      @site = Site.new(@config, @filters)
+
+      if @config[:auto_regeneration]
+        puts 'Automatic regeneration enabled.'
+
+        require 'directory_watcher'
+
+        dw = DirectoryWatcher.new(@config[:source_path])
+        dw.glob = [@config[:hidden_files] ? 'items/**/{.[^.],}*' : 'items/**/*', 'templates/*.*', 'script.rb']
+        dw.interval = 1
+        dw.add_observer { |*args| @site.generate }
+        dw.start
+        gets
+        dw.stop
+      else
+        @site.generate
+      end
+
+      exit
+    end
+
+    private
+
+    def parse_options
+      begin
+        OptionParser.new do |opts|
+          opts.banner = "Magneto is a static site generator."
+          opts.separator ""
+          opts.separator "  Usage: #{File.basename($PROGRAM_NAME)} [OPTION]..."
+          opts.separator ""
+          opts.separator "  Source file items, their templates and the site controller script"
+          opts.separator "  are loaded from the 'items' and 'templates' directories and from the"
+          opts.separator "  'script.rb' file, all within the current directory. These are watched"
+          opts.separator "  for changes and reloaded when automatic regeneration is enabled."
+          opts.separator ""
+          opts.separator "  Ruby library files are loaded from the 'plugins' directory only once."
+          opts.separator ""
+          opts.separator "  The generated site is written to the 'output' directory."
+          opts.separator ""
+          opts.separator "  Configuration is loaded from 'config.yaml' but can be overriden"
+          opts.separator "  using the following options:"
+          opts.separator ""
+
+          opts.on('-c', '--config PATH', 'use specific YAML configuration file')  { |cp| @config_path = cp }
+          opts.on('-s', '--source PATH', 'use specific source directory')         { |sp| @options[:source_path] = sp }
+          opts.on('-o', '--output PATH', 'use specific output directory')         { |op| @options[:output_path] = op }
+
+          opts.separator ""
+
+          opts.on('--[no-]hidden', 'include [exclude] hidden source files')       { |hf| @options[:hidden_files] = hf }
+          opts.on('--[no-]remove', 'remove [keep] obsolete output')               { |ro| @options[:remove_obsolete] = ro }
+          opts.on('--[no-]auto', 'enable [disable] automatic regeneration')       { |ar| @options[:auto_regeneration] = ar }
+
+          opts.separator ""
+
+          opts.on_tail('-h', '--help', 'display this help and exit') do
+            puts opts
+            exit
+          end
+
+          opts.on_tail '--version', 'output version information and exit' do
+            puts <<VERSION_HERE
+#{File.basename($PROGRAM_NAME)} #{VERSION}
+Copyright (c) 2012 Don Melton
+This is free software; see the source for copying conditions.  There is NO
+warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+VERSION_HERE
+            exit
+          end
+        end.parse!
+      rescue => ex
+        $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+        usage
+      end
+
+      if ARGV.size > 0
+        $stderr.print "#{File.basename($PROGRAM_NAME)}: unknown argument(s):"
+        ARGV.each { |a| $stderr.print " #{a}" }
+        $stderr.puts
+        usage
+      end
+    end
+
+    def usage
+      $stderr.puts "Try '#{File.basename($PROGRAM_NAME)} --help' for more information."
+      exit false
+    end
+
+    def load_configuration
+      puts 'Loading configuration...'
+
+      begin
+        configuration = YAML.load_file(@config_path)
+        raise unless configuration.is_a? Hash
+      rescue => ex
+        $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+        $stderr.puts "WARNING: Couldn't load configuration. Using defaults (and options)."
+        configuration = {}
+      end
+
+      @config.deep_merge! configuration.symbolize_keys
+    end
+
+    def load_plugins
+      puts 'Loading plugins...'
+      Dir[@config[:source_path] + '/plugins/**/*.rb'].each { |plugin| require plugin unless File.directory? plugin }
+    end
+
+    def find_filters
+      puts 'Finding filters...'
+
+      Magneto::Filter.subclasses.each do |subclass|
+        filter = subclass.new(@config)
+        @filters[filter.name.to_sym] = filter
+      end
+    end
+  end
+end

data/lib/magneto/context.rb

@@ -0,0 +1,21 @@
+module Magneto
+
+  # Adapted from `nanoc/base/context.rb` with thanks to Denis Defreyne and
+  # contributors.
+  class Context
+
+    def initialize(ivars)
+      super()
+      eigenclass = class << self ; self ; end
+
+      ivars.each do |symbol, value|
+        instance_variable_set('@' + symbol.to_s, value)
+        eigenclass.send(:define_method, symbol) { value } unless eigenclass.send(:respond_to?, symbol)
+      end
+    end
+
+    def get_binding
+      binding
+    end
+  end
+end

data/lib/magneto/core_ext.rb

@@ -0,0 +1,58 @@
+class Hash
+
+  # Copied from `active_support/core_ext/hash/keys.rb` with thanks to David
+  # Heinemeier Hansson and contributors.
+
+  # Return a new hash with all keys converted to strings.
+  def stringify_keys
+    dup.stringify_keys!
+  end
+
+  # Destructively convert all keys to strings.
+  def stringify_keys!
+    keys.each do |key|
+      self[key.to_s] = delete(key)
+    end
+    self
+  end
+
+  # Return a new hash with all keys converted to symbols, as long as
+  # they respond to +to_sym+.
+  def symbolize_keys
+    dup.symbolize_keys!
+  end
+
+  # Destructively convert all keys to symbols, as long as they respond
+  # to +to_sym+.
+  def symbolize_keys!
+    keys.each do |key|
+      self[(key.to_sym rescue key) || key] = delete(key)
+    end
+    self
+  end
+
+  # Adapted from `jekyll/core_ext.rb` with thanks to Tom Preston-Werner.
+
+  # Merges self with another hash, recursively.
+  #
+  # This code was lovingly stolen (now adapted) from some random gem:
+  # http://gemjack.com/gems/tartan-0.1.1/classes/Hash.html
+  #
+  # Thanks to whoever made it.
+  def deep_merge(hash)
+    dup.deep_merge! hash
+  end
+
+  def deep_merge!(hash)
+    hash.keys.each do |key|
+      if hash[key].is_a? Hash and self[key].is_a? Hash
+        self[key] = self[key].deep_merge(hash[key])
+        next
+      end
+
+      self[key] = hash[key]
+    end
+
+    self
+  end
+end

data/lib/magneto/filter.rb

@@ -0,0 +1,21 @@
+module Magneto
+
+  # Adapted from `jekyll/plugin.rb` with thanks to Tom Preston-Werner.
+  class Filter
+
+    class << self
+
+      def inherited(subclass)
+        subclasses << subclass
+      end
+
+      def subclasses
+        @subclasses ||= []
+      end
+    end
+
+    def initialize(config)
+      @config = config
+    end
+  end
+end

data/lib/magneto/filters.rb

@@ -0,0 +1,13 @@
+require 'magneto/filters/bluecloth'
+require 'magneto/filters/coffeescript'
+require 'magneto/filters/erb'
+require 'magneto/filters/erubis'
+require 'magneto/filters/haml'
+require 'magneto/filters/kramdown'
+require 'magneto/filters/less'
+require 'magneto/filters/maruku'
+require 'magneto/filters/rdiscount'
+require 'magneto/filters/redcarpet'
+require 'magneto/filters/redcloth'
+require 'magneto/filters/rubypants'
+require 'magneto/filters/sass'

data/lib/magneto/filters/bluecloth.rb

@@ -0,0 +1,22 @@
+module Magneto
+
+  class BlueClothFilter < Filter
+
+    def name
+      'bluecloth'
+    end
+
+    def apply(content, ivars)
+      begin
+        require 'bluecloth'
+      rescue LoadError => ex
+        $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+        $stderr.puts "You're missing a library required to use BlueCloth. Try running:"
+        $stderr.puts '  $ [sudo] gem install bluecloth'
+        raise 'Missing dependency: bluecloth'
+      end
+
+      BlueCloth.new(content, (ivars[:bluecloth].symbolize_keys rescue {})).to_html
+    end
+  end
+end

data/lib/magneto/filters/coffeescript.rb

@@ -0,0 +1,22 @@
+module Magneto
+
+  class CoffeeScriptFilter < Filter
+
+    def name
+      'coffeescript'
+    end
+
+    def apply(content, ivars)
+      begin
+        require 'coffee-script'
+      rescue LoadError => ex
+        $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+        $stderr.puts "You're missing a library required to use CoffeeScript. Try running:"
+        $stderr.puts '  $ [sudo] gem install coffee-script'
+        raise 'Missing dependency: coffee-script'
+      end
+
+      CoffeeScript.compile(content, (ivars[:coffeescript].symbolize_keys rescue {}))
+    end
+  end
+end

data/lib/magneto/filters/erb.rb

@@ -0,0 +1,22 @@
+module Magneto
+
+  class ERBFilter < Filter
+
+    def name
+      'erb'
+    end
+
+    def apply(content, ivars)
+      require 'erb'
+
+      # Adapted from `nanoc/filters/erb.rb` with thanks to Denis Defreyne and
+      # contributors.
+      context = RenderContext.new(ivars)
+      proc = ivars[:content] ? lambda { ivars[:content] } : lambda {}
+      b = context.get_binding(&proc)
+
+      args = ivars[:erb].symbolize_keys rescue {}
+      ERB.new(content, args[:safe_level], args[:trim_mode]).result b
+    end
+  end
+end

data/lib/magneto/filters/erubis.rb

@@ -0,0 +1,28 @@
+module Magneto
+
+  class ErubisFilter < Filter
+
+    def name
+      'erubis'
+    end
+
+    def apply(content, ivars)
+      begin
+        require 'erubis'
+        require 'erubis/engine/enhanced'
+      rescue LoadError => ex
+        $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+        $stderr.puts "You're missing a library required to use Erubis. Try running:"
+        $stderr.puts '  $ [sudo] gem install erubis'
+        raise 'Missing dependency: erubis'
+      end
+
+      # Adapted from "nanoc/filters/erubis.rb" with thanks to Denis Defreyne and contributors.
+      context = RenderContext.new(ivars)
+      proc = ivars[:content] ? lambda { ivars[:content] } : lambda {}
+      b = context.get_binding(&proc)
+
+      Erubis::ErboutEruby.new(content, (ivars[:erubis].symbolize_keys rescue {})).result b
+    end
+  end
+end

data/lib/magneto/filters/haml.rb

@@ -0,0 +1,26 @@
+module Magneto
+
+  class HamlFilter < Filter
+
+    def name
+      'haml'
+    end
+
+    def apply(content, ivars)
+      begin
+        require 'haml'
+      rescue LoadError => ex
+        $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+        $stderr.puts "You're missing a library required to use Haml. Try running:"
+        $stderr.puts '  $ [sudo] gem install haml'
+        raise 'Missing dependency: haml'
+      end
+
+      # Adapted from "nanoc/filters/haml.rb" with thanks to Denis Defreyne and contributors.
+      context = RenderContext.new(ivars)
+      proc = ivars[:content] ? lambda { ivars[:content] } : lambda {}
+
+      Haml::Engine.new(content, (ivars[:haml].symbolize_keys rescue {})).render(context, ivars, &proc)
+    end
+  end
+end

data/lib/magneto/filters/kramdown.rb

@@ -0,0 +1,22 @@
+module Magneto
+
+  class KramdownFilter < Filter
+
+    def name
+      'kramdown'
+    end
+
+    def apply(content, ivars)
+      begin
+        require 'kramdown'
+      rescue LoadError => ex
+        $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+        $stderr.puts "You're missing a library required to use kramdown. Try running:"
+        $stderr.puts '  $ [sudo] gem install kramdown'
+        raise 'Missing dependency: kramdown'
+      end
+
+      Kramdown::Document.new(content, (ivars[:kramdown].symbolize_keys rescue {})).to_html
+    end
+  end
+end

data/lib/magneto/filters/less.rb

@@ -0,0 +1,23 @@
+module Magneto
+
+  class LessFilter < Filter
+
+    def name
+      'less'
+    end
+
+    def apply(content, ivars)
+      begin
+        require 'less'
+      rescue LoadError => ex
+        $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+        $stderr.puts "You're missing a library required to use Less. Try running:"
+        $stderr.puts '  $ [sudo] gem install less'
+        raise 'Missing dependency: less'
+      end
+
+      args = ivars[:less].symbolize_keys rescue {}
+      Less::Parser.new(args).parse(content).to_css(args)
+    end
+  end
+end

data/lib/magneto/filters/maruku.rb

@@ -0,0 +1,22 @@
+module Magneto
+
+  class MarukuFilter < Filter
+
+    def name
+      'maruku'
+    end
+
+    def apply(content, ivars)
+      begin
+        require 'maruku'
+      rescue LoadError => ex
+        $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+        $stderr.puts "You're missing a library required to use Maruku. Try running:"
+        $stderr.puts '  $ [sudo] gem install maruku'
+        raise 'Missing dependency: maruku'
+      end
+
+      Maruku.new(content, (ivars[:maruku].symbolize_keys rescue {})).to_html
+    end
+  end
+end

data/lib/magneto/filters/rdiscount.rb

@@ -0,0 +1,22 @@
+module Magneto
+
+  class RDiscountFilter < Filter
+
+    def name
+      'rdiscount'
+    end
+
+    def apply(content, ivars)
+      begin
+        require 'rdiscount'
+      rescue LoadError => ex
+        $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+        $stderr.puts "You're missing a library required to use RDiscount. Try running:"
+        $stderr.puts '  $ [sudo] gem install rdiscount'
+        raise 'Missing dependency: rdiscount'
+      end
+
+      RDiscount.new(content, *((ivars[:rdiscount].symbolize_keys rescue {})[:extensions] || [])).to_html
+    end
+  end
+end

data/lib/magneto/filters/redcarpet.rb

@@ -0,0 +1,29 @@
+module Magneto
+
+  class RedcarpetFilter < Filter
+
+    def name
+      'redcarpet'
+    end
+
+    def apply(content, ivars)
+      begin
+        require 'redcarpet'
+      rescue LoadError => ex
+        $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+        $stderr.puts "You're missing a library required to use Redcarpet. Try running:"
+        $stderr.puts '  $ [sudo] gem install redcarpet'
+        raise 'Missing dependency: redcarpet'
+      end
+
+      args = ivars[:redcarpet].symbolize_keys rescue {}
+      renderer_class = Kernel.const_get(args[:renderer_name]) rescue args[:renderer_class] || Redcarpet::Render::HTML
+      args.delete(:renderer_name)
+      args.delete(:renderer_class)
+      renderer_options = args[:renderer_options].symbolize_keys rescue {}
+      args.delete(:renderer_options)
+
+      Redcarpet::Markdown.new(renderer_class.new(renderer_options), args).render(content)
+    end
+  end
+end

data/lib/magneto/filters/redcloth.rb

@@ -0,0 +1,24 @@
+module Magneto
+
+  class RedClothFilter < Filter
+
+    def name
+      'redcloth'
+    end
+
+    def apply(content, ivars)
+      begin
+        require 'redcloth'
+      rescue LoadError => ex
+        $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+        $stderr.puts "You're missing a library required to use RedCloth. Try running:"
+        $stderr.puts '  $ [sudo] gem install RedCloth'
+        raise 'Missing dependency: RedCloth'
+      end
+
+      textile_doc = RedCloth.new(content)
+      ivars[:redcloth].each { |rule, value| textile_doc.send((rule.to_s + '=').to_sym, value) }
+      textile_doc.to_html
+    end
+  end
+end

data/lib/magneto/filters/rubypants.rb

@@ -0,0 +1,22 @@
+module Magneto
+
+  class RubyPantsFilter < Filter
+
+    def name
+      'rubypants'
+    end
+
+    def apply(content, ivars)
+      begin
+        require 'rubypants'
+      rescue LoadError => ex
+        $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+        $stderr.puts "You're missing a library required to use RubyPants. Try running:"
+        $stderr.puts '  $ [sudo] gem install rubypants'
+        raise 'Missing dependency: rubypants'
+      end
+
+      RubyPants.new(content, *((ivars[:rubypants].symbolize_keys rescue {})[:options] || [])).to_html
+    end
+  end
+end

data/lib/magneto/filters/sass.rb

@@ -0,0 +1,22 @@
+module Magneto
+
+  class SassFilter < Filter
+
+    def name
+      'sass'
+    end
+
+    def apply(content, ivars)
+      begin
+        require 'sass'
+      rescue LoadError => ex
+        $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+        $stderr.puts "You're missing a library required to use Sass. Try running:"
+        $stderr.puts '  $ [sudo] gem install sass'
+        raise 'Missing dependency: sass'
+      end
+
+      Sass::Engine.new(content, (ivars[:sass].symbolize_keys rescue {})).render
+    end
+  end
+end

data/lib/magneto/item.rb

@@ -0,0 +1,118 @@
+require 'magneto/readable'
+
+module Magneto
+
+  class Item
+    include Readable
+
+    attr_reader :site, :origin
+
+    INVALID_LOCATION_MATCH_PATTERN = %r{(^[^/].*$|^.*/$)}
+
+    def initialize(site, origin = '')
+      super()
+      @site = site
+      @origin = origin.sub(INVALID_LOCATION_MATCH_PATTERN, '')
+      @destination = nil
+      @metadata = nil
+      @content = nil
+      @precomposed_content = nil
+    end
+
+    def relocated?
+      @origin == ''
+    end
+
+    def relocate
+      @origin = ''
+    end
+
+    def abandoned?
+      @destination == ''
+    end
+
+    def abandon
+      @destination = ''
+    end
+
+    def destination
+      @destination ||= @origin.dup
+      @destination
+    end
+
+    def destination=(destination)
+      @destination = (destination || '').sub(INVALID_LOCATION_MATCH_PATTERN, '')
+    end
+
+    def origin_path
+      @site.items_path + @origin
+    end
+
+    alias_method :path, :origin_path
+
+    def destination_path
+      @site.config[:output_path] + (@destination || @origin)
+    end
+
+    def import_metadata
+      self.destination = @metadata[:destination] unless @metadata.nil? || @metadata[:destination].nil?
+    end
+
+    def precomposed_content
+      read if @content.nil?
+      @precomposed_content || @content.dup
+    end
+
+    def apply_filter(filter_name, args = {})
+      filter = @site.filters[filter_name.to_sym]
+
+      if filter.nil?
+        $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+        raise "Couldn't find filter: '#{filter_name.to_s}'"
+      end
+
+      read if @content.nil?
+
+      @content = filter.apply(@content, @site.config.deep_merge(@metadata || {}).deep_merge({
+        :config => @site.config,
+        :site => @site,
+        :item => self
+      }).deep_merge(filter_name.to_sym => args))
+    end
+
+    def apply_template(template_name, args = {})
+      template = @site.templates[template_name.to_sym]
+
+      if template.nil?
+        $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+        raise "Couldn't find template: '#{template_name.to_s}'"
+      end
+
+      read if @content.nil?
+      @precomposed_content ||= @content.dup
+
+      @content = template.filter.apply(template.content, {
+        template.filter.name.to_sym => {}
+      }.deep_merge(@site.config).deep_merge(@metadata || {}).deep_merge(template.metadata || {}).deep_merge({
+        :config => @site.config,
+        :site => @site,
+        :item => self,
+        :content => @content
+      }).deep_merge(args.symbolize_keys))
+    end
+
+    def write
+      unless abandoned?
+        if content?
+          FileUtils.mkdir_p File.dirname(destination_path)
+          File.open(destination_path, 'w') { |f| f.write content }
+        else
+          unless relocated?
+            FileUtils.mkdir_p File.dirname(destination_path)
+            FileUtils.cp origin_path, destination_path
+          end
+        end
+      end
+    end
+  end
+end

data/lib/magneto/readable.rb

@@ -0,0 +1,55 @@
+module Magneto
+
+  module Readable
+
+    def metadata?
+      not @metadata.nil? || @metadata.empty?
+    end
+
+    def metadata
+      read if @metadata.nil?
+      @metadata || {}
+    end
+
+    def metadata=(metadata)
+      @metadata = metadata || {}
+    end
+
+    def content?
+      not @content.nil? || @content.empty?
+    end
+
+    def content
+      read if @content.nil?
+      @content || ''
+    end
+
+    alias to_s content
+
+    def content=(content)
+      @content = content || ''
+    end
+
+    # Adapted from `jekyll/convertible.rb` with thanks to Tom Preston-Werner.
+    def read
+      @metadata = {}
+      @content = File.read(path)
+
+      if @content =~ /^(---\s*\n.*?\n?)^(---\s*$\n?)/m
+        @content = $POSTMATCH
+
+        begin
+          @metadata = YAML.load($1)
+          raise unless @metadata.is_a? Hash
+        rescue => ex
+          $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+          $stderr.puts "WARNING: Couldn't load metadata."
+          @metadata = {}
+        end
+
+        @metadata.symbolize_keys!
+        import_metadata
+      end
+    end
+  end
+end

data/lib/magneto/render_context.rb

@@ -0,0 +1,51 @@
+module Magneto
+
+  # Adapted from `nanoc/helpers/rendering.rb` and `nanoc/helpers/capturing.rb`
+  # with thanks to Denis Defreyne and contributors.
+  class RenderContext < Context
+
+    def render(template_name, args = {}, &block)
+      template = @site.templates[template_name.to_sym]
+
+      if template.nil?
+        $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+        raise "Couldn't find template: '#{template_name.to_s}'"
+      end
+
+      if block_given?
+        # Get templating system output instance.
+        erbout = eval('_erbout', block.binding)
+
+        # Save output length.
+        erbout_length = erbout.length
+
+        # Execute block (which may cause recursion).
+        block.call
+
+        # Use additional output from block execution as content.
+        current_content = erbout[erbout_length..-1]
+
+        # Remove addition from templating system output.
+        erbout[erbout_length..-1] = ''
+      else
+        current_content = nil
+      end
+
+      ivars = {}
+      self.instance_variables.each { |ivar| ivars[ivar[1..-1].to_sym] = self.instance_variable_get(ivar) }
+
+      result = template.filter.apply(template.content, ivars.deep_merge({
+        :content => current_content
+      }).deep_merge(template.metadata || {}).deep_merge(args.symbolize_keys))
+
+      if block_given?
+        # Append filter result to templating system output and return empty
+        # string.
+        erbout << result
+        ''
+      else
+        result
+      end
+    end
+  end
+end

data/lib/magneto/script_context.rb

@@ -0,0 +1,18 @@
+module Magneto
+
+  class ScriptContext < Context
+
+    def initialize(ivars)
+      super
+      puts 'Evaluating script...'
+
+      begin
+        self.instance_eval File.read(@source_path + '/script.rb')
+        @site.write
+      rescue => ex
+        $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+        raise 'Script evaluation failed.'
+      end
+    end
+  end
+end

data/lib/magneto/site.rb

@@ -0,0 +1,116 @@
+module Magneto
+
+  class Site
+
+    attr_reader :config, :filters, :items_path, :items, :templates
+
+    def initialize(config, filters)
+      super()
+      @config = config
+      @filters = filters
+      @items_path = @config[:source_path] + '/items'
+      @items_path.freeze
+      reset
+    end
+
+    def generate
+      find_items
+      find_templates
+      find_existing_output
+
+      ScriptContext.new(@config.deep_merge({
+        :config => @config,
+        :site => self
+      }))
+
+      reset
+    end
+
+    def write
+      return if @written
+
+      puts 'Writing output...'
+      @written = true
+      output = Set.new unless @existing_output.empty?
+
+      @items.each do |item|
+        item.write
+
+        unless @existing_output.empty?
+          next if item.abandoned?
+          path = item.destination_path
+
+          while path.start_with? @config[:output_path] do
+            output << path
+            path = File.dirname(path)
+          end
+        end
+      end
+
+      unless @existing_output.empty?
+        obsolete_output = @existing_output - output
+  
+        unless obsolete_output.empty?
+          if @config[:remove_obsolete]
+            puts 'Removing obsolete output...'
+
+            obsolete_output.to_a.sort.reverse.each do |path|
+              if File.directory? path
+                FileUtils.rmdir path
+              else
+                FileUtils.rm path
+              end
+            end
+          else
+            puts 'Listing obsolete output...'
+            puts obsolete_output.to_a.sort.reverse
+          end
+        end
+      end
+
+      puts 'Site generation succeeded.'
+    end
+
+    private
+
+    def reset
+      @items = []
+      @templates = {}
+      @existing_output = Set.new
+      @written = false
+    end
+
+    def find_items
+      puts 'Finding items...'
+
+      if File.directory? @items_path
+        Dir.chdir @items_path do
+          Dir[@config[:hidden_files] ? '**/{.[^.],}*' : '**/*'].each do |path|
+            unless File.directory? path
+              @items << Item.new(self, '/' + path)
+            end
+          end
+        end
+      end
+    end
+
+    def find_templates
+      puts 'Finding templates...'
+
+      Dir[@config[:source_path] + '/templates/*.*'].each do |path|
+        unless File.directory? path
+          name = File.basename(path).split('.')[0..-2].join('.')
+          @templates[name.to_sym] = Template.new(self, path, name)
+        end
+      end
+    end
+
+    def find_existing_output
+      puts 'Finding existing output...'
+
+      Dir[@config[:output_path] + '/**/{.[^.],}*'].each do |path|
+        @existing_output << path
+      end
+    end
+  end
+end

data/lib/magneto/template.rb

@@ -0,0 +1,31 @@
+module Magneto
+
+  class Template
+    include Readable
+
+    attr_reader :site, :path, :name, :filter
+
+    def initialize(site, path, name)
+      super()
+      @site = site
+      @path = path
+      @name = name
+      @filter = nil
+      @metadata = nil
+      @content = nil
+    end
+
+    def use_filter(filter_name)
+      @filter = @site.filters[filter_name.to_sym]
+
+      if @filter.nil?
+        $stderr.puts "#{File.basename($PROGRAM_NAME)}: #{ex.to_s}"
+        raise "Couldn't find filter: '#{filter_name.to_s}'"
+      end
+    end
+
+    def import_metadata
+      @filter = use_filter(@metadata[:filter]) unless @metadata.nil? || @metadata[:filter].nil?
+    end
+  end
+end

data/magneto.gemspec

@@ -0,0 +1,17 @@
+$LOAD_PATH.unshift File.expand_path(File.dirname(__FILE__) + '/lib')
+
+require 'magneto'
+
+Gem::Specification.new do |s|
+  s.name              = 'magneto'
+  s.version           = Magneto::VERSION
+  s.summary           = 'A static site generator.'
+  s.description       = 'Magneto is a static site generator.'
+  s.authors           = ['Don Melton']
+  s.email             = 'don@blivet.com'
+  s.homepage          = 'https://github.com/donmelton/magneto'
+  s.files             = Dir['{bin,lib}/**/*'] + Dir['[A-Z]*'] + ['magneto.gemspec']
+  s.executables       = ['magneto']
+  s.extra_rdoc_files  = ['LICENSE']
+  s.require_paths     = ['lib']
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification
+name: magneto
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Don Melton
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-17 00:00:00.000000000 Z
+dependencies: []
+description: Magneto is a static site generator.
+email: don@blivet.com
+executables:
+- magneto
+extensions: []
+extra_rdoc_files:
+- LICENSE
+files:
+- bin/magneto
+- lib/magneto/application.rb
+- lib/magneto/context.rb
+- lib/magneto/core_ext.rb
+- lib/magneto/filter.rb
+- lib/magneto/filters/bluecloth.rb
+- lib/magneto/filters/coffeescript.rb
+- lib/magneto/filters/erb.rb
+- lib/magneto/filters/erubis.rb
+- lib/magneto/filters/haml.rb
+- lib/magneto/filters/kramdown.rb
+- lib/magneto/filters/less.rb
+- lib/magneto/filters/maruku.rb
+- lib/magneto/filters/rdiscount.rb
+- lib/magneto/filters/redcarpet.rb
+- lib/magneto/filters/redcloth.rb
+- lib/magneto/filters/rubypants.rb
+- lib/magneto/filters/sass.rb
+- lib/magneto/filters.rb
+- lib/magneto/item.rb
+- lib/magneto/readable.rb
+- lib/magneto/render_context.rb
+- lib/magneto/script_context.rb
+- lib/magneto/site.rb
+- lib/magneto/template.rb
+- lib/magneto.rb
+- LICENSE
+- README.md
+- magneto.gemspec
+homepage: https://github.com/donmelton/magneto
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: A static site generator.
+test_files: []