campfire-bot 0.0.1

data/vendor/escape/install.rb

@@ -0,0 +1,109 @@
+#!/usr/bin/env ruby
+
+# usage: ruby install.rb [-n]
+# options:
+#  -n : don't install
+#
+# Author: Tanaka Akira <akr@m17n.org>
+
+require 'optparse'
+require 'fileutils'
+
+def target_directory
+  $:.each {|loc|
+    if %r{/site_ruby/[\d.]+\z} =~ loc
+      return loc
+    end
+  }
+  raise "could not find target install directory"
+end
+
+CVS_FILES = {}
+def cvs_files(dir)
+  return CVS_FILES[dir] if CVS_FILES.include? dir
+  if File.directory? "#{dir}/CVS"
+    result = {}
+    File.foreach("#{dir}/CVS/Entries") {|line|
+      case line
+      when %r{\A/([^/]+)/} then result[$1] = true
+      when %r{\AD/([^/]+)/} then result[$1] = true
+      end
+    }
+  else
+    result = nil
+  end
+  CVS_FILES[dir] = result
+  result
+end
+
+def each_target(&block)
+  target_set = {}
+  cvs = cvs_files('.')
+  Dir.glob("*.rb") {|filename|
+    next if /\Atest-/ =~ filename
+    next if /\Ainstall/ =~ filename
+    next if cvs && !cvs.include?(filename)
+    target_set[filename] = true
+    yield filename
+    each_require(filename, target_set, &block)
+  }
+end
+
+def each_require(file, target_set, &block)
+  File.foreach(file) {|line|
+    next if /\A\s*require\s+['"]([^'"]+)['"]/ !~ line
+    feature = $1
+    filename = "#{feature}.rb"
+    next if target_set.include? filename
+    next if !File.exist?(filename)
+    target_set[filename] = true
+    yield filename
+    each_require(filename, target_set, &block)
+  }
+end
+
+def collect_target
+  result = []
+  each_target {|filename| result << filename }
+  result.sort!
+  result
+end
+
+def install_file(src, dst)
+  ignore_exc(Errno::ENOENT) { return if FileUtils.compare_file src, dst }
+  # check shadow
+  ignore_exc(Errno::ENOENT) { File.unlink dst }
+  FileUtils.mkdir_p(File.dirname(dst), :mode=>0755)
+  FileUtils.cp(src, dst, :verbose => true)
+  File.chmod(0644, dst)
+end
+
+def ignore_exc(exc)
+  begin
+    yield
+  rescue exc
+  end
+end
+
+$opt_n = false
+ARGV.options {|q|
+  q.banner = 'ruby install.rb [opts]'
+  q.def_option('--help', 'show this message') {puts q; exit(0)}
+  q.def_option('-n', "don't install") { $opt_n = true }
+  q.parse!
+}
+
+if $opt_n
+  dir = target_directory
+  collect_target.each {|filename|
+    puts "-> #{dir}/#{filename}"
+  }
+  exit
+else
+  File.umask 022
+  dir = target_directory
+  collect_target.each {|filename|
+    install_file filename, "#{dir}/#{filename}"
+  }
+end
+

data/vendor/escape/misc/README.erb

@@ -0,0 +1,85 @@
+= escape - HTML/URI/shell escaping utilities
+<%
+  def version
+    File.read("VERSION").chomp
+  end
+%>
+
+escape library provides several HTML/URI/shell escaping functions.
+
+== Author
+
+Tanaka Akira <akr@fsij.org>
+
+== Home Page
+
+((<URL:http://www.a-k-r.org/escape/>))
+
+== Feature
+
+* several escaping/composing functions
+  * HTML text
+  * HTML attribute value
+  * HTML form (x-www-form-urlencoded)
+  * URI path
+  * shell command line
+* dedicated classes for escaped strings
+* escape and compose strongly related strings at once
+
+== Usage
+
+  require 'escape'
+
+  Escape.shell_command(["echo", "*"]) #=> #<Escape::ShellEscaped: echo '*'>
+  Escape.uri_path("a?b/c?d/e?f") #=> #<Escape::PercentEncoded: a%3Fb/c%3Fd/e%3Ff>
+  Escape.html_form([["a","b"], ["c","d"]]) #=> #<Escape::PercentEncoded: a=b&c=d>
+  Escape.html_form({"a"=>"b", "c"=>"d"}) #=> #<Escape::PercentEncoded: a=b&c=d>
+  Escape.html_text("a & b < c > d") #=> #<Escape::HTMLEscaped: a &amp; b &lt; c &gt; d>
+  Escape.html_attr_value("ab&<>\"c") #=> #<Escape::HTMLAttrValue: "ab&amp;&lt;&gt;&quot;c">
+
+== Requirements
+
+* ruby : http://www.ruby-lang.org/
+
+== Download
+
+* latest release: ((<escape-<%=version%>.tar.gz|URL:escape-<%=version%>.tar.gz>))
+
+* development version in Subversion repository:
+
+    % svn co svn://svn@svn.a-k-r.org/akr/escape/trunk escape
+
+== Install
+
+  % ruby install.rb
+
+== Reference Manual
+
+See rdoc/classes/Escape.html or
+((<URL:http://www.a-k-r.org/escape/rdoc/classes/Escape.html>))
+
+== License
+
+The modified BSD licence
+
+  Redistribution and use in source and binary forms, with or without
+  modification, are permitted provided that the following conditions are met:
+  
+   1. Redistributions of source code must retain the above copyright notice, this
+      list of conditions and the following disclaimer.
+   2. Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+   3. The name of the author may not be used to endorse or promote products
+      derived from this software without specific prior written permission.
+  
+  THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
+  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
+  EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+  EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
+  OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+  IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
+  OF SUCH DAMAGE.

data/vendor/escape/rdoc/classes/Escape.html

@@ -0,0 +1,427 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Module: Escape</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+
+    elemStyle = elem.style;
+    
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+
+    return true;
+  }
+  
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  
+  // ]]>
+  </script>
+
+</head>
+<body>
+
+
+
+    <div id="classHeader">
+        <table class="header-table">
+        <tr class="top-aligned-row">
+          <td><strong>Module</strong></td>
+          <td class="class-name-in-header">Escape</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../files/escape_rb.html">
+                escape.rb
+                </a>
+        <br />
+            </td>
+        </tr>
+
+        </table>
+    </div>
+  <!-- banner header -->
+
+  <div id="bodyContent">
+
+
+
+  <div id="contextContent">
+
+    <div id="description">
+      <p>
+<a href="Escape.html">Escape</a> module provides several escape functions.
+</p>
+<ul>
+<li>URI
+
+</li>
+<li>HTML
+
+</li>
+<li>shell command
+
+</li>
+</ul>
+
+    </div>
+
+
+   </div>
+
+    <div id="method-list">
+      <h3 class="section-bar">Methods</h3>
+
+      <div class="name-list">
+      <a href="#M000028">html_attr_value</a>&nbsp;&nbsp;
+      <a href="#M000026">html_form</a>&nbsp;&nbsp;
+      <a href="#M000027">html_text</a>&nbsp;&nbsp;
+      <a href="#M000022">shell_command</a>&nbsp;&nbsp;
+      <a href="#M000023">shell_single_word</a>&nbsp;&nbsp;
+      <a href="#M000025">uri_path</a>&nbsp;&nbsp;
+      <a href="#M000024">uri_segment</a>&nbsp;&nbsp;
+      </div>
+    </div>
+
+  </div>
+
+
+    <!-- if includes -->
+
+    <div id="section">
+
+    <div id="class-list">
+      <h3 class="section-bar">Classes and Modules</h3>
+
+      Class <a href="Escape/HTMLAttrValue.html" class="link">Escape::HTMLAttrValue</a><br />
+Class <a href="Escape/HTMLEscaped.html" class="link">Escape::HTMLEscaped</a><br />
+Class <a href="Escape/PercentEncoded.html" class="link">Escape::PercentEncoded</a><br />
+Class <a href="Escape/ShellEscaped.html" class="link">Escape::ShellEscaped</a><br />
+Class <a href="Escape/StringWrapper.html" class="link">Escape::StringWrapper</a><br />
+
+    </div>
+
+
+
+
+      
+
+
+    <!-- if method_list -->
+    <div id="methods">
+      <h3 class="section-bar">Public Instance methods</h3>
+
+      <div id="method-M000028" class="method-detail">
+        <a name="M000028"></a>
+
+        <div class="method-heading">
+          <a href="Escape.src/M000028.html" target="Code" class="method-signature"
+            onclick="popupCode('Escape.src/M000028.html');return false;">
+          <span class="method-name">html_attr_value</span><span class="method-args">(str)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+<a href="Escape.html#M000028">Escape.html_attr_value</a> encodes a string
+as a double-quoted HTML attribute using character references. It returns an
+instance of <a href="Escape/HTMLAttrValue.html">HTMLAttrValue</a>.
+</p>
+<pre>
+ Escape.html_attr_value(&quot;abc&quot;) #=&gt; #&lt;Escape::HTMLAttrValue: &quot;abc&quot;&gt;
+ Escape.html_attr_value(&quot;a&amp;b&quot;) #=&gt; #&lt;Escape::HTMLAttrValue: &quot;a&amp;amp;b&quot;&gt;
+ Escape.html_attr_value(&quot;ab&amp;&lt;&gt;\&quot;c&quot;) #=&gt; #&lt;Escape::HTMLAttrValue: &quot;ab&amp;amp;&amp;lt;&amp;gt;&amp;quot;c&quot;&gt;
+ Escape.html_attr_value(&quot;a'c&quot;) #=&gt; #&lt;Escape::HTMLAttrValue: &quot;a'c&quot;&gt;
+</pre>
+<p>
+It escapes 4 characters:
+</p>
+<ul>
+<li>&#8217;&amp;&#8217; to &#8217;&amp;amp;&#8217;
+
+</li>
+<li>&#8217;&lt;&#8217; to &#8217;&amp;lt;&#8217;
+
+</li>
+<li>&#8217;&gt;&#8217; to &#8217;&amp;gt;&#8217;
+
+</li>
+<li>&#8217;&quot;&#8217; to &#8217;&amp;quot;&#8217;
+
+</li>
+</ul>
+        </div>
+      </div>
+
+      <div id="method-M000026" class="method-detail">
+        <a name="M000026"></a>
+
+        <div class="method-heading">
+          <a href="Escape.src/M000026.html" target="Code" class="method-signature"
+            onclick="popupCode('Escape.src/M000026.html');return false;">
+          <span class="method-name">html_form</span><span class="method-args">(pairs, sep='&amp;')</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+<a href="Escape.html#M000026">Escape.html_form</a> composes HTML form
+key-value pairs as a x-www-form-urlencoded encoded string. It returns an
+instance of <a href="Escape/PercentEncoded.html">PercentEncoded</a>.
+</p>
+<p>
+<a href="Escape.html#M000026">Escape.html_form</a> takes an array of pair
+of strings or an hash from string to string.
+</p>
+<pre>
+ Escape.html_form([[&quot;a&quot;,&quot;b&quot;], [&quot;c&quot;,&quot;d&quot;]]) #=&gt; #&lt;Escape::PercentEncoded: a=b&amp;c=d&gt;
+ Escape.html_form({&quot;a&quot;=&gt;&quot;b&quot;, &quot;c&quot;=&gt;&quot;d&quot;}) #=&gt; #&lt;Escape::PercentEncoded: a=b&amp;c=d&gt;
+</pre>
+<p>
+In the array form, it is possible to use same key more than once. (It is
+required for a HTML form which contains checkboxes and select element with
+multiple attribute.)
+</p>
+<pre>
+ Escape.html_form([[&quot;k&quot;,&quot;1&quot;], [&quot;k&quot;,&quot;2&quot;]]) #=&gt; #&lt;Escape::PercentEncoded: k=1&amp;k=2&gt;
+</pre>
+<p>
+If the strings contains characters which must be escaped in
+x-www-form-urlencoded, they are escaped using %-encoding.
+</p>
+<pre>
+ Escape.html_form([[&quot;k=&quot;,&quot;&amp;;=&quot;]]) #=&gt; #&lt;Escape::PercentEncoded: k%3D=%26%3B%3D&gt;
+</pre>
+<p>
+The separator can be specified by the optional second argument.
+</p>
+<pre>
+ Escape.html_form([[&quot;a&quot;,&quot;b&quot;], [&quot;c&quot;,&quot;d&quot;]], &quot;;&quot;) #=&gt; #&lt;Escape::PercentEncoded: a=b;c=d&gt;
+</pre>
+<p>
+See HTML 4.01 for details.
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000027" class="method-detail">
+        <a name="M000027"></a>
+
+        <div class="method-heading">
+          <a href="Escape.src/M000027.html" target="Code" class="method-signature"
+            onclick="popupCode('Escape.src/M000027.html');return false;">
+          <span class="method-name">html_text</span><span class="method-args">(str)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+<a href="Escape.html#M000027">Escape.html_text</a> escapes a string
+appropriate for HTML text using character references. It returns an
+instance of <a href="Escape/HTMLEscaped.html">HTMLEscaped</a>.
+</p>
+<p>
+It escapes 3 characters:
+</p>
+<ul>
+<li>&#8217;&amp;&#8217; to &#8217;&amp;amp;&#8217;
+
+</li>
+<li>&#8217;&lt;&#8217; to &#8217;&amp;lt;&#8217;
+
+</li>
+<li>&#8217;&gt;&#8217; to &#8217;&amp;gt;&#8217;
+
+</li>
+</ul>
+<pre>
+ Escape.html_text(&quot;abc&quot;) #=&gt; #&lt;Escape::HTMLEscaped: abc&gt;
+ Escape.html_text(&quot;a &amp; b &lt; c &gt; d&quot;) #=&gt; #&lt;Escape::HTMLEscaped: a &amp;amp; b &amp;lt; c &amp;gt; d&gt;
+</pre>
+<p>
+This function is not appropriate for escaping HTML element attribute
+because quotes are not escaped.
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000022" class="method-detail">
+        <a name="M000022"></a>
+
+        <div class="method-heading">
+          <a href="Escape.src/M000022.html" target="Code" class="method-signature"
+            onclick="popupCode('Escape.src/M000022.html');return false;">
+          <span class="method-name">shell_command</span><span class="method-args">(command)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+<a href="Escape.html#M000022">Escape.shell_command</a> composes a sequence
+of words to a single shell command line. All shell meta characters are
+quoted and the words are concatenated with interleaving space. It returns
+an instance of <a href="Escape/ShellEscaped.html">ShellEscaped</a>.
+</p>
+<pre>
+ Escape.shell_command([&quot;ls&quot;, &quot;/&quot;]) #=&gt; #&lt;Escape::ShellEscaped: ls /&gt;
+ Escape.shell_command([&quot;echo&quot;, &quot;*&quot;]) #=&gt; #&lt;Escape::ShellEscaped: echo '*'&gt;
+</pre>
+<p>
+Note that system(*command) and system(<a
+href="Escape.html#M000022">Escape.shell_command(command)</a>) is roughly
+same. There are two exception as follows.
+</p>
+<ul>
+<li>The first is that the later may invokes /bin/sh.
+
+</li>
+<li>The second is an interpretation of an array with only one element: the
+element is parsed by the shell with the former but it is recognized as
+single word with the later. For example, system(*[&quot;echo foo&quot;])
+invokes echo command with an argument &quot;foo&quot;. But system(<a
+href="Escape.html#M000022">Escape.shell_command</a>([&quot;echo
+foo&quot;])) invokes &quot;echo foo&quot; command without arguments (and it
+probably fails).
+
+</li>
+</ul>
+        </div>
+      </div>
+
+      <div id="method-M000023" class="method-detail">
+        <a name="M000023"></a>
+
+        <div class="method-heading">
+          <a href="Escape.src/M000023.html" target="Code" class="method-signature"
+            onclick="popupCode('Escape.src/M000023.html');return false;">
+          <span class="method-name">shell_single_word</span><span class="method-args">(str)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+<a href="Escape.html#M000023">Escape.shell_single_word</a> quotes shell
+meta characters. It returns an instance of <a
+href="Escape/ShellEscaped.html">ShellEscaped</a>.
+</p>
+<p>
+The result string is always single shell word, even if the argument is
+&quot;&quot;. <a
+href="Escape.html#M000023">Escape.shell_single_word</a>(&quot;&quot;)
+returns #&lt;<a href="Escape/ShellEscaped.html">Escape::ShellEscaped</a>:
+&#8217;&#8217;&gt;.
+</p>
+<pre>
+ Escape.shell_single_word(&quot;&quot;) #=&gt; #&lt;Escape::ShellEscaped: ''&gt;
+ Escape.shell_single_word(&quot;foo&quot;) #=&gt; #&lt;Escape::ShellEscaped: foo&gt;
+ Escape.shell_single_word(&quot;*&quot;) #=&gt; #&lt;Escape::ShellEscaped: '*'&gt;
+</pre>
+        </div>
+      </div>
+
+      <div id="method-M000025" class="method-detail">
+        <a name="M000025"></a>
+
+        <div class="method-heading">
+          <a href="Escape.src/M000025.html" target="Code" class="method-signature"
+            onclick="popupCode('Escape.src/M000025.html');return false;">
+          <span class="method-name">uri_path</span><span class="method-args">(str)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+<a href="Escape.html#M000025">Escape.uri_path</a> escapes URI path using
+percent-encoding. The given path should be a sequence of (non-escaped)
+segments separated by &quot;/&quot;. The segments cannot contains
+&quot;/&quot;. It returns an instance of <a
+href="Escape/PercentEncoded.html">PercentEncoded</a>.
+</p>
+<pre>
+ Escape.uri_path(&quot;a/b/c&quot;) #=&gt; #&lt;Escape::PercentEncoded: a/b/c&gt;
+ Escape.uri_path(&quot;a?b/c?d/e?f&quot;) #=&gt; #&lt;Escape::PercentEncoded: a%3Fb/c%3Fd/e%3Ff&gt;
+</pre>
+<p>
+The path is the part after authority before query in URI, as follows.
+</p>
+<pre>
+  scheme://authority/path#fragment
+</pre>
+<p>
+See RFC 3986 for details of URI.
+</p>
+<p>
+Note that this function is not appropriate to convert OS path to URI.
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000024" class="method-detail">
+        <a name="M000024"></a>
+
+        <div class="method-heading">
+          <a href="Escape.src/M000024.html" target="Code" class="method-signature"
+            onclick="popupCode('Escape.src/M000024.html');return false;">
+          <span class="method-name">uri_segment</span><span class="method-args">(str)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+<a href="Escape.html#M000024">Escape.uri_segment</a> escapes URI segment
+using percent-encoding. It returns an instance of <a
+href="Escape/PercentEncoded.html">PercentEncoded</a>.
+</p>
+<pre>
+ Escape.uri_segment(&quot;a/b&quot;) #=&gt; #&lt;Escape::PercentEncoded: a%2Fb&gt;
+</pre>
+<p>
+The segment is &quot;/&quot;-splitted element after authority before query
+in URI, as follows.
+</p>
+<pre>
+  scheme://authority/segment1/segment2/.../segmentN?query#fragment
+</pre>
+<p>
+See RFC 3986 for details of URI.
+</p>
+        </div>
+      </div>
+
+
+    </div>
+
+
+  </div>
+
+
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+
+</body>
+</html>