Hello, <%= name %>!
// application.js
//= require templates/hello
$("#hello").html(JST["templates/hello"]({ name: "Sam" }));
```
Sprockets supports two JavaScript template languages:
[EJS](https://github.com/sstephenson/ruby-ejs), for embedded
JavaScript, and [Eco](https://github.com/sstephenson/ruby-eco), for
embedded CoffeeScript. Both languages use the familiar `<% … %>`
syntax for embedding logic in templates.
If the `ejs` gem is available to your application, you can use EJS
templates in Sprockets. EJS templates have the extension `.jst.ejs`.
If the `eco` gem is available to your application, you can use [Eco
templates](https://github.com/sstephenson/eco) in Sprockets. Eco
templates have the extension `.jst.eco`. Note that the `eco` gem
depends on the CoffeeScript compiler, so the same caveats apply as
outlined above for the CoffeeScript engine.
### Invoking Ruby with ERB
Sprockets provides an ERB engine for preprocessing assets using
embedded Ruby code. Append `.erb` to a CSS or JavaScript asset's
filename to enable the ERB engine.
Ruby code embedded in an asset is evaluated in the context of a
`Sprockets::Context` instance for the given asset. Common uses for ERB
include:
- embedding another asset as a Base64-encoded `data:` URI with the
`asset_data_uri` helper
- inserting the URL to another asset, such as with the `asset_path`
helper provided by the Sprockets Rails plugin
- embedding other application resources, such as a localized string
database, in a JavaScript asset via JSON
- embedding version constants loaded from another file
See the [Helper Methods](lib/sprockets/context.rb) section for more information about
interacting with `Sprockets::Context` instances via ERB.
## Managing and Bundling Dependencies
You can create *asset bundles* -- ordered concatenations of asset
source files -- by specifying dependencies in a special comment syntax
at the top of each source file.
Sprockets reads these comments, called *directives*, and processes
them to recursively build a dependency graph. When you request an
asset with dependencies, the dependencies will be included in order at
the top of the file.
### The Directive Processor
Sprockets runs the *directive processor* on each CSS and JavaScript
source file. The directive processor scans for comment lines beginning
with `=` in comment blocks at the top of the file.
``` js
//= require jquery
//= require jquery-ui
//= require backbone
//= require_tree .
```
The first word immediately following `=` specifies the directive
name. Any words following the directive name are treated as
arguments. Arguments may be placed in single or double quotes if they
contain spaces, similar to commands in the Unix shell.
**Note**: Non-directive comment lines will be preserved in the final
asset, but directive comments are stripped after
processing. Sprockets will not look for directives in comment blocks
that occur after the first line of code.
#### Supported Comment Types
The directive processor understands comment blocks in three formats:
``` css
/* Multi-line comment blocks (CSS, SCSS, JavaScript)
*= require foo
*/
```
``` js
// Single-line comment blocks (SCSS, JavaScript)
//= require foo
```
``` coffee
# Single-line comment blocks (CoffeeScript)
#= require foo
```
### Sprockets Directives
You can use the following directives to declare dependencies in asset
source files.
For directives that take a *path* argument, you may specify either a
logical path or a relative path. Relative paths begin with `./` and
reference files relative to the location of the current file.
#### The `require` Directive
`require` *path* inserts the contents of the asset source file
specified by *path*. If the file is required multiple times, it will
appear in the bundle only once.
### The `require_directory` Directive ###
`require_directory` *path* requires all source files of the same
format in the directory specified by *path*. Files are required in
alphabetical order.
#### The `require_tree` Directive
`require_tree` *path* works like `require_directory`, but operates
recursively to require all files in all subdirectories of the
directory specified by *path*.
#### The `require_self` Directive
`require_self` tells Sprockets to insert the body of the current
source file before any subsequent `require` directives.
#### The `link` Directive
`link` *path* declares a dependency on the target *path* and adds it to a list
of subdependencies to automatically be compiled when the asset is written out to
disk.
For an example, in a CSS file you might reference an external image that always
needs to be compiled along with the css file.
``` css
/*= link "logo.png" */
.logo {
background-image: url(logo.png)
}
```
However, if you use a `asset-path` or `asset-url` SCSS helper, these links will
automatically be defined for you.
``` css
.logo {
background-image: asset-url("logo.png")
}
```
#### The `depend_on` Directive
`depend_on` *path* declares a dependency on the given *path* without
including it in the bundle. This is useful when you need to expire an
asset's cache in response to a change in another file.
#### The `depend_on_asset` Directive
`depend_on_asset` *path* works like `depend_on`, but operates
recursively reading the file and following the directives found. This is automatically implied if you use `link`, so consider if it just makes sense using `link` instead of `depend_on_asset`.
#### The `stub` Directive
`stub` *path* allows dependency to be excluded from the asset bundle.
The *path* must be a valid asset and may or may not already be part
of the bundle. `stub` should only be used at the top level bundle, not
within any subdependencies.
## Processor Interface
Sprockets 2.x was originally design around [Tilt](https://github.com/rtomayko/tilt)'s engine interface. However, starting with 3.x, a new interface has been introduced deprecating Tilt.
Similar to Rack, a processor is a any "callable" (an object that responds to `call`). This maybe a simple Proc or a full class that defines a `def self.call(input)` method. The `call` method accepts an `input` Hash and returns a Hash of metadata.
Also see [`Sprockets::ProcessorUtils`](https://github.com/rails/sprockets/blob/master/lib/sprockets/processor_utils.rb) for public helper methods.
### input Hash
The `input` Hash defines the following public fields.
* `:data` - String asset contents
* `:environment` - Current `Sprockets::Environment` instance.
* `:cache` - A `Sprockets::Cache` instance. See [`Sprockets::Cache#fetch`](https://github.com/rails/sprockets/blob/master/lib/sprockets/cache.rb).
* `:uri` - String Asset URI.
* `:filename` - String full path to original file.
* `:load_path` - String current load path for filename.
* `:name` - String logical path for filename.
* `:content_type` - String content type of the output asset.
* `:metadata` - Hash of processor metadata.
``` ruby
def self.call(input)
input[:cache].fetch("my:cache:key:v1") do
# Remove all semicolons from source
input[:data].gsub(";", "")
end
end
```
### return Hash
The processor should return metadata `Hash`. With the exception of the `:data` key, the processor can store arbitrary JSON valid values in this Hash. The data will be stored and exposed on `Asset#metadata`.
The returned `:data` replaces the assets `input[:data]` to the next processor in the chain. Returning a `String` is shorthand for returning `{ data: str }`. And returning `nil` is shorthand for a no-op where the input data is not transformed, `{ data: input[:data] }`.
### metadata
The metadata Hash provides an open format for processors to extend the pipeline processor. Internally, built-in processors use it for passing data to each other.
* `:required` - A `Set` of String Asset URIs that the Bundle processor should concatenate together.
* `:stubbed` - A `Set` of String Asset URIs that will be omitted from the `:required` set.
* `:links` - A `Set` of String Asset URIs that should be compiled along with this asset.
* `:dependencies` - A `Set` of String Cache URIs that should be monitored for caching.
``` ruby
def self.call(input)
# Any metadata may start off as nil, so initialize it the value
required = Set.new(input[:metadata][:required])
# Manually add "foo.js" asset uri to our bundle
required << input[:environment].resolve("foo.js")
{ required: required }
end
```
## Development
### Contributing
The Sprockets source code is [hosted on
GitHub](https://github.com/rails/sprockets). You can check out a
copy of the latest code using Git:
$ git clone https://github.com/rails/sprockets
If you've found a bug or have a question, please open an issue on the
[Sprockets issue
tracker](https://github.com/rails/sprockets/issues). Or, clone
the Sprockets repository, write a failing test case, fix the bug and
submit a pull request.
### Version History
Please see the [CHANGELOG](https://github.com/rails/sprockets/tree/master/CHANGELOG.md)
## License
Copyright © 2014 Sam Stephenson <Hello, World!
sprockets-3.7.2/test/fixtures/default/interpolation.js 0000664 0000000 0000000 00000000042 13312220220 0023220 0 ustar 00root root 0000000 0000000 var Interpolation = <%= 1 + 1 %>; sprockets-3.7.2/test/fixtures/default/jquery.tmpl.min.js 0000664 0000000 0000000 00000000014 13312220220 0023404 0 ustar 00root root 0000000 0000000 var jQuery; sprockets-3.7.2/test/fixtures/default/logo.svg 0000664 0000000 0000000 00000000164 13312220220 0021461 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/default/manifest.js.yml 0000664 0000000 0000000 00000000037 13312220220 0022743 0 ustar 00root root 0000000 0000000 require: - foo.js - bar.js sprockets-3.7.2/test/fixtures/default/menu/ 0000775 0000000 0000000 00000000000 13312220220 0020743 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/default/menu/menu.css 0000664 0000000 0000000 00000000011 13312220220 0022411 0 ustar 00root root 0000000 0000000 .menu {} sprockets-3.7.2/test/fixtures/default/menu/menu.html 0000664 0000000 0000000 00000000016 13312220220 0022572 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/default/menu/menu.js 0000664 0000000 0000000 00000000020 13312220220 0022235 0 ustar 00root root 0000000 0000000 $.fn.menu = {}; sprockets-3.7.2/test/fixtures/default/missing_absolute_depend_on.js 0000664 0000000 0000000 00000000046 13312220220 0025717 0 ustar 00root root 0000000 0000000 //= depend_on /tmp/sprockets/notfound sprockets-3.7.2/test/fixtures/default/missing_depend_on.js 0000664 0000000 0000000 00000000027 13312220220 0024020 0 ustar 00root root 0000000 0000000 //= depend_on notfound sprockets-3.7.2/test/fixtures/default/missing_require.js 0000664 0000000 0000000 00000000027 13312220220 0023541 0 ustar 00root root 0000000 0000000 // =require "notfound" sprockets-3.7.2/test/fixtures/default/mobile-min/ 0000775 0000000 0000000 00000000000 13312220220 0022027 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/default/mobile-min/index.min.js 0000664 0000000 0000000 00000000007 13312220220 0024253 0 ustar 00root root 0000000 0000000 var $; sprockets-3.7.2/test/fixtures/default/mobile/ 0000775 0000000 0000000 00000000000 13312220220 0021246 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/default/mobile/a.js 0000664 0000000 0000000 00000000007 13312220220 0022021 0 ustar 00root root 0000000 0000000 var A; sprockets-3.7.2/test/fixtures/default/mobile/b.js 0000664 0000000 0000000 00000000007 13312220220 0022022 0 ustar 00root root 0000000 0000000 var B; sprockets-3.7.2/test/fixtures/default/mobile/c.css 0000664 0000000 0000000 00000000006 13312220220 0022176 0 ustar 00root root 0000000 0000000 .c {} sprockets-3.7.2/test/fixtures/default/mobile/d.css 0000664 0000000 0000000 00000000006 13312220220 0022177 0 ustar 00root root 0000000 0000000 .d {} sprockets-3.7.2/test/fixtures/default/mobile/index.css 0000664 0000000 0000000 00000000032 13312220220 0023062 0 ustar 00root root 0000000 0000000 /* *= require_tree . */ sprockets-3.7.2/test/fixtures/default/mobile/index.js 0000664 0000000 0000000 00000000023 13312220220 0022706 0 ustar 00root root 0000000 0000000 //= require_tree . sprockets-3.7.2/test/fixtures/default/ng-view.ngt 0000664 0000000 0000000 00000000024 13312220220 0022061 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/default/nokogiri-html.html.builder 0000664 0000000 0000000 00000000136 13312220220 0025075 0 ustar 00root root 0000000 0000000 doc.html do doc.body do doc.span.bold do doc.text "Hello world" end end end sprockets-3.7.2/test/fixtures/default/nokogiri-xml.xml.builder 0000664 0000000 0000000 00000000165 13312220220 0024567 0 ustar 00root root 0000000 0000000 xml.root do xml.products do xml.widget do xml.id_ "10" xml.name "Awesome widget" end end end sprockets-3.7.2/test/fixtures/default/noreturn.js 0000664 0000000 0000000 00000000010 13312220220 0022200 0 ustar 00root root 0000000 0000000 var Foo; sprockets-3.7.2/test/fixtures/default/project.js.coffee.erb 0000664 0000000 0000000 00000000067 13312220220 0024003 0 ustar 00root root 0000000 0000000 window.Project = class Project VERSION: <%= "1.0" %> sprockets-3.7.2/test/fixtures/default/qunit/ 0000775 0000000 0000000 00000000000 13312220220 0021137 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/default/qunit/bower.json 0000664 0000000 0000000 00000000125 13312220220 0023146 0 ustar 00root root 0000000 0000000 { "name": "qunit", "version": "1.0.0", "main": ["./qunit.js", "./qunit.css"] } sprockets-3.7.2/test/fixtures/default/qunit/qunit.css 0000664 0000000 0000000 00000000012 13312220220 0023002 0 ustar 00root root 0000000 0000000 .qunit {} sprockets-3.7.2/test/fixtures/default/qunit/qunit.js 0000664 0000000 0000000 00000000013 13312220220 0022627 0 ustar 00root root 0000000 0000000 var qunit; sprockets-3.7.2/test/fixtures/default/rails/ 0000775 0000000 0000000 00000000000 13312220220 0021111 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/default/rails/bower.json 0000664 0000000 0000000 00000000064 13312220220 0023122 0 ustar 00root root 0000000 0000000 { "name": "rails", "main": ["./rails.coffee"] } sprockets-3.7.2/test/fixtures/default/rails/rails.coffee 0000664 0000000 0000000 00000000013 13312220220 0023366 0 ustar 00root root 0000000 0000000 Rails = {} sprockets-3.7.2/test/fixtures/default/rand.js.erb 0000664 0000000 0000000 00000000036 13312220220 0022027 0 ustar 00root root 0000000 0000000 <% @dependencies << "rand" %> sprockets-3.7.2/test/fixtures/default/requirejs/ 0000775 0000000 0000000 00000000000 13312220220 0022010 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/default/requirejs/bower.json 0000664 0000000 0000000 00000000106 13312220220 0024016 0 ustar 00root root 0000000 0000000 { "name": "requirejs", "main": ["require.min.js", "require.js"] } sprockets-3.7.2/test/fixtures/default/requirejs/require.js 0000664 0000000 0000000 00000000030 13312220220 0024013 0 ustar 00root root 0000000 0000000 function requirejs() {} sprockets-3.7.2/test/fixtures/default/schneems.js 0000664 0000000 0000000 00000000153 13312220220 0022141 0 ustar 00root root 0000000 0000000 //= stub interpolation.js //= require ./noreturn.js //= require_self //= link logo.svg var dog = "cinco"; sprockets-3.7.2/test/fixtures/default/symlink 0000777 0000000 0000000 00000000000 13312220220 0022575 2mobile ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/default/troll.png 0000664 0000000 0000000 00000170706 13312220220 0021654 0 ustar 00root root 0000000 0000000 PNG IHDR m gAMA |Q cHRM R @ }y < s☃
sprockets-3.7.2/test/fixtures/encoding/utf8.js 0000664 0000000 0000000 00000000024 13312220220 0021361 0 ustar 00root root 0000000 0000000 var snowman = "☃"; sprockets-3.7.2/test/fixtures/encoding/utf8_bom.html 0000664 0000000 0000000 00000000015 13312220220 0022546 0 ustar 00root root 0000000 0000000 ☃
sprockets-3.7.2/test/fixtures/encoding/utf8_bom.js 0000664 0000000 0000000 00000000027 13312220220 0022221 0 ustar 00root root 0000000 0000000 var snowman = "☃"; sprockets-3.7.2/test/fixtures/engines/ 0000775 0000000 0000000 00000000000 13312220220 0020003 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/engines/hello.alert 0000664 0000000 0000000 00000000015 13312220220 0022133 0 ustar 00root root 0000000 0000000 Hello world! sprockets-3.7.2/test/fixtures/engines/moo.js 0000664 0000000 0000000 00000000045 13312220220 0021132 0 ustar 00root root 0000000 0000000 console.log("Moo, #{RUBY_VERSION}"); sprockets-3.7.2/test/fixtures/errors/ 0000775 0000000 0000000 00000000000 13312220220 0017667 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/errors/symlink 0000777 0000000 0000000 00000000000 13312220220 0023666 2missing_file ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/manifest_utils/ 0000775 0000000 0000000 00000000000 13312220220 0021401 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/manifest_utils/default/ 0000775 0000000 0000000 00000000000 13312220220 0023025 5 ustar 00root root 0000000 0000000 .sprockets-manifest-f4bf345974645583d284686ddfb7625e.json 0000664 0000000 0000000 00000000000 13312220220 0033723 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/manifest_utils/default sprockets-3.7.2/test/fixtures/manifest_utils/legacy/ 0000775 0000000 0000000 00000000000 13312220220 0022645 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/manifest_utils/legacy/manifest-02f33520c330d408567423cefa7a03ba.json 0000664 0000000 0000000 00000000000 13312220220 0031517 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/manifest_utils/legacy2/ 0000775 0000000 0000000 00000000000 13312220220 0022727 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/manifest_utils/legacy2/manifest.json 0000664 0000000 0000000 00000000000 13312220220 0025416 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/octicons/ 0000775 0000000 0000000 00000000000 13312220220 0020174 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/octicons/octicons.eot 0000664 0000000 0000000 00000000000 13312220220 0022514 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/octicons/octicons.scss 0000664 0000000 0000000 00000000470 13312220220 0022713 0 ustar 00root root 0000000 0000000 @font-face { font-family: 'octicons'; src: font-url('octicons.eot?#iefix') format('embedded-opentype'), font-url('octicons.woff') format('woff'), font-url('octicons.ttf') format('truetype'), font-url('octicons.svg#octicons') format('svg'); font-weight: normal; font-style: normal; } sprockets-3.7.2/test/fixtures/octicons/octicons.svg 0000664 0000000 0000000 00000000000 13312220220 0022524 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/octicons/octicons.ttf 0000664 0000000 0000000 00000000000 13312220220 0022522 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/octicons/octicons.woff 0000664 0000000 0000000 00000000000 13312220220 0022666 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/ 0000775 0000000 0000000 00000000000 13312220220 0017472 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/all.coffee/ 0000775 0000000 0000000 00000000000 13312220220 0021470 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/all.coffee/hot.coffee 0000664 0000000 0000000 00000000000 13312220220 0023421 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/all.coffee/index.coffee 0000664 0000000 0000000 00000000000 13312220220 0023736 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/all.coffee/plain.js 0000664 0000000 0000000 00000000000 13312220220 0023117 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/application.coffee 0000664 0000000 0000000 00000000000 13312220220 0023134 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/application.css 0000664 0000000 0000000 00000000000 13312220220 0022475 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/application.css.scss 0000664 0000000 0000000 00000000000 13312220220 0023447 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/application.js 0000664 0000000 0000000 00000000000 13312220220 0022321 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/application.js.coffee 0000664 0000000 0000000 00000000000 13312220220 0023547 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/application.js.erb 0000664 0000000 0000000 00000000000 13312220220 0023070 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/application.scss 0000664 0000000 0000000 00000000000 13312220220 0022660 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/bar-ng.ngt.haml 0000664 0000000 0000000 00000000000 13312220220 0022260 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/baz-ng.js.ngt 0000664 0000000 0000000 00000000000 13312220220 0021763 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/bower/ 0000775 0000000 0000000 00000000000 13312220220 0020610 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/bower/bower.json 0000664 0000000 0000000 00000000000 13312220220 0022607 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/bower/main.js 0000664 0000000 0000000 00000000000 13312220220 0022060 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/coffee/ 0000775 0000000 0000000 00000000000 13312220220 0020721 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/coffee/foo.coffee 0000664 0000000 0000000 00000000000 13312220220 0022643 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/coffee/index.js 0000664 0000000 0000000 00000000000 13312220220 0022354 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/default/ 0000775 0000000 0000000 00000000000 13312220220 0021116 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/default/bower/ 0000775 0000000 0000000 00000000000 13312220220 0022234 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/default/bower/main.js 0000664 0000000 0000000 00000000000 13312220220 0023504 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/empty 0000664 0000000 0000000 00000000000 13312220220 0020541 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/files.erb 0000664 0000000 0000000 00000000000 13312220220 0021254 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/foo-ng.ngt 0000664 0000000 0000000 00000000000 13312220220 0021357 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/hello.jst.ejs 0000664 0000000 0000000 00000000000 13312220220 0022065 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/jquery-coffee.min.coffee 0000664 0000000 0000000 00000000000 13312220220 0024157 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/jquery-custom.min.js.erb 0000664 0000000 0000000 00000000000 13312220220 0024176 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/jquery.csv.js 0000664 0000000 0000000 00000000000 13312220220 0022127 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/jquery.csv.min.js 0000664 0000000 0000000 00000000000 13312220220 0022711 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/jquery.ext/ 0000775 0000000 0000000 00000000000 13312220220 0021610 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/jquery.ext/form.js 0000664 0000000 0000000 00000000000 13312220220 0023077 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/jquery.ext/index.js 0000664 0000000 0000000 00000000000 13312220220 0023243 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/jquery.foo.min.js 0000664 0000000 0000000 00000000000 13312220220 0022701 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/jquery.js 0000664 0000000 0000000 00000000000 13312220220 0021335 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/jquery.js.min 0000664 0000000 0000000 00000000000 13312220220 0022117 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/jquery.min.js 0000664 0000000 0000000 00000000000 13312220220 0022117 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/jquery.tmpl.js 0000664 0000000 0000000 00000000000 13312220220 0022310 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/jquery.tmpl.min.js 0000664 0000000 0000000 00000000000 13312220220 0023072 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/project.js.coffee.erb 0000664 0000000 0000000 00000000000 13312220220 0023461 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/sprite.css.embed 0000664 0000000 0000000 00000000000 13312220220 0022553 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/store.css.erb 0000664 0000000 0000000 00000000000 13312220220 0022075 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/store.foo 0000664 0000000 0000000 00000000000 13312220220 0021321 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/traceur.es6 0000664 0000000 0000000 00000000000 13312220220 0021544 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/paths/traceur.js.es6 0000664 0000000 0000000 00000000000 13312220220 0022157 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/public/ 0000775 0000000 0000000 00000000000 13312220220 0017631 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/public/compiled-digest-0aa2105d29558f3eb790d411d7d8fb66.js 0000664 0000000 0000000 00000000052 13312220220 0027532 0 ustar 00root root 0000000 0000000 (function() { application.boot(); })(); sprockets-3.7.2/test/fixtures/public/compiled-digest-1c41eb0cf934a0c76babe875f982f9d1.js 0000664 0000000 0000000 00000000023 13312220220 0027755 0 ustar 00root root 0000000 0000000 (function() {})(); sprockets-3.7.2/test/fixtures/resolve/ 0000775 0000000 0000000 00000000000 13312220220 0020032 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/resolve/javascripts/ 0000775 0000000 0000000 00000000000 13312220220 0022363 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/resolve/javascripts/bar.css 0000664 0000000 0000000 00000000000 13312220220 0023627 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/resolve/javascripts/bar.js 0000664 0000000 0000000 00000000000 13312220220 0023453 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/resolve/javascripts/foo.js 0000664 0000000 0000000 00000000000 13312220220 0023472 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/resolve/stylesheets/ 0000775 0000000 0000000 00000000000 13312220220 0022406 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/resolve/stylesheets/foo.css 0000664 0000000 0000000 00000000000 13312220220 0023671 0 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/sass/ 0000775 0000000 0000000 00000000000 13312220220 0017324 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/sass/_colors.scss 0000664 0000000 0000000 00000000037 13312220220 0021661 0 ustar 00root root 0000000 0000000 $link: "red"; $header: 'blue'; sprockets-3.7.2/test/fixtures/sass/_header.scss 0000664 0000000 0000000 00000000036 13312220220 0021607 0 ustar 00root root 0000000 0000000 #header { color: $header; } sprockets-3.7.2/test/fixtures/sass/_rounded.scss 0000664 0000000 0000000 00000000237 13312220220 0022022 0 ustar 00root root 0000000 0000000 @mixin rounded($side, $radius: 10px) { border-#{$side}-radius: $radius; -moz-border-radius-#{$side}: $radius; -webkit-border-#{$side}-radius: $radius; } sprockets-3.7.2/test/fixtures/sass/data_url.scss 0000664 0000000 0000000 00000000061 13312220220 0022011 0 ustar 00root root 0000000 0000000 div { url: asset-data-url('asset/blue.png'); } sprockets-3.7.2/test/fixtures/sass/error.sass 0000664 0000000 0000000 00000000045 13312220220 0021347 0 ustar 00root root 0000000 0000000 .foo color: green .bar invalid/ sprockets-3.7.2/test/fixtures/sass/import_load_path.scss 0000664 0000000 0000000 00000000023 13312220220 0023541 0 ustar 00root root 0000000 0000000 @import "compass"; sprockets-3.7.2/test/fixtures/sass/import_nonpartial.scss 0000664 0000000 0000000 00000000025 13312220220 0023757 0 ustar 00root root 0000000 0000000 @import "variables"; sprockets-3.7.2/test/fixtures/sass/import_partial.sass 0000664 0000000 0000000 00000000204 13312220220 0023241 0 ustar 00root root 0000000 0000000 @import "rounded" #navbar li @include rounded(top) #footer @include rounded(top, 5px) #sidebar @include rounded(left, 8px) sprockets-3.7.2/test/fixtures/sass/import_partial.scss 0000664 0000000 0000000 00000000214 13312220220 0023244 0 ustar 00root root 0000000 0000000 @import "rounded"; #navbar li { @include rounded(top); } #footer { @include rounded(top, 5px); } #sidebar { @include rounded(left, 8px); } sprockets-3.7.2/test/fixtures/sass/links.scss 0000664 0000000 0000000 00000000056 13312220220 0021342 0 ustar 00root root 0000000 0000000 @import "colors"; a:link { color: $link; } sprockets-3.7.2/test/fixtures/sass/main.scss 0000664 0000000 0000000 00000000043 13312220220 0021142 0 ustar 00root root 0000000 0000000 $header: 'blue'; @import "header"; sprockets-3.7.2/test/fixtures/sass/nesting.scss 0000664 0000000 0000000 00000000217 13312220220 0021670 0 ustar 00root root 0000000 0000000 table.hl { margin: 2em 0; td.ln { text-align: right; } } li { font: { family: serif; weight: bold; size: 1.2em; } } sprockets-3.7.2/test/fixtures/sass/paths.scss 0000664 0000000 0000000 00000000414 13312220220 0021337 0 ustar 00root root 0000000 0000000 div { url: url(asset-path("foo.svg")); url: url(image-path("foo.png")); url: url(video-path("foo.mov")); url: url(audio-path("foo.mp3")); url: url(font-path("foo.woff")); url: url(javascript-path("foo.js")); url: url(stylesheet-path("foo.css")); } sprockets-3.7.2/test/fixtures/sass/relative.scss 0000664 0000000 0000000 00000000070 13312220220 0022031 0 ustar 00root root 0000000 0000000 @import "shared/colors"; body { background: $grey; } sprockets-3.7.2/test/fixtures/sass/reset.css 0000664 0000000 0000000 00000000156 13312220220 0021162 0 ustar 00root root 0000000 0000000 article, aside, details, figcaption, figure, footer, header, hgroup, menu, nav, section { display: block; } sprockets-3.7.2/test/fixtures/sass/shared/ 0000775 0000000 0000000 00000000000 13312220220 0020572 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/sass/shared/colors.sass 0000664 0000000 0000000 00000000017 13312220220 0022764 0 ustar 00root root 0000000 0000000 $grey: #666666 sprockets-3.7.2/test/fixtures/sass/shared/relative.scss 0000664 0000000 0000000 00000000217 13312220220 0023302 0 ustar 00root root 0000000 0000000 @import "../rounded"; #navbar li { @include rounded(top); } #footer { @include rounded(top, 5px); } #sidebar { @include rounded(left, 8px); } sprockets-3.7.2/test/fixtures/sass/urls.scss 0000664 0000000 0000000 00000000342 13312220220 0021205 0 ustar 00root root 0000000 0000000 div { url: asset-url("foo.svg"); url: image-url("foo.png"); url: video-url("foo.mov"); url: audio-url("foo.mp3"); url: font-url("foo.woff"); url: javascript-url("foo.js"); url: stylesheet-url("foo.css"); } sprockets-3.7.2/test/fixtures/sass/variables.sass 0000664 0000000 0000000 00000000257 13312220220 0022173 0 ustar 00root root 0000000 0000000 $blue: #3bbfce $margin: 16px .content-navigation border-color: $blue color: darken($blue, 9%) .border padding: $margin / 2 margin: $margin / 2 border-color: $blue sprockets-3.7.2/test/fixtures/server/ 0000775 0000000 0000000 00000000000 13312220220 0017661 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/server/app/ 0000775 0000000 0000000 00000000000 13312220220 0020441 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/server/app/images/ 0000775 0000000 0000000 00000000000 13312220220 0021706 5 ustar 00root root 0000000 0000000 sprockets-3.7.2/test/fixtures/server/app/images/logo.png 0000664 0000000 0000000 00000123645 13312220220 0023367 0 ustar 00root root 0000000 0000000 PNG IHDR , K9 tEXtSoftware Adobe ImageReadyqe< fiTXtXML:com.adobe.xmp☃
", str.encode(Encoding::UTF_8) path = File.expand_path("../fixtures/encoding/utf8_bom.html", __FILE__) str = File.binread(path) str.force_encoding(Encoding::UTF_8) assert_equal 13, str.bytesize str = detect_html(str) assert_equal Encoding::UTF_8, str.encoding assert_equal 10, str.bytesize assert_equal "☃
", str.encode(Encoding::UTF_8) path = File.expand_path("../fixtures/encoding/utf16le.html", __FILE__) str = File.binread(path) assert_equal Encoding::BINARY, str.encoding assert_equal 18, str.bytesize str = detect_html(str) assert_equal Encoding::UTF_16LE, str.encoding assert_equal 16, str.bytesize assert_equal "☃
", str.encode(Encoding::UTF_8) path = File.expand_path("../fixtures/encoding/utf16be.html", __FILE__) str = File.binread(path) str.force_encoding(Encoding::UTF_16BE) assert_equal 18, str.bytesize str = detect_html(str) assert_equal Encoding::UTF_16BE, str.encoding assert_equal 16, str.bytesize assert_equal "☃
", str.encode(Encoding::UTF_8) path = File.expand_path("../fixtures/encoding/utf32be.html", __FILE__) str = File.binread(path) assert_equal Encoding::BINARY, str.encoding assert_equal 36, str.bytesize str = detect_html(str) assert_equal Encoding::UTF_32BE, str.encoding assert_equal 32, str.bytesize assert_equal "☃
", str.encode(Encoding::UTF_8) path = File.expand_path("../fixtures/encoding/utf32le.html", __FILE__) str = File.binread(path) assert_equal Encoding::BINARY, str.encoding assert_equal 36, str.bytesize str = detect_html(str) assert_equal Encoding::UTF_32LE, str.encoding assert_equal 32, str.bytesize assert_equal "☃
", str.encode(Encoding::UTF_8) end end sprockets-3.7.2/test/test_engines.rb 0000664 0000000 0000000 00000001703 13312220220 0017517 0 ustar 00root root 0000000 0000000 require 'sprockets_test' require 'sprockets/engines' class AlertProcessor def self.default_mime_type 'application/javascript' end def initialize(file, &block) @data = block.call end def render(context, locals = {}) "alert(#{@data.inspect});" end end class StringProcessor def initialize(file, &block) @data = block.call end def render(context, locals = {}) @data.gsub(/#\{.*?\}/, "moo") end end class TestEngines < Sprockets::TestCase test "registering engine" do env = new_environment Sprockets::SilenceDeprecation.silence do env.register_engine ".alert", AlertProcessor, silence_deprecation: true end asset = env["hello.alert"] assert_equal "alert(\"Hello world!\\n\");\n", asset.to_s assert_equal 'application/javascript', asset.content_type end def new_environment Sprockets::Environment.new.tap do |env| env.append_path(fixture_path('engines')) end end end sprockets-3.7.2/test/test_environment.rb 0000664 0000000 0000000 00000072013 13312220220 0020435 0 ustar 00root root 0000000 0000000 require 'sprockets_test' require 'rack/mock' require 'execjs' module EnvironmentTests def self.test(name, &block) define_method("test_#{name.inspect}", &block) end test "working directory is the default root" do assert_equal Dir.pwd, @env.root end test "default logger level is set to fatal" do assert_equal Logger::FATAL, @env.logger.level end test "active css compressor" do assert_nil @env.css_compressor end test "active js compressor" do assert_nil @env.js_compressor end test "paths" do assert_equal [fixture_path("default")], @env.paths.to_a end test "register global path" do assert_equal [fixture_path("default")], new_environment.paths.to_a Sprockets.append_path(fixture_path("asset")) assert_equal [fixture_path("asset"), fixture_path("default")], new_environment.paths.to_a Sprockets.clear_paths end test "eco templates" do asset = @env["goodbye.js"] context = ExecJS.compile(asset.to_s) assert_equal "Goodbye world\n", context.call("JST['goodbye']", :name => "world") end test "ejs templates" do assert asset = @env["hello.js"] context = ExecJS.compile(asset.to_s) assert_equal "hello: world\n", context.call("JST['hello']", :name => "world") end test "another ejs templates" do assert asset = @env["hello2.js"] context = ExecJS.compile(asset.to_s) assert_equal "hello2: world\n", context.call("JST2['hello2']", :name => "world") end test "angular templates" do assert asset = @env["ng-view.js"] assert_equal <<-JS, asset.to_s $app.run(function($templateCache) { $templateCache.put('ng-view.html', ""); }); JS end test "asset_data_uri helper" do assert asset = @env["with_data_uri.css"] assert_equal "body {\n background-image: url(data:image/gif;base64,R0lGODlhAQABAIAAAP%2F%2F%2FwAAACH5BAAAAAAALAAAAAABAAEAAAICRAEAOw%3D%3D) no-repeat;\n}\n", asset.to_s end test "lookup bundle processors" do assert_equal 1, @env.bundle_processors['application/javascript'].size assert_equal 1, @env.bundle_processors['text/css'].size end test "find asset with accept type" do assert asset = @env.find_asset("gallery.js", accept: '*/*') assert_equal fixture_path('default/gallery.js'), asset.filename assert asset = @env.find_asset("gallery", accept: 'application/javascript') assert_equal fixture_path('default/gallery.js'), asset.filename assert asset = @env.find_asset("gallery", accept: 'application/javascript, text/css') assert_equal fixture_path('default/gallery.js'), asset.filename assert asset = @env.find_asset("gallery.js", accept: 'application/javascript') assert_equal fixture_path('default/gallery.js'), asset.filename assert asset = @env.find_asset("gallery", accept: 'text/css, application/javascript') assert_equal fixture_path('default/gallery.css.erb'), asset.filename assert asset = @env.find_asset("coffee/foo", accept: "application/javascript") assert_equal fixture_path('default/coffee/foo.coffee'), asset.filename assert asset = @env.find_asset("coffee/foo.coffee", accept: "application/javascript") assert_equal fixture_path('default/coffee/foo.coffee'), asset.filename assert asset = @env.find_asset("jquery.tmpl.min", accept: 'application/javascript') assert_equal fixture_path('default/jquery.tmpl.min.js'), asset.filename assert asset = @env.find_asset("jquery.tmpl.min.js", accept: 'application/javascript') assert_equal fixture_path('default/jquery.tmpl.min.js'), asset.filename assert asset = @env.find_asset('manifest.js.yml', accept: 'text/yaml') assert_equal fixture_path('default/manifest.js.yml'), asset.filename assert asset = @env.find_asset('manifest.js.yml', accept: 'text/css, */*') assert_equal fixture_path('default/manifest.js.yml'), asset.filename refute @env.find_asset("gallery.js", accept: "text/css") refute @env.find_asset(fixture_path('default/gallery.js'), accept: "text/css") refute @env.find_asset('manifest.js.yml', accept: 'application/javascript') end test "find all linked assets" do assert assets = @env.find_all_linked_assets("missing.js").to_a assert_equal 0, assets.length assert assets = @env.find_all_linked_assets("gallery.js").to_a assert_equal 1, assets.length assert_equal @env["gallery.js"], assets[0] assert assets = @env.find_all_linked_assets("gallery-link.js").to_a assert_equal 2, assets.length assert_equal @env["gallery-link.js"], assets[0] assert_equal @env["gallery.js"], assets[1] assert assets = @env.find_all_linked_assets("explore-link.js").to_a assert_equal 3, assets.length assert_equal @env["explore-link.js"], assets[0] assert_equal @env["gallery-link.js"], assets[1] assert_equal @env["gallery.js"], assets[2] end test "html subresource links" do assert asset = @env["homepage-links.html"] assert_equal "text/html", asset.content_type assert asset.to_s.match(/gallery-[a-z0-9]+\.css/) assert asset.to_s.match(/gallery-[a-z0-9]+\.js/) assert asset.links.include?(@env["gallery.css"].uri) assert asset.links.include?(@env["gallery.js"].uri) end test "web component assets" do assert asset = @env["menu/menu.html"] assert_equal "text/html", asset.content_type assert_equal "\n", asset.to_s assert asset = @env["menu/menu.js"] assert_equal "application/javascript", asset.content_type assert_equal "$.fn.menu = {};\n", asset.to_s assert asset = @env["menu/menu.css"] assert_equal "text/css", asset.content_type assert_equal ".menu {}\n", asset.to_s end test "explicit bower.json access returns json file" do assert_equal fixture_path('default/bower/bower.json'), @env["bower/bower.json"].filename end test "find default bower main" do assert_equal fixture_path('default/bower/main.js'), @env["bower"].filename assert_equal fixture_path('default/qunit/qunit.js'), @env["qunit"].filename assert_equal fixture_path('default/rails/rails.coffee'), @env["rails"].filename end test "find bower main by format extension" do assert_equal fixture_path('default/bower/main.js'), @env["bower.js"].filename refute @env.find_asset("bower.css") assert_equal fixture_path('default/qunit/qunit.js'), @env["qunit.js"].filename assert_equal fixture_path('default/qunit/qunit.css'), @env["qunit.css"].filename assert_equal fixture_path('default/rails/rails.coffee'), @env["rails.js"].filename assert_equal fixture_path('default/requirejs/require.js'), @env.find_asset("requirejs.js").filename end test "find bower main by content type" do assert_equal fixture_path('default/bower/main.js'), @env.find_asset("bower", accept: 'application/javascript').filename assert_equal fixture_path('default/bower/main.js'), @env.find_asset("bower.js", accept: 'application/javascript').filename assert_equal fixture_path('default/qunit/qunit.js'), @env.find_asset("qunit", accept: 'application/javascript').filename assert_equal fixture_path('default/qunit/qunit.js'), @env.find_asset("qunit.js", accept: 'application/javascript').filename assert_equal fixture_path('default/qunit/qunit.css'), @env.find_asset("qunit", accept: 'text/css').filename assert_equal fixture_path('default/qunit/qunit.css'), @env.find_asset("qunit.css", accept: 'text/css').filename assert_equal fixture_path('default/rails/rails.coffee'), @env.find_asset("rails", accept: 'application/javascript').filename assert_equal fixture_path('default/rails/rails.coffee'), @env.find_asset("rails.js", accept: 'application/javascript').filename assert_equal fixture_path('default/requirejs/require.js'), @env.find_asset("requirejs.js", accept: 'application/javascript').filename end test "bower main with invalid files" do assert @env.find_asset("zeroclipboard/FILEFILE") assert @env.find_asset("zeroclipboard/mimetype.unknown") assert @env.find_asset("zeroclipboard/zc.js") assert @env.find_asset("zeroclipboard.js") refute @env.find_asset("zeroclipboard.unknown") end test "find bundled asset in environment" do assert_equal "var Gallery = {};\n", @env["gallery.js"].to_s end test "find bundled asset with absolute path environment" do assert_equal "var Gallery = {};\n", @env[fixture_path("default/gallery.js")].to_s end test "find bundled asset with implicit format" do assert_equal "(function() {\n var foo;\n\n foo = 'hello';\n\n}).call(this);\n", @env["coffee/foo.js"].to_s end test "find static asset in environment" do assert_equal "Hello world\n", @env["hello.txt"].to_s end test "find static asset with leading slash in environment" do assert_equal "Hello world\n", @env[fixture_path("default/hello.txt")].to_s end test "find index.js in directory" do assert_equal "var A;\nvar B;\n", @env["mobile.js"].to_s end test "find index.css in directory" do assert_equal ".c {}\n.d {}\n/*\n\n */\n\n", @env["mobile.css"].to_s end test "ignore index.min.js in directory" do refute @env["mobile-min.js"] end test "find bower.json in directory" do assert_equal "var bower;\n", @env["bower.js"].to_s end test "find multiple bower.json in directory" do assert_equal "var qunit;\n", @env["qunit.js"].to_s assert_equal ".qunit {}\n", @env["qunit.css"].to_s end test "find erb assets" do assert asset = @env.find_asset("erb/a") assert_equal "text/plain", asset.content_type assert asset = @env.find_asset("erb/b") assert_equal "text/plain", asset.content_type assert asset = @env.find_asset("erb/c") assert_equal "application/javascript", asset.content_type assert asset = @env.find_asset("erb/d") assert_equal "text/css", asset.content_type assert asset = @env.find_asset("erb/e") assert_equal "text/html", asset.content_type assert asset = @env.find_asset("erb/f") assert_equal "text/yaml", asset.content_type end test "find html builder asset" do assert asset = @env.find_asset("nokogiri-html.html") assert_equal "text/html", asset.content_type assert_equal <<-HTML, asset.to_s Hello world HTML end test "find xml builder asset" do assert asset = @env.find_asset("nokogiri-xml.xml") assert_equal "application/xml", asset.content_type assert_equal <<-XML, asset.to_s