kcomp 0.1.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,17 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+gem "rgl", "~>0.4.0"
+
+group :development do
+  gem "pry", "~> 0.9.12"
+  gem "rspec", "~> 2.8.0"
+  gem "rdoc", "~> 3.12"
+  gem "bundler", "~> 1.3.0"
+  gem "jeweler", "~> 1.8.4"
+  gem "simplecov", ">= 0"
+end

data/Gemfile.lock

@@ -0,0 +1,50 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    coderay (1.0.9)
+    diff-lcs (1.1.3)
+    git (1.2.5)
+    jeweler (1.8.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.7.7)
+    method_source (0.8.1)
+    multi_json (1.7.2)
+    pry (0.9.12)
+      coderay (~> 1.0.5)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    rake (10.0.4)
+    rdoc (3.12.2)
+      json (~> 1.4)
+    rgl (0.4.0)
+      rake
+      stream (>= 0.5)
+    rspec (2.8.0)
+      rspec-core (~> 2.8.0)
+      rspec-expectations (~> 2.8.0)
+      rspec-mocks (~> 2.8.0)
+    rspec-core (2.8.0)
+    rspec-expectations (2.8.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.8.0)
+    simplecov (0.7.1)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.7.1)
+    simplecov-html (0.7.1)
+    slop (3.4.4)
+    stream (0.5)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.3.0)
+  jeweler (~> 1.8.4)
+  pry (~> 0.9.12)
+  rdoc (~> 3.12)
+  rgl (~> 0.4.0)
+  rspec (~> 2.8.0)
+  simplecov

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Jeremy Holland
+
+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.rdoc

