sprockets 0.9.0

data/Rakefile

@@ -0,0 +1,16 @@
+require "rubygems"
+require "rake/testtask"
+require "rake/gempackagetask"
+
+task :default => :test
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList["test/test_*.rb"]
+  t.verbose = true
+end
+
+Rake::GemPackageTask.new(eval(IO.read(File.join(File.dirname(__FILE__), "sprockets.gemspec")))) do |pkg|
+  pkg.need_zip = true
+  pkg.need_tar = true
+end

data/bin/sprocketize

@@ -0,0 +1,54 @@
+#!/usr/bin/env ruby
+
+require File.join(File.dirname(__FILE__), *%w".. lib sprockets")
+require "optparse"
+
+load_path = (ENV["SPROCKETS_PATH"] || "").split(":")
+filenames = []
+options = { :load_path => load_path, :source_files => filenames, :expand_paths => false }
+
+OptionParser.new do |opts|
+  opts.summary_width = 28
+  opts.banner = "Usage: sprocketize [options] filename [filename ...]"
+  
+  def opts.show_usage
+    puts self
+    exit
+  end
+  
+  opts.on("-C DIRECTORY", "--directory=DIRECTORY", "Change to DIRECTORY before doing anything") do |directory|
+    Dir.chdir(directory)
+  end
+  
+  opts.on("-I DIRECTORY", "--include-dir=DIRECTORY", "Adds the directory to the Sprockets load path") do |directory|
+    load_path << directory
+  end
+  
+  opts.on("-a DIRECTORY", "--asset-root=DIRECTORY", "Copy provided assets into DIRECTORY") do |directory|
+    options[:asset_root] = directory
+  end
+  
+  opts.on_tail("-h", "--help", "Shows this help message") do
+    opts.show_usage
+  end
+  
+  opts.on_tail("-v", "--version", "Shows version") do
+    puts Sprockets::Version::STRING
+    exit
+  end
+  
+  opts.show_usage if ARGV.empty?
+  
+  begin
+    opts.order(ARGV) do |filename|
+      filenames << filename
+    end
+  rescue OptionParser::ParseError => e
+    opts.warn e.message
+    opts.show_usage
+  end
+end
+
+secretary = Sprockets::Secretary.new(options)
+secretary.install_assets if options[:asset_root]
+print secretary.concatenation

data/lib/sprockets.rb

@@ -0,0 +1,14 @@
+$:.unshift File.dirname(__FILE__)
+
+require "yaml"
+require "fileutils"
+
+require "sprockets/version"
+require "sprockets/error"
+require "sprockets/environment"
+require "sprockets/pathname"
+require "sprockets/source_line"
+require "sprockets/source_file"
+require "sprockets/concatenation"
+require "sprockets/preprocessor"
+require "sprockets/secretary"

data/lib/sprockets/concatenation.rb

@@ -0,0 +1,36 @@
+module Sprockets
+  class Concatenation
+    attr_reader :source_lines
+    
+    def initialize
+      @source_lines = []
+      @source_file_mtimes = {}
+    end
+    
+    def record(source_line)
+      source_lines << source_line
+      record_mtime_for(source_line.source_file)
+      source_line
+    end
+    
+    def to_s
+      source_lines.join
+    end
+
+    def mtime
+      @source_file_mtimes.values.max
+    end
+    
+    def save_to(filename)
+      timestamp = mtime
+      File.open(filename, "w") { |file| file.write(to_s) }
+      File.utime(timestamp, timestamp, filename)
+      true
+    end
+
+    protected
+      def record_mtime_for(source_file)
+        @source_file_mtimes[source_file] ||= source_file.mtime
+      end
+  end
+end

data/lib/sprockets/environment.rb

@@ -0,0 +1,56 @@
+module Sprockets
+  class Environment
+    attr_reader :root, :load_path
+    
+    def initialize(root, load_path = [])
+      @load_path = [@root = Pathname.new(self, root)]
+
+      load_path.reverse_each do |location|
+        register_load_location(location)
+      end
+    end
+    
+    def pathname_from(location)
+      Pathname.new(self, absolute_location_from(location))
+    end
+
+    def register_load_location(location)
+      pathname = pathname_from(location)
+      load_path.delete(pathname)
+      load_path.unshift(pathname)
+      location
+    end
+    
+    def find(location)
+      if absolute?(location) && File.exists?(location)
+        pathname_from(location)
+      else
+        find_all(location).first
+      end
+    end
+    
+    def constants(reload = false)
+      @constants = nil if reload
+      @constants ||= find_all("constants.yml").inject({}) do |constants, pathname|
+        contents = YAML.load(pathname.contents) rescue nil
+        contents = {} unless contents.is_a?(Hash)
+        constants.merge(contents)
+      end
+    end
+    
+    protected
+      def absolute?(location)
+        location[0, 1] == File::SEPARATOR
+      end
+      
+      def absolute_location_from(location)
+        location = location.to_s
+        location = File.join(root.absolute_location, location) unless absolute?(location)
+        File.expand_path(location)
+      end
+      
+      def find_all(location)
+        load_path.map { |pathname| pathname.find(location) }.compact
+      end
+  end
+end

data/lib/sprockets/error.rb

@@ -0,0 +1,5 @@
+module Sprockets
+  class Error < ::StandardError;        end
+  class LoadError < Error;              end
+  class UndefinedConstantError < Error; end
+end

data/lib/sprockets/pathname.rb

@@ -0,0 +1,37 @@
+module Sprockets
+  class Pathname
+    attr_reader :environment, :absolute_location
+    
+    def initialize(environment, absolute_location)
+      @environment = environment
+      @absolute_location = File.expand_path(absolute_location)
+    end
+
+    # Returns a Pathname for the location relative to this pathname's absolute location.
+    def find(location, kind = :file)
+      location = File.join(absolute_location, location)
+      File.send("#{kind}?", location) ? Pathname.new(environment, location) : nil
+    end
+
+    def parent_pathname
+      Pathname.new(environment, File.dirname(absolute_location))
+    end
+
+    def source_file
+      SourceFile.new(environment, self)
+    end
+    
+    def contents
+      IO.read(absolute_location)
+    end
+    
+    def ==(pathname)
+      environment == pathname.environment &&
+        absolute_location == pathname.absolute_location
+    end
+    
+    def to_s
+      absolute_location
+    end
+  end
+end

data/lib/sprockets/preprocessor.rb

@@ -0,0 +1,109 @@
+module Sprockets
+  class Preprocessor
+    attr_reader :environment, :concatenation, :source_files, :asset_paths
+    
+    def initialize(environment, options = {})
+      @environment = environment
+      @concatenation = Concatenation.new
+      @source_files = []
+      @asset_paths = []
+      @options = options
+    end
+    
+    def require(source_file)
+      return if source_files.include?(source_file)
+      source_files << source_file
+      
+      source_file.each_source_line do |source_line|
+        if source_line.require?
+          require_from_source_line(source_line)
+        elsif source_line.provide?
+          provide_from_source_line(source_line)
+        else
+          record_source_line(source_line)
+        end
+      end
+    end
+    
+    def provide(asset_path)
+      return if !asset_path || asset_paths.include?(asset_path)
+      asset_paths << asset_path
+    end
+    
+    protected
+      attr_reader :options
+    
+      def require_from_source_line(source_line)
+        require pathname_from(source_line).source_file
+      end
+      
+      def provide_from_source_line(source_line)
+        provide asset_path_from(source_line)
+      end
+      
+      def record_source_line(source_line)
+        skip_pdoc_comments(source_line) do
+          unless source_line.comment? && strip_comments?
+            concatenation.record(source_line)
+          end
+        end
+      end
+
+      def skip_pdoc_comments(source_line)
+        yield unless strip_comments?
+
+        @commented ||= false
+
+        if source_line.begins_multiline_comment?
+          @commented = true
+        end
+
+        yield unless @commented
+
+        if source_line.closes_multiline_comment?
+          @commented = false
+        end
+      end
+
+      def strip_comments?
+        options[:strip_comments] != false
+      end
+      
+      def pathname_from(source_line)
+        pathname = send(pathname_finder_from(source_line), source_line)
+        raise_load_error_for(source_line) unless pathname
+        pathname
+      end
+
+      def pathname_for_require_from(source_line)
+        environment.find(location_from(source_line))
+      end
+      
+      def pathname_for_relative_require_from(source_line)
+        source_line.source_file.find(location_from(source_line))
+      end
+
+      def pathname_finder_from(source_line)
+        "pathname_for_#{kind_of_require_from(source_line)}_from"
+      end
+
+      def kind_of_require_from(source_line)
+        source_line.require[/^(.)/, 1] == '"' ? :relative_require : :require
+      end
+
+      def location_from(source_line)
+        location = source_line.require[/^.(.*).$/, 1]
+        File.join(File.dirname(location), File.basename(location, ".js") + ".js")
+      end
+      
+      def asset_path_from(source_line)
+        source_line.source_file.find(source_line.provide, :directory)
+      end
+
+      def raise_load_error_for(source_line)
+        kind = kind_of_require_from(source_line).to_s.tr("_", " ")
+        file = File.split(location_from(source_line)).last
+        raise LoadError, "can't find file for #{kind} `#{file}' (#{source_line.inspect})"
+      end
+  end
+end

data/lib/sprockets/secretary.rb

