sprockets 3.4.0 → 3.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2fdc7a23f1f27c37cc18683119a5ba3d27dcc5e8
-  data.tar.gz: 70560ff73b7fdd20363d768f99df198edaf314cf
+  metadata.gz: cb84129a09e33080f696f5eec822299e24279dba
+  data.tar.gz: fc5e73588c47c119874882bacdc8d8fd8da77567
 SHA512:
-  metadata.gz: 7b8a6dd4c114dc92fdd9e57b98d8dcdb6be5d58fe450d44564d23898622a1dabb62e65338700947ee67f3c19b20c9b1936b09a12f27648a6b4bf3b22c32766cb
-  data.tar.gz: 98e60c8ac724ef2b814b5fcf2ca8b01d91cf7542159fc66e4752b46ff8ea82964c8fc20de40731b58d2dcf40b805b5ac1fedf8aded422fcc89a3c2aff637027c
+  metadata.gz: e2166e7a2f5b2bea3e6eda0a29d0fd4816709bd9e93e6d99cfd00a85ff7df26747ef7d386c8a9812081726948465f887f0721a46a00c6cf06c832ed5f29b6ea0
+  data.tar.gz: 19c40eff6ab900018c2e7e0210e5ece20eb7780729daa0b2402cc2819012291adb145863c718340fdce43787acbc25e5407b88794df53558cea8e12c4cd5c545

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+**3.4.1** (November 25, 2015)
+
+* PathUtils::Entries will no longer error on an empty directory.
+
 **3.4.0** (October 5, 2015)
 
 * Expose method to override the sass cache in the SassProcessor.

data/README.md

@@ -20,6 +20,44 @@ Or include it in your project's `Gemfile` with Bundler:
 gem 'sprockets', '~> 3.0'
 ```
 
+## Behavior
+
+### Index files are proxies for folders
+
+In sprockets index files such as `index.js` or `index.css` files inside of a folder will generate a file with the folder's name. So if you have a `foo/index.js` file it will compile down to `foo.js`. This is similar to NPM's behavior of using [folders as modules](https://nodejs.org/api/modules.html#modules_folders_as_modules). It is also somewhat similar to the way that a file in `public/my_folder/index.html` can be reached by a request to `/my_folder`. This means that you cannot directly use an index file. For example this would not work:
+
+```
+<%= asset_path("foo/index.js") %>
+```
+
+Instead you would need to use:
+
+```
+<%= asset_path("foo.js") %>
+```
+
+Why would you want to use this behavior?  It is common behavior where you might want to include an entire directory of files in a top level javascript. You can do this in sprockets using `require_tree .`
+
+```
+//= require_tree .
+```
+
+This has the problem that files are required alphabetically. If your directory has `jquery-ui.js` and `jquery.min.js` then sprockets will require `jquery-ui.js` before `jquery` is required which won't work (because jquery-ui depends on jquery). Previously the only way to get the correct ordering would be to rename your files, something like `0-jquery-ui.js`. Instead of doing that you can use an index file.
+
+For example, if you have an `application.js` and want all the files in the `foo/` folder you could do this:
+
+```
+//= require foo.js
+```
+
+Then create a file `foo/index.js` that requires all the files in that folder in any order you want:
+
+```
+//= require foo.min.js
+//= require foo-ui.js
+```
+
+Now in your `application.js` will correctly load the `foo.min.js` before `foo-ui.js`. If you used `require_tree` it would not work correctly.
 
 ## Understanding the Sprockets Environment
 

data/lib/sprockets/path_utils.rb

@@ -55,9 +55,11 @@ module Sprockets
     # Returns an empty `Array` if the directory does not exist.
     def entries(path)
       if File.directory?(path)
-        Dir.entries(path, :encoding => Encoding.default_internal).reject! { |entry|
+        entries = Dir.entries(path, :encoding => Encoding.default_internal)
+        entries.reject! { |entry|
           entry =~ /^\.|~$|^\#.*\#$/
-        }.sort!
+        }
+        entries.sort!
       else
         []
       end

data/lib/sprockets/version.rb

@@ -1,3 +1,3 @@
 module Sprockets
-  VERSION = "3.4.0"
+  VERSION = "3.4.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sprockets
 version: !ruby/object:Gem::Version
-  version: 3.4.0
+  version: 3.4.1
 platform: ruby
 authors:
 - Sam Stephenson
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-10-05 00:00:00.000000000 Z
+date: 2015-11-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack
@@ -317,7 +317,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: sprockets
-rubygems_version: 2.4.5.1
+rubygems_version: 2.5.0
 signing_key: 
 specification_version: 4
 summary: Rack-based asset packaging system