monad 0.0.1

data/features/support/env.rb

@@ -0,0 +1,25 @@
+require 'fileutils'
+require 'rr'
+require 'test/unit'
+
+World do
+  include Test::Unit::Assertions
+end
+
+TEST_DIR    = File.join('/', 'tmp', 'monad')
+JEKYLL_PATH = File.join(File.dirname(__FILE__), '..', '..', 'bin', 'monad')
+
+def run_monad(opts = {})
+  command = JEKYLL_PATH.clone
+  command << " build"
+  command << " --drafts" if opts[:drafts]
+  command << " >> /dev/null 2>&1" if opts[:debug].nil?
+  system command
+end
+
+def has_time_component?(date_string)
+  date_string.split(" ").size > 1
+end
+
+# work around "invalid option: --format" cucumber bug (see #296)
+Test::Unit.run = true if RUBY_VERSION < '1.9'

data/lib/monad.rb

@@ -0,0 +1,90 @@
+$:.unshift File.dirname(__FILE__) # For use/testing when no gem is installed
+
+# Require all of the Ruby files in the given directory.
+#
+# path - The String relative path from here to the directory.
+#
+# Returns nothing.
+def require_all(path)
+  glob = File.join(File.dirname(__FILE__), path, '*.rb')
+  Dir[glob].each do |f|
+    require f
+  end
+end
+
+# rubygems
+require 'rubygems'
+
+# stdlib
+require 'fileutils'
+require 'time'
+require 'safe_yaml'
+require 'English'
+
+# 3rd party
+require 'liquid'
+require 'maruku'
+require 'colorator'
+
+# internal requires
+require 'monad/core_ext'
+require 'monad/logger'
+require 'monad/deprecator'
+require 'monad/configuration'
+require 'monad/site'
+require 'monad/convertible'
+require 'monad/layout'
+require 'monad/page'
+require 'monad/post'
+require 'monad/draft'
+require 'monad/filters'
+require 'monad/static_file'
+require 'monad/errors'
+
+# extensions
+require 'monad/plugin'
+require 'monad/converter'
+require 'monad/generator'
+require 'monad/command'
+
+require_all 'monad/commands'
+require_all 'monad/converters'
+require_all 'monad/converters/markdown'
+require_all 'monad/generators'
+require_all 'monad/tags'
+require_all 'monad/drivers'
+
+SafeYAML::OPTIONS[:suppress_warnings] = true
+
+module Monad
+  VERSION = '0.0.1'
+
+  # Public: Generate a Monad configuration Hash by merging the default
+  # options with anything in _config.yml, and adding the given options on top.
+  #
+  # override - A Hash of config directives that override any options in both
+  #            the defaults and the config file. See Monad::Configuration::DEFAULTS for a
+  #            list of option names and their defaults.
+  #
+  # Returns the final configuration Hash.
+  def self.configuration(override)
+    config = Configuration[Configuration::DEFAULTS]
+    override = Configuration[override].stringify_keys
+    config = config.read_config_files(config.config_files(override))
+
+    # Merge DEFAULTS < _config.yml < override
+    config = config.deep_merge(override).stringify_keys
+    set_timezone(config['timezone']) if config['timezone']
+
+    config
+  end
+
+  # Static: Set the TZ environment variable to use the timezone specified
+  #
+  # timezone - the IANA Time Zone
+  #
+  # Returns nothing
+  def self.set_timezone(timezone)
+    ENV['TZ'] = timezone
+  end
+end

data/lib/monad/command.rb

@@ -0,0 +1,27 @@
+module Monad
+  class Command
+    def self.globs(source, destination)
+      Dir.chdir(source) do
+        dirs = Dir['*'].select { |x| File.directory?(x) }
+        dirs -= [destination, File.expand_path(destination), File.basename(destination)]
+        dirs = dirs.map { |x| "#{x}/**/*" }
+        dirs += ['*']
+      end
+    end
+
+    # Static: Run Site#process and catch errors
+    #
+    # site - the Monad::Site object
+    #
+    # Returns nothing
+    def self.process_site(site)
+      site.process
+    rescue Monad::FatalException => e
+      puts
+      Monad::Logger.error "ERROR:", "YOUR SITE COULD NOT BE BUILT:"
+      Monad::Logger.error "", "------------------------------------"
+      Monad::Logger.error "", e.message
+      exit(1)
+    end
+  end
+end