@@ -0,0 +1,106 @@
+module Sprockets
+  class Secretary
+    DEFAULT_OPTIONS = {
+      :root         => ".",
+      :load_path    => [],
+      :source_files => [],
+      :expand_paths => true
+    }
+
+    attr_reader :environment, :preprocessor
+    
+    def initialize(options = {})
+      reset!(options)
+    end
+
+    def reset!(options = @options)
+      @options = DEFAULT_OPTIONS.merge(options)
+      @environment  = Sprockets::Environment.new(@options[:root])
+      @preprocessor = Sprockets::Preprocessor.new(@environment)
+
+      add_load_locations(@options[:load_path])
+      add_source_files(@options[:source_files])
+    end
+
+    def add_load_location(load_location, options = {})
+      add_load_locations([load_location], options)
+    end
+
+    def add_load_locations(load_locations, options = {})
+      expand_paths(load_locations, options).each do |load_location|
+        environment.register_load_location(load_location)
+      end
+    end
+    
+    def add_source_file(source_file, options = {})
+      add_source_files([source_file], options)
+    end
+    
+    def add_source_files(source_files, options = {})
+      expand_paths(source_files, options).each do |source_file|
+        if pathname = environment.find(source_file)
+          preprocessor.require(pathname.source_file)
+        else
+          raise Sprockets::LoadError, "no such file `#{source_file}'"
+        end
+      end
+    end
+    
+    def concatenation
+      preprocessor.concatenation
+    end
+    
+    def install_assets
+      if @options[:asset_root]
+        preprocessor.asset_paths.each do |asset_path|
+          copy_assets_from(asset_path.absolute_location)
+        end
+      end
+    end
+    
+    def source_last_modified
+      preprocessor.source_files.map { |s| s.mtime }.max
+    end
+    
+    protected
+      def expand_paths(paths, options = {})
+        if options.has_key?(:expand_paths) ? options[:expand_paths] : @options[:expand_paths]
+          paths.map { |path| Dir[from_root(path)].sort }.flatten.compact
+        else
+          paths.map { |path| from_root(path) }
+        end
+      end
+      
+      def from_root(path)
+        if path[0, 1] == File::SEPARATOR
+          path
+        else
+          File.join(@options[:root], path)
+        end
+      end
+      
+      def copy_assets_from(asset_path)
+        relative_file_paths_beneath(asset_path).each do |filename|
+          source, destination = File.join(asset_path, filename), File.join(asset_root, File.dirname(filename))
+          if !File.directory?(source)
+            FileUtils.mkdir_p(destination)
+            FileUtils.cp(source, destination)
+          end
+        end
+      end
+      
+      def relative_file_paths_beneath(path)
+        Dir[File.join(path, "**", "*")].map do |filename|
+          File.join(*path_pieces(filename)[path_pieces(path).length..-1])
+        end
+      end
+      
+      def asset_root
+        from_root(@options[:asset_root])
+      end
+      
+      def path_pieces(path)
+        path.split(File::SEPARATOR)
+      end
+  end
+end

data/lib/sprockets/source_file.rb

@@ -0,0 +1,32 @@
+module Sprockets
+  class SourceFile
+    attr_reader :environment, :pathname
+
+    def initialize(environment, pathname)
+      @environment = environment
+      @pathname = pathname
+    end
+    
+    def each_source_line
+      File.open(pathname.absolute_location) do |file|
+        file.each do |line|
+          yield SourceLine.new(self, line, file.lineno)
+        end
+      end
+    end
+    
+    def find(location, kind = :file)
+      pathname.parent_pathname.find(location, kind)
+    end
+    
+    def ==(source_file)
+      pathname == source_file.pathname
+    end
+    
+    def mtime
+      File.mtime(pathname.absolute_location)
+    rescue Errno::ENOENT
+      0
+    end
+  end
+end

data/lib/sprockets/source_line.rb