@@ -0,0 +1,23 @@
+= kcomp
+
+This is a simple command-line compiler for CodeKit .kit files for those of us who don't have it, aren't on Macs, or simply prefer the command line  Usage is pretty simple:
+
+  kcomp SRC-DIR DEST-DIR
+
+if the arguemnts are omitted, they will both be assumed to be the CWD. Documentation on the .kit file format can be found at http://incident57.com/codekit/kit.php.
+
+== Contributing to kcomp
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2013 Jeremy Holland. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,49 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "kcomp"
+  gem.homepage = "http://github.com/awebneck/kcomp"
+  gem.license = "MIT"
+  gem.summary = %Q{Codekit .kit file command-line compiler}
+  gem.description = %Q{Codekit .kit file command-line compiler}
+  gem.email = "jeremy@jeremypholland.com"
+  gem.authors = ["Jeremy Holland"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "kcomp #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/bin/kcomp

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require File.dirname(__FILE__) + "/../lib/kcomp"
+
+KComp.compile! ARGV[0] || ".", ARGV[1] || "."

data/kcomp.gemspec

@@ -0,0 +1,96 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "kcomp"
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Jeremy Holland"]
+  s.date = "2013-04-06"
+  s.description = "Codekit .kit file command-line compiler"
+  s.email = "jeremy@jeremypholland.com"
+  s.executables = ["kcomp"]
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "bin/kcomp",
+    "kcomp.gemspec",
+    "lib/errors.rb",
+    "lib/kcomp.rb",
+    "spec/kcomp_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/support/test-dest/.gitkeep",
+    "spec/support/test-src-cyclic-1/inc1.kit",
+    "spec/support/test-src-cyclic-1/test-inclusion.kit",
+    "spec/support/test-src-cyclic-2/inc1.kit",
+    "spec/support/test-src-cyclic-2/inc2.kit",
+    "spec/support/test-src-cyclic-2/test-inclusion.kit",
+    "spec/support/test-src-missing-dependency/test.kit",
+    "spec/support/test-src-undefined-variable/test.kit",
+    "spec/support/test-src/_partial1.kit",
+    "spec/support/test-src/_partial2.kit",
+    "spec/support/test-src/_partial3.kit",
+    "spec/support/test-src/inc1.kit",
+    "spec/support/test-src/inc10.kit",
+    "spec/support/test-src/inc11.kit",
+    "spec/support/test-src/inc12.kit",
+    "spec/support/test-src/inc2.kit",
+    "spec/support/test-src/inc4.kit",
+    "spec/support/test-src/inc5.kit",
+    "spec/support/test-src/inc7.kit",
+    "spec/support/test-src/inc8.kit",
+    "spec/support/test-src/inc9.kit",
+    "spec/support/test-src/somedir/inc3.kit",
+    "spec/support/test-src/somedir/inc6.kit",
+    "spec/support/test-src/test-inclusion.kit"
+  ]
+  s.homepage = "http://github.com/awebneck/kcomp"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.23"
+  s.summary = "Codekit .kit file command-line compiler"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<rgl>, ["~> 0.4.0"])
+      s.add_development_dependency(%q<pry>, ["~> 0.9.12"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.8.0"])
+      s.add_development_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.3.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.4"])
+      s.add_development_dependency(%q<simplecov>, [">= 0"])
+    else
+      s.add_dependency(%q<rgl>, ["~> 0.4.0"])
+      s.add_dependency(%q<pry>, ["~> 0.9.12"])
+      s.add_dependency(%q<rspec>, ["~> 2.8.0"])
+      s.add_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_dependency(%q<bundler>, ["~> 1.3.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
+      s.add_dependency(%q<simplecov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rgl>, ["~> 0.4.0"])
+    s.add_dependency(%q<pry>, ["~> 0.9.12"])
+    s.add_dependency(%q<rspec>, ["~> 2.8.0"])
+    s.add_dependency(%q<rdoc>, ["~> 3.12"])
+    s.add_dependency(%q<bundler>, ["~> 1.3.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
+    s.add_dependency(%q<simplecov>, [">= 0"])
+  end
+end
+

data/lib/errors.rb

@@ -0,0 +1,5 @@
+class KComp
+  class MissingDependencyError < Exception; end
+  class CyclicDependencyError < Exception; end
+  class UndefinedVariableError < Exception; end
+end

data/lib/kcomp.rb

@@ -0,0 +1,146 @@
+require 'rgl/adjacency'
+require 'rgl/topsort'
+require 'fileutils'
+require File.dirname(__FILE__) + "/errors"
+
+class KComp
+  def initialize(src, dest)
+    @depdg = RGL::DirectedAdjacencyGraph.new
+    @texts = {}
+    @ctexts = {}
+    @vars = {}
+    @src = src = src =~ /\/$/ ? src : src + "/"
+    @dest = dest = dest =~ /\/$/ ? dest : dest + "/"
+    build_vertices src
+    @vertices = @depdg.to_a
+    build_edges src
+    check_for_cycles
+    @tsort = @depdg.topsort_iterator
+    @reversedg = @depdg.reverse
+    @rtsort = @reversedg.topsort_iterator
+    define_variables
+  end
+
+  def dependency_digraph
+    @depdg
+  end
+
+  def reverse_dependency_digraph
+    @reversedg
+  end
+
+  def files
+    @tsort.to_a
+  end
+
+  def compile!
+    compile_files(@dest)
+    puts "Compilation complete"
+  end
+
+  private
+    def define_variables
+      @tsort.each do |v|
+        rf = f = @texts[v]
+        vars = {}
+        f.scan(/(<!-- ?[$@]([A-Za-z_][A-Za-z0-9_\-]*) ?[ :=] *(.+) *-->)/).each do |var|
+          vars[var[1]] = var.last.strip
+          rf.gsub! var.first, ""
+        end
+        define_variables_for_vertex v, vars
+      end
+    end
+
+    def define_variables_for_vertex(v, vars)
+      @vars[v] ||= {}
+      @vars[v].merge! vars
+      @depdg.adjacent_vertices(v).each do |dep|
+        define_variables_for_vertex dep, vars
+      end
+    end
+
+    def compile_files(dest)
+      @rtsort.each do |v|
+        rf = f = @texts[v]
+        f.scan(/(<!--!!! (.+) !!!-->)/).each do |import|
+          rf.gsub! import.first, @ctexts[import.last]
+        end
+        f.scan(/(<!-- ?[$@]([A-Za-z_][A-Za-z0-9_\-]*) ?-->)/).each do |import|
+          if @vars[v][import.last].nil?
+            raise UndefinedVariableError, "Variable #{import.last} not defined."
+          end
+          rf.gsub! import.first, @vars[v][import.last]
+        end
+        @ctexts[v] = rf.gsub(/\n+/, "\n")
+        if (v !~ /_[^\/]+\.kit$/)
+          filename = dest + v.gsub(@src, "").gsub(/\.kit$/, ".html")
+          dirname = filename.gsub(/\/[^\/]+$/, "")
+          puts "Compiling #{filename}"
+          unless Dir.exists?(dirname)
+            FileUtils.mkdir_p dirname
+          end
+          File.open(filename, 'w+') do |file|
+            file.write @ctexts[v]
+          end
+        end
+      end
+    end
+
+    def check_for_cycles
+      cycle = @depdg.cycles.first
+      unless cycle.nil?
+        last = cycle.pop
+        text = cycle.join(", ")
+        text += (cycle.length > 1 ? ", and " : " and ") + last
+        raise CyclicDependencyError, "A cyclic dependency exists between: #{text}."
+      end
+    end
+
+    def build_vertices(src)
+      Dir.entries(src).each do |entry|
+        if Dir.exists?(src + entry) && ![".", ".."].include?(entry)
+          build_vertices(src + entry + "/")
+        elsif entry =~ /\.kit$/
+          @depdg.add_vertex src + entry
+        end
+      end
+    end
+
+    def build_edges(src)
+      @depdg.vertices.each do |v|
+        add_edges(src, v)
+      end
+    end
+
+    def add_edges(src, vertex)
+      rf = f = File.read(vertex)
+      f.scan(/(<!-- ?@(?:import|include) ['"]?((?:[A-Za-z0-9_\/\-.]+(?:, *)?)+)['"]? ?-->)/).each do |import|
+        repl = []
+        import.last.split(/, */).each do |incl|
+          match = nil
+          if @vertices.include?(src + incl)
+            match = src + incl
+          elsif @vertices.include?(src + "_" + incl)
+            match = src + "_" + incl
+          else
+            match = @vertices.select { |v| v =~ /#{incl}$/ }.first
+            if match.nil?
+              match = @vertices.select { |v| v =~ /_#{incl}$/ }.first
+            end
+          end
+          if match.nil?
+            raise MissingDependencyError, "File #{vertex} depends upon #{incl}, but no such file was found."
+          end
+          @depdg.add_edge vertex, match
+          repl << match
+        end
+        rf.gsub! import.first, repl.map { |r| "<!--!!! #{r} !!!-->" }.join("\n")
+      end
+      @texts[vertex] = rf
+    end
+
+  def self.compile!(src, dest)
+    kc = KComp.new src, dest
+    kc.compile!
+  end
+end

data/spec/kcomp_spec.rb

@@ -0,0 +1,238 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe KComp do
+  describe "constructor" do
+    it "should raise a CyclicDependencyError if there are cyclic dependencies in the src files of the provided directory" do
+      lambda { KComp.new CYCLIC_SRC_1, DEST }.should raise_error KComp::CyclicDependencyError
+      lambda { KComp.new CYCLIC_SRC_2, DEST }.should raise_error KComp::CyclicDependencyError
+    end
+
+    it "should raise a MissingDependencyError if there are imported files that can't be found" do
+      lambda { KComp.new MISSING_DEP_SRC, DEST }.should raise_error KComp::MissingDependencyError
+    end
+  end
+
+  describe "instance methods" do
+    let(:comp) { KComp.new GOOD_SRC, DEST }
+    let(:undef) { KComp.new UNDEFINED_VAR_SRC, DEST }
+
+    describe "dependency_digraph" do
+      let(:dg) { comp.dependency_digraph }
+      let(:adjv) { dg.adjacent_vertices(GOOD_SRC + "/test-inclusion.kit") }
+      it "should contain a node for each .kit file in the directory" do
+        dg.should include(GOOD_SRC + "/_partial1.kit")
+        dg.should include(GOOD_SRC + "/_partial2.kit")
+        dg.should include(GOOD_SRC + "/_partial3.kit")
+        dg.should include(GOOD_SRC + "/inc1.kit")
+        dg.should include(GOOD_SRC + "/inc2.kit")
+        dg.should include(GOOD_SRC + "/somedir/inc3.kit")
+        dg.should include(GOOD_SRC + "/inc4.kit")
+        dg.should include(GOOD_SRC + "/inc5.kit")
+        dg.should include(GOOD_SRC + "/somedir/inc6.kit")
+        dg.should include(GOOD_SRC + "/inc7.kit")
+        dg.should include(GOOD_SRC + "/inc8.kit")
+        dg.should include(GOOD_SRC + "/inc9.kit")
+        dg.should include(GOOD_SRC + "/inc10.kit")
+        dg.should include(GOOD_SRC + "/inc11.kit")
+        dg.should include(GOOD_SRC + "/inc12.kit")
+        dg.should include(GOOD_SRC + "/test-inclusion.kit")
+      end
+
+      it "should have directed edges indicating dependency relations" do
+        adjv.should include(GOOD_SRC + "/_partial1.kit")
+        adjv.should include(GOOD_SRC + "/_partial2.kit")
+        adjv.should include(GOOD_SRC + "/inc1.kit")
+        adjv.should include(GOOD_SRC + "/inc2.kit")
+        adjv.should include(GOOD_SRC + "/somedir/inc3.kit")
+        adjv.should include(GOOD_SRC + "/inc4.kit")
+        adjv.should include(GOOD_SRC + "/inc5.kit")
+        adjv.should include(GOOD_SRC + "/somedir/inc6.kit")
+        adjv.should include(GOOD_SRC + "/inc7.kit")
+        adjv.should include(GOOD_SRC + "/inc8.kit")
+        adjv.should include(GOOD_SRC + "/inc9.kit")
+        adjv.should include(GOOD_SRC + "/inc10.kit")
+      end
+
+      it "should not have any directed edges for undependent or indirectly dependent files" do
+        adjv = dg.adjacent_vertices(GOOD_SRC + "/test-inclusion.kit")
+        adjv.should_not include(GOOD_SRC + "/test-inclusion.kit")
+        adjv.should_not include(GOOD_SRC + "/inc11.kit")
+        adjv.should_not include(GOOD_SRC + "/inc12.kit")
+        adjv.should_not include(GOOD_SRC + "/_partial3.kit")
+      end
+    end
+
+    describe "reverse_dependency_digraph" do
+      let(:dg) { comp.reverse_dependency_digraph }
+      let(:adjv1) { dg.adjacent_vertices(GOOD_SRC + "/inc4.kit") }
+      let(:adjv2) { dg.adjacent_vertices(GOOD_SRC + "/inc11.kit") }
+      let(:adjv3) { dg.adjacent_vertices(GOOD_SRC + "/_partial3.kit") }
+
+      it "should contain a node for each .kit file in the directory" do
+        dg.should include(GOOD_SRC + "/_partial1.kit")
+        dg.should include(GOOD_SRC + "/_partial2.kit")
+        dg.should include(GOOD_SRC + "/_partial3.kit")
+        dg.should include(GOOD_SRC + "/inc1.kit")
+        dg.should include(GOOD_SRC + "/inc2.kit")
+        dg.should include(GOOD_SRC + "/somedir/inc3.kit")
+        dg.should include(GOOD_SRC + "/inc4.kit")
+        dg.should include(GOOD_SRC + "/inc5.kit")
+        dg.should include(GOOD_SRC + "/somedir/inc6.kit")
+        dg.should include(GOOD_SRC + "/inc7.kit")
+        dg.should include(GOOD_SRC + "/inc8.kit")
+        dg.should include(GOOD_SRC + "/inc9.kit")
+        dg.should include(GOOD_SRC + "/inc10.kit")
+        dg.should include(GOOD_SRC + "/inc11.kit")
+        dg.should include(GOOD_SRC + "/inc12.kit")
+        dg.should include(GOOD_SRC + "/test-inclusion.kit")
+      end
+
+      it "should have directed edges indicating dependent relations" do
+        adjv1.should include(GOOD_SRC + "/test-inclusion.kit")
+        adjv2.should include(GOOD_SRC + "/inc10.kit")
+        adjv3.should include(GOOD_SRC + "/inc10.kit")
+      end
+
+      it "should not have any directed edges for undependent or indirectly dependent files" do
+        adjv1.should_not include(GOOD_SRC + "/inc10.kit")
+        adjv2.should_not include(GOOD_SRC + "/test-inclusion.kit")
+        adjv3.should_not include(GOOD_SRC + "/test-inclusion.kit")
+      end
+    end
+
+    describe "files" do
+      let(:files) { comp.files }
+
+      it "should return an array of all .kit files" do
+        files.should include(GOOD_SRC + "/_partial1.kit")
+        files.should include(GOOD_SRC + "/_partial2.kit")
+        files.should include(GOOD_SRC + "/_partial3.kit")
+        files.should include(GOOD_SRC + "/inc1.kit")
+        files.should include(GOOD_SRC + "/inc2.kit")
+        files.should include(GOOD_SRC + "/somedir/inc3.kit")
+        files.should include(GOOD_SRC + "/inc4.kit")
+        files.should include(GOOD_SRC + "/inc5.kit")
+        files.should include(GOOD_SRC + "/somedir/inc6.kit")
+        files.should include(GOOD_SRC + "/inc7.kit")
+        files.should include(GOOD_SRC + "/inc8.kit")
+        files.should include(GOOD_SRC + "/inc9.kit")
+        files.should include(GOOD_SRC + "/inc10.kit")
+        files.should include(GOOD_SRC + "/inc11.kit")
+        files.should include(GOOD_SRC + "/inc12.kit")
+        files.should include(GOOD_SRC + "/test-inclusion.kit")
+      end
+
+      it "should order the files topologically by dependency" do
+        files.index(GOOD_SRC + "/_partial3.kit").should > files.index(GOOD_SRC + "/inc10.kit")
+        files.index(GOOD_SRC + "/inc11.kit").should > files.index(GOOD_SRC + "/inc10.kit")
+        files.index(GOOD_SRC + "/_partial1.kit").should > files.index(GOOD_SRC + "/test-inclusion.kit")
+        files.index(GOOD_SRC + "/inc10.kit").should > files.index(GOOD_SRC + "/test-inclusion.kit")
+      end
+    end
+
+    describe "compile!" do
+
+      it "should create any destination directories it needs (as dictated by the source directory structure)" do
+        FileUtils.rm_rf DEST + "/*"
+        capture_stdout do
+          comp.compile!
+        end
+        Dir.exists?(DEST + "/somedir").should be_true
+      end
+
+      it "should create a single html file for each regular kit file" do
+        File.exists?(DEST + "/inc1.html").should be_true
+        File.exists?(DEST + "/inc2.html").should be_true
+        File.exists?(DEST + "/somedir/inc3.html").should be_true
+        File.exists?(DEST + "/inc4.html").should be_true
+        File.exists?(DEST + "/inc5.html").should be_true
+        File.exists?(DEST + "/somedir/inc6.html").should be_true
+        File.exists?(DEST + "/inc7.html").should be_true
+        File.exists?(DEST + "/inc8.html").should be_true
+        File.exists?(DEST + "/inc9.html").should be_true
+        File.exists?(DEST + "/inc10.html").should be_true
+        File.exists?(DEST + "/inc11.html").should be_true
+        File.exists?(DEST + "/inc12.html").should be_true
+        File.exists?(DEST + "/test-inclusion.html").should be_true
+      end
+
+      it "should not create an html file for partials" do
+        File.exists?(DEST + "/partial1.html").should be_false
+        File.exists?(DEST + "/partial2.html").should be_false
+        File.exists?(DEST + "/partial3.html").should be_false
+      end
+
+      describe "generated files" do
+        it "should contain any valid variable references" do
+          File.read(DEST + "/inc1.html").should =~ /VAR 1/
+          File.read(DEST + "/inc2.html").should =~ /VAR 2/
+          File.read(DEST + "/somedir/inc3.html").should =~ /VAR 3/
+          File.read(DEST + "/inc4.html").should =~ /VAR 4/
+          f = File.read(DEST + "/test-inclusion.html")
+          f.should =~ /VAR 1/
+          f.should =~ /VAR 2/
+          f.should =~ /VAR 3/
+          f.should =~ /VAR 4/
+          f.should =~ /VAR 5/
+          f.should =~ /VAR 6/
+          f.should =~ /VAR 7/
+          f.should =~ /VAR 8/
+          f.should =~ /VAR 9/
+          f.should =~ /VAR 10/
+          f.should =~ /VAR 11/
+          f.should =~ /VAR 12/
+        end
+
+        it "should contain any inclusions" do
+          f = File.read(DEST + "/inc10.html")
+          f.scan(/INCLUSION 11/).length.should == 1
+          f.scan(/PARTIAL 3/).length.should == 1
+          f = File.read(DEST + "/test-inclusion.html")
+          f.scan(/INCLUSION 1$/).length.should == 2
+          f.scan(/INCLUSION 2/).length.should == 1
+          f.scan(/INCLUSION 3/).length.should == 1
+          f.scan(/INCLUSION 4/).length.should == 1
+          f.scan(/INCLUSION 5/).length.should == 1
+          f.scan(/INCLUSION 6/).length.should == 1
+          f.scan(/INCLUSION 7/).length.should == 1
+          f.scan(/INCLUSION 8/).length.should == 1
+          f.scan(/INCLUSION 9/).length.should == 1
+          f.scan(/INCLUSION 10/).length.should == 1
+          f.scan(/INCLUSION 11/).length.should == 1
+          f.scan(/PARTIAL 1/).length.should == 1
+          f.scan(/PARTIAL 2/).length.should == 1
+          f.scan(/PARTIAL 3/).length.should == 1
+          f.scan(/VAR 1$/).length.should == 2
+          f.scan(/VAR 2/).length.should == 1
+          f.scan(/VAR 3/).length.should == 1
+          f.scan(/VAR 4/).length.should == 1
+          f.scan(/VAR 5/).length.should == 1
+          f.scan(/VAR 6/).length.should == 1
+          f.scan(/VAR 7/).length.should == 1
+          f.scan(/VAR 8/).length.should == 1
+          f.scan(/VAR 9/).length.should == 1
+          f.scan(/VAR 10/).length.should == 1
+          f.scan(/VAR 11/).length.should == 1
+          f.scan(/VAR 12/).length.should == 1
+        end
+      end
+
+      it "should strip out any repeated newlines" do
+        f = File.read(DEST + "/test-inclusion.html")
+        f.should_not =~ /\n\n+/
+      end
+    end
+
+  end
+
+  describe "class methods" do
+    describe "compile!" do
+      it "should create a new KComp instance with the provided source and destination directories and delegate compilation thereto" do
+        kcomp = mock('KComp')
+        KComp.should_receive(:new).with('blah', 'hat').and_return kcomp
+        kcomp.should_receive(:compile!)
+        KComp.compile!('blah', 'hat')
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,29 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'kcomp'
+require 'fileutils'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+GOOD_SRC = File.dirname(__FILE__) + "/support/test-src"
+CYCLIC_SRC_1 = File.dirname(__FILE__) + "/support/test-src-cyclic-1"
+CYCLIC_SRC_2 = File.dirname(__FILE__) + "/support/test-src-cyclic-2"
+MISSING_DEP_SRC = File.dirname(__FILE__) + "/support/test-src-missing-dependency"
+UNDEFINED_VAR_SRC = File.dirname(__FILE__) + "/support/test-src-undefined-variable"
+DEST = File.dirname(__FILE__) + "/support/test-dest"
+
+RSpec.configure do |config|
+  config.after :all do
+    FileUtils.rm_r Dir.glob(DEST + "/*")
+  end
+end
+
+def capture_stdout
+  prev = $stdout
+  $stdout = StringIO.new
+  yield
+  $stdout = prev
+end

data/spec/support/test-dest/.gitkeep

@@ -0,0 +1 @@
+git sucks

data/spec/support/test-src/_partial1.kit

@@ -0,0 +1 @@
+PARTIAL 1

data/spec/support/test-src/_partial2.kit

@@ -0,0 +1 @@
+PARTIAL 2

data/spec/support/test-src/_partial3.kit

@@ -0,0 +1 @@
+PARTIAL 3

data/spec/support/test-src/inc1.kit

@@ -0,0 +1,3 @@
+INCLUSION 1
+
+<!-- @var1 -->

data/spec/support/test-src/inc10.kit

@@ -0,0 +1,3 @@
+INCLUSION 10
+<!--@include inc11.kit-->
+<!--@include partial3.kit-->

data/spec/support/test-src/inc11.kit

@@ -0,0 +1 @@
+INCLUSION 11

data/spec/support/test-src/inc12.kit

@@ -0,0 +1 @@
+INCLUSION 12

data/spec/support/test-src/inc2.kit

@@ -0,0 +1,3 @@
+INCLUSION 2
+
+<!--@var2-->

data/spec/support/test-src/inc4.kit

@@ -0,0 +1,3 @@
+INCLUSION 4
+
+<!--$var4-->

data/spec/support/test-src/inc5.kit

@@ -0,0 +1 @@
+INCLUSION 5

data/spec/support/test-src/inc7.kit

@@ -0,0 +1 @@
+INCLUSION 7

data/spec/support/test-src/inc8.kit

@@ -0,0 +1 @@
+INCLUSION 8

data/spec/support/test-src/inc9.kit

@@ -0,0 +1 @@
+INCLUSION 9

data/spec/support/test-src/somedir/inc3.kit

@@ -0,0 +1,3 @@
+INCLUSION 3
+
+<!-- $var3 -->

data/spec/support/test-src/somedir/inc6.kit

@@ -0,0 +1 @@
+INCLUSION 6

data/spec/support/test-src/test-inclusion.kit

@@ -0,0 +1,39 @@
+Here is a kit file
+
+Here is a var
+<!-- @var1 VAR 1 -->
+<!-- @var2=VAR 2 -->
+<!-- @var3:VAR 3 -->
+<!--@var4 VAR 4-->
+<!--@var5=VAR 5-->
+<!--@var6:VAR 6-->
+<!-- $var7 VAR 7 -->
+<!-- $var8=VAR 8 -->
+<!-- $var9:VAR 9 -->
+<!--$var10 VAR 10-->
+<!--$var11=VAR 11-->
+<!--$var12:VAR 12-->
+
+Here is an inclusion
+<!-- @import inc1.kit -->
+<!--@import inc2.kit-->
+<!-- @import ./somedir/inc3.kit -->
+<!-- @import partial1.kit -->
+
+<!-- @include inc4.kit -->
+<!--@include inc5.kit-->
+<!-- @include ./somedir/inc6.kit -->
+<!-- @include partial2.kit -->
+
+<!-- @import inc7.kit,inc8.kit -->
+<!--@include inc9.kit, inc10.kit-->
+
+<!--@var5-->
+<!--@var6-->
+<!--@var7-->
+<!--@var8-->
+<!--@var9-->
+<!--@var10-->
+<!--@var11-->
+<!--@var12-->
+<!-- @import inc1.kit -->

data/spec/support/test-src-cyclic-1/inc1.kit

@@ -0,0 +1,3 @@
+INCLUSION 1
+
+<!-- @import test-inclusion.kit -->

data/spec/support/test-src-cyclic-1/test-inclusion.kit

@@ -0,0 +1,5 @@
+Here is a kit file
+
+Here is an inclusion
+
+<!-- @import inc1.kit -->

data/spec/support/test-src-cyclic-2/inc1.kit

@@ -0,0 +1,3 @@
+INCLUSION 1
+
+<!-- @import inc2.kit -->

data/spec/support/test-src-cyclic-2/inc2.kit

@@ -0,0 +1,3 @@
+INCLUSION 2
+
+<!-- @import test-inclusion.kit -->

data/spec/support/test-src-cyclic-2/test-inclusion.kit

@@ -0,0 +1,5 @@
+Here is a kit file
+
+Here is an inclusion
+
+<!-- @import inc1.kit -->

data/spec/support/test-src-missing-dependency/test.kit

@@ -0,0 +1,5 @@
+Here is a kit file
+
+Here is an inclusion
+
+<!-- @import inc1.kit -->

data/spec/support/test-src-undefined-variable/test.kit

@@ -0,0 +1,5 @@
+Here is a kit file
+
+Here is an inclusion
+
+<!-- @undefvar -->

metadata

@@ -0,0 +1,201 @@
+--- !ruby/object:Gem::Specification
+name: kcomp
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Jeremy Holland
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rgl
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.12
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.12
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.8.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.8.0
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Codekit .kit file command-line compiler
+email: jeremy@jeremypholland.com
+executables:
+- kcomp
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .document
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- bin/kcomp
+- kcomp.gemspec
+- lib/errors.rb
+- lib/kcomp.rb
+- spec/kcomp_spec.rb
+- spec/spec_helper.rb
+- spec/support/test-dest/.gitkeep
+- spec/support/test-src-cyclic-1/inc1.kit
+- spec/support/test-src-cyclic-1/test-inclusion.kit
+- spec/support/test-src-cyclic-2/inc1.kit
+- spec/support/test-src-cyclic-2/inc2.kit
+- spec/support/test-src-cyclic-2/test-inclusion.kit
+- spec/support/test-src-missing-dependency/test.kit
+- spec/support/test-src-undefined-variable/test.kit
+- spec/support/test-src/_partial1.kit
+- spec/support/test-src/_partial2.kit
+- spec/support/test-src/_partial3.kit
+- spec/support/test-src/inc1.kit
+- spec/support/test-src/inc10.kit
+- spec/support/test-src/inc11.kit
+- spec/support/test-src/inc12.kit
+- spec/support/test-src/inc2.kit
+- spec/support/test-src/inc4.kit
+- spec/support/test-src/inc5.kit
+- spec/support/test-src/inc7.kit
+- spec/support/test-src/inc8.kit
+- spec/support/test-src/inc9.kit
+- spec/support/test-src/somedir/inc3.kit
+- spec/support/test-src/somedir/inc6.kit
+- spec/support/test-src/test-inclusion.kit
+homepage: http://github.com/awebneck/kcomp
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 1029961015163305883
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Codekit .kit file command-line compiler
+test_files: []