homeostasis 0.0.6 → 0.0.7

data/README.md

@@ -1,8 +1,8 @@
 Description
 ===========
 
-Stasis plugin for asset stamping with git revisions, environment branching,
-and uri helpers.
+Stasis plugin for asset stamping with git revisions, yaml front-matter,
+environment branching, and uri helpers.
 
 Installation
 ============
@@ -13,13 +13,14 @@ In your controller:
 
     require 'rubygems'
     require 'homeostasis/asset'   # for asset stamping
+    require 'homeostasis/front'   # for yaml front-matter
     require 'homeostasis/env'     # for environment handler
     require 'homeostasis/path'    # for path helpers
 
 Each component is optional.
 
-Usage
-=====
+Asset Stamping
+==============
 
 By default, assets matching `/\.(jpg|png|gif|css|js)$/i` will be stamped.
 So if your root directory is like this:
@@ -58,6 +59,9 @@ You can even concat your assets into a single file:
     %link{:href => asset_path('all.css')}
     %script{:src => asset_path('all.js')}
 
+Environment Handler
+===================
+
 The environment handler just adds a variable:
 
     Homeostasis::ENV
@@ -67,6 +71,44 @@ can use this to branch in your view:
 
     = Homeostasis::ENV.development? ? 'local.js' : 'production.js'
 
+YAML Front-matter
+=================
+
+This adds YAML front-matter support:
+
+    #!
+      :title: Lorem Ipsum
+      :desc:  Quick fox over lazy dog.
+    %div
+      Page continues as normal here
+    %h1= front[:title]
+    %p= front[:desc]
+
+Note the 2-space indentation is required.  This works for HTML, Markdown, and
+ERB comments as well:
+
+    <!--
+      :title: Lorem Ipsum
+    -->
+    Continue as normal
+
+You can configure which files to check in `controller.rb`.  Here's the default:
+
+    Homeostasis::Front.matchers = {
+      'erb'  => /<%#/,
+      'haml' => /-#/,
+      'html' => /<!--/,
+      'md'   => /<!--/
+    }
+
+Just start the file with YAML inside a comment with 2-space indentation.  The
+data will be available from the `front` method in your views and controller.
+There's also a `front_site` helper which contains the data for all pages for
+cross-page access.
+
+Path Helper
+===========
+
 The path helper uses the environment handler.  It just adds the view helper
 `path` which returns differently depending on the environment:
 

data/lib/homeostasis/front.rb

@@ -0,0 +1,64 @@
+require File.join(File.dirname(__FILE__), '..', 'homeostasis')
+require 'yaml'
+
+class Homeostasis::Front < Stasis::Plugin
+  before_all    :before_all
+  action_method :front
+  action_method :front_site
+
+  def initialize(stasis)
+    @stasis = stasis
+    @front_site = {}
+    @@matchers = {
+      'erb'  => /<%#/,
+      'haml' => /-#/,
+      'html' => /<!--/,
+      'md'   => /<!--/
+    }
+  end
+
+  def before_all
+    @stasis.paths.each do |path|
+      next if path !~ /\.(#{@@matchers.keys.join('|')})$/
+      contents = File.read(path)
+      next if contents !~ @@matchers[File.extname(path)[1..-1]]
+
+      lines, data, index = contents.split("\n"), "", 1
+      while index < lines.size
+        break if lines[index] !~ /^  /
+        data += lines[index] + "\n"
+        index += 1
+      end
+      
+      begin
+        yaml = YAML.load(data)
+        @front_site[front_key(path)] = yaml if yaml.is_a?(Hash)
+      rescue Psych::SyntaxError => error
+        next
+      end
+    end
+  end
+
+  def front
+    @front_site[front_key(@stasis.path)] || {}
+  end
+
+  def front_site
+    @front_site
+  end
+
+  def self.matchers
+    @@matchers
+  end
+
+  def self.matchers=(ext)
+    @@matchers = ext
+  end
+
+  private
+  def front_key(filename)
+    filename.sub(Dir.pwd, '')[1..-1].sub(/\.[^.]+$/, '')
+  end
+end
+
+Stasis.register(Homeostasis::Front)

data/lib/homeostasis.rb

@@ -1,3 +1,3 @@
 module Homeostasis
-  VERSION = '0.0.6'
+  VERSION = '0.0.7'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: homeostasis
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-06-16 00:00:00.000000000 Z
+date: 2012-07-28 00:00:00.000000000 Z
 dependencies: []
 description: Provides asset stamping using git revisions, environments, and a few
   view helpers.
@@ -22,6 +22,7 @@ files:
 - LICENSE.md
 - README.md
 - lib/homeostasis/env.rb
+- lib/homeostasis/front.rb
 - lib/homeostasis/path.rb
 - lib/homeostasis/asset.rb
 - lib/homeostasis.rb