usmu 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f2ce1d8bd5d6466dc1d6a3fd7bee6e296e53dc14
+  data.tar.gz: 9bc408aade4f29424ab873ec38ba4efef844b9ec
+SHA512:
+  metadata.gz: adfea26ea6f7bc59ae8e95f7eaf9a3e795b40744933e6321fe2dacc2be4fa23f1dc38273edba618e6a80901c75ccc880ee3cda095f0667f1e96a48a7016c68b0
+  data.tar.gz: 9189d6c6248807abc95bd2c02b02f324b56eb89d99740565aac15b5339f6b2fc7e4586dd21c12cc9045321fdb18d456f285fd26fcd3d54c6b80a6976fcee48d2

data/.cane

@@ -0,0 +1,4 @@
+--color
+--max-violations 0
+--style-measure 120
+--abc-exclude Usmu::Layout#initialize

data/.gitignore

@@ -0,0 +1,17 @@
+/.bundle/
+/.yardoc
+/Gemfile*.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+
+# Generated test site
+/test/site/site

data/.rspec

@@ -0,0 +1,5 @@
+--color
+-I test/spec
+--require spec_helper
+--format documentation
+--no-profile

data/.travis.yml

@@ -0,0 +1,34 @@
+language: ruby
+script: rake ci
+rvm:
+  - 2.0
+  - 2.1
+  - ruby-head
+  - jruby-19mode
+  - jruby-head
+  - rbx-2
+  - rbx-head
+gemfile:
+  - Gemfile
+  - Gemfile-jruby
+matrix:
+  exclude:
+    - rvm: 2.0
+      gemfile: Gemfile-jruby
+    - rvm: 2.1
+      gemfile: Gemfile-jruby
+    - rvm: ruby-head
+      gemfile: Gemfile-jruby
+    - rvm: jruby-19mode
+      gemfile: Gemfile
+    - rvm: jruby-head
+      gemfile: Gemfile
+    - rvm: rbx-2
+      gemfile: Gemfile-jruby
+    - rvm: rbx-head
+      gemfile: Gemfile-jruby
+  allow_failures:
+    - rvm: jruby-19mode
+    - rvm: jruby-head
+    - rvm: rbx-2
+    - rvm: rbx-head

data/.yardopts

@@ -0,0 +1 @@
+--private --protected --hide-void-return -m markdown -M redcarpet lib/**/*.rb - README.md

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in usmu.gemspec
+gemspec name: 'usmu'

data/Gemfile-jruby

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in usmu.gemspec
+gemspec name: 'usmu-jruby'

data/LICENSE.md

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Matthew Scharley and contributors
+
+MIT License
+
+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,50 @@
+# usmu [![Build Status](https://travis-ci.org/usmu/usmu.svg?branch=master)](https://travis-ci.org/usmu/usmu)
+
+**Source:** [https://github.com/usmu/usmu](https://github.com/usmu/usmu)  
+**Author:** Matthew Scharley  
+**Contributors:** [See contributors on GitHub][gh-contrib]  
+**Bugs/Support:** [Github Issues][gh-issues]  
+**Copyright:** 2014  
+**License:** [MIT license][license]  
+**Status:** Active
+
+## Synopsis
+
+`usmu` is a static site generator intended to be used with the future Rails-based editing platform. It can also be used
+to generate locally if you don't wish to use the web-based editor.
+
+## Installation
+
+    $ gem install usmu
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Compatibility
+
+As a baseline `usmu` will pull in Slim for layouts and Redcarpet for content written in Markdown. However we use the
+Tilt API to render all layouts and content, therefore you should be able to use anything supported by Tilt including
+Sass, Less, Textile and [many others][tilt-support], you just need to ensure you have the correct gems installed.
+
+If you want to further [configure the way your template's are processed][template-options] then you can specify 
+configurations for each template engine. Just add it to your `usmu.yml`:
+
+```yaml
+slim:
+  :pretty: true
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request
+
+  [gh-contrib]: https://github.com/usmu/usmu/graphs/contributors
+  [gh-issues]: https://github.com/usmu/usmu/issues
+  [license]: https://github.com/usmu/usmu/blob/master/LICENSE.md
+  [tilt-support]: https://github.com/rtomayko/tilt/blob/master/README.md
+  [template-options]: https://github.com/rtomayko/tilt/blob/master/docs/TEMPLATES.md

data/Rakefile

@@ -0,0 +1,61 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'rspec/core/rake_task'
+require 'cucumber'
+require 'cucumber/rake/task'
+require 'usmu/version'
+
+def current_gems
+  Dir["pkg/usmu-#{Usmu::VERSION}*.gem"]
+end
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.pattern = 'test/spec/**/*_spec.rb'
+end
+
+Cucumber::Rake::Task.new(:features) do |t|
+  t.cucumber_opts = 'test/features'
+end
+
+desc 'Run all test scripts'
+task :test => [:clean, :spec, :features]
+
+desc 'Run CI test suite'
+task :ci => [:test]
+
+desc 'Clean up after tests'
+task :clean do
+  rm_r 'test/site/site' if File.exist? 'test/site/site'
+  current_gems.each {|f| rm f }
+end
+
+namespace :gem do
+  desc 'Build gems'
+  task :build => [:clean] do
+    mkdir 'pkg' unless File.exist? 'pkg'
+    Dir['*.gemspec'].each do |gemspec|
+      sh "gem build #{gemspec}"
+    end
+    Dir['*.gem'].each do |gem|
+      mv gem, "pkg/#{gem}"
+    end
+  end
+
+  desc 'Install gem'
+  task :install => ['gem:build'] do
+    if RUBY_PLATFORM == 'java'
+      sh "gem install pkg/usmu-#{Usmu::VERSION}-java.gem"
+    else
+      sh "gem install pkg/usmu-#{Usmu::VERSION}.gem"
+    end
+  end
+
+  desc 'Deploy gems to rubygems'
+  task :deploy => ['gem:build'] do
+    current_gems.each do |gem|
+      sh "gem push #{gem}"
+    end
+    sh "git tag #{Usmu::VERSION}" if File.exist? '.git'
+  end
+end

data/bin/usmu

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+begin
+  require 'usmu/ui/console'
+rescue LoadError
+  $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+  require 'usmu/ui/console'
+end
+
+Usmu::Ui::Console.new(ARGV).execute

data/cucumber.yml

@@ -0,0 +1,2 @@
+---
+default: test/features --format pretty

data/lib/usmu.rb

@@ -0,0 +1,12 @@
+%W{
+  usmu/version
+  usmu/configuration
+  usmu/static_file
+  usmu/layout
+  usmu/page
+  usmu/site_generator
+}.each { |f| require f }
+
+# This module contains all the code for the Usmu site generator
+module Usmu
+end

data/lib/usmu/configuration.rb

@@ -0,0 +1,83 @@
+require 'yaml'
+
+module Usmu
+  # This class is used to represent a configuration file. This file should be a YAML file and called `usmu.yml`
+  # by default.
+  class Configuration
+    # @!attribute [r] config_file
+    # @return [String] the name of the file used to load the configuration.
+    attr_reader :config_file
+    # @!attribute [r] config_file
+    # @return [String] the folder that the configuration was loaded from.
+    attr_reader :config_dir
+
+    # Load a configuration from a YAML file on disk.
+    #
+    # @return [Usmu::Configuration]
+    def self.from_file(filename)
+      from_hash(YAML.load_file(filename), filename)
+    end
+
+    # Load a configuration from a hash.
+    #
+    # @return [Usmu::Configuration]
+    def self.from_hash(hash, config_path = nil)
+      self.new(hash, config_path)
+    end
+
+    # @!attribute [r] source_path
+    # @return [String] the full path to the source folder
+    def source_path
+      get_path @config['source'] || 'src'
+    end
+
+    # @!attribute [r] destination_path
+    # @return [String] the full path to the destination folder
+    def destination_path
+      get_path @config['destination'] || 'site'
+    end
+
+    # @!attribute [r] layouts_path
+    # @return [String] the full path to the layouts folder
+    def layouts_path
+      get_path @config['layouts'] || 'layouts'
+    end
+
+    # An index accessor to directly access the configuration file. It should be noted that `['source']` and
+    # `#source_path` and other similar pairs will have different values. `['source']` is the raw value from the
+    # configuration file while the latter is a path on the system, potentially altered by the path from the current
+    # working directory to the configuration file and other factors. The accessor functions such as `#source_path`
+    # should be preferred for most usages.
+    #
+    # @param [String, Symbol] index The index to return.
+    # @return [Array, Hash, String, Symbol] Returns a value from the hash loaded from YAML. The type of value will
+    #   ultimately depend on the configuration file and the index provided.
+    def [](index)
+      @config[index]
+    end
+
+    private
+
+    # This class has a private constructor.
+    #
+    # @see Usmu::Configuration.from_file
+    # @see Usmu::Configuration.from_hash
+    def initialize(hash, config_path)
+      @config = hash
+      @config_file = config_path
+      @config_dir = config_path ? File.dirname(config_path) : nil
+    end
+
+    # Helper function to transform a relative path in the configuration file to a relative path from the current
+    # working directory.
+    #
+    # @return [String]
+    def get_path(path)
+      if @config_dir.nil?
+        path
+      else
+        File.join(@config_dir, path)
+      end
+    end
+  end
+end

data/lib/usmu/layout.rb

@@ -0,0 +1,166 @@
+require 'tilt'
+require 'deep_merge'
+require 'usmu/static_file'
+
+module Usmu
+  # Class to represent files templated with a Tilt library. Most of the custom rendering logic is contained here.
+  class Layout < StaticFile
+    # @!attribute [r] type
+    # @return [String] the type of file this is. This is used to determine which template engine to use.
+    attr_reader :type
+
+    # @param configuration [Usmu::Configuration] The configuration for the website we're generating.
+    # @param name [String] The name of the file in the source directory.
+    # @param type [String] The type of template to use with the file. Used for testing purposes.
+    # @param content [String] The content of the file. Used for testing purposes.
+    # @param metadata [String] The metadata for the file. Used for testing purposes.
+    def initialize(configuration, name, type = nil, content = nil, metadata = nil)
+      super(configuration, name)
+
+      if type.nil?
+        type = name.split('.').last
+        unless ::Tilt.default_mapping[type]
+          raise "Templates of type '#{type}' aren't currently supported by Tilt. " +
+                'Do you have the required gem installed?'
+        end
+      end
+      @type = type
+      path = File.join("#{content_path}", "#{name[0, name.length - type.length - 1]}")
+
+      if content.nil?
+        content = File.read("#{path}.#{type}")
+      end
+      @content = content
+
+      if metadata.nil?
+        meta_file = "#{path}.meta.yml"
+        metadata = if File.exist? meta_file
+          YAML.load_file(meta_file)
+        else
+          {}
+        end
+      end
+      @metadata = metadata
+
+      @parent = Layout.find_layout(configuration, metadata['layout'])
+    end
+
+    # @!attribute [r] metadata
+    # @return [Hash] the metadata associated with this layout.
+    #
+    # Returns the metadata associated with this layout.
+    #
+    # This will include any metadata from parent templates and default metadata
+    def metadata
+      if @parent.nil?
+        @metadata.deep_merge(@configuration['default meta'] || {})
+      else
+        @metadata.deep_merge(@parent.metadata)
+      end
+    end
+
+    # Renders the file with any templating language required and returns the result
+    #
+    # @param variables [Hash] Variables to be used in the template.
+    # @return [String] The rendered file.
+    def render(variables = {})
+      content = template_class.new("#{@name}.#{@type}", 1, @configuration[provider_name]) { @content }.
+          render(nil, get_variables(variables))
+      has_cr = content.index("\r")
+      content += (has_cr ? "\r\n" : "\n") if content[-1] != "\n"
+      if @parent.nil?
+        content
+      else
+        @parent.render({'content' => content})
+      end
+    end
+
+    # @!attribute [r] output_extension
+    # @return [String] the extension to use with the output file.
+    def output_extension
+      'html'
+    end
+
+    # @!attribute [r] output_filename
+    # @return [String] the filename to use in the output directory.
+    #
+    # Returns the filename to use for the output directory with any modifications to the input filename required.
+    def output_filename
+      @name[0..@name.rindex('.')] + output_extension
+    end
+
+    # Static method to create a layout for a given configuration by it's name if it exists. This differs from
+    # `#initialise` in that it allows different types of values to be supplied as the name and will not fail if name
+    # is nil
+    #
+    # @param configuration [Usmu::Configuration] The configuration to use for the search
+    # @param name [String]
+    #   If name is a string then search for a template with that name. Name here should not include
+    #   file extension, eg. body not body.slim. If name is not a string then it will be returned verbatim. This means
+    #   that name is nilable and can also be passed in as an Usmu::Layout already for testing purposes.
+    # @return [Usmu::Layout]
+    def self.find_layout(configuration, name)
+      if name.class.name == 'String'
+        Dir["#{configuration.layouts_path}/#{name}.*"].each do |f|
+          filename = File.basename(f)
+          if filename != "#{name}.meta.yml"
+            return new(configuration, f[(configuration.layouts_path.length + 1)..f.length])
+          end
+        end
+      else
+        name
+      end
+    end
+
+    # Tests if a given file is a valid Tilt template based on the filename.
+    #
+    # @param folder_type [String]
+    #   One of `"source"` or `"layout"` depending on where the template is in the source tree.
+    #   Not used by Usmu::Layout directly but intended to be available for future API.
+    # @param name [String] The filename to be tested.
+    # @return [Boolean]
+    def self.is_valid_file?(folder_type, name)
+      type = name.split('.').last
+      ::Tilt.default_mapping[type] ? true : false
+    end
+
+    protected
+
+    # @!attribute [r] template_class
+    # @return [Tilt::Template] the Tilt template engine for this layout
+    def template_class
+      @template_class ||= ::Tilt.default_mapping[@type]
+    end
+
+    # @!attribute [r] provider_name
+    # @return [String] the Tilt template engine's name for this layout
+    #
+    # Returns the Tilt template engine's name for this layout.
+    #
+    # This is used to determine which settings to use from the configuration file.
+    def provider_name
+      Tilt.default_mapping.lazy_map[@type].select {|x| x[0] == template_class.name }.first[1].split('/').last
+    end
+
+    # @!attribute [r] content_path
+    # @return [string] the base path to the files used by this class.
+    #
+    # Returns the base path to the files used by this class.
+    #
+    # This folder should be the parent folder for the file named by the name attribute.
+    #
+    # @see #name
+    def content_path
+      @configuration.layouts_path
+    end
+
+    private
+
+    # Utility function which collates variables to pass to the template engine.
+    #
+    # @return [Hash]
+    def get_variables(variables)
+      variables.deep_merge(metadata).deep_merge({site: @configuration})
+    end
+  end
+end