rapper 0.0.2 → 0.0.3

data/README.markdown

@@ -63,7 +63,7 @@ The following defaults are applied if not defined in your configuration:
 
 The `definition_root` setting in the rapper config is a path to a folder containing more YAML files that define the various types of bundles you want to build (eg. `stylesheets.yml`, `javascripts.yml`) Example definition file:
 
-    --- !omap 
+    --- 
     - source_root: public/javascripts
     - destination_root: public/assets/javascripts
     - suffix: js
@@ -82,9 +82,9 @@ The above definition will create two asset files: `public/assets/javascripts/bas
 
 ## Versioning
 
-If versioning is turned on in your config, version strings will be used to enforce better browser caching of assets.
+If versioning is turned on in your config, version strings will be used to enforce better browser caching of assets. (Version numbers are always used in definition files.)
 
-    --- !omap 
+    --- 
     - source_root: public/javascripts
     - destination_root: public/assets/javascripts
     - suffix: js
@@ -99,7 +99,9 @@ If versioning is turned on in your config, version strings will be used to enfor
           - ext_js_full
         - version: db62
 
-These version strings are hashes of the final asset file. This means that they will only change when the contents of the asset file change. Version strings are used to enforce good browser caching habits, especially when you have a far-future expires header configured on your web server. For example, suppose you had the following asset:
+Version strings are short hashes of the pre-compression asset file. This means that they will only change when the contents of the component files for an asset change and time-consuming compression will only happen when a bundle needs to be re-packaged.
+
+Version strings are also used to enforce good browser caching habits, especially when you have a far-future expires header configured on your web server. For example, suppose you had the following asset:
 
     <script type="text/javascript" src="/assets/milkshake.js?v=d3va"></script>
 
@@ -123,6 +125,7 @@ Browsers will automatically re-download and cache the new asset.
 
 ## Version history
 
+* **0.0.3** - New `Definition` object to make working with definitions significantly easier, don't re-package assets that don't need re-packaging.
 * **0.0.2** - Compression now works and is specced.
 * **0.0.1** - Initial release. Functioning bundler, minus the view helpers.
 

data/VERSION

@@ -1 +1 @@
-0.0.2
+0.0.3

data/lib/rapper.rb

@@ -33,7 +33,7 @@ module Rapper
     end
     
     # Package assets according to the loaded config and definitions. Defaults
-    # to packaging all asset types.
+    # to packaging all asset types. Skips files that don't need re-packaging.
     # 
     # @param [<String>] types Asset types to refresh versions for.
     def package( *types )
@@ -42,18 +42,17 @@ module Rapper
       
       types.each do |type|
         definition = @definitions[type]
-        source = File.expand_path( definition["source_root"] )
-        destination = definition["destination_root"]
-        suffix = definition["suffix"]
+        source = File.expand_path( definition.source_root )
+        destination = definition.destination_root
+        suffix = definition.suffix
         
-        definition["assets"].each do |asset|
-          name = asset.keys.first
-          spec = asset.values.first.first
+        definition.assets.each do |name, spec|
+          next unless needs_packaging?( type, name )
           
-          source_files = asset_component_paths( type, name )
-          destination_file = asset_path( type, name )
+          source_files = definition.asset_component_paths( name )
+          destination_file = definition.asset_path( name )
           
-          log :verbose, "Joining #{definition["assets"].count} files to #{name}"
+          log :verbose, "Joining #{source_files.size} files to #{name}"
           join_files( source_files, destination_file )
           
           if get_config( "compress" )

data/lib/rapper/config.rb

@@ -24,10 +24,10 @@ module Rapper
         raise Rapper::Errors::NoDefinitionRoot,
           "No 'definition_root' has been defined for #{@environment}"
       end
-      definition_path = File.join( env_config["definition_root"], "*.yml" )
-      Dir[definition_path].each do |definition|
+      definition_paths = File.join( env_config["definition_root"], "*.yml" )
+      Dir[definition_paths].each do |definition|
         type = File.basename( definition, ".yml" )
-        @definitions[type] = YAML.load_file( definition )
+        @definitions[type] = Definition.new( definition )
       end
     end
     
@@ -59,10 +59,7 @@ module Rapper
       log :info, "Updating definitions for #{types.join( ', ' )}"
       
       types.each do |type|
-        log "Updating definition file for", type
-        File.open( definition_path( type ), "w" ) do |file|
-          file.puts @definitions[type].to_yaml
-        end
+        @definitions[type].update
       end
     end
     

data/lib/rapper/definition.rb

@@ -0,0 +1,114 @@
+module Rapper
+  # Basic definition abstraction to make working with the wacky YAML structure
+  # easier.
+  class Definition
+    
+    def initialize( path )
+      @path = path
+      @type = File.basename( path, ".yml" )
+      @definition = YAML.load_file( @path )
+    end
+    
+    # =======================
+    # = Definition settings =
+    # =======================
+    
+    def source_root
+      first_key_value( "source_root", @definition ) || ""
+    end
+    
+    def destination_root
+      first_key_value( "destination_root", @definition ) || ""
+    end
+    
+    def suffix
+      first_key_value( "suffix", @definition )
+    end
+    
+    # ==========
+    # = Assets =
+    # ==========
+    
+    # @return [Hash] Simplified structure representing all asset definitions.
+    def assets
+      assets = {}
+      
+      first_key_value( "assets", @definition ).each do |spec|
+        assets[spec.keys.first] = spec.values.first.inject({}) do |memo, item|
+          memo.merge( item )
+        end
+      end
+      
+      assets
+    end
+    
+    # Update the version string for a specific asset.
+    # 
+    # @param [String] name Asset name.
+    # 
+    # @param [String] version New version string for the asset.
+    def set_version( name, version )
+      first_key_value( "assets", @definition ).each do |spec|
+        next unless spec[name]
+        spec[name].each do |setting|
+          next unless setting["version"]
+          setting["version"] = version
+        end
+      end
+    end
+    
+    # ==========
+    # = Saving =
+    # ==========
+    
+    # Writes the in-memory definition out to disk.
+    def update
+      File.open( @path, "w" ) do |file|
+        file.puts @definition.to_yaml
+      end
+    end
+    
+    # =========
+    # = Paths =
+    # =========
+    
+    # @param [String] name The asset's name.
+    # 
+    # @return [String] Path to the packaged asset file.
+    def asset_path( name )
+      file_name = "#{name}.#{self.suffix}"
+      File.join( self.destination_root, file_name )
+    end
+    
+    # @param [String] name Name of the asset.
+    # 
+    # @return [Array<String>] Ordered list of the files that comprise the given
+    #   asset.
+    def asset_component_paths( name )
+      spec = self.assets[name]
+      
+      if spec.nil?
+        raise Rapper::Errors::InvalidAssetName,
+          "'#{name}' is not a valid #{@type} asset. Make sure it is defined in the definition file."
+      end
+      
+      ( spec["files"] || [] ).map do |file|
+        file_name = "#{file}.#{self.suffix}"
+        File.join( self.source_root, file_name )
+      end
+    end
+    
+    private
+    
+    # @param [Object] key Key to search for.
+    # 
+    # @param [Array<Hash>] array Array of Hash object to search in.
+    # 
+    # @return [Object,nil] The first value found for the key or nil of nothing
+    #   was found.
+    def first_key_value( key, array )
+      hash = array.find { |h| h.keys.include? key }
+      hash ? hash[key] : nil
+    end
+  end
+end

data/lib/rapper/errors.rb

@@ -10,11 +10,6 @@ module Rapper
     # environment.
     class NoDefinitionRoot < StandardError; end
     
-    # Raised when an invalid definition type param is used. An invalid
-    # definition type is one that doesn't have a definition YAML file in the
-    # "definition_root" folder (set in the config).
-    class InvalidDefinitionType < StandardError; end
-    
     # Raised when an invalid asset name param is used. An invalid asset name
     # is one not defined in a given definition file.
     class InvalidAssetName < StandardError; end

data/lib/rapper/utils.rb

@@ -4,67 +4,11 @@ module Rapper
     
     protected
     
-    # =========
-    # = Paths =
-    # =========
-    
-    # @param [String] type Asset type.
-    # 
-    # @return [String] Path to the definition file for the given asset type.
-    def definition_path( type )
-      File.join( get_config( "definition_root" ), "#{type}.yml")
-    end
-    
-    # @param [String] type Asset type.
-    # 
-    # @param [String] name Name of the asset.
-    # 
-    # @return [String] Path to the packaged asset file for the given type and
-    #   name.
-    def asset_path( type, name )
-      if @definitions[type].nil?
-        raise Rapper::Errors::InvalidDefinitionType,
-          "'#{type}' is not a defined asset type."
-      end
-      
-      file_name = "#{name}.#{@definitions[type]["suffix"]}"
-      
-      File.join( @definitions[type]["destination_root"], file_name )
-    end
-    
-    # @param [String] type Asset type.
-    # 
-    # @param [String] name Name of the asset.
-    # 
-    # @return [Array<String>] Ordered list of asset component file paths.
-    def asset_component_paths( type, name )
-      if @definitions[type].nil?
-        raise Rapper::Errors::InvalidDefinitionType,
-          "'#{type}' is not a defined asset type."
-      end
-      
-      spec = first_hash_with_key( name, @definitions[type]["assets"] )
-      
-      if spec.nil?
-        raise Rapper::Errors::InvalidAssetName,
-          "'#{name}' is not a valid #{type} asset. Make sure it is defined in the definition file."
-      end
-      
-      source_root = @definitions[type]["source_root"]
-      suffix = @definitions[type]["suffix"]
-      files = first_hash_with_key( "files", spec.values.first )["files"] || []
-      
-      files.map do |file|
-        file_name = "#{file}.#{suffix}"
-        File.join( source_root, file_name )
-      end
-    end
-    
     # =========
     # = Files =
     # =========
     
-    # Contatenate one or more files. Uses <code>cat</code>.
+    # Concatenate one or more files. Uses <code>cat</code>.
     # 
     # @param [Array<String>,String] source_files A  path or array of paths to
     #   files to concatenate.
@@ -75,18 +19,5 @@ module Rapper
       system "cat #{source_files} > #{destination_file}"
     end
     
-    # =========
-    # = Misc. =
-    # =========
-    
-    # @param [Object] key Key to search for.
-    # 
-    # @param [Array<Hash>] array Array of Hash object to search in.
-    # 
-    # @return [Hash] First hash with the given key.
-    def first_hash_with_key( key, array )
-      array.find { |h| h.keys.include? key }
-    end
-    
   end
 end

data/lib/rapper/versioning.rb

@@ -1,4 +1,5 @@
 require 'digest/md5'
+require 'tempfile'
 
 module Rapper
   # Asset versioning methods.
@@ -6,6 +7,20 @@ module Rapper
     
     protected
     
+    # @param [String] type The asset type.
+    # 
+    # @param [String] name The name of the asset.
+    # 
+    # @return [Boolean] True if the asset needs re-packaging, false otherwise.
+    def needs_packaging?( type, name )
+      definition = @definitions[type]
+      destination_file = definition.asset_path( name )
+      return true unless File.exists?( destination_file )
+      current_version = definition.assets[name]["version"]
+      new_version = version( type, name )
+      new_version != current_version
+    end
+    
     # Refresh the version hashes for the given asset types. If no arguments are
     # passed, version hashes for all asset types will be updated.
     # 
@@ -16,21 +31,25 @@ module Rapper
       log :info, "Refreshing versions for #{types.join( ', ' )}"
       
       types.each do |type|
-        @definitions[type]["assets"].each do |asset|
-          name = asset.keys.first
-          spec = asset.values.first
-          path = asset_path( type, name )
-          version = version( path )
-          first_hash_with_key( "version", spec )["version"] = version
+        @definitions[type].assets.each do |name, spec|
+          version = version( type, name )
+          @definitions[type].set_version( name, version )
         end
       end
     end
     
-    # @param [String] file_path The path to a file to generate a version for.
+    # @param [String] type The asset type.
+    # 
+    # @param [String] name The name of the asset.
     # 
-    # @return [String] A four-character MD5 hash of the contents of the file.
-    def version( file_path )
-      Digest::MD5.file( file_path ).to_s[0,4]
+    # @return [String] A four-character version hash for the given asset.
+    def version( type, name )
+      source_files = @definitions[type].asset_component_paths( name )
+      destination_file = Tempfile.new( 'rapper' )
+      join_files( source_files, destination_file.path )
+      version = Digest::MD5.file( destination_file.path ).to_s[0,4]
+      destination_file.unlink
+      version
     end
     
   end

data/rapper.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{rapper}
-  s.version = "0.0.2"
+  s.version = "0.0.3"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Tyson Tate"]
-  s.date = %q{2011-02-05}
+  s.date = %q{2011-02-19}
   s.description = %q{Static asset packager and compressor with versioning and built-in view helpers. Easy to configure, easy to use, and easy to ignore when you want to. No crazy JavaScript comment DSLs, either.}
   s.email = %q{tyson@tysontate.com}
   s.extra_rdoc_files = [
@@ -28,6 +28,7 @@ Gem::Specification.new do |s|
     "lib/rapper.rb",
     "lib/rapper/compressors.rb",
     "lib/rapper/config.rb",
+    "lib/rapper/definition.rb",
     "lib/rapper/errors.rb",
     "lib/rapper/logging.rb",
     "lib/rapper/utils.rb",
@@ -37,7 +38,6 @@ Gem::Specification.new do |s|
     "spec/fixtures/config/assets.yml",
     "spec/fixtures/config/assets/base/javascripts.yml",
     "spec/fixtures/config/assets/base/stylesheets.yml",
-    "spec/fixtures/config/assets/base/validators.yml",
     "spec/fixtures/javascripts/simple_1.js",
     "spec/fixtures/javascripts/simple_2.js",
     "spec/fixtures/stylesheets/simple_1.css",
@@ -117,7 +117,7 @@ Gem::Specification.new do |s|
   s.homepage = %q{http://tysontate.github.com/rapper/}
   s.licenses = ["MIT"]
   s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.3.7}
+  s.rubygems_version = %q{1.4.2}
   s.summary = %q{Static asset packager and compressor with versioning and built-in view helpers.}
   s.test_files = [
     "spec/rapper_spec.rb",
@@ -126,7 +126,6 @@ Gem::Specification.new do |s|
   ]
 
   if s.respond_to? :specification_version then
-    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
     s.specification_version = 3
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then

data/spec/fixtures/config/assets/base/javascripts.yml

@@ -1,12 +1,14 @@
---- !omap 
+--- 
 - source_root: spec/fixtures/javascripts
-- destination_root: spec/fixtures/javascripts
+- destination_root: tmp
 - suffix: js
-- assets:
+- assets: 
   - single_file: 
     - files: 
-      - mootools
+      - simple_1
+    - version: 0
   - multiple_files: 
     - files: 
-      - mootools
-      - jquery
+      - simple_1
+      - simple_2
+    - version: 0

data/spec/fixtures/config/assets/base/stylesheets.yml

@@ -1,10 +1,14 @@
---- !omap 
+--- 
 - source_root: spec/fixtures/stylesheets
-- destination_root: spec/fixtures/stylesheets
+- destination_root: tmp
 - suffix: css
-- assets:
-  - master: 
+- assets: 
+  - single_file: 
     - files: 
-      - reset
-      - base
-      - layout
+      - simple_1
+    - version: 0
+  - multiple_files: 
+    - files: 
+      - simple_1
+      - simple_2
+    - version: 0

data/spec/fixtures/test_cases/compression/definitions/css.yml

@@ -1,4 +1,4 @@
---- !omap 
+--- 
 - source_root: spec/fixtures/stylesheets
 - destination_root: tmp
 - suffix: css

data/spec/fixtures/test_cases/compression/definitions/js.yml

@@ -1,4 +1,4 @@
---- !omap 
+--- 
 - source_root: spec/fixtures/javascripts
 - destination_root: tmp
 - suffix: js

data/spec/fixtures/test_cases/concatenation/definitions/css.yml

@@ -1,4 +1,4 @@
---- !omap 
+--- 
 - source_root: spec/fixtures/stylesheets
 - destination_root: tmp
 - suffix: css

data/spec/fixtures/test_cases/concatenation/definitions/js.yml

@@ -1,4 +1,4 @@
---- !omap 
+--- 
 - source_root: spec/fixtures/javascripts
 - destination_root: tmp
 - suffix: js

data/spec/rapper_spec.rb

@@ -48,12 +48,22 @@ describe Rapper do
     
     it "loads asset definitions" do
       rapper = Rapper::Engine.new( "spec/fixtures/config/assets.yml", "test" )
-      rapper.send( :asset_types ).sort.should == ["javascripts", "stylesheets", "validators"]
-      rapper.definitions["stylesheets"]["source_root"].should == "spec/fixtures/stylesheets"
-      rapper.definitions["stylesheets"]["suffix"].should == "css"
-      # Using a YAML::OMap here, so it looks a bit weird
-      rapper.definitions["stylesheets"]["assets"].first.key?( "master" ).should be_true
-      rapper.definitions["stylesheets"]["assets"].first["master"].first["files"].should == ["reset", "base", "layout"]
+      rapper.send( :asset_types ).sort.should == ["javascripts", "stylesheets"]
+      rapper.definitions["javascripts"].should be_a( Rapper::Definition )
+      rapper.definitions["stylesheets"].should be_a( Rapper::Definition )
+      rapper.definitions["javascripts"].source_root.should == "spec/fixtures/javascripts"
+      rapper.definitions["javascripts"].destination_root.should == "tmp"
+      rapper.definitions["javascripts"].suffix.should == "js"
+      rapper.definitions["javascripts"].assets.should == {
+        "single_file"=>{
+          "files"=>["simple_1"],
+          "version"=>0
+        },
+        "multiple_files"=>{
+          "files"=>["simple_1", "simple_2"],
+          "version"=>0
+        }
+      }
     end
   end
   
@@ -92,6 +102,30 @@ describe Rapper do
     end
   end
   
+  describe "versioning" do
+    it "uses the concatenated file to calculate versions" do
+      rapper = Rapper::Engine.new( "spec/fixtures/config/assets.yml", "test" )
+      rapper.send( :refresh_versions )
+      rapper.definitions["javascripts"].assets["single_file"].should == {
+        "files"=>["simple_1"],
+        "version"=>"98bc"
+      }
+      rapper.definitions["javascripts"].assets["multiple_files"].should == {
+        "files"=>["simple_1", "simple_2"],
+        "version"=>"f3d9"
+      }
+    end
+    
+    it "doesn't re-package assets that don't need re-packaging" do
+      rapper = Rapper::Engine.new( "spec/fixtures/config/assets.yml", "test" )
+      rapper.stub!( :update_definitions ).and_return( nil ) # Block definition updating
+      rapper.package
+      
+      rapper.should_not_receive( :compress )
+      rapper.package
+    end
+  end
+  
   describe "packaging test cases" do
     Dir["spec/fixtures/test_cases/*"].each do |folder|
       next unless File.directory?( folder )

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: rapper
 version: !ruby/object:Gem::Version 
-  hash: 27
-  prerelease: false
+  hash: 25
+  prerelease: 
   segments: 
   - 0
   - 0
-  - 2
-  version: 0.0.2
+  - 3
+  version: 0.0.3
 platform: ruby
 authors: 
 - Tyson Tate
@@ -15,13 +15,13 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-02-05 00:00:00 -08:00
+date: 2011-02-19 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  type: :runtime
   prerelease: false
   name: closure-compiler
+  type: :runtime
   version_requirements: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -35,9 +35,9 @@ dependencies:
         version: 1.0.0
   requirement: *id001
 - !ruby/object:Gem::Dependency 
-  type: :development
   prerelease: false
   name: rspec
+  type: :development
   version_requirements: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -51,9 +51,9 @@ dependencies:
         version: 1.3.1
   requirement: *id002
 - !ruby/object:Gem::Dependency 
-  type: :development
   prerelease: false
   name: yard
+  type: :development
   version_requirements: &id003 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -67,9 +67,9 @@ dependencies:
         version: 0.6.4
   requirement: *id003
 - !ruby/object:Gem::Dependency 
-  type: :development
   prerelease: false
   name: bluecloth
+  type: :development
   version_requirements: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -83,9 +83,9 @@ dependencies:
         version: 2.0.10
   requirement: *id004
 - !ruby/object:Gem::Dependency 
-  type: :development
   prerelease: false
   name: bundler
+  type: :development
   version_requirements: &id005 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -99,9 +99,9 @@ dependencies:
         version: 1.0.0
   requirement: *id005
 - !ruby/object:Gem::Dependency 
-  type: :development
   prerelease: false
   name: jeweler
+  type: :development
   version_requirements: &id006 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -115,9 +115,9 @@ dependencies:
         version: 1.5.2
   requirement: *id006
 - !ruby/object:Gem::Dependency 
-  type: :runtime
   prerelease: false
   name: closure-compiler
+  type: :runtime
   version_requirements: &id007 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -131,9 +131,9 @@ dependencies:
         version: 1.0.0
   requirement: *id007
 - !ruby/object:Gem::Dependency 
-  type: :development
   prerelease: false
   name: rspec
+  type: :development
   version_requirements: &id008 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -147,9 +147,9 @@ dependencies:
         version: 1.3.1
   requirement: *id008
 - !ruby/object:Gem::Dependency 
-  type: :development
   prerelease: false
   name: yard
+  type: :development
   version_requirements: &id009 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -163,9 +163,9 @@ dependencies:
         version: 0.6.4
   requirement: *id009
 - !ruby/object:Gem::Dependency 
-  type: :development
   prerelease: false
   name: bluecloth
+  type: :development
   version_requirements: &id010 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -179,9 +179,9 @@ dependencies:
         version: 2.0.10
   requirement: *id010
 - !ruby/object:Gem::Dependency 
-  type: :development
   prerelease: false
   name: bundler
+  type: :development
   version_requirements: &id011 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -195,9 +195,9 @@ dependencies:
         version: 1.0.0
   requirement: *id011
 - !ruby/object:Gem::Dependency 
-  type: :development
   prerelease: false
   name: jeweler
+  type: :development
   version_requirements: &id012 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -231,6 +231,7 @@ files:
 - lib/rapper.rb
 - lib/rapper/compressors.rb
 - lib/rapper/config.rb
+- lib/rapper/definition.rb
 - lib/rapper/errors.rb
 - lib/rapper/logging.rb
 - lib/rapper/utils.rb
@@ -240,7 +241,6 @@ files:
 - spec/fixtures/config/assets.yml
 - spec/fixtures/config/assets/base/javascripts.yml
 - spec/fixtures/config/assets/base/stylesheets.yml
-- spec/fixtures/config/assets/base/validators.yml
 - spec/fixtures/javascripts/simple_1.js
 - spec/fixtures/javascripts/simple_2.js
 - spec/fixtures/stylesheets/simple_1.css
@@ -346,7 +346,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.7
+rubygems_version: 1.4.2
 signing_key: 
 specification_version: 3
 summary: Static asset packager and compressor with versioning and built-in view helpers.

data/spec/fixtures/config/assets/base/validators.yml

@@ -1,9 +0,0 @@
---- !omap 
-- source_root: spec/fixtures/validators
-- destination_root: spec/fixtures/validators
-- suffix: js
-- assets:
-  - master: 
-    - files: 
-      - spec/fixtures/javascripts/foo
-      - spec/fixtures/javascripts/bar