data/lib/monad/commands/build.rb

@@ -0,0 +1,64 @@
+module Monad
+  module Commands
+    class Build < Command
+      def self.process(options)
+        site = Monad::Site.new(options)
+
+        self.build(site, options)
+        self.watch(site, options) if options['watch']
+      end
+
+      # Private: Build the site from source into destination.
+      #
+      # site - A Monad::Site instance
+      # options - A Hash of options passed to the command
+      #
+      # Returns nothing.
+      def self.build(site, options)
+        source = options['source']
+        destination = options['destination']
+        Monad::Logger.info "Source:", source
+        Monad::Logger.info "Destination:", destination
+        print Monad::Logger.formatted_topic "Generating..."
+        self.process_site(site)
+        puts "done."
+      end
+
+      # Private: Watch for file changes and rebuild the site.
+      #
+      # site - A Monad::Site instance
+      # options - A Hash of options passed to the command
+      #
+      # Returns nothing.
+      def self.watch(site, options)
+        require 'directory_watcher'
+
+        source = options['source']
+        destination = options['destination']
+
+        Monad::Logger.info "Auto-regeneration:", "enabled"
+
+        dw = DirectoryWatcher.new(source, :glob => self.globs(source, destination), :pre_load => true)
+        dw.interval = 1
+
+        dw.add_observer do |*args|
+          t = Time.now.strftime("%Y-%m-%d %H:%M:%S")
+          print Monad::Logger.formatted_topic("Regenerating:") + "#{args.size} files at #{t} "
+          self.process_site(site)
+          puts  "...done."
+        end
+
+        dw.start
+
+        unless options['serving']
+          trap("INT") do
+            puts "     Halting auto-regeneration."
+            exit 0
+          end
+
+          loop { sleep 1000 }
+        end
+      end
+    end
+  end
+end

data/lib/monad/commands/doctor.rb

@@ -0,0 +1,29 @@
+module Monad
+  module Commands
+    class Doctor < Command
+      class << self
+        def process(options)
+          site = Monad::Site.new(options)
+          site.read
+
+          unless deprecated_relative_permalinks(site)
+            Monad::Logger.info "Your test results", "are in. Everything looks fine."
+          end
+        end
+
+        def deprecated_relative_permalinks(site)
+          contains_deprecated_pages = false
+          site.pages.each do |page|
+            if page.uses_relative_permalinks
+              Monad::Logger.warn "Deprecation:", "'#{page.path}' uses relative" +
+                                  " permalinks which will be deprecated in" +
+                                  " Monad v1.1 and beyond."
+              contains_deprecated_pages = true
+            end
+          end
+          contains_deprecated_pages
+        end
+      end
+    end
+  end
+end

data/lib/monad/commands/new.rb

@@ -0,0 +1,50 @@
+require 'erb'
+
+module Monad
+  module Commands
+    class New < Command
+      def self.process(args)
+        raise ArgumentError.new('You must specify a path.') if args.empty?
+
+        new_blog_path = File.expand_path(args.join(" "), Dir.pwd)
+        FileUtils.mkdir_p new_blog_path
+        unless Dir["#{new_blog_path}/**/*"].empty?
+          Monad::Logger.error "Conflict:", "#{new_blog_path} exists and is not empty."
+          exit(1)
+        end
+
+        create_sample_files new_blog_path
+
+        File.open(File.expand_path(self.initialized_post_name, new_blog_path), "w") do |f|
+          f.write(self.scaffold_post_content(site_template))
+        end
+        puts "New monad site installed in #{new_blog_path}."
+      end
+
+      def self.scaffold_post_content(template_site)
+        ERB.new(File.read(File.expand_path(scaffold_path, site_template))).result
+      end
+
+      # Internal: Gets the filename of the sample post to be created
+      #
+      # Returns the filename of the sample post, as a String
+      def self.initialized_post_name
+        "_posts/#{Time.now.strftime('%Y-%m-%d')}-welcome-to-monad.markdown"
+      end
+
+      private
+      def self.create_sample_files(path)
+        FileUtils.cp_r site_template + '/.', path
+        FileUtils.rm File.expand_path(scaffold_path, path)
+      end
+
+      def self.site_template
+        File.expand_path("../../site_template", File.dirname(__FILE__))
+      end
+
+      def self.scaffold_path
+        "_posts/0000-00-00-welcome-to-monad.markdown.erb"
+      end
+    end
+  end
+end

data/lib/monad/commands/serve.rb

@@ -0,0 +1,33 @@
+# -*- coding: utf-8 -*-
+module Monad
+  module Commands
+    class Serve < Command
+      def self.process(options)
+        require 'webrick'
+        include WEBrick
+
+        destination = options['destination']
+
+        FileUtils.mkdir_p(destination)
+
+        mime_types_file = File.expand_path('../mime.types', File.dirname(__FILE__))
+        mime_types = WEBrick::HTTPUtils::load_mime_types(mime_types_file)
+
+        # recreate NondisclosureName under utf-8 circumstance
+        fh_option = WEBrick::Config::FileHandler
+        fh_option[:NondisclosureName] = ['.ht*','~*']
+
+        s = HTTPServer.new(
+          :Port => options['port'],
+          :BindAddress => options['host'],
+          :MimeTypes => mime_types
+        )
+
+        s.mount(options['baseurl'], HTTPServlet::FileHandler, destination, fh_option)
+        t = Thread.new { s.start }
+        trap("INT") { s.shutdown }
+        t.join()
+      end
+    end
+  end
+end

data/lib/monad/configuration.rb

