piano 0.10.6 → 0.10.7

data/README.rdoc

@@ -190,6 +190,34 @@ Another helper you may find useful is <tt>extract("source_text/html", word_count
 
   %p= extract content, 25
 
+=== <tt>flash</tt> & <tt>flash?</tt>
+
+Most times on a POST request the server performs an action and you want to give the user some feedback about that action. The data for that feedback has become known as "flash text" steming from the Rails argot.
+
+Piano provides <tt>flash</tt> for you, ease to use. A sample
+
+==== Pianofile
+  
+  post "/article/new" do
+    Article.create params             # ActiveRecord-like article creation
+    
+    flash "The article was created"   # You set the flash text by calling `flash` 
+                                      # with an argument
+  end
+
+==== articles.haml
+
+  %html
+    %head
+      %title Articles index
+    %body
+      - if flash? # Checks if any flash text is setted
+        %output= flash
+
+<tt>flash</tt> called without an argument destructively returns the flash text. Destructively so further request to <tt>/articles</tt> (which in this case will bring up <tt>articles.haml</tt>) will not display the flash text. 
+
+Internally, <tt>flash</tt> and <tt>flash?</tt> set and check the <tt>session[:flash]</tt> object.
+
 Code is poetry.
 
 === Etags

data/lib/piano/version.rb

@@ -1,3 +1,3 @@
 module Piano
-  VERSION = "0.10.6"
+  VERSION = "0.10.7"
 end

data/lib/sinatra/piano.rb

@@ -131,10 +131,29 @@ module Sinatra
       end
     end
     
+    # Returns the session[:flash] if is defined, nil otherwise
+    def flash?  
+      session[:flash]
+    end
+
+    # If an argument is passed, it sets the `session[:flash]` to the passed argument
+    #
+    # Otherwise, returns `session[:flash]` and removes `:flash` from the `session`
+    # hash to make it available for subsequent requests.
+    def flash data = nil
+      if data
+        session[:flash] = data
+      else
+        flash_text = session[:flash]
+        session.delete :flash
+        return flash_text
+      end
+    end
+    
     # Non implemented yet
     def t(key)
       I18n.translate key
-    end
+    end   
   end
   
   register Piano

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: piano
 version: !ruby/object:Gem::Version
-  version: 0.10.6
+  version: 0.10.7
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-11-16 00:00:00.000000000 Z
+date: 2011-12-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sinatra
-  requirement: &16774000 !ruby/object:Gem::Requirement
+  requirement: &70397330 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: 1.2.6
   type: :runtime
   prerelease: false
-  version_requirements: *16774000
+  version_requirements: *70397330
 - !ruby/object:Gem::Dependency
   name: haml
-  requirement: &16772720 !ruby/object:Gem::Requirement
+  requirement: &70397010 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: 3.1.1
   type: :runtime
   prerelease: false
-  version_requirements: *16772720
+  version_requirements: *70397010
 - !ruby/object:Gem::Dependency
   name: sass
-  requirement: &16770960 !ruby/object:Gem::Requirement
+  requirement: &70396690 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: 3.1.1
   type: :runtime
   prerelease: false
-  version_requirements: *16770960
+  version_requirements: *70396690
 - !ruby/object:Gem::Dependency
   name: coffee-script
-  requirement: &16770080 !ruby/object:Gem::Requirement
+  requirement: &70396360 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +54,10 @@ dependencies:
         version: 2.2.0
   type: :runtime
   prerelease: false
-  version_requirements: *16770080
+  version_requirements: *70396360
 - !ruby/object:Gem::Dependency
   name: i18n
-  requirement: &16769340 !ruby/object:Gem::Requirement
+  requirement: &70449840 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,10 +65,10 @@ dependencies:
         version: 0.6.0
   type: :runtime
   prerelease: false
-  version_requirements: *16769340
+  version_requirements: *70449840
 - !ruby/object:Gem::Dependency
   name: polyglot
-  requirement: &16768600 !ruby/object:Gem::Requirement
+  requirement: &70449430 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -76,10 +76,10 @@ dependencies:
         version: 0.3.1
   type: :runtime
   prerelease: false
-  version_requirements: *16768600
+  version_requirements: *70449430
 - !ruby/object:Gem::Dependency
   name: metafun
-  requirement: &16756100 !ruby/object:Gem::Requirement
+  requirement: &70448730 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -87,10 +87,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *16756100
+  version_requirements: *70448730
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &16755220 !ruby/object:Gem::Requirement
+  requirement: &70448160 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -98,7 +98,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *16755220
+  version_requirements: *70448160
 description: Out-of-the-box sinatra server for web site sketching using haml + sass
   + coffee-script
 email:
@@ -150,4 +150,3 @@ specification_version: 3
 summary: Out-of-the-box sinatra server for web site sketching using haml + sass +
   coffee-script
 test_files: []
-has_rdoc: