stevenson 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 283a293b67a913eb19f38d5c26e28af097f7a397
+  data.tar.gz: b030b2e3298150ff97011f35de15d382170d3c4b
+SHA512:
+  metadata.gz: 9d7087c8863bb1e47c762409f3756ebabe512c93f1b1dc7276684baefe6c7bfdb438961538c8f3fc65e1d3e3098b8bc55bd633df86590d570a5eebea8f0ee771
+  data.tar.gz: f01181f0ee29f1cee4eb3c36a5d8da36d8142ad0d29fbd7480277f3092a4c4990c40ed3563dafb794e4f6d0e3fbcb7071b9640896125deff4e88d5ec6ca3f77d

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.1.2

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 RootsRated, LLC
+
+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,146 @@
+# Stevenson
+[![Build Status](https://travis-ci.org/RootsRated/stevenson.png)](https://travis-ci.org/RootsRated/stevenson)
+
+Stevenson is a [Jekyll](http://jekyllrb.com) microsite generator created by
+RootsRated.com. Stevenson is named for Robert Louis Stevenson, author of *The
+Strange Case of Dr. Jekyll and Mr. Hyde*.
+[A project](https://github.com/dirk/stevenson) was previously created with this
+name and a similar purpose about 2 years ago, but it hasn't been updated since.
+This project is our attempt to resurrect the idea of a quick simple Jekyll site
+generator.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'stevenson', :git => 'git://github.com/RootsRated/stevenson.git'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself with:
+
+    $ git clone git://github.com/RootsRated/stevenson.git
+    $ cd stevenson
+    $ rake install
+
+## Usage
+
+### Basics
+
+Use Stevenson to create a new microsite like this:
+
+    $ stevenson new hello_world
+
+This will create a new directory in your current working directory named
+`hello_world`. This directory should be a ready-to-use Jekyll
+installation.
+
+### Jekyll Compiling
+
+Stevenson can automatically jekyll build a project and output a built directory
+using the `-j` or `--jekyll`. Following the example from above, you can use the
+following command:
+
+    $ stevenson new hello_world -j
+
+This will output a directory called `hello_world` with the built assets from the
+jekyll project created by the earlier command without the jekyll flag.
+
+### Zip Output
+
+Stevenson can also output directories as a zip archive using the `-z` or `--zip`
+flags. The following command will produce the same result as the first example
+as a zip archive:
+
+    $ stevenson new hello_world.zip -z
+
+Also, the zip flag and jekyll flag can be used together to produce a built and
+compress out like so:
+
+    $ stevenson new hello_world.zip -z -j
+
+This will output a file called `hello_world.zip` with a ready-built website.
+
+Remember that the first argument to `stevenson new` should have a `.zip` on the
+end, as stevenson will not automatically add this extension.
+
+### Templates
+
+By default, stevenson will use RootsRated's
+[Hyde](https://github.com/rootsrated/hyde) repo as the template for the new
+site, but alternative templates can be used with the `--template` or `-t`
+option, like so:
+
+    $ stevenson new hello_world -t https://github.com/YourUsername/YourTemplate.git
+
+This will clone the repo at `https://github.com/YourUsername/YourTemplate.git`
+to `hello_world` and begin altering the repo based on the contents of a
+YAML file in your template's root directory named `_stevenson.yml`. This file
+should contain config options to be set in various files of your Jekyll
+installation along with information on whether these options should be secret,
+validated as emails, validated as URLs, or limited to a certain length.
+
+Here's an example of the YAML file:
+
+    #_stevenson.yml
+    '_config.yml':
+      title:
+        question: 'Title: '
+       limit: 40
+      email:
+        question: 'Email: '
+        email: true
+      description:
+        question: 'Description: '
+      url:
+        question: 'URL: '
+        url: true
+
+This file will produce the following questions when
+`stevenson new hello_world https://github.com/YourUsername/YourTemplate.git` is
+used:
+
+    $ stevenson new hello_world -t https://github.com/YourUsername/YourTemplate.git
+    Title: My Site
+    Email: info@example.org
+    Description: Lorem Ipsum...
+    URL: http://www.example.org
+
+When these questions are answered, the following will be added to
+`hello_world/_config.yml`:
+
+    #_config.yml
+    title: RootsRated.com
+    email: info@rootsrated.com
+    description: This is a microsite created by RootsRated.com
+    url: http://www.rootsrated.com
+
+**The 'question' of each option is required** and will be used to ask users for
+input to replace these values.
+
+Any values already set in the `_config.yml` will be used as defaults for these
+questions.
+
+## Similar Projects
+
+Stevenson may not be the right tool for what you're trying to do, so here's a few
+other projects with similar ideas but slight differences:
+
+- [Octopress](http://octopress.org/) - Octopress is a build and management tool
+for jekyll sites that's more targeted at blogging and personal sites than
+microsites. Octopress is a much more complete solution for jekyll sites with a
+much bigger community, however it definitely lacks some of the simplicity and
+ease of Stevenson. If Stevenson is Sinatra, Octopress is Ruby on Rails.
+- [The Original Stevenson Project](https://github.com/dirk/stevenson) - This
+project was not a first. There was another project called Stevenson with a similar
+idea a while back, but unfortunately it hasn't been updated in over 2 years.
+
+## Contributing
+
+1. Fork it ( https://github.com/RootsRated/stevenson/fork )
+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

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new
+
+task :default => :spec

data/assets/template_aliases.yml

@@ -0,0 +1,36 @@
+hyde-base:
+  git: https://github.com/RootsRated/hyde.git
+  subdirectory: base
+templatedco-exmachina:
+  git: https://github.com/RootsRated/hyde.git
+  subdirectory: exmachina
+templatedco-horizons:
+  git: https://github.com/RootsRated/hyde.git
+  subdirectory: horizons
+templatedco-ion:
+  git: https://github.com/RootsRated/hyde.git
+  subdirectory: ion
+templatedco-linear:
+  git: https://github.com/RootsRated/hyde.git
+  subdirectory: linear
+templatedco-phaseshift:
+  git: https://github.com/RootsRated/hyde.git
+  subdirectory: phaseshift
+templatedco-solarize:
+  git: https://github.com/RootsRated/hyde.git
+  subdirectory: solarize
+rr-base:
+  git: https://github.com/RootsRated/rootsrated_hyde.git
+  subdirectory: base
+rr-ironman:
+  git: https://github.com/RootsRated/rootsrated_hyde.git
+  subdirectory: ironman
+rr-ironwood:
+  git: https://github.com/RootsRated/rootsrated_hyde.git
+  subdirectory: ironwood
+rr-new-balance:
+  git: https://github.com/RootsRated/rootsrated_hyde.git
+  subdirectory: new-balance
+rr-ski-seattle:
+  git: https://github.com/RootsRated/rootsrated_hyde.git
+  subdirectory: ski-seattle

data/bin/stevenson

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'stevenson'
+
+Stevenson::Application.start ARGV

data/lib/stevenson/configurators/yaml_configurator.rb

@@ -0,0 +1,99 @@
+require 'highline/import'
+require 'yaml'
+
+module Stevenson
+  module Configurator
+    class YAMLConfigurator
+      def initialize(config_path)
+        # Save the config path for later use
+        @config_path = config_path
+
+        # Load options from the template
+        @root_options = load_yaml File.join(config_path, '_stevenson.yml')
+      end
+
+      def configure(path=nil, options=nil)
+        # If no options are provided, use the root_options
+        options ||= @root_options
+
+        # If no path is provided, use the config_path
+        path ||= @config_path
+
+        # If the path is a directory, recursively configure that directory
+        if File.directory? path
+          # Iterate through each option provided
+          options.each do |key, value|
+            configure "#{path}/#{key}", value
+          end
+        else
+          # If path is a file, load the YAML from that file
+          config = load_yaml path
+
+          # Collect answers for the config in the file
+          config = collect_answers options, config
+
+          # And save the config back to YAML file.
+          save_yaml path, config
+        end
+      end
+
+      private
+
+      def collect_answers(options, config)
+        if !options['question'] || options['question'].is_a?(Hash)
+          # If the current option is not a leaf, iterate over its values
+          options.each do |key, value|
+            # If no key is present in the config, assign one
+            config[key] = {} unless config[key]
+
+            # Recursively collect answers for the current key in the config and
+            # options
+            config[key] = collect_answers value, config[key]
+          end
+
+          # Return the new config
+          config
+        else
+          # If the option is not a hash, ask the user for input set the key in
+          # the config to it
+          ask_question options, config
+        end
+      end
+
+      def load_yaml(path)
+        # If a YAML file is present, load it
+        if File.file? path
+          YAML.load_file(path) || {}
+        else
+          # Otherwise, return an empty hash
+          {}
+        end
+      end
+
+      def save_yaml(path, config)
+        # Write config to path as YAML
+        File.open(path, 'w') do |f|
+          f.write config.to_yaml
+        end
+      end
+
+      def ask_question(options, default_value)
+        # Load the question text and highline options hash
+        question = options['question']
+        options.delete 'question'
+  
+        # Ask the user the question and apply all options
+        answer = ask(question) do |q|
+          q.default = default_value if default_value != {}
+          q.echo = false if options['secret']
+          q.validate = /\A[\w+\-.]+@[a-z\d\-]+(\.[a-z]+)*\.[a-z]+\z/i  if options['email']
+          q.validate = /https?:\/\/[\S]+/  if options['url']
+          q.limit = options['limit'] if options['limit']
+        end
+  
+        # Return the user's answer
+        answer.to_s
+      end
+    end
+  end
+end

data/lib/stevenson/output_filters/jekyll.rb

@@ -0,0 +1,22 @@
+module Stevenson
+  module OutputFilters
+    module JekyllFilter
+      def output(directory)
+        # Jekyll Build the Directory
+        Dir.chdir(path) do
+          `jekyll b`
+        end
+
+        # Replace the repository with the compiled directory
+        Dir.mktmpdir do |dir|
+          FileUtils.cp_r File.join(path, '_site', '.'), dir
+          FileUtils.rm_r path
+          FileUtils.cp_r dir, path
+        end
+
+        # Call the parent method
+        super directory
+      end
+    end
+  end
+end

data/lib/stevenson/output_filters/zip.rb

@@ -0,0 +1,46 @@
+require 'zip'
+
+module Stevenson
+  module OutputFilters
+    module ZipFilter
+      def output(directory)
+        Dir.mktmpdir do |dir|
+          # Call the parent method
+          super dir
+  
+          # Zip up the output directory
+          write dir, directory
+        end
+      end
+
+      private
+
+      def write(inputDir, outputFile)
+        @inputDir = inputDir
+        @outputFile = outputFile
+
+        entries = Dir.entries(@inputDir)
+        entries.delete(".")
+        entries.delete("..")
+        io = Zip::File.open(@outputFile, Zip::File::CREATE)
+
+        writeEntries(entries, "", io)
+        io.close()
+      end
+
+      def writeEntries(entries, path, io)
+        entries.each { |e|
+          zipFilePath = path == "" ? e : File.join(path, e)
+          diskFilePath = File.join(@inputDir, zipFilePath)
+          if File.directory?(diskFilePath)
+            io.mkdir(zipFilePath)
+            subdir =Dir.entries(diskFilePath); subdir.delete("."); subdir.delete("..")
+            writeEntries(subdir, zipFilePath, io)
+          else
+            io.get_output_stream(zipFilePath) { |f| f.puts(File.open(diskFilePath, "rb").read())}
+          end
+        }
+      end
+    end
+  end
+end

data/lib/stevenson/template_loader.rb

@@ -0,0 +1,50 @@
+require 'stevenson/templates/base'
+require 'stevenson/templates/git'
+require 'yaml'
+
+module Stevenson
+  class TemplateLoader
+    TEMPLATE_ALIASES_PATH = File.join('..', '..', 'assets', 'template_aliases.yml')
+
+    def self.load(template_name)
+      # If a template alias exists with the key template
+      if template_aliases[template_name]
+        # Load a template and return it
+        load_template template_aliases[template_name]
+      elsif template_name =~ /^.*\.git$/
+        # If the given string is a git url, load the git template and return it
+        Templates::GitTemplate.new template_name
+      else
+        # Otherwise, return a new template using the name as a path
+        Templates::Base.new template_name
+      end
+    end
+
+    def self.template_aliases
+      # Get the path to the template aliases file
+      template_aliases_path = File.join(File.dirname(__FILE__), TEMPLATE_ALIASES_PATH)
+
+      # Load the template aliases
+      template_aliases = YAML.load_file template_aliases_path
+    end
+
+    def self.load_template(template_options)
+      # If the template options contain a git url, load the git template and return it
+      if template_options['git']
+        template = Templates::GitTemplate.new template_options['git']
+
+        # If the alias provides a branch, switch to it
+        template.switch_branch template_options['branch'] if template_options['branch']
+
+        # If the alias provides a subdirectory, switch to it
+        template.select_subdirectory template_options['subdirectory'] if template_options['subdirectory']
+
+        # Return the template
+        template
+      else
+        # Otherwise, return false
+        false
+      end
+    end
+  end
+end

data/lib/stevenson/templates/base.rb

@@ -0,0 +1,45 @@
+require 'stevenson/templates/invalid_template_exception'
+
+module Stevenson
+  module Templates
+    class Base
+      def initialize(path)
+        if !File.directory?(path)
+          # If the given path is not a directory, raise an invalid template exception
+          raise InvalidTemplateException.new('The given path is not a directory')
+        else
+          # Otherwise, copy the template to a temporary directory to work with
+          @path = Dir.mktmpdir
+          FileUtils.cp_r File.join(path, '.'), @path
+        end
+      end
+  
+      def path
+        # Return the path to the repo
+        @path
+      end
+
+      def select_subdirectory(directory)
+        # Create a new temporary directory to work from
+        new_path = Dir.mktmpdir
+
+        # Copy files from the subdirectory to the new temp dir
+        FileUtils.cp_r File.join(@path, directory, '.'), new_path
+
+        # Remove the old temporary directory
+        FileUtils.remove_entry_secure @path
+
+        # Set the path to the new path
+        @path = new_path
+      end
+  
+      def output(directory)
+        # Copy the configured template to the output_directory
+        FileUtils.copy_entry @path, directory
+  
+        # Cleanup the temporary directory
+        FileUtils.remove_entry_secure @path
+      end
+    end
+  end
+end

data/lib/stevenson/templates/git.rb

@@ -0,0 +1,27 @@
+require 'git'
+require 'stevenson/templates/base'
+
+module Stevenson
+  module Templates
+    class GitTemplate < Base
+      def initialize(template_url)
+        # Create a temporary directory to clone the repo at
+        Dir.mktmpdir do |dir|
+          # Clone the repo to a temporary directory for later use
+          Git.clone template_url, File.join(dir, 'repo')
+
+          # Call the super, thereby assigning the @path
+          super File.join(dir, 'repo')
+        end
+      rescue Git::GitExecuteError => e
+        # If the given URL is not valid, raise an exception and cleanup
+        raise InvalidTemplateException.new('Failed to clone the repository')
+      end
+
+      def switch_branch(branch)
+        repo = Git::Base.open(path)
+        repo.checkout(branch)
+      end
+    end
+  end
+end

data/lib/stevenson/templates/invalid_template_exception.rb

@@ -0,0 +1,6 @@
+module Stevenson
+  module Templates
+    class InvalidTemplateException < StandardError
+    end
+  end
+end

data/lib/stevenson/version.rb

@@ -0,0 +1,3 @@
+module Stevenson
+  VERSION = "1.0.0"
+end

data/lib/stevenson.rb

@@ -0,0 +1,59 @@
+require 'stevenson/configurators/yaml_configurator'
+require 'stevenson/output_filters/jekyll'
+require 'stevenson/output_filters/zip'
+require 'stevenson/template_loader'
+require 'stevenson/version'
+require 'thor'
+
+module Stevenson
+
+  class Application < Thor
+    desc 'stevenson new PROJECT_NAME', 'generates a Jekyll at PROJECT_NAME'
+
+    method_option :branch,
+                  aliases: '-b',
+                  desc: 'The git branch you would like to use from your template'
+    method_option :jekyll,
+                  type: :boolean,
+                  aliases: '-j',
+                  desc: 'Jekyll compiles the output directory'
+    method_option :subdirectory,
+                  aliases: '-s',
+                  desc: 'The subdirectory to use from the template, if any'
+    method_option :template,
+                  aliases: '-t',
+                  default: 'hyde-base',
+                  desc: 'The template repository to use'
+    method_option :zip,
+                  type: :boolean,
+                  aliases: "-z",
+                  desc: 'Zip compresses the output directory'
+
+    def new(output_directory)
+      # Load the template using the template loader
+      template = Stevenson::TemplateLoader.load options[:template]
+
+      # If a branch is provided, switch to that branch
+      template.switch_branch options[:branch] if options[:branch]
+
+      # If a subdirectory is provided, switch to that directory
+      template.select_subdirectory options[:subdirectory] if options[:subdirectory]
+
+      # Configure the template
+      configurator = Stevenson::Configurator::YAMLConfigurator.new template.path
+      configurator.configure
+
+      # If the jekyll flag is set, compile the template output
+      template.extend(Stevenson::OutputFilters::JekyllFilter) if options[:jekyll]
+
+      # If the zip flag is set, zip up the template output
+      template.extend(Stevenson::OutputFilters::ZipFilter) if options[:zip]
+
+      # Save the repo to the output directory
+      template.output output_directory
+
+    rescue Templates::InvalidTemplateException => e
+      say e.message
+    end
+  end
+end

data/spec/configurators/yaml_configurator_spec.rb

@@ -0,0 +1,12 @@
+describe Stevenson::Configurator::YAMLConfigurator do
+  describe '#initialize' do
+    let(:temporary_directory) { Dir.mktmpdir }
+    let(:yaml_configurator) { Stevenson::Configurator::YAMLConfigurator.new temporary_directory }
+
+    it 'creates a new configurator' do
+      expect(yaml_configurator).to be_an_instance_of Stevenson::Configurator::YAMLConfigurator
+    end
+
+    after { FileUtils.remove_entry_secure temporary_directory }
+  end
+end

data/spec/helpers.rb

@@ -0,0 +1,14 @@
+module Helpers
+  def capture(stream)
+    begin
+      stream = stream.to_s
+      eval "$#{stream} = StringIO.new"
+      yield
+      result = eval("$#{stream}").string
+    ensure
+      eval("$#{stream} = #{stream.upcase}")
+    end
+  
+    result
+  end
+end

data/spec/output_filters/jekyll_spec.rb

@@ -0,0 +1,17 @@
+describe Stevenson::OutputFilters::JekyllFilter do
+  describe '#output' do
+    let(:temporary_directory) { Dir.mktmpdir }
+    let(:template) { Stevenson::TemplateLoader.load 'hyde-base' }
+
+    before do
+      template.extend(subject)
+      template.output temporary_directory
+    end
+
+    it 'outputs a jekyll compiled directory' do
+      expect(File.exists? File.join(temporary_directory, '_config.yml')).to eq false
+    end
+
+    after { FileUtils.remove_entry_secure temporary_directory }
+  end
+end

data/spec/output_filters/zip_spec.rb

@@ -0,0 +1,17 @@
+describe Stevenson::OutputFilters::ZipFilter do
+  describe '#output' do
+    let(:temporary_directory) { Dir.mktmpdir }
+    let(:template) { Stevenson::Templates::GitTemplate.new 'https://github.com/RootsRated/stevenson-base-template.git' }
+
+    before do
+      template.extend(subject)
+      template.output File.join(temporary_directory, 'archive.zip')
+    end
+
+    it 'outputs a zipped directory' do
+      expect(File.exists? File.join(temporary_directory, 'archive.zip')).to eq true
+    end
+
+    after { FileUtils.remove_entry_secure temporary_directory }
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,13 @@
+require 'bundler/setup'
+Bundler.setup
+
+require 'helpers'
+require 'stevenson'
+
+RSpec.configure do |config|
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+  config.include Helpers
+  config.order = 'random'
+end

data/spec/template_loader_spec.rb

@@ -0,0 +1,51 @@
+describe Stevenson::TemplateLoader do
+  subject { Stevenson::TemplateLoader }
+
+  describe '.load' do
+    context 'when given a template alias' do
+      let(:template_alias) { 'hyde-base' }
+      let(:template) { subject.load template_alias }
+
+      it 'returns the appropriate template' do
+        expect(template).to be_an_instance_of Stevenson::Templates::GitTemplate
+      end
+
+      after do
+        Dir.mktmpdir do |dir|
+          template.output dir
+        end
+      end
+    end
+
+    context 'when given a git url' do
+      let(:url) { 'https://github.com/RootsRated/stevenson-base-template.git' }
+      let(:template) { subject.load url }
+
+      it 'returns the appropriate template' do
+        expect(template).to be_an_instance_of Stevenson::Templates::GitTemplate
+      end
+
+      after do
+        Dir.mktmpdir do |dir|
+          template.output dir
+        end
+      end
+    end
+
+    context 'when given a path' do
+      let(:path) { Dir.mktmpdir }
+      let(:template) { subject.load path }
+
+      it 'returns the appropriate template' do
+        expect(template).to be_an_instance_of Stevenson::Templates::Base
+      end
+
+      after do
+        FileUtils.remove_entry_secure path
+        Dir.mktmpdir do |dir|
+          template.output dir
+        end
+      end
+    end
+  end
+end

data/spec/templates/base_spec.rb

@@ -0,0 +1,83 @@
+describe Stevenson::Templates::Base do
+  subject { Stevenson::Templates::Base }
+
+  describe '#initialize' do
+    context 'with a valid path' do
+      let(:path) { Dir.mktmpdir }
+
+      before { FileUtils.touch File.join(path, '_stevenson.yml') }
+
+      it 'creates a new Template' do
+        expect( subject.new path ).to be_an_instance_of Stevenson::Templates::Base
+      end
+
+      after { FileUtils.remove_entry_secure path }
+    end
+
+    context 'with an invalid path' do
+      let(:path) { Dir.mktmpdir }
+
+      it 'raises an invalid template exception' do
+        expect{ subject.new File.join(path, 'not-a-path') }.to raise_exception Stevenson::Templates::InvalidTemplateException
+      end
+
+      after { FileUtils.remove_entry_secure path }
+    end
+  end
+
+  describe '#path' do
+    let(:path) { Dir.mktmpdir }
+    let(:template) { subject.new path }
+
+    before do
+      FileUtils.touch File.join(path, '_stevenson.yml')
+    end
+
+    it 'returns the path of the template' do
+      expect(File.exists? File.join(template.path, '_stevenson.yml')).to eq true
+    end
+
+    after { FileUtils.remove_entry_secure path }
+  end
+
+  describe '#select_subdirectory' do
+    let(:path) { Dir.mktmpdir }
+    let(:subdirectory) { 'subdirectory' }
+    let(:template) { subject.new path }
+
+    before do
+      Dir.mkdir File.join(path, subdirectory)
+      FileUtils.touch File.join(path, subdirectory, '_stevenson.yml')
+    end
+
+    it 'changes the path of the template to a given subdirectory' do
+      template.select_subdirectory subdirectory
+      expect(File.exists? File.join(template.path, '_stevenson.yml')).to eq true
+    end
+
+    after do
+      template.output path
+      FileUtils.remove_entry_secure path
+    end
+  end
+
+  describe '#output' do
+    let(:path) { Dir.mktmpdir }
+    let(:template) { subject.new path }
+    let(:temporary_directory) { Dir.mktmpdir }
+
+    before { template.output File.join(temporary_directory, 'output') }
+
+    it 'outputs the finished template to the directory' do
+      expect(File.exists? File.join(temporary_directory, 'output')).to eq true
+    end
+
+    it 'destroys the temporary directory' do
+      expect(File.exists? template.path).to eq false
+    end
+
+    after do
+      FileUtils.remove_entry_secure temporary_directory
+    end
+  end
+end

data/spec/templates/git_spec.rb

@@ -0,0 +1,37 @@
+describe Stevenson::Templates::GitTemplate do
+  subject { Stevenson::Templates::GitTemplate }
+
+  describe '#initialize' do
+    context 'with a valid URL' do
+      let(:template) { subject.new 'https://github.com/RootsRated/stevenson-base-template.git' }
+
+      it 'creates a new GitTemplate' do
+        expect(template).to be_an_instance_of Stevenson::Templates::GitTemplate
+      end
+
+      it 'clones the given repository to the working template path' do
+        expect(File.exists? File.join(template.path, 'base', '_config.yml')).to eq true
+      end
+    end
+
+    context 'with an invalid URL' do
+      let(:invalid_url) {  'https://github.com/RootsRated/not-a-repo.git' }
+
+      it 'raises an invalid template exception' do
+        expect{ subject.new invalid_url }.to raise_exception(Stevenson::Templates::InvalidTemplateException)
+      end
+    end
+  end
+
+  describe '#switch_branch' do
+    let(:branch) { 'master' }
+    let(:template) { subject.new 'https://github.com/RootsRated/stevenson-base-template.git' }
+
+    before { template.switch_branch branch }
+
+    it 'checksout the repo to the given branch' do
+      repo = Git::Base.open(template.path)
+      expect(repo.current_branch).to eq branch
+    end
+  end
+end

data/stevenson.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'stevenson/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "stevenson"
+  spec.version       = Stevenson::VERSION
+  spec.authors       = ["Dylan Karr"]
+  spec.email         = ["dylan@RootsRated.com"]
+  spec.summary       = "Stevenson is a generator for Jekyll microsites created by RootsRated.com"
+  spec.description   = "Stevenson is a simple generator for microsites using Jekyll"
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+
+  spec.add_dependency "git"
+  spec.add_dependency "highline"
+  spec.add_dependency "jekyll"
+  spec.add_dependency "rubyzip", ">= 1.0.0"
+  spec.add_dependency "thor"
+end

metadata

@@ -0,0 +1,192 @@
+--- !ruby/object:Gem::Specification
+name: stevenson
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Dylan Karr
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-12-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: git
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: jekyll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Stevenson is a simple generator for microsites using Jekyll
+email:
+- dylan@RootsRated.com
+executables:
+- stevenson
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- assets/template_aliases.yml
+- bin/stevenson
+- lib/stevenson.rb
+- lib/stevenson/configurators/yaml_configurator.rb
+- lib/stevenson/output_filters/jekyll.rb
+- lib/stevenson/output_filters/zip.rb
+- lib/stevenson/template_loader.rb
+- lib/stevenson/templates/base.rb
+- lib/stevenson/templates/git.rb
+- lib/stevenson/templates/invalid_template_exception.rb
+- lib/stevenson/version.rb
+- spec/configurators/yaml_configurator_spec.rb
+- spec/helpers.rb
+- spec/output_filters/jekyll_spec.rb
+- spec/output_filters/zip_spec.rb
+- spec/spec_helper.rb
+- spec/template_loader_spec.rb
+- spec/templates/base_spec.rb
+- spec/templates/git_spec.rb
+- stevenson.gemspec
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Stevenson is a generator for Jekyll microsites created by RootsRated.com
+test_files:
+- spec/configurators/yaml_configurator_spec.rb
+- spec/helpers.rb
+- spec/output_filters/jekyll_spec.rb
+- spec/output_filters/zip_spec.rb
+- spec/spec_helper.rb
+- spec/template_loader_spec.rb
+- spec/templates/base_spec.rb
+- spec/templates/git_spec.rb