picnic 0.8.0 → 0.8.1

data/vendor/zuk-camping-2.0.20090429/extras/flipbook.rb

@@ -0,0 +1,357 @@
+CAMPING_EXTRAS_DIR = File.expand_path(File.dirname(__FILE__))
+require 'rdoc/generator/html'
+
+module RDoc::Generator
+[Class, File].each do |klass|
+  old = klass.instance_method(:value_hash)
+  klass.send(:define_method, :value_hash) {
+    old.bind(self).call
+    @values['root'] = @path.split("/").map { ".." }[1..-1].join("/")
+    @values
+  }
+end
+
+module HTML::FLIPBOOK
+######################################################################
+#
+# The following is used for the -1 option
+#
+
+FONTS = "verdana,arial,'Bitstream Vera Sans',helvetica,sans-serif"
+
+STYLE = %{
+    body, th, td {
+        font: normal 14px verdana,arial,'Bitstream Vera Sans',helvetica,sans-serif;
+        line-height: 160%;
+        padding: 0; margin: 0;
+        margin-bottom: 30px;
+        /* background-color: #402; */
+        background-color: #694;
+    }
+    h1, h2, h3, h4 {
+        font-family: Utopia, Georgia, serif;
+        font-weight: bold;
+        letter-spacing: -0.018em;
+    }
+    h1 { font-size: 24px; margin: .15em 1em 0 0 }
+    h2 { font-size: 24px }
+    h3 { font-size: 19px }
+    h4 { font-size: 17px; font-weight: normal; }
+    h4.ruled { border-bottom: solid 1px #CC9; }
+    h2.ruled { padding-top: 35px; border-top: solid 1px #AA5; }
+
+    /* Link styles */
+    :link, :visited {
+        color: #00b;
+    }
+    :link:hover, :visited:hover {
+        background-color: #eee;
+        color: #B22;
+    }
+    #fullpage {
+        width: 720px;
+        margin: 0 auto;
+    }
+    .page_shade, .page {
+        padding: 0px 5px 5px 0px;
+        background-color: #fcfcf9;
+        border: solid 1px #983;
+    }
+    .page {
+        margin-left: -5px;
+        margin-top: -5px;
+        padding: 20px 35px;
+    }
+    .page .header {
+        float: right;
+        color: #777;
+        font-size: 10px;
+    }
+    .page h1, .page h2, .page h3 {
+        clear: both;
+        text-align: center;
+    }
+    #pager {
+        padding: 10px 4px;
+        color: white;
+        font-size: 11px;
+    }
+    #pager :link, #pager :visited {
+        color: #bfb;
+        padding: 0px 5px;
+    }
+    #pager :link:hover, #pager :visited:hover {
+        background-color: #262;
+        color: white;
+    }
+    #logo { float: left; }
+    #menu { background-color: #dfa; padding: 4px 12px; margin: 0; }
+    #menu h3 { padding: 0; margin: 0; }
+    #menu #links { float: right; }
+    pre { font-weight: bold; color: #730; }
+    tt { color: #703; font-size: 12pt; }
+    .dyn-source { background-color: #775915; padding: 4px 8px; margin: 0; display: none; }
+    .dyn-source pre  { color: #DDDDDD; font-size: 8pt; }
+    .source-link     { text-align: right; font-size: 8pt; }
+    .ruby-comment    { color: green; font-style: italic }
+    .ruby-constant   { color: #CCDDFF; font-weight: bold; }
+    .ruby-identifier { color: #CCCCCC;  }
+    .ruby-ivar       { color: #BBCCFF; }
+    .ruby-keyword    { color: #EEEEFF; font-weight: bold }
+    .ruby-node       { color: #FFFFFF; }
+    .ruby-operator   { color: #CCCCCC;  }
+    .ruby-regexp     { color: #DDFFDD; }
+    .ruby-value      { color: #FFAAAA; font-style: italic }
+    .kw { color: #DDDDFF; font-weight: bold }
+    .cmt { color: #CCFFCC; font-style: italic }
+    .str { color: #EECCCC; font-style: italic }
+    .re  { color: #EECCCC; }
+}
+
+CONTENTS_XML = %q{
+<%= values['description'] if values['description'] %>
+
+<% if values['requires'] %>
+  <h4>Requires:</h4>
+  <ul>
+  <% values['requires'].each do |req| %>
+    <li><%= href(req['aref'], req['name']) %></li>
+  <% end %>
+<% end %>
+
+<% if values['attributes'] %>
+  <h4>Attributes</h4>
+  <table>
+  <% values['attribtes'].each do |attr| %>
+    <tr><td><%= attr['name'] %></td><td><%= attr['rw'] %></td><td><%= attr['a_desc'] %></td></tr>
+  <% end %>
+</table>
+<% end %>
+
+<% if values['includes'] %>
+  <h4>Includes</h4>
+  <ul>
+  <% values['includes'].each do |i| %>
+    <li><%= href i['aref'], i['name'] %></li>
+  <% end %>
+  </ul> 
+<% end %>
+
+<% values['sections'].each do |sec| %>
+  <% if sec['method_list'] %>
+    <h2 class="ruled">Methods</h2>
+    <% sec['method_list'].each do |ml| %>
+      <% if ml['methods'] %>
+        <% ml['methods'].each do |m| %>
+          <h4 class="ruled"><%= m['type'] %> <%= m['category'] %> method:
+          <% c = m['callseq'] %>
+          <strong id="<%= m['aref'] %>"><%= c ? c : m['name'] + m['params'] %></strong>
+          <a href="#<%= m['aref'] %>"><img src="<%= values['root'] %>/permalink.gif" border="0" title="Permalink to <%= c ? c : "#{m['type']} #{m['category']} method: #{m['name']}" %>" /></a></h4> 
+        
+          <%= m['m_desc'] if m['m_desc'] %>
+        
+          <% if m['sourcecode'] %>
+            <div class="sourcecode">
+            <p class="source-link">[ <a href="javascript:toggleSource('<%= m['aref'] %>_source')" id="l_<%= m['aref'] %>_source">show source</a> ]</p>
+            <div id="<%= m['aref'] %>_source" class="dyn-source">
+            <pre>
+            <%= m['sourcecode'] %>
+            </pre>
+            </div>
+            </div>
+          <% end %>
+        <% end %>
+      <% end %>
+    <% end %>                
+  <% end %>
+<% end %>
+}
+
+############################################################################
+
+
+BODY = %q{
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+  <title>
+  <% if values['title'] %>
+    <%= values['realtitle'] %> &raquo; <%= values['title'] %>
+  <% else %>
+    <%= values['realtitle'] %>
+  <% end %>
+  </title>
+  <meta http-equiv="Content-Type" content="text/html; charset=<%= values['charset'] %>" />
+  <link rel="stylesheet" href="<%= values['style_url'] %>" type="text/css" media="screen" />
+    <script language="JavaScript" type="text/javascript">
+    // <![CDATA[
+
+    function toggleSource( id )
+    {
+    var elem
+    var link
+
+    if( document.getElementById )
+    {
+    elem = document.getElementById( id )
+    link = document.getElementById( "l_" + id )
+    }
+    else if ( document.all )
+    {
+    elem = eval( "document.all." + id )
+    link = eval( "document.all.l_" + id )
+    }
+    else
+    return false;
+
+    if( elem.style.display == "block" )
+    {
+    elem.style.display = "none"
+    link.innerHTML = "show source"
+    }
+    else
+    {
+    elem.style.display = "block"
+    link.innerHTML = "hide source"
+    }
+    }
+
+    function openCode( url )
+    {
+    window.open( url, "SOURCE_CODE", "width=400,height=400,scrollbars=yes" )
+    }
+    // ]]>
+    </script>
+</head>
+<body>
+<div id="menu">
+<div id="links">
+    <a href="http://redhanded.hobix.com/bits/campingAMicroframework.html">backstory</a> |
+    <a href="http://code.whytheluckystiff.net/camping/">wiki</a> |
+    <a href="http://code.whytheluckystiff.net/camping/newticket">bugs</a> |
+    <a href="http://code.whytheluckystiff.net/svn/camping/">svn</a>
+</div>
+<h3 class="title"><%= values['title'] %></h3>
+</div>
+<div id="fullpage">
+<div id="logo"><img src="<%= values['root'] %>/Camping.gif" /></div>
+<div id="pager">
+<strong>Files:</strong>
+<% values['file_list'].each do |file| %>
+  <%= href "#{file['href']}", file['name'] %>
+<% end %>
+<% if values['class_list'] %>
+  |
+  <strong>classes:</strong>
+  <% values['class_list'].each do |klass| %>
+    <%= href "#{klass['href']}", klass['name'] %>
+  <% end %>
+<% end %>
+</ul>
+</div>
+
+    <%= template_include %>
+
+</div>
+</body>
+</html>
+}
+
+###############################################################################
+
+FILE_PAGE = <<_FILE_PAGE_
+<div id="<%= values['full_path'] %>" class="page_shade">
+<div class="page">
+<div class="header">
+  <div class="path"><%= values['full_path'] %> / <%= values['dtm_modified'] %></div>
+</div>
+#{CONTENTS_XML}
+</div>
+</div>
+_FILE_PAGE_
+
+###################################################################
+
+CLASS_PAGE = %{
+<div id="<%= values['full_name'] %>" class="page_shade">
+<div class="page">
+<% if values['parent'] %>
+  <h3><%= values['classmod'] %> <%= values['full_name'] %> &lt; <%= href values['par_url'], values['parent'] %></h3>
+<% else %>
+  <h3><%= values['classmod'] %> <%= values['full_name'] %></h3>
+<% end %>
+
+<% if values['infiles'] %>
+  (in files
+  <% values['infiles'].each do |file| %>
+    <%= href file['full_path_url'], file['full_path'] %>
+  <% end %>
+  )
+<% end %>
+} + CONTENTS_XML + %{
+</div>
+</div>
+}
+
+METHOD_LIST = ""
+########################## Index ################################
+
+FR_INDEX_BODY = %{
+<%= template_include %>
+}
+
+FILE_INDEX = %{
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=<%= values['charset'] %>">
+<style>
+<!--
+  body {
+background-color: #ddddff;
+     font-family: #{FONTS}; 
+       font-size: 11px; 
+      font-style: normal;
+     line-height: 14px; 
+           color: #000040;
+  }
+div.banner {
+  background: #0000aa;
+  color:      white;
+  padding: 1;
+  margin: 0;
+  font-size: 90%;
+  font-weight: bold;
+  line-height: 1.1;
+  text-align: center;
+  width: 100%;
+}
+  
+-->
+</style>
+<base target="docwin">
+</head>
+<body>
+<div class="banner"><%= values['list_title'] %></div>
+<% values['entries'].each do |entry| %>
+  <%= href entry['href'], entry['name'] %><br>
+<% end %>
+</body></html>
+}
+
+CLASS_INDEX = FILE_INDEX
+METHOD_INDEX = FILE_INDEX
+
+INDEX = %{
+<HTML>
+<HEAD>
+<META HTTP-EQUIV="refresh" content="0;URL=<%= values['initial_page'] %>">
+<TITLE><%= values['realtitle'] %></TITLE>
+</HEAD>
+<BODY>
+Click <a href="<%= values['initial_page'] %>">here</a> to open the Camping docs.
+</BODY>
+</HTML>
+}
+
+end
+end

data/vendor/{camping-2.0.20090212 → zuk-camping-2.0.20090429}/lib/camping-unabridged.rb

@@ -9,23 +9,6 @@
 # nicely with piles of documentation everywhere.  This documentation is entirely
 # generated from lib/camping-unabridged.rb using RDoc and our "flipbook" template
 # found in the extras directory of any camping distribution.
-#
-# == Requirements
-#
-# Camping requires at least Ruby 1.8.2.
-#
-# Camping depends on the following libraries.  If you install through RubyGems,
-# these will be automatically installed for you.
-#
-# * ActiveRecord, used in your models.
-#   ActiveRecord is an object-to-relational database mapper with adapters
-#   for SQLite3, MySQL, PostgreSQL, SQL Server and more.
-# * Markaby, used in your views to describe HTML in plain Ruby.
-#
-# Camping also works well with Mongrel, the swift Ruby web server.
-# http://rubyforge.org/projects/mongrel  Mongrel comes with examples
-# in its <tt>examples/camping</tt> directory. 
-#
 %w[uri stringio rack].map { |l| require l }
 
 class Object #:nodoc:
@@ -34,7 +17,11 @@ class Object #:nodoc:
   end
 end
 
-# == Camping 
+# == Camping
+# TODO: Tutorial: Camping.goes, MVC (link to Controllers, Models, Views where
+#       they're described in detail), Camping Server (for development), Rack
+#       (for production). the create-method. Service overload too, perhaps?
+#       Overriding r404, r500 and r501.
 #
 # The camping module contains three modules for separating your application:
 #
@@ -47,6 +34,7 @@ end
 # * Camping::Helpers which can be used in controllers and views.
 #
 # == The Camping Server
+# TODO: Only for development.
 #
 # How do you run Camping apps?  Oh, uh... The Camping Server!
 #
@@ -84,6 +72,7 @@ end
 #     end
 #   end 
 #
+# TODO: Wiki is down.
 # For more tips, see http://code.whytheluckystiff.net/camping/wiki/GiveUsTheCreateMethod.
 module Camping
   C = self
@@ -91,6 +80,7 @@ module Camping
   P = "<h1>Cam\ping Problem!</h1><h2>%s</h2>"
   U = Rack::Utils
   Apps = []
+  # TODO: @input[:page] != @input['page']
   # An object-like Hash.
   # All Camping query string and cookie variables are loaded as this.
   # 
@@ -125,7 +115,8 @@ module Camping
     end
     undef id, type
   end
-
+  
+  # TODO: Fair enough. Maybe complete the ActionPack example?
   # Helpers contains methods available in your controllers and views.  You may add
   # methods of your own to this module, including many helper methods from Rails.
   # This is analogous to Rails' <tt>ApplicationHelper</tt> module.
@@ -190,7 +181,7 @@ module Camping
     # is assigned to route <tt>/logout</tt>.  The HTML will come out as:
     #
     #   <div id="menu">
-    #     <a href="//localhost:3301/frodo/">Home</a>
+    #     <a href="http://localhost:3301/frodo/">Home</a>
     #     <a href="/frodo/profile">Profile</a>
     #     <a href="/frodo/logout">Logout</a>
     #     <a href="http://google.com">Google</a>
@@ -251,6 +242,7 @@ module Camping
   # Forgivable, considering that it's only really a handful of methods and accessors.
   #
   # == Treating controller methods like Response objects
+  # TODO: I don't think this belongs here. Either Controllers or Camping.
   #
   # Camping originally came with a barebones Response object, but it's often much more readable
   # to just use your controller as the response.
@@ -279,6 +271,7 @@ module Camping
   #
   module Base
     attr_accessor :input, :cookies, :headers, :body, :status, :root
+    M = proc { |_, o, n| o.merge(n, &M) }
 
     # Display a view, calling it by its method name +m+.  If a <tt>layout</tt>
     # method is found in Camping::Views, it will be used to wrap the HTML.
@@ -328,6 +321,7 @@ module Camping
     # You can also switch the body and the header in order to support Rack:
     #
     #  r(302, {'Location' => self / "/view/12"}, '')
+    #  r(another_app.call(@env))
     #
     # See also: #r404, #r500 and #r501
     def r(s, b, h = {})
@@ -367,8 +361,8 @@ module Camping
     # end
     #
     # See: I
-    def r404(p=env.PATH)
-      r(404, P % "#{p} not found")
+    def r404(p)
+      P % "#{p} not found"
     end
 
     # If there is a parse error in Camping or in your application's source code, it will not be caught
@@ -378,15 +372,15 @@ module Camping
     # You can overide it, but if you have an error in here, it will be uncaught !
     #
     # See: I
-    def r500(k,m,x)
-      r(500, P % "#{k}.#{m}" + "<h3>#{x.class} #{x.message}: <ul>#{x.backtrace.map{|b|"<li>#{b}</li>"}}</ul></h3>")
+    def r500(k,m,e)
+      raise e
     end
 
     # Called if an undefined method is called on a Controller, along with the request method +m+ (GET, POST, etc.)
     #
     # See: I
-    def r501(m=@method)
-      r(501, P % "#{m.upcase} not implemented")
+    def r501(m)
+      P % "#{m.upcase} not implemented"
     end
 
     # Turn a controller into an array.  This is designed to be used to pipe
@@ -401,46 +395,41 @@ module Camping
     #     end
     #   end
     def to_a
-      @response.body = (@body.respond_to?(:each) ? @body : '')
-      @response.status = @status
-      @response.headers.merge!(@headers)
+      r = Rack::Response.new(@body, @status, @headers)
       @cookies.each do |k, v|
         v = {:value => v, :path => self / "/"} if String===v
-        @response.set_cookie(k, v) if @request.cookies[k] != v
+        r.set_cookie(k, v)
       end
-      @response.to_a
+      r.to_a
     end
     
-    def initialize(env) #:nodoc: 
-      @request, @response, @env =
-      Rack::Request.new(env), Rack::Response.new, env
-      @root, @input, @cookies,
-      @headers, @status =
-      @env.SCRIPT_NAME.sub(/\/$/,''), 
-      H[@request.params], H[@request.cookies],
-      @response.headers, @response.status
-            
-      @input.each do |k, v|
-        if k[-2..-1] == "[]"
-          @input[k[0..-3]] = @input.delete(k)
-        elsif k =~ /(.*)\[([^\]]+)\]$/
-          (@input[$1] ||= H[])[$2] = @input.delete(k)
-        end
+    def initialize(env, m) #:nodoc: 
+      r = @request = Rack::Request.new(@env = env)
+      @root, p, @cookies,
+      @headers, @status, @method =
+      (env.SCRIPT_NAME||'').sub(/\/$/,''), 
+      H[r.params], H[r.cookies],
+      {}, m =~ /r(\d+)/ ? $1.to_i : 200, m
+      
+      @input = p.inject(H[]) do |h, (k, v)|
+        h.merge(k.split(/[\]\[]+/).reverse.inject(v) { |x, i| H[i => x] }, &M)
       end
     end
 
+    # TODO: The wiki is down. Service overload should probably go in Camping.
     # All requests pass through this method before going to the controller.  Some magic
     # in Camping can be performed by overriding this method.
     #
     # See http://code.whytheluckystiff.net/camping/wiki/BeforeAndAfterOverrides for more
     # on before and after overrides with Camping.
     def service(*a)
-      r = catch(:halt){send(@env.REQUEST_METHOD.downcase, *a)}
+      r = catch(:halt){send(@method, *a)}
       @body ||= r 
       self
     end
   end
-
+  
+  # TODO: @input & @cookies at least.
   # Controllers is a module for placing classes which handle URLs.  This is done
   # by defining a route to each class using the Controllers::R method.
   #
@@ -510,7 +499,7 @@ module Camping
         [I, 'r404', p]
       end
 
-      N = H.new { |_,x| x.downcase }.merge! "N" => '(\d+)', "X" => '(\w+)', "Index" => ''
+      N = H.new { |_,x| x.downcase }.merge! "N" => '(\d+)', "X" => '([^/]+)', "Index" => ''
       # The route maker, this is called by Camping internally, you shouldn't need to call it.
       #
       # Still, it's worth know what this method does.  Since Ruby doesn't keep track of class
@@ -533,8 +522,7 @@ module Camping
     end
 
     # Internal controller with no route. Used by #D and C.call to show internal messages.
-    class I < R()
-    end
+    I = R()
   end
   X = Controllers
 
@@ -559,10 +547,12 @@ module Camping
     # And array with [statuc, headers, body] is expected at the output.
     def call(e)
       X.M
-      e = H[e.to_hash]
-      k,m,*a=X.D e.PATH_INFO,(e.REQUEST_METHOD||'get').downcase
-      e.REQUEST_METHOD = m
-      k.new(e).service(*a).to_a
+      e = H[e]
+      p = e.PATH_INFO = U.unescape(e.PATH_INFO)
+      k,m,*a=X.D p,(e.REQUEST_METHOD||'get').downcase
+      k.new(e,m).service(*a).to_a
+    rescue
+      r500(:I, k, m, $!, :env => e).to_a
     end
 
     # The Camping scriptable dispatcher.  Any unhandled method call to the app module will
@@ -585,14 +575,15 @@ module Camping
     #
     def method_missing(m, c, *a)
       X.M
-      h=Hash===a[-1]?H[a.pop]:{}
-      e=H[h[:env]||{}].merge!({'rack.input'=>StringIO.new,'REQUEST_METHOD'=>m.to_s})
-      k = X.const_get(c).new(H[e])
-      k.send("input=",h[:input]) if h[:input]
+      h = Hash === a[-1] ? a.pop : {}
+      e = H[Rack::MockRequest.env_for('',h[:env]||{})]
+      k = X.const_get(c).new(e,m.to_s)
+      k.send("input=", h[:input]) if h[:input]
       k.service(*a)
     end
   end
-
+  
+  # TODO: More examples.
   # Views is an empty module for storing methods which create HTML.  The HTML is described
   # using the Markaby language.
   #
@@ -601,7 +592,8 @@ module Camping
   # If your Views module has a <tt>layout</tt> method defined, it will be called with a block
   # which will insert content from your view.
   module Views; include X, Helpers end
- 
+  
+  # TODO: Migrations
   # Models is an empty Ruby module for housing model classes derived
   # from ActiveRecord::Base.  As a shortcut, you may derive from Base
   # which is an alias for ActiveRecord::Base.