sinatra-settings 0.1.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,23 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+doc
+
+## PROJECT::SPECIFIC
+spec/fixtures/

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 kematzy
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,133 @@
+= Sinatra::Settings
+
+A Sinatra Extension that shows your app's settings and other debug information.
+
+Ever wanted an overview of all Sinatra settings (formerly options) in your app? 
+
+Well, now you can through this Sinatra Extension which makes that task dead simple, 
+while also adding in some other useful debug information in the output.
+
+With a heavy dose of inspiration taken from Sinatra's Show Exception output page.
+
+
+== Installation
+
+  #  Add Gemcutter to your RubyGems sources 
+  $  gem sources -a http://gemcutter.com
+
+  $  (sudo)? gem install sinatra-settings
+
+== Dependencies
+
+This Gem depends upon the following:
+
+=== Runtime:
+
+* sinatra ( >= 1.0.a )
+
+
+=== Development & Tests:
+
+* rspec (>= 1.3.0 )
+* rack-test (>= 0.5.3)
+* rspec_hpricot_matchers (>= 0.1.0)
+* sinatra-tests (>= 0.1.6)
+
+
+== Getting Started
+
+To view the settings in your app, just require and register the extension 
+in your sub-classed Sinatra app:
+  
+  require 'sinatra/settings'
+  
+  class YourApp < Sinatra::Base
+    
+    register(Sinatra::Settings)
+    
+    enable :show_settings   # turn it on 
+    
+    <snip...>
+  end
+
+
+Then at the bottom of your App's layout - <tt>layout.(erb|haml)</tt> add the following:
+
+
+      <snip...>
+      
+      <%= show_settings_output? %>
+      
+    </body>
+  </html>
+
+
+Reload your app and view the added content at the bottom of your page.
+
+You can see an example of the output here:
+
+http://kematzy.com/tmp/sinatra-settings/sinatra-settings-extension-output-50.jpg 
+
+
+
+That's really all there is.
+
+
+== Configuration Options
+
+By default, these are the settings:
+  
+  
+  # don't show settings by default
+  set :show_settings, false
+  
+  # only show the settings in development mode.
+  set :show_settings_environment, :development
+
+
+Apart from turning it On / Off, you can also set the output to show up 
+in <tt>:production</tt> or <tt>:test</tt> enviroments.
+
+The advantage of having two configuration 'switches' is that you can leave 
+all the code as is, and in +:development+  it will show the output, but in
+<tt>:production</tt> no output will be shown 
+(other than a tiny HTML comment telling you it's Off)
+
+
+That's it. I hope that's easy enough.
+
+
+== RTFM
+
+If the above is not clear enough, please check the Specs for a better understanding.
+
+
+== Errors / Bugs
+
+If something is not behaving intuitively, it is a bug, and should be reported.
+Report it here: http://github.com/kematzy/sinatra-settings/issues 
+
+
+== TODOs
+
+* Decide whether this functionality should really be incorporated into a 
+  Sinatra::Debug extension instead.
+
+* Any other improvements you or I can think of.
+
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  * (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2010 kematzy. Released under the MIT License.
+
+See LICENSE for details.

data/Rakefile

@@ -0,0 +1,90 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "sinatra-settings"
+    gem.summary = %Q{A Sinatra Extension that shows your app's settings and other debug information}
+    gem.description = %Q{Want an overview of all Sinatra settings (formerly options) in your app? This Sinatra Extension makes that dead simple.}
+    gem.email = "kematzy@gmail.com"
+    gem.homepage = "http://github.com/kematzy/sinatra-settings"
+    gem.authors = ["kematzy"]
+    gem.add_dependency "sinatra", ">= 0.10.1"
+    gem.add_development_dependency "sinatra-tests", ">= 0.1.6"
+    gem.add_development_dependency "rspec", ">= 1.3.0"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_opts = ["--color", "--format", "specdoc", "--require", "spec/spec_helper.rb"]  
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_opts = ["--color", "--format", "specdoc", "--require", "spec/spec_helper.rb"]
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+namespace :spec do
+  
+  desc "Run all specifications quietly"
+  Spec::Rake::SpecTask.new(:quiet) do |t|
+    t.libs << "lib"
+    t.spec_opts = ["--color", "--require", "spec/spec_helper.rb"]
+  end
+  
+  desc "Run specific spec (SPEC=/path/2/file)"
+  Spec::Rake::SpecTask.new(:select) do |t|
+    t.libs << "lib"
+    t.spec_files = [ENV["SPEC"]]
+    t.spec_opts = ["--color", "--format", "specdoc", "--require", "spec/spec_helper.rb"] 
+  end
+  
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "sinatra-settings #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+
+desc 'Build the rdoc HTML Files'
+task :docs do
+  version = File.exist?('VERSION') ? IO.read('VERSION').chomp : "[Unknown]"
+    
+  sh "sdoc -N --title 'Sinatra::Settings v#{version}' lib/ README.rdoc"
+end
+
+namespace :docs do
+  
+  desc 'Remove rdoc products'
+  task :remove => [:clobber_rdoc]
+  
+  desc 'Force a rebuild of the RDOC files'
+  task :rebuild => [:rerdoc]
+  
+  desc 'Build docs, and open in browser for viewing (specify BROWSER)'
+  task :open => [:docs] do
+    browser = ENV["BROWSER"] || "safari"
+    sh "open -a #{browser} doc/index.html"
+  end
+  
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/sinatra/settings.rb

@@ -0,0 +1,428 @@
+
+require 'sinatra/base'
+
+
+module Sinatra
+  
+  # :stopdoc:
+  ##
+  # Add :sinatra_settings_for_inspection setting to base, so that it's 
+  # always available
+  # 
+  class Base
+    
+    set :sinatra_settings_for_inspection, %w(
+      app_file bind clean_trace dump_errors environment lock 
+      logging method_override port public raise_errors reload_templates
+      root run running server sessions show_exceptions static views
+    )
+    
+  end #/class Base
+  
+  # :startdoc:
+  
+  # = Sinatra::Settings
+  # 
+  # A Sinatra Extension that shows your app's settings and other debug information.
+  # 
+  # Ever wanted an overview of all Sinatra settings (formerly options) in your app? 
+  # 
+  # Well, now you can through this Sinatra Extension which makes that task dead simple, 
+  # while also adding in some other useful debug information in the output.
+  # 
+  # With a heavy dose of inspiration taken from Sinatra's Show Exception output page.
+  # 
+  # 
+  # == Installation
+  # 
+  #   #  Add Gemcutter to your RubyGems sources 
+  #   $  gem sources -a http://gemcutter.com
+  # 
+  #   $  (sudo)? gem install sinatra-settings
+  # 
+  # == Dependencies
+  # 
+  # This Gem depends upon the following:
+  # 
+  # === Runtime:
+  # 
+  # * sinatra ( >= 1.0.a )
+  # 
+  # 
+  # === Development & Tests:
+  # 
+  # * rspec (>= 1.3.0 )
+  # * rack-test (>= 0.5.3)
+  # * rspec_hpricot_matchers (>= 0.1.0)
+  # * sinatra-tests (>= 0.1.6)
+  # 
+  # 
+  # == Getting Started
+  # 
+  # To view the settings in your app, just require and register the extension 
+  # in your sub-classed Sinatra app:
+  # 
+  #   require 'sinatra/settings'
+  # 
+  #   class YourApp < Sinatra::Base
+  # 
+  #     register(Sinatra::Settings)
+  # 
+  #     enable :show_settings   # turn it on 
+  # 
+  #     <snip...>
+  #   end
+  # 
+  # 
+  # Then at the bottom of your App's layout - <tt>layout.(erb|haml)</tt> add the following:
+  # 
+  # 
+  #       <snip...>
+  # 
+  #       <%= show_settings_output? %>
+  # 
+  #     </body>
+  #   </html>
+  # 
+  # 
+  # Reload your app and view the added content at the bottom of your page.
+  # 
+  # You can see an example of the output here:
+  # 
+  # http://kematzy.com/tmp/sinatra-settings/sinatra-settings-extension-output-50.jpg 
+  # 
+  # 
+  # That's really all there is.
+  # 
+  # 
+  # == Configuration Options
+  # 
+  # By default, these are the settings:
+  # 
+  # 
+  #   # don't show settings by default
+  #   set :show_settings, false
+  # 
+  #   # only show the settings in development mode.
+  #   set :show_settings_environment, :development
+  # 
+  # 
+  # Apart from turning it On / Off, you can also set the output to show up 
+  # in <tt>:production</tt> or <tt>:test</tt> enviroments.
+  # 
+  # The advantage of having two configuration 'switches' is that you can leave 
+  # all the code as is, and in +:development+  it will show the output, but in
+  # <tt>:production</tt> no output will be shown 
+  # (other than a tiny HTML comment telling you it's Off)
+  # 
+  # 
+  # That's it. I hope that's easy enough.
+  # 
+  # 
+  # == TODOs
+  # 
+  # * Decide whether this functionality should really be incorporated into a 
+  #   Sinatra::Debug extension instead.
+  # 
+  # * Any other improvements you or I can think of.
+  # 
+  # == Copyright
+  # 
+  # Copyright (c) 2010 kematzy. Released under the MIT License.
+  # 
+  # See LICENSE for details.
+  # 
+  
+  module Settings
+    
+    VERSION = '0.1.0' unless const_defined?(:VERSION)
+    def self.version; "Sinatra::Settings v#{VERSION}"; end
+    
+    
+    module Helpers
+      
+      # Add Rack::Utils if not already present
+      unless respond_to?(:h)
+        include Rack::Utils
+        alias_method :h, :escape_html
+      end
+      
+      
+      ##
+      # Convenience helper method that returns a Hash, nicely
+      # formatted with all 'registered' settings in the app.
+      # 
+      # Mainly used in the HTML output of :show_settings_output? method,
+      # but can be used for other debug purposes.
+      #  
+      # ==== Examples
+      # 
+      #   settings_inspect => {...} # a Hash with settings.
+      # 
+      # 
+      # @api public
+      def settings_inspect 
+        out = {}
+        settings.sinatra_settings_for_inspection.uniq.each do |s|
+          out[s.to_sym] = self.class.respond_to?(s.to_sym) ? self.class.send(s) : nil
+        end
+        out
+      end
+      
+      
+      ##
+      # Add settings debug output to the page. 
+      # Controlled by the following configurations:
+      # 
+      # * set :show_settings_output, (boolean) => turns output On / Off
+      # * set :show_settings_environment, (symbol) :development/:production => turns output On in the given environment
+      #  
+      # ==== Examples
+      # 
+      #   <%= show_settings_output? %>  => will output the settings debug if enabled.
+      # 
+      # @api public/private
+      def show_settings_output?
+        if _show_settings_output?
+          erb(TEMPLATE, :layout => false)
+        else
+          "<!-- :show_settings is [#{settings.show_settings ? 'ON' : 'OFF'}]  -->"
+        end
+      end
+      
+      
+      protected
+        
+        # :stopdoc:
+        
+        def _show_settings_output?
+          return (
+            settings.show_settings === true && 
+            ( settings.show_settings_environment == (settings.environment || :development) )
+          )
+        end
+      
+      
+TEMPLATE = <<HTML
+<style type="text/css" media="screen">
+  #debug { border: 1px solid #ccc; background: #fff; width: 870px; margin: 2em auto; font-family: 'Lucida Grande', 'Lucida Sans Unicode', 'Garuda';}
+  #debug h2 { text-align: center; border-bottom: 1px solid #ccc; background-color: #eee; font-size: 1.4em; }
+  #explanation { text-align: center; }
+  #debug h3 { margin: 1em 0 0.2em 0.4em; }
+  #settings, #params, #get, #post, #cookies, #sessions, #rack { width: 860px; margin: 0 auto 10px auto;}
+  p.no-data {padding-top: 2px; color: #666; margin: -1.8em 0 0.8em 10em; }
+  table.req { width: 850px; text-align: left; color: #666; padding: 0; border-spacing: 0; border: 1px solid #eee; border-bottom: 0; border-left: 0; margin: 0 auto;}
+   table.req tr th { padding: 2px 10px; font-weight: bold; background: #F7F7F7; border-bottom: 1px solid #eee; border-left: 1px solid #eee;}
+   table.req tr td { padding: 2px 20px 2px 10px; border-bottom: 1px solid #eee;  border-left: 1px solid #eee; }
+   table.req tr td.key  {vertical-align: top; width: 150px;}  
+   /* table.req tr td.code { white-space: pre-wrap; word-wrap: break-word; } */
+   table.req tr td.key { width: 200px; overflow:hidden; } 
+   table.req tr td.code div { width: 650px; overflow:hidden; } 
+
+</style>
+
+<div id="debug">
+
+  <h2>PAGE DEBUG</h2>
+
+  <div id="get">
+   <h3>GET</h3>
+   <% unless request.GET.empty? %>
+     <table class="req">
+       <tr>
+         <th>Variable</th>
+         <th>Value</th>
+       </tr>
+        <% request.GET.sort_by { |k, v| k.to_s }.each { |key, val| %>
+       <tr>
+         <td class="key"><%=h key %></td>
+         <td class="code"><div><%=h val.inspect %></div></td>
+       </tr>
+       <% } %>
+     </table>
+   <% else %>
+     <p class="no-data">No GET data.</p>
+   <% end %>
+   <div class="clear"></div>
+  </div> <!-- /GET -->
+
+  <hr>
+
+  <div id="params">
+    <h3>PARAMS</h3>
+    <% unless params.empty? %>
+      <table class="req">
+        <tr>
+          <th>Variable</th>
+          <th>Value</th>
+        </tr>
+         <% params.sort_by { |k, v| k.to_s }.each { |key, val| %>
+         <tr>
+           <td class="key"><%=h key %></td>
+           <td class="code"><div><%=h val %></div></td>
+         </tr>
+         <% } %>
+      </table>
+    <% else %>
+      <p class="no-data">No PARAMS data.</p>
+    <% end %>
+    <div class="clear"></div>
+  </div> <!-- /PARAMS -->
+
+  <hr>
+
+  <div id="sessions">
+    <h3>SESSIONS</h3>
+    <% unless session.empty? %>
+      <table class="req">
+        <tr>
+          <th>Variable</th>
+          <th>Value</th>
+        </tr>
+         <% session.sort_by { |k, v| k.to_s }.each { |key, val| %>
+         <tr>
+           <td class="key"><%=h key %></td>
+           <td class="code"><div><%=h val.inspect %></div></td>
+         </tr>
+         <% } %>
+      </table>
+    <% else %>
+      <p class="no-data">No SESSION data.</p>
+    <% end %>
+    <div class="clear"></div>
+  </div> <!-- /SESSIONS -->
+
+  <hr>
+
+  <div id="cookies">
+    <h3>COOKIES</h3>
+    <% unless request.cookies.empty? %>
+      <table class="req">
+        <tr>
+          <th>Variable</th>
+          <th>Value</th>
+        </tr>
+        <% request.cookies.each { |key, val| %>
+          <tr>
+            <td class="key"><%=h key %></td>
+            <td class="code"><div><%= nl2br(val) %></div></td>
+          </tr>
+        <% } %>
+      </table>
+    <% else %>
+      <p class="no-data">No COOKIE data.</p>
+    <% end %>
+    <div class="clear"></div>
+  </div> <!-- /COOKIES -->
+
+  <hr>
+
+  <div id="routes">
+    <h3>ROUTES</h3>
+    <% r = self.methods.sort.reject { |i|  i !~ /^(DELETE|GET|POST|PUT)\s/ } %>
+    <% unless r.empty? %>
+      <table class="req">
+        <tr>
+          <th>Verb</th>
+          <th>Path</th>
+        </tr>
+        <% r.each { |route| %>
+          <tr>
+            <td class="key"><%=h route.split(' ').first %></td>
+            <td class="code"><div><%= request.script_name %><%=h route.split(' ')[1] %></div></td>
+          </tr>
+        <% } %>
+      </table>
+    <% else %>
+      <p class="no-data">No ROUTES declared.</p>
+    <% end %>
+    <div class="clear"></div>
+  </div> <!-- /ROUTES -->
+
+  <hr>
+
+  <div id="settings">
+    <h3>SETTINGS</h3>
+    <table class="req">
+      <tr>
+        <th>Variable</th>
+        <th>Value</th>
+      </tr>
+       <% settings_inspect.sort_by { |k, v| k.to_s }.each { |key, val| %>
+       <tr>
+         <td class="key"><%=h key %></td>
+         <% if !val.is_a?(String) %>
+            <% if( key == :sass) %>
+            <%# val[:load_paths] = val[:load_paths].uniq! %>
+            <td class="code">SASS
+              <div><%= h val.inspect %></div>
+            </td>
+          <% else %>
+            <td class="code"><div><%=h val.inspect %></div></td>
+          <% end %>
+         <% else %>
+          <td class="code"><div><%=h val %></div></td>
+         <% end %>
+       </tr>
+       <% } %>
+    </table>
+    <div class="clear"></div>
+  </div> <!-- /SETTINGS -->
+
+  <hr>
+
+  <div id="rack"> 
+    <h3 id="env-info">Rack ENV</h3>
+    <table class="req">
+      <tr>
+        <th>Variable</th>
+        <th>Value</th>
+      </tr>
+       <% env.sort_by { |k, v| k.to_s }.each { |key, val| %>
+       <tr>
+         <td class="key"><%=h key %></td>
+         <% unless val.is_a?(String) %>
+         <td class="code"><div><%=h(val.inspect).gsub('\n','<br>').gsub('%0A','<br>') %></div></td>
+         <% else %>
+         <td class="code"><div><%=h(val).gsub('\n','<br>').gsub('%0A','<br>') %></div></td>
+         <% end %>
+       </tr>
+       <% } %>
+    </table>
+    <div class="clear"></div>
+  </div> <!-- /RACK ENV -->
+
+  <p id="explanation">You're seeing this output because you have enabled the <code>show_settings</code> option.</p>
+
+
+</div>
+HTML
+      
+      # :startdoc:
+      
+    end #/module Helpers
+    
+    
+    
+    def self.registered(app)
+      app.helpers Sinatra::Settings::Helpers
+      
+      # don't show settings by default
+      app.set :show_settings, false
+      # only show the settings in development mode.
+      app.set :show_settings_environment, :development
+      
+      ## add the extension specific settings to those inspectable by the :settings_inspect method
+      if app.respond_to?(:sinatra_settings_for_inspection)
+        %w(show_settings show_settings_environment).each do |s|
+          app.sinatra_settings_for_inspection << s
+        end
+      end
+      
+    end
+    
+    
+  end #/module Settings
+  
+end #/module Sinatra
+

data/sinatra-settings.gemspec

@@ -0,0 +1,61 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{sinatra-settings}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["kematzy"]
+  s.date = %q{2010-02-23}
+  s.description = %q{Want an overview of all Sinatra settings (formerly options) in your app? This Sinatra Extension makes that dead simple.}
+  s.email = %q{kematzy@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "lib/sinatra/settings.rb",
+     "sinatra-settings.gemspec",
+     "spec/sinatra/settings_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/kematzy/sinatra-settings}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{A Sinatra Extension that shows your app's settings and other debug information}
+  s.test_files = [
+    "spec/sinatra/settings_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<sinatra>, [">= 0.10.1"])
+      s.add_development_dependency(%q<sinatra-tests>, [">= 0.1.6"])
+      s.add_development_dependency(%q<rspec>, [">= 1.3.0"])
+    else
+      s.add_dependency(%q<sinatra>, [">= 0.10.1"])
+      s.add_dependency(%q<sinatra-tests>, [">= 0.1.6"])
+      s.add_dependency(%q<rspec>, [">= 1.3.0"])
+    end
+  else
+    s.add_dependency(%q<sinatra>, [">= 0.10.1"])
+    s.add_dependency(%q<sinatra-tests>, [">= 0.1.6"])
+    s.add_dependency(%q<rspec>, [">= 1.3.0"])
+  end
+end
+

data/spec/sinatra/settings_spec.rb

@@ -0,0 +1,215 @@
+
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+
+describe "Sinatra" do 
+  
+  class MyTestApp
+    register Sinatra::Settings
+  end
+  
+  before(:each) do 
+    @sinatra_default_settings = %w(
+      app_file bind clean_trace dump_errors environment lock 
+      logging method_override port public raise_errors reload_templates
+      root run running server sessions show_exceptions static views
+    )
+  end
+  
+  describe "Base" do 
+    
+    describe "#sinatra_settings_for_inspection" do 
+      
+      it "should be an Array" do 
+        Sinatra::Base.sinatra_settings_for_inspection.should be_a_kind_of(Array)
+      end
+      
+      it "should include all the default Sinatra configuration settings" do 
+        @sinatra_default_settings.each do |s|
+          Sinatra::Base.sinatra_settings_for_inspection.should include(s)
+        end
+      end
+      
+    end #/ #sinatra_settings_for_inspection
+    
+  end #/ Base
+  
+  describe "Settings" do 
+    
+    before(:each) do 
+      class ::Test::Unit::TestCase 
+        def app; ::MyTestApp.new ; end
+      end
+      @app = app
+    end
+    
+    after(:each) do 
+      class ::Test::Unit::TestCase 
+        def app; nil ; end
+      end
+      @app = nil
+    end
+    
+    describe "VERSION" do 
+      
+      it "should return the VERSION string" do 
+        Sinatra::Settings::VERSION.should be_a_kind_of(String)
+        Sinatra::Settings::VERSION.should match(/\d\.\d+\.\d+(\.\d)?/)
+      end
+      
+    end #/ VERSION
+    
+    describe "#self.version" do 
+      
+      it "should return a string with the version number" do 
+        Sinatra::Settings.version.should match(/Sinatra::Settings v\d\.\d\.\d/)
+      end
+      
+    end #/ #version
+    
+    describe "Configuration" do 
+      
+      it "should set :show_settings to FALSE" do 
+        MyTestApp.show_settings.should == false
+        app.settings.show_settings.should == false
+      end
+      
+      it "should set :show_settings_environment to :development" do 
+        MyTestApp.show_settings_environment.should == :development
+        app.settings.show_settings_environment.should == :development
+      end
+      
+    end #/ Configuration
+    
+    describe "#sinatra_settings_for_inspection" do 
+      
+      it "should return an Array of Sinatra configuration settings" do 
+        app.settings.sinatra_settings_for_inspection.should be_a_kind_of(Array)
+      end
+      
+      it "should include all the Sinatra default configuration settings" do 
+        @sinatra_default_settings.each do |s|
+          MyTestApp.sinatra_settings_for_inspection.should include(s)
+          app.settings.sinatra_settings_for_inspection.should include(s)
+        end
+      end
+      
+      it "should include the settings from this extension" do 
+        %w( show_settings show_settings_environment ).each do |s|
+          MyTestApp.sinatra_settings_for_inspection.should include(s)
+          app.settings.sinatra_settings_for_inspection.should include(s)
+        end
+      end
+      
+      it "should not duplicate settings in the array" do 
+        pending %Q{ allows duplicate values in array }
+        # TODO: This is not a big issue, since we do .uniq on the output in :settings_inspect,
+        # which is where it's important, but still it would be nice to not have it from the start
+        
+        %w(foo bar foo bar).each do |s|
+          app.settings.sinatra_settings_for_inspection << s
+        end
+        app.settings.sinatra_settings_for_inspection.should == app.settings.sinatra_settings_for_inspection.uniq
+      end
+      
+    end #/ #sinatra_settings_for_inspection
+    
+    describe "Helpers" do 
+      
+      describe "#settings_inspect" do 
+        
+        it "should return a Hash" do 
+          app.settings_inspect.should be_a_kind_of(Hash)
+        end
+        
+        it "should contain the Sinatra default configurations" do 
+          @sinatra_default_settings.each do |s|
+            app.settings_inspect.keys.should include(s.to_sym)
+            # app.settings.sinatra_settings_for_inspection.should include(s)
+          end
+        end
+        
+        it "should contain no duplicates" do 
+          app.settings_inspect.keys.map(&:to_s).sort.should == 
+            app.settings.sinatra_settings_for_inspection.uniq.sort
+        end
+        
+      end #/ #settings_inspect
+      
+      describe "#show_settings_output?" do 
+        
+        describe "with :show_settings disabled" do 
+          
+          it "should show the :show_settings HTML comment output" do 
+            erb_app "<%= show_settings_output? %>"
+            body.should == '<!-- :show_settings is [OFF]  -->'
+          end
+          
+        end #/ with :show_settings disabled
+        
+        describe "with :show_settings enabled" do 
+          
+          class MyCustomTestApp < Sinatra::Base
+            set :app_dir, "#{fixtures_path}/app"
+            set :public, "#{public_fixtures_path}"
+            set :views, "#{app_dir}/views"
+            register(Sinatra::Tests)
+            register(Sinatra::Settings)
+            
+            enable :show_settings
+            set :show_settings_environment, :test
+            enable :raise_errors
+          end
+          
+          before(:each) do 
+            class ::Test::Unit::TestCase 
+              def app; ::MyCustomTestApp.new ; end
+            end
+            @app = app
+          end
+          
+          after(:each) do 
+            class ::Test::Unit::TestCase 
+              def app; nil ; end
+            end
+            @app = nil
+          end
+          
+          it "should show the full HTML output" do 
+            erb_app "<%= show_settings_output? %>"
+            # body.should have_tag(:debug)
+            body.should have_tag('div#debug') do |div| 
+              div.should have_tag('h2', 'PAGE DEBUG')
+              div.should have_tag('div#get > table.req')
+              
+              div.should have_tag('div#params > table.req')
+              
+              div.should have_tag('div#sessions > h3','SESSIONS')
+              
+              div.should have_tag('div#cookies > h3','COOKIES')
+              
+              div.should have_tag('div#routes > h3','ROUTES')
+              
+              div.should have_tag('div#settings') do |settings_div|
+                settings_div.should have_tag('h3', 'SETTINGS')
+                settings_div.should have_tag('table.req') do |table|
+                  table.should have_tag('tr > td.key', 'show_settings')
+                  table.should have_tag('tr > td.code > div', 'true')
+                  
+                  table.should have_tag('tr > td.key', 'show_settings_environment')
+                  table.should have_tag('tr > td.code > div', ':test')
+                end
+              end 
+              div.should have_tag('div#rack > h3#env-info','Rack ENV')
+            end
+          end
+          
+        end #/ with :show_settings enabled
+        
+      end #/ #show_settings_output?
+      
+    end #/ Helpers
+    
+  end #/ Settings
+  
+end #/ Sinatra

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,57 @@
+
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+
+#--
+# DEPENDENCIES
+#++
+%w( 
+sinatra/base 
+).each {|lib| require lib }
+
+#--
+## SINATRA EXTENSIONS
+#++
+%w(
+sinatra/tests
+sinatra/settings
+).each {|ext| require ext }
+
+
+Spec::Runner.configure do |config|
+  config.include RspecHpricotMatchers
+  config.include Sinatra::Tests::TestCase
+  config.include Sinatra::Tests::RSpec::SharedSpecs
+end
+
+
+# quick convenience methods..
+
+def fixtures_path
+  "#{File.dirname(File.expand_path(__FILE__))}/fixtures"
+end
+
+def public_fixtures_path
+  "#{fixtures_path}/public"
+end
+
+
+class MyTestApp < Sinatra::Base 
+  
+  set :app_dir, "#{fixtures_path}/app"
+  set :public, "#{public_fixtures_path}"
+  # set :views, "#{fixtures_path}/app/views"
+  set :views, "#{app_dir}/views"
+  
+  register(Sinatra::Tests)
+  
+  enable :raise_errors
+  
+end #/class MyTestApp
+
+
+class Test::Unit::TestCase 
+  Sinatra::Base.set :environment, :test
+end

metadata

@@ -0,0 +1,115 @@
+--- !ruby/object:Gem::Specification 
+name: sinatra-settings
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- kematzy
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-02-23 00:00:00 +08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: sinatra
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 10
+        - 1
+        version: 0.10.1
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: sinatra-tests
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 1
+        - 6
+        version: 0.1.6
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 3
+        - 0
+        version: 1.3.0
+  type: :development
+  version_requirements: *id003
+description: Want an overview of all Sinatra settings (formerly options) in your app? This Sinatra Extension makes that dead simple.
+email: kematzy@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/sinatra/settings.rb
+- sinatra-settings.gemspec
+- spec/sinatra/settings_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/kematzy/sinatra-settings
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: A Sinatra Extension that shows your app's settings and other debug information
+test_files: 
+- spec/sinatra/settings_spec.rb
+- spec/spec_helper.rb