rapper_lite 0.1.1 → 0.1.2

data/Gemfile

@@ -1,13 +1,14 @@
 source "http://rubygems.org"
 
+gem "yui-compressor", "~> 0.9.6"
+gem "fssm", "~> 0.2.7"
+gem "rb-fsevent"
+gem "coffee-script", "~> 2.2.0"
+
 group :development do
-  gem "rake", "~> 0.9.2"
+  gem "rake", "= 0.9.2"
   gem "rspec", "~> 1.3.2"
   gem "yard"
   gem "rdiscount", "~> 1.6.8"
   gem "jeweler", "~> 1.6.4"
-  gem "yui-compressor", "~> 0.9.6"
-  gem "fssm", "~> 0.2.7"
-  gem "rb-fsevent"
-  gem "coffee-script", "~> 2.2.0"
 end

data/Gemfile.lock

@@ -18,12 +18,12 @@ GEM
       git (>= 1.2.5)
       rake
     multi_json (1.0.3)
-    open4 (1.0.1)
+    open4 (1.2.0)
     rake (0.9.2)
     rb-fsevent (0.4.3.1)
     rdiscount (1.6.8)
     rspec (1.3.2)
-    yard (0.6.4)
+    yard (0.7.2)
     yui-compressor (0.9.6)
       POpen4 (>= 0.1.4)
 
@@ -35,7 +35,7 @@ DEPENDENCIES
   coffee-script (~> 2.2.0)
   fssm (~> 0.2.7)
   jeweler (~> 1.6.4)
-  rake (~> 0.9.2)
+  rake (= 0.9.2)
   rb-fsevent
   rdiscount (~> 1.6.8)
   rspec (~> 1.3.2)

data/README.markdown

