homeostasis 0.0.2

data/LICENSE.md

@@ -0,0 +1,23 @@
+Copyright (c) 2012, Hugh Bien
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+Redistributions of source code must retain the above copyright notice, this list
+of conditions and the following disclaimer.
+
+Redistributions in binary form must reproduce the above copyright notice, this
+list of conditions and the following disclaimer in the documentation and/or
+other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,83 @@
+Description
+===========
+
+Stasis plugin for asset stamping with git revisions, environment branching,
+and uri helpers.
+
+Installation
+============
+
+    % gem install homeostasis
+
+In your controller:
+
+    require 'rubygems'
+    require 'homeostasis/asset'   # for asset stamping
+    require 'homeostasis/env'     # for environment handler
+    require 'homeostasis/path'    # for path helpers
+
+Each component is optional.
+
+Usage
+=====
+
+By default, assets matching `/\.(jpg|png|gif|css|js)$/i` will be stamped.
+So if your root directory is like this:
+
+    background.jpg
+    index.html.haml
+    script.js
+    styles.css
+
+You'll end up with something like this:
+
+    background.sha1.jpg
+    index.html
+    script.sha1.js
+    styles.sha1.css
+
+In your views, use the `asset_path` helper:
+
+    %img{:src => asset_path('background.jpg')}
+
+For CSS files, I use the extension `.erb` like `styles.css.erb`:
+
+    background: url(<%= asset_path('background.jpg') %>);
+
+You can set the regex for asset matching in your controller:
+
+    Homeostasis::Asset.matcher = /myregex$/i
+
+You can even concat your assets into a single file:
+
+    # in controller.rb
+    Homeostasis::Asset.concat 'all.js', %w(jquery.js mine.js)
+    Homeostasis::Asset.concat 'all.css', %w(reset.css mine.css)
+
+    # in views
+    %link{:href => asset_path('all.css')}
+    %script{:src => asset_path('all.js')}
+
+The environment handler just adds a variable:
+
+    Homeostasis::ENV
+
+It's set to whatever `HOMEOSTASIS_ENV` or `'development'` by default.  You
+can use this to branch in your view:
+
+    = Homeostasis::ENV.development? ? 'local.js' : 'production.js'
+
+The path helper uses the environment handler.  It just adds the view helper
+`path` which returns differently depending on the environment:
+
+    path('/blog')  # development => '/blog.html' 
+    path('/blog')  # production  => '/blog/' 
+
+This goes along well with an `htaccess` file that drops the `.html` extensions
+from requests and adds trailing slashes.
+
+License
+=======
+
+Copyright 2012 Hugh Bien - http://hughbien.com.
+Released under BSD License, see LICENSE.md for more info.

data/lib/homeostasis/asset.rb

@@ -0,0 +1,108 @@
+require File.join(File.dirname(__FILE__), '..', 'homeostasis')
+
+class Homeostasis::Asset < Stasis::Plugin
+  before_all    :before_all
+  after_all     :after_all
+  action_method :asset_path 
+
+  def initialize(stasis)
+    @stasis = stasis
+    @@matcher = /\.(jpg|png|gif|css|js)/i
+    @@mapping = {}
+    @@concats = {}
+  end
+
+  def before_all
+    @stasis.paths.each do |path|
+      relative = path[(@stasis.root.length+1)..-1]
+      ext = Tilt.mappings.keys.find { |ext| File.extname(path)[1..-1] == ext }
+      dest = (ext && File.extname(relative) == ".#{ext}") ?
+        relative[0..-1*ext.length-2] :
+        relative
+      @@mapping[relative] = dest
+    end
+    imapping = @@mapping.invert
+    @@concats.each do |dest, files|
+      full_origs = files.map do |file|
+        orig = imapping[file]
+        raise "Asset not found #{file}" if orig.nil?
+        File.join(@stasis.root, imapping[file])
+      end
+      @@concats[dest] = full_origs
+    end
+  end
+
+  def after_all
+    @@concats.each do |concatted, files|
+      version = self.class.version(files)
+      full_concatted = File.join(@stasis.destination, concatted)
+      full_concatted = self.class.stamped(full_concatted, version)
+      content = files.map do |full_orig|
+        orig = full_orig[(@stasis.root.length+1)..-1]
+        full_dest = File.join(@stasis.destination, @@mapping[orig])
+        raise "File not found #{full_dest}" if !File.exists?(full_dest)
+        file_contents = File.read(full_dest)
+        @@mapping.delete(orig)
+        File.delete(full_dest)
+        file_contents
+      end.join("\n")
+      File.open(full_concatted, 'w') {|f| f.print(content)}
+    end
+    @@mapping.each do |orig, dest|
+      next if dest !~ @@matcher
+      full_orig = File.join(@stasis.root, orig)
+      full_dest = File.join(@stasis.destination, dest)
+      version = self.class.version(full_orig)
+      File.rename(full_dest, self.class.stamped(full_dest, version))
+    end
+  end
+
+  def asset_path(path)
+    dest = path =~ /^\// ? path[1..-1] : path
+    if (concats = self.class.concats[dest])
+      self.class.stamped(path, self.class.version(concats))
+    else
+      orig = self.class.mapping.invert[dest]
+      raise "Asset not found: #{dest}" if orig.nil?
+      full_orig = File.join(@_stasis.root, orig)
+      self.class.stamped(path, self.class.version(full_orig))
+    end
+  end
+
+  def self.stamped(path, version)
+    path = path.split('.')
+    path.insert(
+      path.length > 1 ? -2 : -1,
+      version)
+    path.join('.')
+  end
+
+  def self.version(paths)
+    paths = [paths] if !paths.is_a?(Array)
+    versions = paths.map do |path|
+      log = `git log -n1 #{path} 2> /dev/null`.split("\n")
+      log.length > 1 ? log[0].split(' ').last : '0'
+    end
+    versions.size == 1 ?
+      versions[0] :
+      Digest::SHA1.hexdigest(versions.join('.'))
+  end
+
+  def self.matcher=(regex)
+    @@matcher = regex
+  end
+
+  def self.mapping
+    @@mapping
+  end
+
+  def self.concat(dest, files)
+    @@concats[dest] = files
+  end
+
+  def self.concats
+    @@concats
+  end
+end
+
+Stasis.register(Homeostasis::Asset)

data/lib/homeostasis/env.rb

@@ -0,0 +1,19 @@
+require File.join(File.dirname(__FILE__), '..', 'homeostasis')
+
+module Homeostasis
+  class Environment
+    def initialize(env)
+      @env = env
+    end
+
+    def method_missing(message, *args, &block)
+      if message =~ /\?$/
+        @env == message[0..-2]
+      else
+        super
+      end
+    end
+  end
+
+  ENV = Environment.new(::ENV['HOMEOSTASIS_ENV'] || 'development')
+end

data/lib/homeostasis/path.rb

@@ -0,0 +1,18 @@
+require File.join(File.dirname(__FILE__), 'env')
+
+class Homeostasis::Path < Stasis::Plugin
+  action_method :path
+
+  def initialize(stasis)
+    @stasis = stasis
+  end
+
+  def path(uri)
+    uri = uri[0..-2] if uri =~ /\/$/
+    Homeostasis::ENV.development? ?
+      "#{uri}.html" :
+      "#{uri}/"
+  end
+end
+
+Stasis.register(Homeostasis::Path)

data/lib/homeostasis.rb

@@ -0,0 +1,3 @@
+module Homeostasis
+  VERSION = '0.0.2'
+end

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: homeostasis
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
+platform: ruby
+authors:
+- Hugh Bien
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-02-18 00:00:00.000000000 Z
+dependencies: []
+description: Provides asset stamping using git revisions, environments, and a few
+  view helpers.
+email:
+- hugh@hughbien.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- LICENSE.md
+- lib/homeostasis/asset.rb
+- lib/homeostasis/env.rb
+- lib/homeostasis/path.rb
+- lib/homeostasis.rb
+homepage: https://github.com/hughbien/homeostasis
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: Stasis plugin for asset stamping and more.
+test_files: []