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

ruby-web 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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

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

@@ -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