@@ -0,0 +1,58 @@
+module Sprockets
+  class SourceLine
+    attr_reader :source_file, :line, :number
+
+    def initialize(source_file, line, number)
+      @source_file = source_file
+      @line = line
+      @number = number
+    end
+    
+    def comment
+      @comment ||= line[/^\s*\/\/(.*)/, 1]
+    end
+
+    def comment?
+      !!comment
+    end
+
+    def begins_multiline_comment?
+      line =~ /^\s*\/\*\*(.*)/
+    end
+
+    def closes_multiline_comment?
+      line =~ /^(.*)*\*\*\/\s*/
+    end
+
+    def require
+      @require ||= (comment || "")[/^=\s+require\s+(\"(.*?)\"|<(.*?)>)\s*$/, 1]
+    end
+    
+    def require?
+      !!require
+    end
+    
+    def provide
+      @provide ||= (comment || "")[/^=\s+provide\s+\"(.*?)\"\s*$/, 1]
+    end
+    
+    def provide?
+      !!provide
+    end
+    
+    def inspect
+      "line #@number of #{@source_file.pathname}"
+    end
+    
+    def to_s(constants = source_file.environment.constants)
+      line.chomp.gsub(/<%=(.*?)%>/) do
+        constant = $1.strip
+        if value = constants[constant]
+          value
+        else
+          raise UndefinedConstantError, "couldn't find constant `#{constant}' in #{inspect}"
+        end
+      end + $/
+    end
+  end
+end

data/lib/sprockets/version.rb

@@ -0,0 +1,9 @@
+module Sprockets
+  module Version
+    MAJOR  = 0
+    MINOR  = 9
+    TINY   = 0
+
+    STRING = [MAJOR, MINOR, TINY].join(".")
+  end
+end

data/test/fixtures/assets/images/script_with_assets/one.png

@@ -0,0 +1 @@
+one

data/test/fixtures/assets/images/script_with_assets/two.png

@@ -0,0 +1 @@
+two

data/test/fixtures/assets/stylesheets/script_with_assets.css

@@ -0,0 +1 @@
+/* nothing */

data/test/fixtures/constants.yml

@@ -0,0 +1 @@
+VERSION: 1.0

data/test/fixtures/double_slash_comments_that_are_not_requires_should_be_ignored_when_strip_comments_is_false.js

@@ -0,0 +1,2 @@
+// This is a double-slash comment that should appear in the resulting output file.
+/* This is a slash-star comment that should appear in the resulting output file. */

data/test/fixtures/double_slash_comments_that_are_not_requires_should_be_removed_by_default.js

@@ -0,0 +1,2 @@
+// This is a double-slash comment that should not appear in the resulting output file.
+/* This is a slash-star comment that should not appear in the resulting output file. */

data/test/fixtures/multiline_comments_should_be_removed_by_default.js

@@ -0,0 +1,4 @@
+/**
+ *  This is a slash-star comment
+ *  that should appear in the resulting output file.
+**/

data/test/fixtures/requiring_a_file_after_it_has_already_been_required_should_do_nothing.js

@@ -0,0 +1,5 @@
+var before_first_require;
+//= require <foo>
+var after_first_require_and_before_second_require;
+//= require <foo>
+var after_second_require;

data/test/fixtures/requiring_a_file_that_does_not_exist_should_raise_an_error.js

@@ -0,0 +1 @@
+//= require <nonexistent>

data/test/fixtures/requiring_a_single_file_should_replace_the_require_comment_with_the_file_contents.js

@@ -0,0 +1,3 @@
+var before_require;
+//= require <foo>
+var after_require;

data/test/fixtures/requiring_the_current_file_should_do_nothing.js

@@ -0,0 +1 @@
+//= require "requiring_the_current_file_should_do_nothing"

data/test/fixtures/src/constants.yml

@@ -0,0 +1,3 @@
+ONE: one
+TWO: two
+HELLO: Hello world!

data/test/fixtures/src/foo.js

@@ -0,0 +1 @@
+var Foo = { };

data/test/fixtures/src/foo/bar.js

@@ -0,0 +1,4 @@
+//= require "bar"
+var FooBar = { };
+
+/* Hello! */

data/test/fixtures/src/foo/foo.js

@@ -0,0 +1 @@
+var FooFoo = { };

data/test/fixtures/src/script_with_assets.js

@@ -0,0 +1,3 @@
+//= provide "../assets"
+
+var ScriptWithAssets = { };

data/test/test_concatenation.rb

@@ -0,0 +1,28 @@
+require "test_helper"
+
+class ConcatenationTest < Test::Unit::TestCase
+  def setup
+    @concatenation = Sprockets::Concatenation.new
+    @environment = environment_for_fixtures
+  end
+  
+  def test_record
+    assert_equal [], @concatenation.source_lines
+    assert_equal "hello\n", @concatenation.record(source_line("hello\n")).to_s
+    assert_equal "world\n", @concatenation.record(source_line("world\n")).to_s
+    assert_equal ["hello\n", "world\n"], @concatenation.source_lines.map { |source_line| source_line.to_s }
+  end
+  
+  def test_to_s
+    @concatenation.record(source_line("hello\n"))
+    @concatenation.record(source_line("world\n"))
+    assert_equal "hello\nworld\n", @concatenation.to_s
+  end
+  
+  def test_save_to
+    filename = File.join(FIXTURES_PATH, "output.js")
+    @concatenation.save_to(filename)
+    assert_equal @concatenation.to_s, IO.read(filename)
+    File.unlink(filename)
+  end
+end

data/test/test_environment.rb

@@ -0,0 +1,64 @@
+require "test_helper"
+
+class EnvironmentTest < Test::Unit::TestCase
+  def test_load_path_locations_become_pathnames_for_absolute_locations_from_the_root
+    environment = Sprockets::Environment.new("/root", ["/a", "b"])
+    assert_load_path_equals ["/a", "/root/b", "/root"], environment
+  end
+  
+  def test_pathname_from_for_location_with_leading_slash_should_return_a_pathname_with_the_location_unchanged
+    environment = Sprockets::Environment.new("/root")
+    assert_absolute_location "/a", environment.pathname_from("/a")
+  end
+  
+  def test_pathname_from_for_relative_location_should_return_a_pathname_for_the_expanded_absolute_location_from_root
+    environment = Sprockets::Environment.new("/root")
+    assert_absolute_location "/root/a", environment.pathname_from("a")
+    assert_absolute_location "/root/a", environment.pathname_from("./a")
+    assert_absolute_location "/a", environment.pathname_from("../a")
+  end
+  
+  def test_register_load_location_should_unshift_the_location_onto_the_load_path
+    environment = Sprockets::Environment.new("/root")
+    environment.register_load_location("a")
+    assert_load_path_equals ["/root/a", "/root"], environment
+    environment.register_load_location("b")
+    assert_load_path_equals ["/root/b", "/root/a", "/root"], environment
+  end
+  
+  def test_register_load_location_should_remove_already_existing_locations_before_unshifting
+    environment = Sprockets::Environment.new("/root")
+    environment.register_load_location("a")
+    environment.register_load_location("b")
+    assert_load_path_equals ["/root/b", "/root/a", "/root"], environment
+    environment.register_load_location("a")
+    assert_load_path_equals ["/root/a", "/root/b", "/root"], environment
+  end
+  
+  def test_find_should_return_the_first_matching_pathname_in_the_load_path
+    environment = environment_for_fixtures
+    first_pathname = environment.find("foo.js")
+    assert_absolute_location_ends_with "src/foo.js", first_pathname
+    
+    environment.register_load_location(File.join(FIXTURES_PATH, "src", "foo"))
+    second_pathname = environment.find("foo.js")
+    assert_not_equal first_pathname, second_pathname
+    assert_absolute_location_ends_with "foo/foo.js", second_pathname
+  end
+  
+  def test_find_should_return_nil_when_no_matching_source_file_is_found
+    environment = environment_for_fixtures
+    assert_nil environment.find("nonexistent.js")
+  end
+  
+  def test_constants_should_return_a_hash_of_all_constants_defined_in_the_load_path
+    constants = environment_for_fixtures.constants
+    assert_kind_of Hash, constants
+    assert_equal %w(HELLO ONE TWO VERSION), constants.keys.sort
+  end
+  
+  protected
+    def assert_load_path_equals(load_path_absolute_locations, environment)
+      assert load_path_absolute_locations.zip(environment.load_path).map { |location, pathname| location == pathname.absolute_location }.all?
+    end
+end

data/test/test_helper.rb

@@ -0,0 +1,55 @@
+require File.join(File.dirname(__FILE__), *%w".. lib sprockets")
+require "test/unit"
+require "fileutils"
+require "tmpdir"
+
+class Test::Unit::TestCase
+  FIXTURES_PATH = File.expand_path(File.join(File.dirname(__FILE__), "fixtures")) unless defined?(FIXTURES_PATH)
+  
+  protected
+    def location_for_fixture(fixture)
+      File.join(FIXTURES_PATH, fixture)
+    end
+    
+    def content_of_fixture(fixture)
+      IO.read(location_for_fixture(fixture))
+    end
+  
+    def environment_for_fixtures
+      Sprockets::Environment.new(FIXTURES_PATH, source_directories_in_fixtures_path)
+    end
+  
+    def source_directories_in_fixtures_path
+      Dir[File.join(FIXTURES_PATH, "**", "src")]
+    end
+
+    def assert_absolute_location(location, pathname)
+      assert_equal location, pathname.absolute_location
+    end
+    
+    def assert_absolute_location_ends_with(location_ending, pathname)
+      assert pathname.absolute_location[/#{Regexp.escape(location_ending)}$/]
+    end
+
+    def pathname(location, environment = @environment)
+      Sprockets::Pathname.new(environment, File.join(FIXTURES_PATH, location))
+    end
+    
+    def source_file(location, environment = @environment)
+      Sprockets::SourceFile.new(environment, pathname(location, environment))
+    end
+
+    def source_line(line, source_file = nil, line_number = 1)
+      Sprockets::SourceLine.new(source_file || source_file("dummy"), line, line_number)
+    end
+    
+    def with_temporary_directory
+      path = File.join(Dir.tmpdir, [caller[0][/`(.*)'/, 1], Time.now.to_f].join("_"))
+      begin
+        FileUtils.mkdir(path)
+        yield path
+      ensure
+        FileUtils.rm_rf(path)
+      end
+    end
+end

data/test/test_pathname.rb

@@ -0,0 +1,43 @@
+require "test_helper"
+
+class PathnameTest < Test::Unit::TestCase
+  def setup
+    @environment = environment_for_fixtures
+  end
+  
+  def test_absolute_location_is_automatically_expanded
+    expanded_location = File.expand_path(File.join(FIXTURES_PATH, "foo"))
+    assert_absolute_location expanded_location, pathname("foo")
+    assert_absolute_location expanded_location, pathname("./foo")
+    assert_absolute_location expanded_location, pathname("./foo/../foo")
+  end
+  
+  def test_find_should_return_a_pathname_for_the_location_relative_to_the_absolute_location_of_the_pathname
+    assert_absolute_location_ends_with "src/foo/bar.js", pathname("src/foo").find("bar.js")
+  end
+  
+  def test_find_should_return_nil_when_the_location_relative_to_the_absolute_location_of_the_pathname_is_not_a_file_or_does_not_exist
+    assert_nil pathname("src/foo").find("nonexistent.js")
+  end
+  
+  def test_parent_pathname_should_return_a_pathname_for_the_parent_directory
+    assert_absolute_location_ends_with "src", pathname("src/foo").parent_pathname
+    assert_absolute_location_ends_with "foo", pathname("src/foo/foo.js").parent_pathname
+  end
+  
+  def test_source_file_should_return_a_source_file_for_the_pathname
+    source_file = pathname("src/foo.js").source_file
+    assert_kind_of Sprockets::SourceFile, source_file
+    assert_equal pathname("src/foo.js"), source_file.pathname
+  end
+
+  def test_equality_of_pathnames
+    assert_equal pathname("src/foo.js"), pathname("src/foo.js")
+    assert_equal pathname("src/foo.js"), pathname("src/foo/../foo.js")
+    assert_not_equal pathname("src/foo.js"), pathname("src/foo/foo.js")
+  end
+  
+  def test_to_s_should_return_absolute_location
+    assert_equal pathname("src/foo.js").to_s, pathname("src/foo.js").absolute_location
+  end
+end

data/test/test_preprocessor.rb

@@ -0,0 +1,101 @@
+require "test_helper"
+
+class PreprocessorTest < Test::Unit::TestCase
+  def setup
+    @environment  = environment_for_fixtures
+    @preprocessor = Sprockets::Preprocessor.new(@environment)
+  end
+
+  def test_double_slash_comments_that_are_not_requires_should_be_removed_by_default
+    require_file_for_this_test
+    assert_concatenation_does_not_contain_line "// This is a double-slash comment that should not appear in the resulting output file."
+    assert_concatenation_contains_line "/* This is a slash-star comment that should not appear in the resulting output file. */"
+  end
+
+  def test_double_slash_comments_that_are_not_requires_should_be_ignored_when_strip_comments_is_false
+    @preprocessor = Sprockets::Preprocessor.new(@environment, :strip_comments => false)
+    require_file_for_this_test
+    assert_concatenation_contains_line "// This is a double-slash comment that should appear in the resulting output file."
+    assert_concatenation_contains_line "/* This is a slash-star comment that should appear in the resulting output file. */"
+  end
+
+  def test_multiline_comments_should_be_removed_by_default
+    require_file_for_this_test
+    assert_concatenation_does_not_contain_line "/**"
+    assert_concatenation_does_not_contain_line " *  This is a slash-star comment"
+    assert_concatenation_does_not_contain_line " *  that should appear in the resulting output file."
+    assert_concatenation_does_not_contain_line "**/"
+  end
+
+  def test_requiring_a_single_file_should_replace_the_require_comment_with_the_file_contents
+    require_file_for_this_test
+    assert_concatenation_contains <<-LINES
+      var before_require;
+      var Foo = { };
+      var after_require;
+    LINES
+  end
+  
+  def test_requiring_a_file_that_does_not_exist_should_raise_an_error
+    assert_raises(Sprockets::LoadError) do
+      require_file_for_this_test
+    end
+  end
+  
+  def test_requiring_the_current_file_should_do_nothing
+    require_file_for_this_test
+    assert_equal "", output_text
+  end
+  
+  def test_requiring_a_file_after_it_has_already_been_required_should_do_nothing
+    require_file_for_this_test
+    assert_concatenation_contains <<-LINES
+      var before_first_require;
+      var Foo = { };
+      var after_first_require_and_before_second_require;
+      var after_second_require;
+    LINES
+  end
+  
+  protected
+    attr_reader :environment, :preprocessor
+    
+    def concatenation
+      preprocessor.concatenation
+    end
+    
+    def output_text
+      preprocessor.concatenation.to_s
+    end
+    
+    def source_lines_matching(line)
+      concatenation.source_lines.select { |source_line| source_line.line.strip == line }
+    end
+    
+    def require_file(location)
+      preprocessor.require(environment.find(location).source_file)
+    end
+    
+    def require_file_for_this_test
+      require_file(file_for_this_test)
+    end
+    
+    def file_for_this_test
+      caller.map { |c| c[/`(.*?)'$/, 1] }.grep(/^test_/).first[5..-1] + ".js"
+    end
+    
+    def assert_concatenation_does_not_contain_line(line)
+      assert source_lines_matching(line).empty?, "Expected #{line.inspect} to not exist"
+    end
+    
+    def assert_concatenation_contains_line(line)
+      assert source_lines_matching(line).any?, "Expected #{line.inspect} to exist"
+    end
+    
+    def assert_concatenation_contains(indented_text)
+      lines = indented_text.split($/)
+      initial_indent  = lines.first[/^\s*/].length
+      unindented_text = lines.map { |line| line[initial_indent..-1] }.join($/)
+      assert output_text[unindented_text]
+    end
+end

data/test/test_secretary.rb

@@ -0,0 +1,83 @@
+require "test_helper"
+
+class SecretaryTest < Test::Unit::TestCase
+  def test_load_locations_are_not_expanded_when_expand_paths_is_false
+    secretary = Sprockets::Secretary.new(:root => FIXTURES_PATH)
+    secretary.add_load_locations("src/**/", :expand_paths => false)
+    
+    assert_equal [File.join(FIXTURES_PATH, "src/**"), FIXTURES_PATH], 
+                 secretary.environment.load_path.map { |pathname| pathname.absolute_location }
+  end
+  
+  def test_load_locations_are_expanded_when_expand_paths_is_true
+    secretary = Sprockets::Secretary.new(:root => FIXTURES_PATH)
+    secretary.add_load_locations("src/**/", :expand_paths => true)
+    
+    assert_equal [File.join(FIXTURES_PATH, "src", "foo"), File.join(FIXTURES_PATH, "src"), FIXTURES_PATH],
+                 secretary.environment.load_path.map { |pathname| pathname.absolute_location }
+  end
+  
+  def test_source_files_are_not_expanded_when_expand_paths_is_false
+    secretary = Sprockets::Secretary.new(:root => FIXTURES_PATH)
+    assert_raises(Sprockets::LoadError) do
+      secretary.add_source_files("src/f*.js", :expand_paths => false)
+    end
+  end
+  
+  def test_source_files_are_expanded_when_expand_paths_is_true
+    secretary = Sprockets::Secretary.new(:root => FIXTURES_PATH)
+    secretary.add_source_files("src/f*.js", :expand_paths => true)
+    
+    assert_equal [File.join(FIXTURES_PATH, "src", "foo.js")],
+                 secretary.preprocessor.source_files.map { |source_file| source_file.pathname.absolute_location }
+  end
+  
+  def test_install_assets_into_empty_directory
+    with_temporary_directory do |temp|
+      secretary = Sprockets::Secretary.new(:root => FIXTURES_PATH, :asset_root => temp)
+      secretary.add_source_files("src/script_with_assets.js")
+
+      assert_equal [], Dir[File.join(temp, "**", "*")]
+      secretary.install_assets
+      assert_equal paths_relative_to(temp, 
+        "images", "images/script_with_assets", "images/script_with_assets/one.png", 
+        "images/script_with_assets/two.png", "stylesheets", "stylesheets/script_with_assets.css"),
+        Dir[File.join(temp, "**", "*")]
+    end
+  end
+  
+  def test_install_assets_into_nonexistent_directory
+    with_temporary_directory do |temp|
+      temp = File.join(temp, "assets")
+      secretary = Sprockets::Secretary.new(:root => FIXTURES_PATH, :asset_root => temp)
+      secretary.add_source_files("src/script_with_assets.js")
+
+      assert_equal [], Dir[File.join(temp, "**", "*")]
+      secretary.install_assets
+      assert_equal paths_relative_to(temp, 
+        "images", "images/script_with_assets", "images/script_with_assets/one.png", 
+        "images/script_with_assets/two.png", "stylesheets", "stylesheets/script_with_assets.css"),
+        Dir[File.join(temp, "**", "*")]
+    end
+  end
+  
+  def test_install_assets_into_subdirectories_that_already_exist
+    with_temporary_directory do |temp|
+      secretary = Sprockets::Secretary.new(:root => FIXTURES_PATH, :asset_root => temp)
+      secretary.add_source_files("src/script_with_assets.js")
+
+      FileUtils.mkdir_p(File.join(temp, "images", "script_with_assets"))
+      assert_equal paths_relative_to(temp, "images", "images/script_with_assets"), Dir[File.join(temp, "**", "*")]
+      secretary.install_assets
+      assert_equal paths_relative_to(temp, 
+        "images", "images/script_with_assets", "images/script_with_assets/one.png", 
+        "images/script_with_assets/two.png", "stylesheets", "stylesheets/script_with_assets.css"),
+        Dir[File.join(temp, "**", "*")]
+    end
+  end
+  
+  protected
+    def paths_relative_to(root, *paths)
+      paths.map { |path| File.join(root, path) }
+    end
+end

data/test/test_source_file.rb

@@ -0,0 +1,29 @@
+require "test_helper"
+require "enumerator"
+
+class SourceFileTest < Test::Unit::TestCase
+  def setup
+    @environment = environment_for_fixtures
+  end
+  
+  def test_each_source_line
+    source_file_lines = Enumerable::Enumerator.new(source_file("src/foo/bar.js"), :each_source_line).to_a
+    assert_equal content_of_fixture("src/foo/bar.js"), source_file_lines.map { |line| line.line }.join
+    assert_equal 4, source_file_lines.length
+  end
+  
+  def test_find_should_return_pathname_for_file_relative_to_the_current_pathname
+    assert_absolute_location_ends_with "test/fixtures/src/foo/bar.js", source_file("src/foo/foo.js").find("bar.js")
+  end
+  
+  def test_find_should_return_nil_for_nonexistent_file
+    assert_nil source_file("src/foo/foo.js").find("nonexistent.js")
+  end
+  
+  def test_equality_of_source_files
+    assert_equal source_file("src/foo/foo.js"), source_file("src/foo/foo.js")
+    assert_equal source_file("src/foo/foo.js"), source_file("src/foo/../foo/foo.js")
+    assert_not_equal source_file("src/foo/foo.js"), source_file("src/foo.js")
+    assert_not_equal source_file("src/foo/foo.js"), source_file("src/foo/bar.js")
+  end
+end

data/test/test_source_line.rb

@@ -0,0 +1,75 @@
+require "test_helper"
+
+class SourceLineTest < Test::Unit::TestCase
+  def test_line_that_begins_with_double_slash_should_be_a_comment
+    assert source_line("//").comment?
+    assert source_line("//test").comment?
+    assert source_line("//= require").comment?
+    assert source_line("//= require <foo>").comment?
+    assert source_line(" //").comment?
+    assert source_line("\t//").comment?
+  end
+
+  def test_line_that_begins_a_multiline_comment
+    assert !source_line(" /*").begins_multiline_comment?
+    assert source_line(" /**").begins_multiline_comment?
+  end
+
+  def test_line_that_closes_a_multiline_comment
+    assert !source_line(" */").closes_multiline_comment?
+    assert source_line(" **/").closes_multiline_comment?
+  end
+
+  def test_line_that_contains_but_does_not_begin_with_double_slash_should_not_be_a_comment
+    assert !source_line("f //").comment?
+    assert !source_line("f //= require <foo>").comment?
+  end
+
+  def test_comment_should_be_extracted_from_comment_lines
+    assert_equal "test", source_line("//test").comment
+    assert_equal " test", source_line("// test").comment
+    assert_equal nil, source_line("f //test").comment
+  end
+  
+  def test_line_that_contains_require_comment_should_be_a_require
+    assert source_line("//= require <foo>").require?
+    assert !source_line("//= require<foo>").require?
+    assert source_line("//= require \"foo\"").require?
+    assert !source_line("//= require <foo> f").require?
+  end
+  
+  def test_require_should_be_extracted_from_require_lines
+    assert_nil source_line("//= require").require
+    assert_equal "<foo>", source_line("//= require <foo>").require
+    assert_equal "<foo>", source_line("//= require   <foo> ").require
+    assert_equal "\"foo\"", source_line("//= require \"foo\"").require
+  end
+
+  def test_line_that_contains_a_provide_comment_should_be_a_provide
+    assert source_line("//= provide \"../assets\"").provide?
+    assert !source_line("//= provide").provide?
+    assert !source_line("//= provide <../assets>").provide?
+  end
+  
+  def test_provide_should_be_extracted_from_provide_lines
+    assert_nil source_line("//= provide").provide
+    assert_equal "../assets", source_line("//= provide \"../assets\"").provide
+  end
+
+  def test_inspect_should_include_source_file_location_and_line_number
+    environment = environment_for_fixtures
+    pathname    = Sprockets::Pathname.new(environment, "/a/b/c.js")
+    source_file = Sprockets::SourceFile.new(environment, pathname)
+    assert_equal "line 25 of /a/b/c.js", source_line("hello", source_file, 25).inspect
+  end
+  
+  def test_interpolation_of_constants
+    assert_equal %(var VERSION = "1.0";\n), source_line('var VERSION = "<%= VERSION %>";').to_s("VERSION" => "1.0")
+  end
+  
+  def test_interpolation_of_missing_constant_raises_undefined_constant_error
+    assert_raises(Sprockets::UndefinedConstantError) do
+      source_line('<%= NONEXISTENT %>').to_s("VERSION" => "1.0")
+    end
+  end
+end

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification 
+name: sprockets
+version: !ruby/object:Gem::Version 
+  version: 0.9.0
+platform: ruby
+authors: 
+- Sam Stephenson
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-02-09 00:00:00 -06:00
+default_executable: 
+dependencies: []
+
+description: Sprockets is a Ruby library that preprocesses and concatenates JavaScript source files.
+email: sstephenson@gmail.com
+executables: 
+- sprocketize
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- Rakefile
+- bin/sprocketize
+- lib/sprockets
+- lib/sprockets/concatenation.rb
+- lib/sprockets/environment.rb
+- lib/sprockets/error.rb
+- lib/sprockets/pathname.rb
+- lib/sprockets/preprocessor.rb
+- lib/sprockets/secretary.rb
+- lib/sprockets/source_file.rb
+- lib/sprockets/source_line.rb
+- lib/sprockets/version.rb
+- lib/sprockets.rb
+- test/fixtures
+- test/fixtures/assets
+- test/fixtures/assets/images
+- test/fixtures/assets/images/script_with_assets
+- test/fixtures/assets/images/script_with_assets/one.png
+- test/fixtures/assets/images/script_with_assets/two.png
+- test/fixtures/assets/stylesheets
+- test/fixtures/assets/stylesheets/script_with_assets.css
+- test/fixtures/constants.yml
+- test/fixtures/double_slash_comments_that_are_not_requires_should_be_ignored_when_strip_comments_is_false.js
+- test/fixtures/double_slash_comments_that_are_not_requires_should_be_removed_by_default.js
+- test/fixtures/multiline_comments_should_be_removed_by_default.js
+- test/fixtures/requiring_a_file_after_it_has_already_been_required_should_do_nothing.js
+- test/fixtures/requiring_a_file_that_does_not_exist_should_raise_an_error.js
+- test/fixtures/requiring_a_single_file_should_replace_the_require_comment_with_the_file_contents.js
+- test/fixtures/requiring_the_current_file_should_do_nothing.js
+- test/fixtures/src
+- test/fixtures/src/constants.yml
+- test/fixtures/src/foo
+- test/fixtures/src/foo/bar.js
+- test/fixtures/src/foo/foo.js
+- test/fixtures/src/foo.js
+- test/fixtures/src/script_with_assets.js
+- test/test_concatenation.rb
+- test/test_environment.rb
+- test/test_helper.rb
+- test/test_pathname.rb
+- test/test_preprocessor.rb
+- test/test_secretary.rb
+- test/test_source_file.rb
+- test/test_source_line.rb
+has_rdoc: false
+homepage: http://github.com/sstephenson/sprockets
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: JavaScript dependency management and concatenation
+test_files: 
+- test/test_concatenation.rb
+- test/test_environment.rb
+- test/test_helper.rb
+- test/test_pathname.rb
+- test/test_preprocessor.rb
+- test/test_secretary.rb
+- test/test_source_file.rb
+- test/test_source_line.rb