massimo 0.3.9

data/lib/massimo/resource.rb

@@ -0,0 +1,52 @@
+module Massimo
+  class Resource
+    attr_reader :source_path, :body
+    
+    # Creates a new page associated with the given file path.
+    def initialize(source_path)
+      @source_path = ::Pathname.new(source_path)
+      # read and parse the source file
+      self.read_source!
+    end
+    
+    # Renders the page using the registered filters.
+    def render(locals = {})
+      @body
+    end
+    
+    # Gets the resource's file name.
+    def file_name
+      @source_path.basename.to_s
+    end
+    
+    # Gets the resource type, based on the file's extension
+    def resource_type
+      @source_path.extname.to_s[1..-1]
+    end
+    
+    # Gets the site instance
+    def site
+      ::Massimo::Site()
+    end
+    
+    protected
+    
+      # Reads the source page file, and populates the meta_data and
+      # body attributes.
+      def read_source!
+        raise ::Massimo::MissingResource unless @source_path.exist?
+        # try to read it now
+        begin
+          @line = 1
+          @body = @source_path.read
+        rescue
+          raise ::Massimo::InvalidResource
+        end
+      end
+      
+      # Get the options from the Site's config for the current resource type.
+      def options_for_resource_type
+        self.site.options[self.resource_type.to_sym]
+      end
+  end
+end

data/lib/massimo/site.rb

@@ -0,0 +1,186 @@
+module Massimo
+  class Site
+    include Singleton
+    
+    # Default options. Overriden by values given when creating a Site.
+    DEFAULT_OPTIONS = {
+      :source      => ".",
+      :output      => ::File.join(".", "public"),
+      :server_port => "1984"
+    }.freeze
+    
+    SOURCE_DIRS = [ :pages, :views, :stylesheets, :javascripts, :helpers, :lib ].freeze # :nodoc:
+    
+    attr_accessor :options, :helpers
+    
+    # Setup the Site with the given options. These options may be overridden by the config file.
+    def setup(options = {})
+      @options = DEFAULT_OPTIONS.dup.merge(options.symbolize_keys)
+      self
+    end
+    
+    # Processes all the Pages, Stylesheets, and Javascripts and outputs
+    # them to the output dir.
+    def process!
+      reload_helpers
+      reload_libs
+      pages(true).each(&:process!)
+      stylesheets(true).each(&:process!)
+      javascripts(true).each(&:process!)
+    end
+    
+    # Get all the Pages in the pages dir.
+    def pages(reload = false)
+      return @pages if defined?(@pages) && !reload
+      page_paths = self.find_files_in(:pages)
+      @pages = page_paths.collect { |path| ::Massimo::Page.new(path) }
+    end
+    
+    # Get all the Stylesheets in the stylesheets dir.
+    def stylesheets(reload = false)
+      return @stylesheets if defined?(@stylesheets) && !reload
+      stylesheet_paths = self.find_files_in(:stylesheets, [ :css, :sass, :less ])
+      @stylesheets = stylesheet_paths.collect { |path| ::Massimo::Stylesheet.new(path) }
+    end
+    
+    # Get all the Javascripts in the javascripts dir.
+    def javascripts(reload = false)
+      return @javascripts if defined?(@javascripts) && !reload
+      javascript_paths = self.find_files_in(:javascripts, [ :js ])
+      @javascripts = javascript_paths.collect { |path| ::Massimo::Javascript.new(path) }
+    end
+    
+    # Finds a view by the given name
+    def find_view(name, meta_data = {})
+      view_path = Dir.glob(self.views_dir("#{name}.*")).first
+      view_path && ::Massimo::View.new(view_path, meta_data)
+    end
+    
+    # Finds a view then renders it with the given locals
+    def render_view(name, locals = {}, &block)
+      view = self.find_view(name)
+      view && view.render(locals, &block)
+    end
+    
+    # Determines if the Site is in development mode.
+    def development?
+      @options[:environment].nil? || @options[:environment].to_sym == :development || @options[:development]
+    end
+    
+    # Determines if the Site is in production mode.
+    def production?
+      (@options[:environment] && @options[:environment].to_sym == :production) || @options[:production]
+    end
+    
+    #------------------------------------
+    #  Directory Path Methods
+    #------------------------------------
+    
+    # The path to the source dir
+    def source_dir(*path)
+      ::File.join(@options[:source], *path)
+    end
+    
+    # Get all the source directories as an array.
+    def all_source_dirs
+      SOURCE_DIRS.collect { |d| dir_for(d) }
+    end
+    
+    SOURCE_DIRS.each do |d|
+      define_method("#{d}_dir") do |*path|
+        dir_for(d, *path)
+      end
+    end
+    
+    # The path to the output dir
+    def output_dir(*path)
+      ::File.join(@options[:output], *path)
+    end
+    
+    protected
+    
+      # Get the directory to the given resource type (pages, views, etc.).
+      # If the path has been manually set in the options, you will get that
+      # path. Otherwise you will get the path relative to the source directory.
+      def dir_for(type, *path)
+        if type_path = @options["#{type}_path".to_sym]
+          ::File.join(type_path, *path)
+        else
+          self.source_dir(type.to_s, *path)
+        end
+      end
+    
+      # Find all the files in the given resouce type's directory, optionally
+      # selecting only those with the given extensions. This will return
+      # an array with the full path to the files.
+      def find_files_in(type, extensions = nil)
+        # the directory where these files will be found
+        type_dir = self.dir_for(type)
+        
+        # By default get the file list from the options
+        files = @options[type] && @options[type].dup
+        
+        unless files && files.is_a?(::Array)
+          # If files aren't listed in the options, get them
+          # from the given block
+          glob  = (extensions.nil? || extensions.empty?) ? "*" : "*.{#{extensions.join(",")}}"
+          files = ::Dir.glob(::File.join(type_dir, "**", glob))
+          
+          # normalize the files by removing the directory from the path
+          files.collect! { |file| file.gsub("#{type_dir}/", "") }
+          
+          # reject the files in the skip_files option, which can
+          # either be an array or a Proc.
+          if skip_files = @options["skip_#{type}".to_sym]
+            files.reject! do |file|
+              case skip_files
+              when ::Array
+                skip_files.include?(file)
+              else ::Proc
+                skip_files.call(file)
+              end
+            end
+          end
+        end
+        
+        # Reject all files that begin with _ (like partials) and directories
+        files.reject! { |file| ::File.basename(file) =~ /^_/ }
+        
+        # now add the directory back to the path
+        files.collect! { |file| ::File.join(type_dir, file) }
+        
+        # And make sure we don't find directories
+        files.reject! { |file| ::File.directory?(file) }
+        files
+      end
+      
+      # Reload the Helpers instance with the helper modules
+      def reload_helpers
+        @helpers = ::Massimo::Helpers.new(self.helper_modules.compact)
+      end
+      
+      # Reload all the files in the source lib dir.
+      def reload_libs
+        reload_files ::Dir.glob(lib_dir("**", "*.rb"))
+      end
+      
+      # Find all the helper modules
+      def helper_modules
+        reload_files ::Dir.glob(helpers_dir("*.rb"))
+      end
+      
+      # Relod the given file by removing their constants and loading the file again.
+      # Return an Array of the reloaded Constants.
+      def reload_files(files)
+        files.collect do |file|
+          class_name = ::File.basename(file).gsub(::File.extname(file), "").classify
+          # Unload the constant if it already exists
+          ::Object.class_eval { remove_const(class_name) if const_defined?(class_name) }
+          # Load the constant
+          load(file)
+          # return the constant
+          class_name.constantize rescue nil
+        end
+      end
+  end
+end

data/lib/massimo/stylesheet.rb

