stackable_flash 0.0.1 → 0.0.2

data/CHANGELOG

@@ -1,2 +1,6 @@
+Version 0.0.2 - AUG.18.2012
+- Added rake dependency
+- Expanded README
+
 Version 0.0.1 - AUG.17.2012
 - Initial Release!

data/README.md

@@ -1,7 +1,13 @@
 stackable_flash
 ===============
 
-Stackable Flash overrides the :[]= method of Rails' FlashHash to make it work like Array's :<< method instead, and makes each flash key an array.
+Allows flashes to stack intelligently, while preserving existing behavior of Rails' FlashHash.
+
+Stackable Flash overrides the :[]= method of Rails' FlashHash with the result being that each flash key is an array.
+It is designed following the "Principle of least surprise", so in most ways the flash works as it always has.
+Only now you can push things onto the array with `:<<`, and generally interact with the flash as an array.
+In order to be as compatible as possible with existing implementations of the FlashHash on websites, `:[]=` will still
+replace the entire object at that key.
 
 ## Installation
 
@@ -17,6 +23,23 @@ Or install it yourself as:
 
     $ gem install stackable_flash
 
+## Config (Optional)
+
+In an environment file, or application.rb
+
+    # Here are a few ideas (Don't do them all, pick one):
+    # You can use a lambda instead of a proc
+    StackableFlash::Config.configure do
+      # Leave it as an array
+      config[:stack_with_proc] = Proc.new {|arr| arr } )
+      # Make a set of statements separated by br tags
+      config[:stack_with_proc] = Proc.new {|arr| arr.join('<br/>') } )   # THIS IS DEFAULT IF LEFT UNCONFIGURED
+      # Make a set of p tags:
+      config[:stack_with_proc] = Proc.new {|arr| arr.map! {|x| "<p>#{x}</p>"}.join } } )
+      # Make an unordered list of tags:
+      config[:stack_with_proc] = Proc.new {|arr| '<ul>' + arr.map! {|x| "<li>#{x}</li>"}.join + '</ul> } } )
+    end
+
 ## Usage
 
 When turned on all flashes can be interacted with as arrays.
@@ -59,6 +82,7 @@ There are block helpers which I am sure some enterprising individual will have a
       flash[:notice] = 'original'
       flash[:notice] << 'message'
       flash[:notice]        # => ['original','message']
+      # Uses the :stack_with_proc to transform
       flash[:notice].stack  # => '<p>original</p><p>message</p>'
     end
 
@@ -68,6 +92,7 @@ And
       flash[:notice] = 'original'
       flash[:notice] << ' message'
       flash[:notice]        # => 'original message'
+      # Uses the :stack_with_proc to transform
       flash[:notice].stack  # => NoMethodError !!!
     end
 

data/lib/stackable_flash/version.rb

@@ -1,3 +1,3 @@
 module StackableFlash
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/stackable_flash.gemspec

@@ -21,6 +21,7 @@ Gem::Specification.new do |gem|
   gem.add_development_dependency(%q<rspec-rails>, [">= 2.11.0"])
   gem.add_development_dependency(%q<reek>, [">= 1.2.8"])
   gem.add_development_dependency(%q<roodi>, [">= 2.1.0"])
+  gem.add_development_dependency(%q<rake>, [">= 0"])
 
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stackable_flash
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-17 00:00:00.000000000 Z
+date: 2012-08-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -91,6 +91,22 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: 2.1.0
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Allows flashes to stack intelligently, while preserving existing behavior
   of the Rails FlashHash
 email: