RubyGems - ruby-web - Versions diffs - 1.1.1 - Mend

ruby-web 1.1.1

Files changed (190) hide show

data/ChangeLog +474 -0
data/INSTALL.txt +9 -0
data/InstalledFiles +180 -0
data/LICENSE.txt +74 -0
data/Rakefile +529 -0
data/TODO +65 -0
data/doc/additional.xml +149 -0
data/doc/core.xml +652 -0
data/doc/credits/index.xml +52 -0
data/doc/credits/php.contributors.xml +118 -0
data/doc/credits/php.language-snippets.ent +622 -0
data/doc/install/index.xml +136 -0
data/doc/install/mac/index.xml +21 -0
data/doc/install/ruby-web.install.rb.instructions.xml +7 -0
data/doc/install/unix/index.xml +46 -0
data/doc/install/win/apache1.xml +166 -0
data/doc/install/win/apache2.xml +141 -0
data/doc/install/win/iis.xml +162 -0
data/doc/install/win/index.xml +24 -0
data/doc/install/win/installer.xml +31 -0
data/doc/install/win/manual.xml +43 -0
data/doc/manual.xml +69 -0
data/doc/old/apache_cgi.txt +23 -0
data/doc/old/fastcgi.txt +23 -0
data/doc/old/mod_ruby.txt +21 -0
data/doc/old/snippets.rdoc +183 -0
data/doc/old/webrick.txt +23 -0
data/doc/old/windows_cgi.txt +9 -0
data/doc/tutorial.xml +14 -0
data/doc/xsl/manual-multi.xsl +10 -0
data/doc/xsl/manual-pdf.xsl +6 -0
data/doc/xsl/manual-single.xsl +6 -0
data/doc/xsl/manual.css +22 -0
data/install.rb +1022 -0
data/lib/formatter.rb +314 -0
data/lib/html-parser.rb +429 -0
data/lib/htmlrepair.rb +113 -0
data/lib/htmlsplit.rb +842 -0
data/lib/sgml-parser.rb +332 -0
data/lib/web.rb +68 -0
data/lib/web/assertinclude.rb +129 -0
data/lib/web/config.rb +50 -0
data/lib/web/connection.rb +1070 -0
data/lib/web/convenience.rb +154 -0
data/lib/web/formreader.rb +318 -0
data/lib/web/htmlparser/html-parser.rb +429 -0
data/lib/web/htmlparser/sgml-parser.rb +332 -0
data/lib/web/htmltools/element.rb +296 -0
data/lib/web/htmltools/stparser.rb +276 -0
data/lib/web/htmltools/tags.rb +286 -0
data/lib/web/htmltools/tree.rb +139 -0
data/lib/web/htmltools/xmltree.rb +160 -0
data/lib/web/htmltools/xpath.rb +71 -0
data/lib/web/info.rb +63 -0
data/lib/web/load.rb +210 -0
data/lib/web/mime.rb +87 -0
data/lib/web/phprb.rb +340 -0
data/lib/web/resources/test/cookie.rb +33 -0
data/lib/web/resources/test/counter.rb +20 -0
data/lib/web/resources/test/multipart.rb +14 -0
data/lib/web/resources/test/redirect.rb +8 -0
data/lib/web/resources/test/stock.rb +33 -0
data/lib/web/sapi/apache.rb +129 -0
data/lib/web/sapi/fastcgi.rb +22 -0
data/lib/web/sapi/install/apache.rb +180 -0
data/lib/web/sapi/install/iis.rb +93 -0
data/lib/web/sapi/install/macosx.rb +90 -0
data/lib/web/sapi/webrick.rb +86 -0
data/lib/web/session.rb +83 -0
data/lib/web/shim/cgi.rb +129 -0
data/lib/web/shim/rails.rb +175 -0
data/lib/web/stringio.rb +78 -0
data/lib/web/strscanparser.rb +24 -0
data/lib/web/tagparser.rb +96 -0
data/lib/web/testing.rb +666 -0
data/lib/web/traceoutput.rb +75 -0
data/lib/web/unit.rb +56 -0
data/lib/web/upload.rb +59 -0
data/lib/web/validate.rb +52 -0
data/lib/web/wiki.rb +557 -0
data/lib/web/wiki/linker.rb +72 -0
data/lib/web/wiki/page.rb +201 -0
data/lib/webunit.rb +27 -0
data/lib/webunit/assert.rb +152 -0
data/lib/webunit/converter.rb +154 -0
data/lib/webunit/cookie.rb +118 -0
data/lib/webunit/domwalker.rb +185 -0
data/lib/webunit/exception.rb +14 -0
data/lib/webunit/form.rb +116 -0
data/lib/webunit/frame.rb +37 -0
data/lib/webunit/htmlelem.rb +122 -0
data/lib/webunit/image.rb +26 -0
data/lib/webunit/jscript.rb +31 -0
data/lib/webunit/link.rb +33 -0
data/lib/webunit/params.rb +321 -0
data/lib/webunit/parser.rb +229 -0
data/lib/webunit/response.rb +464 -0
data/lib/webunit/runtest.rb +41 -0
data/lib/webunit/table.rb +148 -0
data/lib/webunit/testcase.rb +45 -0
data/lib/webunit/ui/cui/testrunner.rb +50 -0
data/lib/webunit/utils.rb +68 -0
data/lib/webunit/webunit.rb +28 -0
data/test/dev/action.rb +83 -0
data/test/dev/forms.rb +104 -0
data/test/dev/forms2.rb +104 -0
data/test/dev/parser.rb +17 -0
data/test/dev/scripts/dump.rb +24 -0
data/test/dev/scripts/makedist.rb +62 -0
data/test/dev/scripts/uri.rb +41 -0
data/test/dev/scripts/uri/common.rb +432 -0
data/test/dev/scripts/uri/ftp.rb +149 -0
data/test/dev/scripts/uri/generic.rb +1106 -0
data/test/dev/scripts/uri/http.rb +76 -0
data/test/dev/scripts/uri/https.rb +26 -0
data/test/dev/scripts/uri/ldap.rb +238 -0
data/test/dev/scripts/uri/mailto.rb +260 -0
data/test/dev/scripts/urireg.rb +174 -0
data/test/dev/simpledispatcher.rb +156 -0
data/test/dev/test.action.rb +146 -0
data/test/dev/test.formreader.rb +463 -0
data/test/dev/test.simpledispatcher.rb +186 -0
data/test/dev/webunit/conv/digit-0.rb +21 -0
data/test/dev/webunit/conv/digit-1.rb +17 -0
data/test/dev/webunit/conv/digit.rb +23 -0
data/test/dev/webunit/conv/test_digit-0.rb +16 -0
data/test/dev/webunit/conv/test_digit-1.rb +19 -0
data/test/dev/webunit/conv/test_digit.rb +26 -0
data/test/dev/webunit/conv/test_digit_view-0.rb +76 -0
data/test/dev/webunit/conv/test_digit_view-1.rb +102 -0
data/test/dev/webunit/conv/test_digit_view.rb +134 -0
data/test/installation/htdocs/cgi_test.rb +296 -0
data/test/installation/htdocs/test_install.rb +4 -0
data/test/installation/runwebtest.rb +5 -0
data/test/installation/test_cookie.rb +128 -0
data/test/installation/test_form.rb +47 -0
data/test/installation/test_multipart.rb +51 -0
data/test/installation/test_request.rb +24 -0
data/test/installation/test_response.rb +35 -0
data/test/unit/htdocs/cookie.rb +32 -0
data/test/unit/htdocs/multipart.rb +28 -0
data/test/unit/htdocs/redirect.rb +12 -0
data/test/unit/htdocs/simple.rb +13 -0
data/test/unit/htdocs/stock.rb +33 -0
data/test/unit/test_assert.rb +162 -0
data/test/unit/test_cookie.rb +114 -0
data/test/unit/test_domwalker.rb +77 -0
data/test/unit/test_form.rb +42 -0
data/test/unit/test_frame.rb +40 -0
data/test/unit/test_htmlelem.rb +74 -0
data/test/unit/test_image.rb +45 -0
data/test/unit/test_jscript.rb +57 -0
data/test/unit/test_link.rb +85 -0
data/test/unit/test_multipart.rb +51 -0
data/test/unit/test_params.rb +210 -0
data/test/unit/test_parser.rb +53 -0
data/test/unit/test_response.rb +150 -0
data/test/unit/test_table.rb +70 -0
data/test/unit/test_utils.rb +106 -0
data/test/unit/test_webunit.rb +28 -0
data/test/web/mod_ruby_stub.rb +39 -0
data/test/web/test.assertinclude.rb +109 -0
data/test/web/test.buffer.rb +182 -0
data/test/web/test.code.loader.rb +78 -0
data/test/web/test.config.rb +31 -0
data/test/web/test.error.handling.rb +91 -0
data/test/web/test.formreader-2.0.rb +352 -0
data/test/web/test.load.rb +125 -0
data/test/web/test.mime-type.rb +23 -0
data/test/web/test.narf.cgi.rb +106 -0
data/test/web/test.phprb.rb +239 -0
data/test/web/test.request.rb +368 -0
data/test/web/test.response.rb +637 -0
data/test/web/test.ruby-web.rb +10 -0
data/test/web/test.session.rb +50 -0
data/test/web/test.shim.cgi.rb +96 -0
data/test/web/test.tagparser.rb +65 -0
data/test/web/test.template2.rb +297 -0
data/test/web/test.testing2.rb +318 -0
data/test/web/test.upload.rb +45 -0
data/test/web/test.validate.rb +46 -0
data/test/web/test.web.test.rb +495 -0
data/test/wiki/test.history.rb +297 -0
data/test/wiki/test.illustration_page.rb +287 -0
data/test/wiki/test.linker.rb +197 -0
data/test/wiki/test.tarpit.rb +56 -0
data/test/wiki/test.wiki.rb +300 -0
data/test/wikitestroot/admin.rb +7 -0
data/test/wikitestroot/wiki.rb +6 -0
metadata +234 -0

@@ -0,0 +1,296 @@
+# Copyright::   Copyright (C) 2002, Ned Konz <ned@bike-nomad.com>
+# License::     Same as Ruby's
+# CVS ID:       $Id: element.rb,v 1.8 2002/06/04 01:55:59 ned Exp $
+# This module is a mix-in that provides parent/child behavior to real
+# Element classes. Because it defines <tt>each()</tt> and includes Enumerable,
+# you can iterate through a tree using the usual Enumerable methods.
+require 'web/htmltools/tags'
+module HTMLTree #:nodoc: all
+  module TreeElement
+    include Enumerable
+    protected
+    def initialize_tree_element(parent_or_nil = nil, contents_or_nil = nil)
+      @_content, @_parent = contents_or_nil, parent_or_nil
+      if parent_or_nil
+        parent_or_nil.add_child(self)
+      end
+    end
+    attr_accessor :_parent
+    public
+    # Add one or more children to this node.
+    def add_child(*children_to_add)
+      if can_have_children?
+        children_to_add.each do |child|
+          @_content << child
+          child._parent = self
+        end
+      else
+        raise(ArgumentError.exception('node cannot have children'))
+      end
+    end
+    alias_method(:add_children, :add_child)
+    # Remove one or more children from this node.
+    def remove_child(*children_to_remove)
+      if can_have_children?
+        children_to_remove.each do |child|
+          child._parent = nil if @_content.delete(child)
+        end
+      else
+        raise(ArgumentError.exception('node cannot have children'))
+      end
+    end
+    alias_method(:remove_children, :remove_child)
+    # Change my parent. Disconnects from prior parent, if any.
+    def parent=(parent_or_nil)
+      @_parent.remove_child(self) if @_parent
+      parent_or_nil.add_child(self) if parent_or_nil
+    end
+    # Return true if my content is a collection of Elements
+    # rather than actual data.
+    def can_have_children?
+      @_content.kind_of?(Array)
+    end
+    # Return a collection of my children. Returns an empty Array if I am a
+    # data element, just to keep other methods simple.
+    def children
+      can_have_children? ? @_content : []
+    end
+    # Return my content; either my children or my data.
+    def content
+      @_content
+    end
+    # Return my parent element.
+    def parent
+      @_parent
+    end
+    # Return the ultimate parent.
+    def root
+      @_parent ? self : @_parent.root
+    end
+    # Return true if I have any children.
+    def has_children?
+      children.size > 0
+    end
+    # Breadth-first iterator, required by Enumerable.
+    def each(&block)
+      block.call(self)
+      children.each { |ch| ch.each(&block) }
+    end
+    # Print out to $stdout (or given IO or String)
+    # a formatted dump of my structure.
+    def dump(indent=0, io=$stdout)
+      io << "  " * indent
+      io << self.to_s
+      io << "\n"
+      children.each { |ea| ea.dump(indent+1, io) }
+    end
+  end
+  # This is a Element that represents the whole document (and makes a
+  # scope for the DTD declaration)
+  class Document
+    include TreeElement
+    def initialize
+      initialize_tree_element(nil, [])
+    end
+    def to_s
+      ''
+    end
+    def each(&block)
+      children.each { |ch| ch.each(&block) }
+    end
+    def write(io)
+      children.each { |t| t.write(io) }
+    end
+    def tag
+      ''
+    end
+    # Return my child <html> node, if any.
+    def html_node
+      children.detect { |ea| ea.tag == 'html' }
+    end
+  end
+  # This is a TreeElement that represents tagged items in an HTML
+  # document.
+  class Element
+    include TreeElement
+    protected
+    # parent_or_nil::   TreeElement or nil
+    # tag_name::        String
+    def initialize(parent_or_nil = nil, tag_name = nil)
+      initialize_tree_element(parent_or_nil, [])
+      @_tag = tag_name
+      @_attributes = {}
+      @_attribute_order = []
+    end
+    public
+    def can_have_children?; true; end
+    # Return true if I'm data instead of a tag
+    def data?; false; end
+    def to_s
+      a = [ "<", tag ]
+      @_attribute_order.each { |k|
+        v = @_attributes[k]
+        a << " #{k.to_s}=\"#{v.to_s}\""
+      }
+      a << ">"
+      a.join('')
+    end
+    # Append an attribute. <tt>values</tt> are first flattened into an Array,
+    # then converted into strings.
+    #
+    # If there is a single attribute value, it will appear as a String,
+    # otherwise it will be an Array of Strings.
+    #
+    # Example:
+    #   element.add_attribute("width", "123")
+    #   element.add_attribute("value", [ "a", "b" ])
+    def add_attribute(name, *values)
+      values = values.flatten.collect { |ea| ea.to_s.strip }
+      name = name.downcase
+      if @_attributes.include?(name)
+        @_attributes[name] = @_attributes[name].to_a + values
+      else
+        @_attributes[name] = values.size > 1 ? values : values[0]
+      end
+      @_attribute_order << name
+      self
+    end
+    # Return my tag (should be a String)
+    def tag; @_tag; end
+    # Return an HTML::Tag for further information, or nil if this is an
+    # unknown tag.
+    def tag_info
+      begin
+        HTML::Tag.named(@_tag)
+      rescue NoSuchHTMLTagError
+        nil
+      end
+    end
+    # Return my attributes Hash.
+    def attributes; @_attributes; end
+    # Return the order of my attributes
+    def attribute_order; @_attribute_order; end
+    # Return the value of a single attribute (a String or Array).
+    def attribute(name); @_attributes[name]; end
+    # Return the value of a single attribute (a String or Array).
+    def [](name); attribute(name); end
+    # Replace an attribute.
+    def []=(name, *values)
+      @_attributes[name] = values.size > 1 ? values : values[0]
+      @_attribute_order.delete(name)
+      self
+    end
+    # Print me (and my descendents) on the given IO stream.
+    def write(io)
+      io << self
+      children.each { |t| t.write(io) }
+      unless tag_info.is_empty_element
+        io.puts( "</#{tag()}>" )
+      end
+    end
+  end
+  # This is a TreeElement that represents leaf data nodes (CDATA, scripts,
+  # comments, processing directives). It forwards unknown messages to the
+  # content element, so it otherwise behaves like a String.
+  class Data
+    include TreeElement
+    protected
+    # parent_or_nil:: parent, TreeElement or nil
+    # str:: contents, String
+    def initialize(parent_or_nil = nil, str = '')
+      initialize_tree_element(parent_or_nil, str)
+    end
+    public
+    # Return true because I am a data Element.
+    def data?; true; end
+    # Return false because I have no children.
+    def can_have_children?; false; end
+    # Return an empty collection because I have no children.
+    def children; []; end
+    # Return my (empty) tag String.
+    def tag; ''; end
+    # Return my (empty) attributes Hash.
+    def attributes; {}; end
+    def to_s
+      @_content
+    end
+    # Print me on the given IO stream.
+    def write(io)
+      io << self
+    end
+    # Forward all other methods to my content, so I can otherwise behave
+    # like a String.
+    def method_missing(sym, *args)
+      @_content.method(sym).call(*args)
+    end
+  end
+  class Comment < Data
+    def to_s
+      '<!--' + @_content + '-->'
+    end
+  end
+  class Special < Data
+    def to_s
+      '<' + @_content + '>'
+    end
+  end
+end

data/lib/web/htmltools/stparser.rb ADDED

@@ -0,0 +1,276 @@
+# Copyright:: Copyright(C) 2002 Ned Konz
+# License::   Ruby's License
+# CVS ID::    $Id: stparser.rb,v 1.6 2002/06/04 01:55:59 ned Exp $
+require 'web/htmlparser/sgml-parser'
+require 'web/htmltools/tags'
+# This is an SGMLParser subclass that knows about HTML 4.0 rules
+# and can spot empty tags and deal with tags that may have omitted endtags.
+module HTML #:nodoc: all
+  class StackingParser < SGMLParser
+    # accessors
+    def stack; @tagStack; end
+    def last_tag; @tagStack[-1] || 'html'; end
+    def parent_tag; @tagStack[-2] || 'html'; end
+    def strip_whitespace=(flag); @stripWhitespace = flag; end
+    # input methods
+    # Open and parse the given file.
+    def parse_file_named(name)
+      File.open(name) { |f|
+        while bytes = f.read(65536)
+          feed(bytes)
+        end
+      }
+    end
+    # Feed some more data to the parser.
+    def feed(string)
+      super
+      while @saved.size > 0
+        saved = @saved
+        @saved = ''
+        super(saved)
+      end
+    end
+    # available only to subclasses
+    private
+    if $DEBUG
+      def dprint(*stuff)
+        print(("  " * @tagStack.size), stuff) if @verbose
+      end
+    else
+      def dprint(*stuff); end
+    end
+    def warn(msg)
+      $stderr.print(msg) if @verbose
+    end
+    def initialize(verbose=false, strip_white=false)
+      super(verbose)
+      @tagStack = []
+      @saved = ''
+      @stripWhitespace = strip_white
+    end
+    # handle_data will call this.
+    def skip_script(data)
+      # is the end of the script in this buffer?
+      if m = data.index(%r{</[A-Za-z]})
+        @nomoretags = false
+        @saved = data[m..-1]
+        handle_script(data[0,m]) # call user handler
+      else
+        handle_script(data)
+      end
+    end
+    # Unfortunately, sgml-parser calls this and there's important work to do in
+    # it. So the user handler has to be named something different.
+    def handle_data(data)
+      # need to handle scripts
+      if last_tag() == 'script' && @nomoretags
+        skip_script(data)
+      else
+        if @stripWhitespace
+          begin
+            data.strip! if HTML::Tag.named(last_tag()).can_ignore_whitespace
+          rescue NoSuchHTMLTagError
+            data.strip!
+          end
+        end
+        handle_cdata(data)  if data.size > 0 # call user handler
+      end
+    end
+    def finish_starttag(tag, attrs)
+      dprint "*START* #{tag} #{attrs.inspect}\n"
+      # dprint "-START- #{tag}\n"
+      begin
+        unless HTML::Tag.named(last_tag()).can_contain(tag, parent_tag())
+          dprint "-INSERT-\n"
+          finish_endtag(last_tag())
+        end
+      rescue NoSuchHTMLTagError
+        # hmm.. last_tag was unknown.
+        # Assume it doesn't have an optional endtag.
+      end
+      push(tag)
+      begin
+        if HTML::Tag.named(tag).is_empty_element
+          dprint "-EMPTY-\n"
+          handle_empty_tag(tag, attrs)  # call user handler
+          drop_to_tag(tag)
+        else
+          handle_start_tag(tag, attrs)  # call user handler
+        end
+        if tag.downcase == 'script'
+          @nomoretags = true
+        end
+      rescue NoSuchHTMLTagError
+        # hmm... the start tag is unknown.
+        # And we pushed it.
+        # If it's empty, we'll get rid of it at the next end tag.
+        handle_unknown_tag(tag, attrs)
+      end
+    end
+    # return true if tag is not extra
+    def drop_to_tag(tag)
+      dropped = @tagStack.size - (@tagStack.rindex(tag.downcase) || @tagStack.size)
+      if dropped == 0   # got an end tag but we haven't seen start tag?
+        handle_extra_end_tag(tag)  # call user handler
+        return false
+      end
+      dropped.times do
+        begin
+          # detect missing end tag
+          if last_tag != tag and ! HTML::Tag.named(last_tag).can_omit_end_tag
+            handle_missing_end_tag(last_tag)  # call user handler
+          end
+        rescue NoSuchHTMLTagError
+          # oops, don't recognize last_tag.
+        end
+        pop
+      end
+      return true
+    end
+    def finish_endtag(tag)
+      dprint "*END* #{tag}\n"
+      if drop_to_tag(tag)
+        dprint "-END- #{tag} #{@tagStack.inspect}\n"
+        handle_end_tag(tag) # call user handler
+      end
+    end
+    def push(tag)
+      @tagStack.push(tag.downcase)
+      dprint "*PUSH* #{tag} => #{@tagStack.inspect}\n"
+    end
+    def pop
+      tag = @tagStack.pop
+      dprint "*POP*  #{tag} => #{@tagStack.inspect}\n"
+      tag
+    end
+    def unknown_charref(name)
+      handle_unknown_character(name)
+    end
+    def unknown_entityref(name)
+      handle_unknown_entity(name)
+    end
+    # callbacks: can be overridden in subclasses
+    def handle_start_tag(tag, attrs)
+    end
+    def handle_end_tag(tag)
+    end
+    # by default, an empty tag is handled as a start tag
+    # with an inserted end tag.
+    def handle_empty_tag(tag, attrs)
+      handle_start_tag(tag, attrs)
+      handle_end_tag(tag)
+    end
+    def handle_unknown_tag(tag, attrs)
+      warn("warning: unknown tag #{tag}\n")
+    end
+    def handle_missing_end_tag(tag)
+      warn("warning: missing end tag </#{tag}>\n")
+    end
+    def handle_extra_end_tag(tag)
+      warn("warning: extra end tag </#{tag}>\n")
+    end
+    def handle_cdata(data)
+    end
+    def handle_script(data)
+    end
+    def handle_unknown_character(name)
+    end
+    def handle_unknown_entity(name)
+    end
+    # call super if you want the data stripped
+    def handle_comment(data)
+      data.strip! if @stripWhitespace
+    end
+    def handle_special(data)
+    end
+  end
+end
+# test script
+if $0 == __FILE__
+  $stdout.sync = true
+  class TestStackingParser < HTML::StackingParser #:nodoc: all
+    def dump_stack
+      stack.each { |ea| print ea, '/' }
+    end
+    def handle_start_tag(tag, attrs)
+      print("START: #{tag} #{attrs.inspect}\n")
+    end
+    def handle_end_tag(tag)
+      # print("END: #{tag}\n")
+    end
+    def handle_empty_tag(tag, attrs)
+      # print("EMPTY: #{tag} #{attrs.inspect}\n")
+    end
+    def handle_cdata(data)
+      # print("DATA: #{data.size} chars\n")
+      if last_tag() != 'style'
+        str = data.strip
+        if str.size > 0
+          dump_stack
+          print(str.inspect, "\n")
+        end
+      end
+    end
+    def handle_script(data)
+      # print("SCRIPT: #{data.size} chars\n")
+    end
+    def handle_unknown_character(name)
+      print("UNKC: #{name}\n")
+    end
+    def handle_unknown_entity(name)
+      print("UNKE: #{name}\n")
+    end
+    def handle_comment(data)
+      super
+      print("COMMENT: #{data}\n")
+    end
+    def handle_special(data)
+      print("SPECIAL: #{data}\n")
+    end
+  end
+  $DEBUG = false
+  p = TestStackingParser.new(true)
+  p.parse_file_named(ARGV[0] || 'ebay.html')
+end