@@ -0,0 +1,183 @@
+# encoding: UTF-8
+
+module Monad
+  class Configuration < Hash
+
+    # Default options. Overridden by values in _config.yml.
+    # Strings rather than symbols are used for compatibility with YAML.
+    DEFAULTS = {
+      'source'        => Dir.pwd,
+      'destination'   => File.join(Dir.pwd, '_site'),
+      'plugins'       => '_plugins',
+      'layouts'       => '_layouts',
+      'keep_files'    => ['.git','.svn'],
+
+      'timezone'      => nil,           # use the local timezone
+
+      'safe'          => false,
+      'show_drafts'   => nil,
+      'limit_posts'   => 0,
+      'lsi'           => false,
+      'future'        => true,           # remove and make true just default
+      'pygments'      => true,
+
+      'relative_permalinks' => true,     # backwards-compatibility with < 1.0
+                                         # will be set to false once 1.1 hits
+
+      'markdown'      => 'maruku',
+      'permalink'     => 'date',
+      'baseurl'       => '/',
+      'include'       => ['.htaccess'],
+      'exclude'       => [],
+      'paginate_path' => 'page:num',
+
+      'markdown_ext'  => 'markdown,mkd,mkdn,md',
+      'textile_ext'   => 'textile',
+
+      'port'          => '4000',
+      'host'          => '0.0.0.0',
+
+      'excerpt_separator' => "\n\n",
+
+      'maruku' => {
+        'use_tex'    => false,
+        'use_divs'   => false,
+        'png_engine' => 'blahtex',
+        'png_dir'    => 'images/latex',
+        'png_url'    => '/images/latex'
+      },
+
+      'rdiscount' => {
+        'extensions' => []
+      },
+
+      'redcarpet' => {
+        'extensions' => []
+      },
+
+      'kramdown' => {
+        'auto_ids'      => true,
+        'footnote_nr'   => 1,
+        'entity_output' => 'as_char',
+        'toc_levels'    => '1..6',
+        'smart_quotes'  => 'lsquo,rsquo,ldquo,rdquo',
+        'use_coderay'   => false,
+
+        'coderay' => {
+          'coderay_wrap'              => 'div',
+          'coderay_line_numbers'      => 'inline',
+          'coderay_line_number_start' => 1,
+          'coderay_tab_width'         => 4,
+          'coderay_bold_every'        => 10,
+          'coderay_css'               => 'style'
+        }
+      },
+
+      'redcloth' => {
+        'hard_breaks' => true
+      }
+    }
+
+    # Public: Turn all keys into string
+    #
+    # Return a copy of the hash where all its keys are strings
+    def stringify_keys
+      reduce({}) { |hsh,(k,v)| hsh.merge(k.to_s => v) }
+    end
+
+    # Public: Directory of the Monad source folder
+    #
+    # override - the command-line options hash
+    #
+    # Returns the path to the Monad source directory
+    def source(override)
+      override['source'] || self['source'] || DEFAULTS['source']
+    end
+
+    # Public: Generate list of configuration files from the override
+    #
+    # override - the command-line options hash
+    #
+    # Returns an Array of config files
+    def config_files(override)
+      # Get configuration from <source>/_config.yml or <source>/<config_file>
+      config_files = override.delete('config')
+      config_files = File.join(source(override), "_config.yml") if config_files.to_s.empty?
+      config_files = [config_files] unless config_files.is_a? Array
+      config_files
+    end
+
+    # Public: Read configuration and return merged Hash
+    #
+    # file - the path to the YAML file to be read in
+    #
+    # Returns this configuration, overridden by the values in the file
+    def read_config_file(file)
+      next_config = YAML.safe_load_file(file)
+      raise "Configuration file: (INVALID) #{file}".yellow if !next_config.is_a?(Hash)
+      Monad::Logger.info "Configuration file:", file
+      next_config
+    end
+
+    # Public: Read in a list of configuration files and merge with this hash
+    #
+    # files - the list of configuration file paths
+    #
+    # Returns the full configuration, with the defaults overridden by the values in the
+    # configuration files
+    def read_config_files(files)
+      configuration = clone
+
+      begin
+        files.each do |config_file|
+          new_config = read_config_file(config_file)
+          configuration = configuration.deep_merge(new_config)
+        end
+      rescue SystemCallError
+        # Errno:ENOENT = file not found
+        Monad::Logger.warn "Configuration file:", "none"
+      rescue => err
+        Monad::Logger.warn "WARNING:", "Error reading configuration. " +
+                     "Using defaults (and options)."
+        $stderr.puts "#{err}"
+      end
+
+      configuration.backwards_compatibilize
+    end
+
+    # Public: Ensure the proper options are set in the configuration to allow for
+    # backwards-compatibility with Monad pre-1.0
+    #
+    # Returns the backwards-compatible configuration
+    def backwards_compatibilize
+      config = clone
+      # Provide backwards-compatibility
+      if config.has_key?('auto') || config.has_key?('watch')
+        Monad::Logger.warn "Deprecation:", "Auto-regeneration can no longer" +
+                            " be set from your configuration file(s). Use the"+
+                            " --watch/-w command-line option instead."
+        config.delete('auto')
+        config.delete('watch')
+      end
+
+      if config.has_key? 'server'
+        Monad::Logger.warn "Deprecation:", "The 'server' configuration option" +
+                            " is no longer accepted. Use the 'monad serve'" +
+                            " subcommand to serve your site with WEBrick."
+        config.delete('server')
+      end
+
+      if config.has_key? 'server_port'
+        Monad::Logger.warn "Deprecation:", "The 'server_port' configuration option" +
+                            " has been renamed to 'port'. Please update your config" +
+                            " file accordingly."
+        # copy but don't overwrite:
+        config['port'] = config['server_port'] unless config.has_key?('port')
+        config.delete('server_port')
+      end
+
+      config
+    end
+
+  end
+end