dassets 0.9.0 → 0.10.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8eb00e1656956e770b1e509f47389da503b40842
+  data.tar.gz: f32473d4d3bc21276cc9e09dd8a0ad3ab8677614
+SHA512:
+  metadata.gz: 8293311bd021e41fc50a334f38d3c8ac1a93b07147660faa0b23df81fe64299411c5b6f6e56f6ca22cacf7a4a77c5f275534c591dd11116d45961ffae5a5c75c
+  data.tar.gz: b3b9914524b148a2809b1596c3f5c229b3ccd5a027bccc220c0629f15aebcf98b22f2b754e5a4b20a14064b97eb2e1c17003d2ec2170dad728945e7e44e65389

data/README.md

@@ -28,7 +28,6 @@ end
 ### Link To
 
 ```rb
-Dassets.init
 Dassets['css/site.css'].href       # => "/css/site-123abc.css"
 Dassets['img/logos/main.jpg'].href # => "/img/logos/main-a1b2c3.jpg"
 ```
@@ -51,9 +50,11 @@ Engines are "registered" with dassets based on source extensions.  Name your sou
 
 ### Some Dassets Engines
 
-Examples are key here, so check out some of the Dasset's engines available:
+Examples are key here, so check out some of the Dasset engines available:
 
-TODO
+* **Erb**:       https://github.com/redding/dassets-erb
+* **Sass**:      https://github.com/redding/dassets-sass
+* **Less (v1)**: https://github.com/redding/dassets-lessv1
 
 ### Creating your own Engine
 
@@ -64,11 +65,45 @@ TODO
 
 ## Sources
 
-TODO: filtering files, registering engines
+Sources model a root location for asset files.  They also provide configuration for how assets in that location should be processed and handled.
+
+You can specify filters that control which paths in the location are considered.  You can also register engines which determine how the contents of assets files are handled.  For example:
+
+```ruby
+Dassets.configure do |c|
+  c.source /path/to/assets do |s|
+    s.filter{ |paths| paths.reject{ |p| File.basename(p) =~ /^_/ } }
+
+    s.engine 'erb',  Dassets::Erb::Engine
+    s.engine 'scss', Dassets::Sass::Engine, {
+      :syntax => 'scss'
+      # any other engine-specific options here
+    }
+  end
+end
+```
+
+This configuration says that Dassets, for assets in `/path/to/assets`, should 1) ignore any files beginning in `_` 2) process any files ending in `.erb` with the Erb engine and 3) process any files ending in `.scss` with the Sass engine (using 'scss' syntax).
+
+The goal here is to allow you to control how certain asset files are handled based on their location root.  This is handy for 3rd-paty gems that provide asset source files (such as [Romo](https://github.com/redding/romo)).  See https://github.com/redding/romo/blob/master/lib/romo/dassets.rb for an example of how Romo integrates with Dassets.
 
 ## Combinations
 
-TODO
+Combinations are a way to alias many asset files as a single asset.  Dassets responds to requests for the combined asset by concatenating the combination's asset files into a single response.  For example:
+
+```ruby
+Dassets.configure do |c|
+  c.combination "css/special.css", [
+    'css/romo/normalize.css',
+    'css/romo/base.css',
+    'css/romo/component1.css'
+  ]
+end
+```
+
+This example tells Dassets that if it receives a request for the `css/special.css` asset it should return the content of the 3 files concatenated in that order.
+
+Combinations are treated just like regular asset files (think of them as a kind of alias).  They can be cached/digested/etc just as if they were a true asset file.  Again, see https://github.com/redding/romo/blob/master/lib/romo/dassets.rb for an example of using combinations to abstract the composition of 3rd-party asset files.
 
 ## Installation
 

data/lib/dassets/version.rb

@@ -1,3 +1,3 @@
 module Dassets
-  VERSION = "0.9.0"
+  VERSION = "0.10.0"
 end

data/lib/dassets.rb

@@ -28,3 +28,5 @@ module Dassets
   end
 
 end
+
+Dassets.init

data/test/helper.rb

@@ -31,5 +31,3 @@ Dassets.configure do |c|
     s.engine 'useless', @useless_engine
   end
 end
-
-Dassets.init

metadata

@@ -1,110 +1,95 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: dassets
-version: !ruby/object:Gem::Version 
-  hash: 59
-  prerelease: 
-  segments: 
-  - 0
-  - 9
-  - 0
-  version: 0.9.0
+version: !ruby/object:Gem::Version
+  version: 0.10.0
 platform: ruby
-authors: 
+authors:
 - Kelly Redding
 - Collin Redding
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2014-08-01 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 27
-        segments: 
-        - 2
-        - 12
-        version: "2.12"
-  type: :development
+date: 2015-05-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: assert
-  version_requirements: *id001
-  prerelease: false
-- !ruby/object:Gem::Dependency 
-  requirement: &id002 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 15
-        segments: 
-        - 1
-        - 0
-        version: "1.0"
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.12'
   type: :development
-  name: assert-rack-test
-  version_requirements: *id002
   prerelease: false
-- !ruby/object:Gem::Dependency 
-  requirement: &id003 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 7
-        segments: 
-        - 1
-        - 4
-        version: "1.4"
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.12'
+- !ruby/object:Gem::Dependency
+  name: assert-rack-test
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
   type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
   name: sinatra
-  version_requirements: *id003
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :development
   prerelease: false
-- !ruby/object:Gem::Dependency 
-  requirement: &id004 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 13
-        segments: 
-        - 1
-        - 1
-        version: "1.1"
-  type: :runtime
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
   name: ns-options
-  version_requirements: *id004
-  prerelease: false
-- !ruby/object:Gem::Dependency 
-  requirement: &id005 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 15
-        segments: 
-        - 1
-        - 0
-        version: "1.0"
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
   type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
   name: rack
-  version_requirements: *id005
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
   prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 description: Digest and serve HTML asset files
-email: 
+email:
 - kelly@kellyredding.com
 - collin.redding@me.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
-- .gitignore
+files:
+- ".gitignore"
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -157,39 +142,30 @@ files:
 - test/unit/source_tests.rb
 - tmp/.gitkeep
 homepage: http://github.com/redding/dassets
-licenses: 
+licenses:
 - MIT
+metadata: {}
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
   - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
   - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.8.25
+rubygems_version: 2.4.5
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Digested asset files
-test_files: 
+test_files:
 - test/helper.rb
 - test/support/app.rb
 - test/support/app/assets/file1.txt