@@ -0,0 +1,46 @@
+module Massimo
+  class Stylesheet < Resource
+    # Render the css based on the type of resource
+    def render
+      case resource_type.to_sym
+      when :css
+        @body.to_s
+      when :sass
+        require "sass" unless defined? ::Sass
+        ::Sass::Files.tree_for(@source_path, sass_options).render
+      when :less
+        require "less" unless defined? ::Less
+        ::Less.parse(@body)
+      end
+    end
+    
+    # Writes the rendered css to the output file.
+    def process!
+      # Make the full path to the directory of the output file
+      ::FileUtils.mkdir_p(self.output_path.dirname)
+      # write the filtered data to the output file
+      self.output_path.open("w") do |file|
+        file.write self.render
+      end
+    end
+    
+    protected
+      
+      # Determine the output file path
+      def output_path
+        @output_path ||= ::Pathname.new(@source_path.to_s.
+          sub(self.site.source_dir, self.site.output_dir). # move to output dir
+          sub(/#{@source_path.extname}$/, ".css")) # replace extension with .css
+      end
+      
+      # Gets the Sass options, with Site options merged in.
+      def sass_options
+        options = {
+          :style => site.production? ? :compressed : :nested
+        }
+        options.merge!(self.site.options[:sass]) if self.site.options[:sass].is_a?(Hash)
+        options.merge(:css_filename => self.output_path)
+      end
+    
+  end
+end

data/lib/massimo/templates.rb

@@ -0,0 +1,20 @@
+module Tilt
+  register :html, ::Tilt::ERBTemplate
+  register :php,  ::Tilt::ERBTemplate
+  
+  # My Markdown implementation.
+  class MarkdownTemplate < Template
+    def compile!
+      @erb_engine = ::Tilt::ERBTemplate.new { data }
+    end
+
+    def evaluate(scope, locals, &block)
+      # First evaluate the code using ERB
+      erb_output = @erb_engine.render(scope, locals, &block)
+      # Then evaluate the code using the RDiscountTemplate
+      ::Tilt::RDiscountTemplate.new { erb_output }.render
+    end
+  end
+  register :markdown, MarkdownTemplate
+  register :md, MarkdownTemplate
+end

data/lib/massimo/view.rb

@@ -0,0 +1,30 @@
+module Massimo
+  class View < Resource
+    attr_reader :meta_data
+    
+    # Creates a new page associated with the given file path.
+    def initialize(source_path, meta_data = {})
+      @meta_data = meta_data
+      super(source_path)
+    end
+    
+    # Renders the page using the registered filters.
+    def render(locals = {}, &block)
+      template = ::Tilt.new(self.file_name, @line || 1, self.options_for_resource_type) { @body }
+      template.render(self.site.helpers, @meta_data.merge(locals), &block)
+    end
+    
+    protected
+      
+      # All undefined methods are sent to the meta_data hash.
+      def method_missing(method, *args, &block)
+        if method.to_s.match(/(.*)\=$/) && args.length == 1
+          @meta_data[$1.to_sym] = args.first
+        elsif args.empty? && @meta_data.key?(method)
+          @meta_data[method]
+        else
+          super
+        end
+      end
+  end
+end

data/lib/massimo.rb

@@ -0,0 +1,38 @@
+libdir = ::File.dirname(__FILE__)
+$LOAD_PATH.unshift(libdir) unless $LOAD_PATH.include?(libdir)
+
+# Rubygems
+require "rubygems"
+
+# External
+require "pathname"
+require "fileutils"
+require "singleton"
+require "active_support"
+require "sinatra_more"
+require "sprockets"
+require "jsmin"
+require "tilt"
+
+# Internal
+require "massimo/helpers"
+require "massimo/templates"
+require "massimo/site"
+require "massimo/resource"
+require "massimo/view"
+require "massimo/page"
+require "massimo/stylesheet"
+require "massimo/javascript"
+
+module Massimo
+  VERSION = ::File.read(::File.join(::File.dirname(__FILE__), *%w{.. VERSION})) # :nodoc:
+  
+  MissingResource = ::Class.new(StandardError) # :nodoc:
+  InvalidResource = ::Class.new(StandardError) # :nodoc:
+  
+  #
+  def self.Site(options = {})
+    return @site if defined?(@site) && options.empty?
+    @site = ::Massimo::Site.instance.setup(options)
+  end
+end

data/massimo.gemspec

@@ -0,0 +1,130 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{massimo}
+  s.version = "0.3.9"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Peter Browne"]
+  s.date = %q{2009-12-24}
+  s.default_executable = %q{massimo}
+  s.description = %q{Massimo builds HTML, Javascript, and CSS Files from your source.}
+  s.email = %q{peter@peterbrowne.net}
+  s.executables = ["massimo"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.md"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.md",
+     "Rakefile",
+     "VERSION",
+     "bin/massimo",
+     "lib/massimo.rb",
+     "lib/massimo/command.rb",
+     "lib/massimo/helpers.rb",
+     "lib/massimo/javascript.rb",
+     "lib/massimo/page.rb",
+     "lib/massimo/resource.rb",
+     "lib/massimo/site.rb",
+     "lib/massimo/stylesheet.rb",
+     "lib/massimo/templates.rb",
+     "lib/massimo/view.rb",
+     "massimo.gemspec",
+     "test/assertions.rb",
+     "test/helper.rb",
+     "test/source/config.yml",
+     "test/source/helpers/test_helper.rb",
+     "test/source/javascripts/_plugin.js",
+     "test/source/javascripts/application.js",
+     "test/source/javascripts/lib.js",
+     "test/source/lib/site.rb",
+     "test/source/pages/_skipped_page.haml",
+     "test/source/pages/about_us.erb",
+     "test/source/pages/erb.erb",
+     "test/source/pages/erb_with_layout.erb",
+     "test/source/pages/feed.haml",
+     "test/source/pages/haml.haml",
+     "test/source/pages/html.html",
+     "test/source/pages/index.erb",
+     "test/source/pages/markdown.markdown",
+     "test/source/pages/posts/first-post.haml",
+     "test/source/pages/with_extension.haml",
+     "test/source/pages/with_meta_data.haml",
+     "test/source/pages/with_title.haml",
+     "test/source/pages/with_url.haml",
+     "test/source/pages/without_extension.haml",
+     "test/source/pages/without_meta_data.haml",
+     "test/source/pages/without_title.haml",
+     "test/source/pages/without_url.haml",
+     "test/source/stylesheets/_base.sass",
+     "test/source/stylesheets/application.sass",
+     "test/source/stylesheets/basic.css",
+     "test/source/stylesheets/less_file.less",
+     "test/source/views/layouts/application.haml",
+     "test/source/views/with_helper.haml",
+     "test/source/views/with_locals.haml",
+     "test/source/views/without_locals.haml",
+     "test/test_javascript.rb",
+     "test/test_page.rb",
+     "test/test_resource.rb",
+     "test/test_site.rb",
+     "test/test_stylesheet.rb",
+     "test/test_view.rb"
+  ]
+  s.homepage = %q{http://github.com/peterbrowne/massimo}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Massimo is a static website builder.}
+  s.test_files = [
+    "test/assertions.rb",
+     "test/helper.rb",
+     "test/source/helpers/test_helper.rb",
+     "test/source/lib/site.rb",
+     "test/test_javascript.rb",
+     "test/test_page.rb",
+     "test/test_resource.rb",
+     "test/test_site.rb",
+     "test/test_stylesheet.rb",
+     "test/test_view.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<shoulda>, [">= 2.10.2"])
+      s.add_development_dependency(%q<yard>, [">= 0.5.2"])
+      s.add_runtime_dependency(%q<activesupport>, [">= 2.3.5"])
+      s.add_runtime_dependency(%q<sinatra_more>, [">= 0.3.26"])
+      s.add_runtime_dependency(%q<directory_watcher>, [">= 1.3.1"])
+      s.add_runtime_dependency(%q<sprockets>, [">= 1.0.2"])
+      s.add_runtime_dependency(%q<jsmin>, [">= 1.0.1"])
+    else
+      s.add_dependency(%q<shoulda>, [">= 2.10.2"])
+      s.add_dependency(%q<yard>, [">= 0.5.2"])
+      s.add_dependency(%q<activesupport>, [">= 2.3.5"])
+      s.add_dependency(%q<sinatra_more>, [">= 0.3.26"])
+      s.add_dependency(%q<directory_watcher>, [">= 1.3.1"])
+      s.add_dependency(%q<sprockets>, [">= 1.0.2"])
+      s.add_dependency(%q<jsmin>, [">= 1.0.1"])
+    end
+  else
+    s.add_dependency(%q<shoulda>, [">= 2.10.2"])
+    s.add_dependency(%q<yard>, [">= 0.5.2"])
+    s.add_dependency(%q<activesupport>, [">= 2.3.5"])
+    s.add_dependency(%q<sinatra_more>, [">= 0.3.26"])
+    s.add_dependency(%q<directory_watcher>, [">= 1.3.1"])
+    s.add_dependency(%q<sprockets>, [">= 1.0.2"])
+    s.add_dependency(%q<jsmin>, [">= 1.0.1"])
+  end
+end
+

data/test/assertions.rb

@@ -0,0 +1,8 @@
+module Assertions
+
+  # Assert that the two Arrays contain the same Strings or Symbols
+  def assert_equal_arrays(expected_array, actual_array)
+    assert_equal expected_array.map(&:to_s).sort, actual_array.map(&:to_s).sort
+  end
+  
+end

data/test/helper.rb

@@ -0,0 +1,54 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+require "rubygems"
+require "test/unit"
+require "shoulda"
+# begin require "redgreen"; rescue LoadError; end
+begin require "turn"; rescue LoadError; end
+require "assertions"
+require "rr"
+
+# Load Massimo
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), "..", "lib"))
+require "massimo"
+
+class Test::Unit::TestCase
+  include Assertions
+  include RR::Adapters::TestUnit
+
+  #
+  def source_dir(*subdirs)
+    File.join(File.dirname(__FILE__), "source", *subdirs)
+  end
+
+  #
+  def output_dir(*subdirs)
+    File.join(File.dirname(__FILE__), "output", *subdirs)
+  end
+
+  #
+  def clear_output
+    FileUtils.rm_rf(output_dir)
+  end
+  
+  #
+  def site(options = {})
+    @site = Massimo::Site({
+      :source => source_dir,
+      :output => output_dir,
+      :sass   => { :cache => false }
+    }.merge(options))
+  end
+  
+  #
+  def page(*path)
+    @page ||= Massimo::Page.new(source_dir("pages", *path))
+  end
+  
+  #
+  def view(*path)
+    return @view if defined?(@view)
+    meta_data = path.extract_options!
+    @view = Massimo::View.new(source_dir("views", *path), meta_data)
+  end
+end

data/test/source/config.yml

@@ -0,0 +1,4 @@
+---
+:config: "working"
+:sass:
+  :cache: false

data/test/source/helpers/test_helper.rb

@@ -0,0 +1,5 @@
+module TestHelper
+  def test_method
+    "working"
+  end
+end

data/test/source/javascripts/_plugin.js

@@ -0,0 +1 @@
+var plugin = "plugin";

data/test/source/javascripts/application.js

@@ -0,0 +1,3 @@
+//= require "_plugin"
+
+var application = "application";

data/test/source/javascripts/lib.js

@@ -0,0 +1 @@
+var lib = "lib";

data/test/source/lib/site.rb

@@ -0,0 +1,5 @@
+class Massimo::Site
+  def new_method
+    "working"
+  end
+end

data/test/source/pages/about_us.erb

@@ -0,0 +1,5 @@
+---
+title: About
+layout: false
+---
+<h1>An <%= "HTML" %> Page</h1>

data/test/source/pages/erb.erb

@@ -0,0 +1,5 @@
+---
+title: ERB
+layout: false
+---
+<h1><%= title %></h1>

data/test/source/pages/erb_with_layout.erb

@@ -0,0 +1,4 @@
+---
+title: ERB With Layout
+---
+<h1><%= title %></h1>

data/test/source/pages/feed.haml

@@ -0,0 +1,6 @@
+---
+extension: .rss
+layout: false
+---
+%rss
+  %title RSS Feed

data/test/source/pages/haml.haml

@@ -0,0 +1,5 @@
+---
+title: Haml
+layout: false
+---
+%h1= title

data/test/source/pages/html.html

@@ -0,0 +1,4 @@
+---
+layout: false
+---
+<h1>HTML</h1>

data/test/source/pages/index.erb

@@ -0,0 +1,4 @@
+---
+title: Home
+---
+<h1><%= title %></h1>

data/test/source/pages/markdown.markdown

@@ -0,0 +1,5 @@
+---
+title: Markdown
+layout: false
+---
+# <%= title %>

data/test/source/pages/posts/first-post.haml

@@ -0,0 +1 @@
+%h1 First Post

data/test/source/pages/with_extension.haml

@@ -0,0 +1,4 @@
+---
+extension: .rss
+---
+%h1 A Page with filter extension.

data/test/source/pages/with_meta_data.haml

@@ -0,0 +1,7 @@
+---
+title: A Page with a title
+tags:
+- tag_1
+- tag_2
+---
+%h1 A Page with a title

data/test/source/pages/with_title.haml

@@ -0,0 +1,4 @@
+---
+title: A Title
+---
+%h1 A Page with a title