@@ -1,59 +1,102 @@
-# rapper_lite #
-
-Bare-bones static asset packager and compressor. Currently supports CSS, JavaScript, and CoffeeScript. Uses MD5 versioning to avoid re-compressing packages that don't need to be re-compressed. Uses a simple config file so that you don't have to wrangle wacky comment DSLs in your source code just to join and compress a few files.
-
-## Packaging assets without wanting to claw your eyes out
-
-1. Create a config file:
-
-        --- !omap
-        - root: public/javascripts/
-        - destination: public/assets/
-        - compress: true
-        - css: !omap
-          - base: !omap
-            - files:
-              - reset
-              - layout
-              - typography
-              - colores
-            - version: 683e
-        - js: !omap
-          - mootools: !omap
-            - files:
-              - mootools-core
-              - mootools-more
-            - version: f3d9
-          - base_combined: !omap
-            - files:
-              - preloader
-              - +mootools
-              - widgets
-            - version: ccfc
-
-2. Run rapper lite:
-
-        $ rapper_lite config/static_assets.yml
-
-    Watch for changes:
-
-        $ rapper_lite --watch config/static_assets.yml
-
-    If no config file is passed in, RapperLite will search for the config file:
+# RapperLite #
+
+RapperLite is a bare-bones static asset packager and compressor. It currently supports CSS, JavaScript, and CoffeeScript. It uses MD5 versioning to avoid re-compressing packages that don't need to be re-compressed. RapperLite can be set up with a single config file so that you don't have to wrangle wacky comment DSLs in your source code just to join and compress a few files.
+
+## Configuring ##
+
+Create a YAML file (say, "rapper.yml") that defines your static asset packages like so:
+
+    --- !omap
+    - root: public/src/
+    - destination: public/assets/
+    - compress: true
+    - css: !omap
+      - base: !omap
+        - files:
+          - reset
+          - layout
+          - typography
+          - colores
+        - version: 683e
+    - js: !omap
+      - mootools: !omap
+        - files:
+          - mootools-core
+          - mootools-more
+        - version: f3d9
+      - base_combined: !omap
+        - files:
+          - preloader
+          - +mootools
+          - widgets
+        - version: ccfc
+
+(Why the excessive use of `omap`? I'm doing this to ensure that the line order is maintained when I write updated version strings to the file. Why maintain order? Two words: merge conflicts.)
+
+The above configuration will create the following compressed asset packages when RapperLite is run:
+
+    * `public/assets/base.css`
+    * `public/assets/mootools.js`
+    * `public/assets/base_combined.js`
+
+Component files can be nested in subfolders:
+
+    ...
+    - base: !omap
+      - files:
+        - mootools-core
+        - extras/mootools-more
+        - extras/crazybox
+      - version: f3d9
+    ...
+
+The "css" and "js" nodes of the config can override the "root" and "destination" config variables:
+
+    --- !omap
+    - destination: public/assets/
+    - compress: true
+    - css: !omap
+      - root: public/stylesheets/
+      - base: !omap
+        ...
+    - js: !omap
+      - root: public/javascripts/
+      - base: !omap
+        ...
+
+## Packaging assets ##
+
+You can run RapperLite from the command line:
+
+    $ rapper_lite path/to/config.yml
+    or:
+    $ rapper_lite --watch path/to/config.yml
+
+If no config file is passed in, RapperLite will search for the config file at:
 
         ./rapper.yml
         ./assets.yml
         ./config/rapper.yml
         ./config/assets.yml
 
-3. That's it.
+You can also run RapperLite from Ruby:
+
+    require "rapper_lite"
+    RapperLite::Engine.new( "config/rapper.yml" ).package
+
+Or use the included Rake tasks by adding this to your `Rakefile`:
+
+    Rapper::Tasks.new do |config|
+      config[:path] = "config/assets.yml"
+    end
+
+You can specify a custom namespace, if you want:
 
-Alternatively, you can run Rapper from Ruby:
+    Rapper::Tasks.new( :assets ) do |config| ...
 
-        require "rapper_lite"
-        RapperLite::Engine.new( "config/rapper.yml" ).package
+## CoffeeScript ##
 
-When you run `rapper_lite`, the config is automatically updated with the latest version numbers.
+RapperLite transparently supports CoffeeScript. You don't have to do anything. Refer to the file in your config like you would any regular ol' JavaScript file.
 
 # Development
 
@@ -64,6 +107,7 @@ Rapper's got a Gemfile. You know what to do.
 
 ## Version history
 
+* **0.1.2** - Update Gemfile, add "rapper-lite" command.
 * **0.1.1** - Turns out you can only release `master`, which `jeweler` doesn't tell you. Oops.
 * **0.1.0** - Add CoffeeScript support. Re-write `rapper_lite` command to allow watching for changes. Add watch support to Rake task.
 * **0.0.2** - Fix gem homepage link.

data/VERSION

@@ -1 +1 @@
-0.1.1
+0.1.2

data/bin/rapper-lite

@@ -0,0 +1,44 @@
+#!/usr/bin/env ruby
+
+require File.join( File.expand_path( File.dirname(__FILE__) ), '../lib/rapper_lite' )
+require "optparse"
+require "fssm"
+require "rb-fsevent"
+
+module RapperLite
+  class CommandLine
+    
+    attr_reader :rapper
+    
+    def initialize
+      args, options = self.parse_args
+      @config_path = args.first || RapperLite::Engine.find_config_path
+      @rapper = self.build_rapper_engine
+      options[:watch] ? @rapper.watch : @rapper.noisy_package
+    end
+    
+    def build_rapper_engine
+      puts "Loading RapperLite with #{@config_path}"
+      RapperLite::Engine.new( @config_path )
+    end
+    
+    protected
+    
+    def parse_args
+      options = {}
+      OptionParser.new do |opts|
+        opts.banner = "Usage: #{File.basename(__FILE__)} [-w|--watch] [-h|--help] [configfile]"
+        opts.on( "-h", "--help", "Print this message") do
+          p opts
+          exit 1
+        end
+        opts.on( "-w", "--watch", "Watch files for changes") do
+          options[:watch] = true
+        end
+      end.parse!
+      [ARGV, options]
+    end
+  end
+end
+
+RapperLite::CommandLine.new

data/rapper_lite.gemspec

@@ -5,14 +5,14 @@
 
 Gem::Specification.new do |s|
   s.name = "rapper_lite"
-  s.version = "0.1.1"
+  s.version = "0.1.2"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Tyson Tate"]
-  s.date = "2011-10-05"
+  s.date = "2011-10-09"
   s.description = "Simple static asset packaging. Compresses files only when they're updated."
   s.email = "tyson@tysontate.com"
-  s.executables = ["rapper_lite"]
+  s.executables = ["rapper-lite", "rapper_lite"]
   s.extra_rdoc_files = [
     "LICENSE.txt",
     "README.markdown"
@@ -24,6 +24,7 @@ Gem::Specification.new do |s|
     "README.markdown",
     "Rakefile",
     "VERSION",
+    "bin/rapper-lite",
     "bin/rapper_lite",
     "lib/rapper_lite.rb",
     "lib/rapper_lite/build.rb",
@@ -118,36 +119,36 @@ Gem::Specification.new do |s|
     s.specification_version = 3
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_development_dependency(%q<rake>, ["~> 0.9.2"])
+      s.add_runtime_dependency(%q<yui-compressor>, ["~> 0.9.6"])
+      s.add_runtime_dependency(%q<fssm>, ["~> 0.2.7"])
+      s.add_runtime_dependency(%q<rb-fsevent>, [">= 0"])
+      s.add_runtime_dependency(%q<coffee-script>, ["~> 2.2.0"])
+      s.add_development_dependency(%q<rake>, ["= 0.9.2"])
       s.add_development_dependency(%q<rspec>, ["~> 1.3.2"])
       s.add_development_dependency(%q<yard>, [">= 0"])
       s.add_development_dependency(%q<rdiscount>, ["~> 1.6.8"])
       s.add_development_dependency(%q<jeweler>, ["~> 1.6.4"])
-      s.add_development_dependency(%q<yui-compressor>, ["~> 0.9.6"])
-      s.add_development_dependency(%q<fssm>, ["~> 0.2.7"])
-      s.add_development_dependency(%q<rb-fsevent>, [">= 0"])
-      s.add_development_dependency(%q<coffee-script>, ["~> 2.2.0"])
     else
-      s.add_dependency(%q<rake>, ["~> 0.9.2"])
-      s.add_dependency(%q<rspec>, ["~> 1.3.2"])
-      s.add_dependency(%q<yard>, [">= 0"])
-      s.add_dependency(%q<rdiscount>, ["~> 1.6.8"])
-      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
       s.add_dependency(%q<yui-compressor>, ["~> 0.9.6"])
       s.add_dependency(%q<fssm>, ["~> 0.2.7"])
       s.add_dependency(%q<rb-fsevent>, [">= 0"])
       s.add_dependency(%q<coffee-script>, ["~> 2.2.0"])
+      s.add_dependency(%q<rake>, ["= 0.9.2"])
+      s.add_dependency(%q<rspec>, ["~> 1.3.2"])
+      s.add_dependency(%q<yard>, [">= 0"])
+      s.add_dependency(%q<rdiscount>, ["~> 1.6.8"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
     end
   else
-    s.add_dependency(%q<rake>, ["~> 0.9.2"])
-    s.add_dependency(%q<rspec>, ["~> 1.3.2"])
-    s.add_dependency(%q<yard>, [">= 0"])
-    s.add_dependency(%q<rdiscount>, ["~> 1.6.8"])
-    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
     s.add_dependency(%q<yui-compressor>, ["~> 0.9.6"])
     s.add_dependency(%q<fssm>, ["~> 0.2.7"])
     s.add_dependency(%q<rb-fsevent>, [">= 0"])
     s.add_dependency(%q<coffee-script>, ["~> 2.2.0"])
+    s.add_dependency(%q<rake>, ["= 0.9.2"])
+    s.add_dependency(%q<rspec>, ["~> 1.3.2"])
+    s.add_dependency(%q<yard>, [">= 0"])
+    s.add_dependency(%q<rdiscount>, ["~> 1.6.8"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
   end
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rapper_lite
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,110 +9,111 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-10-05 00:00:00.000000000 Z
+date: 2011-10-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rake
-  requirement: &70105090745260 !ruby/object:Gem::Requirement
+  name: yui-compressor
+  requirement: &70178373844640 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.9.2
-  type: :development
+        version: 0.9.6
+  type: :runtime
   prerelease: false
-  version_requirements: *70105090745260
+  version_requirements: *70178373844640
 - !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: &70105090744000 !ruby/object:Gem::Requirement
+  name: fssm
+  requirement: &70178373841380 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.3.2
-  type: :development
+        version: 0.2.7
+  type: :runtime
   prerelease: false
-  version_requirements: *70105090744000
+  version_requirements: *70178373841380
 - !ruby/object:Gem::Dependency
-  name: yard
-  requirement: &70105090743240 !ruby/object:Gem::Requirement
+  name: rb-fsevent
+  requirement: &70178373840080 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  type: :runtime
   prerelease: false
-  version_requirements: *70105090743240
+  version_requirements: *70178373840080
 - !ruby/object:Gem::Dependency
-  name: rdiscount
-  requirement: &70105090742340 !ruby/object:Gem::Requirement
+  name: coffee-script
+  requirement: &70178373839580 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.6.8
-  type: :development
+        version: 2.2.0
+  type: :runtime
   prerelease: false
-  version_requirements: *70105090742340
+  version_requirements: *70178373839580
 - !ruby/object:Gem::Dependency
-  name: jeweler
-  requirement: &70105090741660 !ruby/object:Gem::Requirement
+  name: rake
+  requirement: &70178373838980 !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ~>
+    - - =
       - !ruby/object:Gem::Version
-        version: 1.6.4
+        version: 0.9.2
   type: :development
   prerelease: false
-  version_requirements: *70105090741660
+  version_requirements: *70178373838980
 - !ruby/object:Gem::Dependency
-  name: yui-compressor
-  requirement: &70105090740380 !ruby/object:Gem::Requirement
+  name: rspec
+  requirement: &70178373838400 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.9.6
+        version: 1.3.2
   type: :development
   prerelease: false
-  version_requirements: *70105090740380
+  version_requirements: *70178373838400
 - !ruby/object:Gem::Dependency
-  name: fssm
-  requirement: &70105090739480 !ruby/object:Gem::Requirement
+  name: yard
+  requirement: &70178373837680 !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ~>
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: 0.2.7
+        version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70105090739480
+  version_requirements: *70178373837680
 - !ruby/object:Gem::Dependency
-  name: rb-fsevent
-  requirement: &70105090737600 !ruby/object:Gem::Requirement
+  name: rdiscount
+  requirement: &70178373836940 !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.6.8
   type: :development
   prerelease: false
-  version_requirements: *70105090737600
+  version_requirements: *70178373836940
 - !ruby/object:Gem::Dependency
-  name: coffee-script
-  requirement: &70105090735640 !ruby/object:Gem::Requirement
+  name: jeweler
+  requirement: &70178373836300 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 2.2.0
+        version: 1.6.4
   type: :development
   prerelease: false
-  version_requirements: *70105090735640
+  version_requirements: *70178373836300
 description: Simple static asset packaging. Compresses files only when they're updated.
 email: tyson@tysontate.com
 executables:
+- rapper-lite
 - rapper_lite
 extensions: []
 extra_rdoc_files:
@@ -125,6 +126,7 @@ files:
 - README.markdown
 - Rakefile
 - VERSION
+- bin/rapper-lite
 - bin/rapper_lite
 - lib/rapper_lite.rb
 - lib/rapper_lite/build.rb
@@ -223,7 +225,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3082783424749448526
+      hash: 2634545149066051193
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: