kitc 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,9 @@
+source "http://rubygems.org"
+
+group :development do
+  gem "rspec"
+  gem "rdoc"
+  gem "bundler"
+  gem "jeweler"
+  gem "rcov"
+end

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Matthew McMillion
+
+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,32 @@
+KitC
+===============================================================================
+
+A Command-Line Compiler and Library for The Kit Language
+-------------------------------------------------------------------------------
+
+**KitC** makes it easy to quickly compile Kit files written in [The Kit Language](http://incident57.com/codekit/kit.php):
+
+	$ gem install kitc
+	$ kitc index.kit
+	
+By default, **KitC** compiles the Kit file to the same location as the source.  This can be overridden by specifying `--output-dir`:
+
+	$ kitc --output-dir /web/ index.kit
+	
+Feel free to queue up as many files as needed.  **KitC** will parse them one at a time:
+
+	$ kitc index.kit bio.kit about.kit
+	
+**KitC** doesn't automatically clobber existing files.  If you want, you can specify to overwrite output files:
+
+	$ kitc --overwrite index.kit
+	
+If piping is your thing, **KitC** can also output to Standard Out:
+
+	$ kitc --stdout index.kit > index.html
+	
+**KitC** is packaged as a Ruby module with a Ruby front-end executable. If you're Ruby-savvy, you can use **KitC** programmatically in your programs or Rake tasks:
+
+	require "kitc"
+	
+	output = KitC.parse(path_to_file)

data/Rakefile

@@ -0,0 +1,51 @@
+# encoding: utf-8
+
+require 'lib/kitc/version'
+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.name = "kitc"
+  gem.version = KitC::Version::STRING
+  gem.homepage = "http://github.com/MatthewMcMillion/kitc"
+  gem.license = "MIT"
+  gem.summary = %Q{Kit Language Compiler}
+  gem.description = %Q{Compiles (Processes) HTML files written with the Kit language}
+  gem.email = "matthew@bitpivot.com"
+  gem.authors = ["Matthew McMillion"]
+  gem.executables = 'kitc'
+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 = KitC::Version::STRING
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "kitc #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+  rdoc.rdoc_files.exclude('lib/**/trollop.rb')
+end

data/bin/kitc

@@ -0,0 +1,39 @@
+#!/usr/bin/env ruby
+
+# Add self to libpath
+$:.unshift File.expand_path("../../lib", __FILE__)
+require "kitc"
+
+opts = Trollop::options do
+  version "KitC #{KitC::Version::STRING}"
+  banner "Usage: kitc --output_dir <output> <input_file_1> <input_file_2>"
+  opt :output_dir, "Output directory", :type => String
+  opt :stdout, "Send output to standard out"
+  opt :overwrite, "Overwrite output files if they exist"
+end
+
+# Blow up if no input files were supplied
+Trollop::die "At least one input file is required" if ARGV.empty?
+
+ARGV.each do |in_file|
+  # Stdout
+  if opts[:stdout]
+    puts KitC.parse(in_file)
+
+  # Write file
+  elsif
+    out_filename =  File.basename(in_file, ".*") + ".html"
+    out_filepath = ""
+    if opts[:output_dir]
+      out_filepath = File.expand_path(File.join(opts[:output_dir], out_filename))
+    else
+      out_filepath = File.expand_path(File.join(File.dirname(in_file), out_filename))
+    end
+
+    # If the file exists and overwrite wasn't specified, blow up
+    abort "ERROR: '#{out_filepath}' already exists and --overwrite was not specified." if (File.exists? out_filepath) && !opts[:overwrite]
+
+    puts "Compiling '#{in_file}'..."
+    File.open(out_filepath, "w") { |f| f.write(KitC.parse(in_file))}
+  end
+end

data/kitc.gemspec

@@ -0,0 +1,73 @@
+# 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 = "kitc"
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Matthew McMillion"]
+  s.date = "2013-03-23"
+  s.description = "Compiles (Processes) HTML files written with the Kit language"
+  s.email = "matthew@bitpivot.com"
+  s.executables = ["kitc"]
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "bin/kitc",
+    "kitc.gemspec",
+    "lib/kitc.rb",
+    "lib/kitc/base.rb",
+    "lib/kitc/trollop.rb",
+    "lib/kitc/version.rb",
+    "spec/base_spec.rb",
+    "spec/spec_helper.rb",
+    "test/assets/_lorem.kit",
+    "test/assets/_sosad.html",
+    "test/assets/fish.kit",
+    "test/assets/sub/sub.kit",
+    "test/assets/sub/sub2/test.html",
+    "test/assets/test.kit",
+    "test/test.html"
+  ]
+  s.homepage = "http://github.com/MatthewMcMillion/kitc"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.25"
+  s.summary = "Kit Language 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_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<rdoc>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+    else
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<rdoc>, [">= 0"])
+      s.add_dependency(%q<bundler>, [">= 0"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<rdoc>, [">= 0"])
+    s.add_dependency(%q<bundler>, [">= 0"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+  end
+end
+

data/lib/kitc/base.rb

@@ -0,0 +1,174 @@
+module KitC
+
+  public
+
+
+
+  # Begin parsing a Kit file
+  #
+  def self.parse(file)
+    filepath = from_fuzzy_path(file)
+    kit_error("File not found", file) unless filepath
+    import(filepath)
+  end
+
+
+
+  private
+
+
+
+  @current_offset # Hold current offset when parsing a Kit file
+
+
+
+  # Fuzzily get an import file's path
+  #
+  def self.from_fuzzy_path(filepath)
+    filepath = File.expand_path(filepath)
+
+    return filepath if FileTest.exists?(filepath)
+
+    # Assume .kit extension
+    assume_kit = "#{filepath}.kit"
+    return assume_kit if FileTest.exists?(assume_kit)
+
+    # Assume Sass partial
+    sass_partial = sass_partial(filepath)
+    return sass_partial if FileTest.exists?(sass_partial)
+
+    # Assume Sass partial and .kit extension
+    sass_partial_kit = sass_partial(assume_kit)
+    return sass_partial_kit if FileTest.exists?(sass_partial_kit)
+
+    return nil
+  end
+
+
+
+  # Performs a file import on one or more files
+  #
+  def self.import(filepaths, imports = Array.new, variables = Hash.new)
+    result = ""
+
+    filepaths.each do |filepath|
+      scope_dir(filepath) do
+        # If the file is a Kit parse it, otherwise just get contents
+        if File.extname(filepath).downcase == ".kit"
+          result += parse_kit(filepath, imports, variables)
+        else
+          result += File.read(filepath)
+        end
+
+        result += "\n" unless filepath == filepaths[-1] # Don't add a newline to last import
+      end
+    end
+
+    return result
+  end
+
+
+
+  # Parse a file for Kit tags
+  #
+  def self.parse_kit(filepath, imports, variables)
+    # Each recursion gets its own verison of imports and variables
+    imports = imports.dup
+    variables = variables.dup
+
+    scope_dir(filepath) do
+      # Blow up with the parent import if this file has already been imported
+      kit_error("Recursion error", imports[-1]) if imports.include? filepath
+
+      result = File.read(filepath)
+      imports << filepath
+
+      # Find and parse all Kit tags
+      result.gsub!(/<!--\s*(?:@|\$)(.*)-->/) do
+        tag = $1.strip.chomp
+        @current_offset = $~.offset(0)[0]
+
+        # Import tag
+        if match = tag.match(/(?:import|include)\s+(.*)/)
+          files = $1.split(",").map do |file|
+            # Clean up any quotes or extraneous spaces and check the file
+            filepath = from_fuzzy_path(strip_quotes(file).strip)
+            kit_error("File not found", file, imports) unless filepath
+            filepath
+          end
+          import(files, imports, variables)
+
+        # Variable assignment tag
+        elsif match = tag.match(/([a-zA-Z0-9\-_]+)\s*(?:=|\:|\s+)\s*(.*)/)
+          variables[$1.strip] = $2.strip
+          "" # Completely remove the comment from the source
+
+        # Variable usage tag
+        elsif match = tag.match(/^([a-zA-Z0-9\-_]+)$/)
+          if variables.has_key? $1
+            variables[$1]
+          else
+            kit_error("Unitialized variable: '#{$1}'", filepath)
+          end
+
+        # Undefined tag type
+        else kit_error("Undefined tag type", filepath)
+
+        end
+      end
+
+      return result
+    end
+  end
+
+
+
+  # Removes Single and Double Quotes
+  #
+  def self.strip_quotes(str)
+    return str.gsub("\"", "").gsub("'", "")
+  end
+
+
+
+  # Return a Sass partial filename
+  #
+  def self.sass_partial(filepath)
+    filename = File.basename(filepath)
+    return File.join(File.dirname(filepath), "_#{filename}")
+  end
+
+
+
+  # Scope a block to a file's directory
+  #
+  def self.scope_dir(filepath, &code)
+    Dir.chdir(File.dirname(filepath)) do
+      code.call
+    end
+  end
+
+
+
+  # Raise a friendly error
+  #
+  def self.kit_error(message, filepath, imports = nil)
+    # File not found, recurse if imports was passed in
+    if !File.exists? filepath
+      puts "ERROR: #{filepath}: #{message}"
+      if imports
+        kit_error(message, imports[-1])
+      else
+        abort
+      end
+
+    # Use the supplied offset to find the line number and column of the error
+    else
+      lines = File.read(filepath)[0, @current_offset].split("\n")
+      line = lines.length
+      column = lines[-1].length
+      abort "ERROR: #{filepath} (Line #{line}, Column #{column}): #{message}"
+    end
+  end
+
+end