RubyGems - assert2 - Versions diffs - 0.3.2 → 0.3.3 - Mend

assert2 0.3.2 → 0.3.3

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 (9) hide show

data/lib/assert2.rb +323 -216
data/lib/assert2/flunk.rb +87 -0
data/lib/assert2/null_reflector.rb +0 -0
data/lib/assert2/ripdoc.html.erb +182 -0
data/lib/assert2/ripdoc.rb +413 -0
data/lib/assert2/ripper_reflector.rb +726 -0
data/lib/{ruby_reflector.rb → assert2/rubynode_reflector.rb} +100 -71
data/lib/assert2/xpath.rb +159 -0
metadata +47 -41

data/lib/assert2/flunk.rb ADDED Viewed

@@ -0,0 +1,87 @@
+require 'test/unit'
+module Test; module Unit; module Assertions
+  # Assert that a block raises a given Exception type matching
+  # a given message
+  #
+  # * +types+ - single exception class or array of classes
+  # * +matcher+ - Regular Expression to match the inner_text of XML nodes
+  # * +diagnostic+ - optional string to add to failure message
+  # * +block+ - Ruby statements that should raise an exception
+  #
+  # Examples:
+  # %transclude AssertXPathSuite#test_assert_raise_message_detects_assertion_failure
+  #
+  # %transclude AssertXPathSuite#test_assert_raise_message_raises_message
+  #
+  # See: {assert_raise - Don't Just Say "No"}[http://www.oreillynet.com/onlamp/blog/2007/07/assert_raise_on_ruby_dont_just.html]
+  #
+  def assert_raise_message(types, expected_message, message = nil, &block)
+    args = [types].flatten + [message]
+    exception = _assert_raise(*args, &block)
+    exception_message = exception.message.dup
+    if expected_message.kind_of? String
+      exception_message.gsub!(/^\s+/, '')  #  if we cosmetically strip leading spaces from both the matcher and matchee,
+      expected_message.gsub!(/^\s+/, '')  #  then multi-line assert_flunk messages are easier on the eyes!
+      expected_message = Regexp.escape(expected_message)
+    end
+    assert message do
+      exception_message.match(expected_message)
+    end
+    return exception.message
+  end
+  # TODO rebuild this
+  def deny_raise_message(types, matcher, diagnostic = nil, &block) #:nodoc:
+    exception = assert_raise_message(types, //, diagnostic, &block)
+    assert_no_match matcher,
+                 exception.message,
+                 [ diagnostic,
+                   "exception #{ exception.class.name
+                     } with this message should not raise from block:",
+                   "\t"+reflect_source(&block).split("\n").join("\n\t")
+                   ].compact.join("\n")
+    return exception.message
+  end
+  def assert_flunk(matcher, message = nil, &block)
+    assert_raise_message FlunkError, matcher, message, &block
+  end
+# TODO reinstall ruby-1.9.0 and pass all cross-tests!!
+      def _assert_raise(*args)
+#        _wrap_assertion do
+          if Module === args.last
+            message = ""
+          else
+            message = args.pop
+          end
+          exceptions, modules = args, [] # _check_exception_class(args)
+          expected = args.size == 1 ? args.first : args
+          actual_exception = nil
+          full_message = build_message(message, "<?> exception expected but none was thrown.", expected)
+          assert_block(full_message) do
+            begin
+              yield
+            rescue Exception => actual_exception
+              break
+            end
+            false
+          end
+          full_message = build_message(message, "<?> exception expected but was\n?", expected, actual_exception)
+          assert_block(full_message) {exceptions.include?(actual_exception.class)}
+          actual_exception
+  #      end
+      end
+end; end; end

data/lib/assert2/null_reflector.rb ADDED Viewed

File without changes

data/lib/assert2/ripdoc.html.erb ADDED Viewed

@@ -0,0 +1,182 @@
+<!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><%= @title %></title>
+  <meta http-equiv="content-type" content="text/html; charset=us-ascii" />
+  <script type="text/javascript" src="javascript/prototype.js"></script>
+  <script type="text/javascript" src="javascript/effects.js"></script>
+  <script type="text/javascript" src="javascript/accordion.js"></script>
+  <link rel="stylesheet" type="text/css" href="css/default.css" />
+<script type="text/javascript">
+//<![CDATA[
+  var bottomAccordion = 42;
+  function raise(id)
+  {
+    var anchor = $(id + '_');
+    if (anchor) {
+      bottomAccordion.activate(anchor.parentNode);
+    }
+  }
+  Event.observe(window, 'load', loadAccordions, false);
+  function loadAccordions() {
+    bottomAccordion = new accordion('vertical_container');
+    var anchor = window.location.href.match(/#(.+)$/);
+    if (anchor)  anchor = anchor[1];
+        if (anchor = $(anchor + '_')) {
+          bottomAccordion.activate(anchor.parentNode);
+             }
+        else {
+          bottomAccordion.activate($$('#vertical_container .accordion_toggle')[0]);
+        }
+  }
+//]]>
+</script>
+<style type="text/css">
+/*<![CDATA[*/
+                /* Vertical Accordions  */
+pre { border-width: 10px;
+        border-color: #e7e7c9;
+        border-style: solid;
+        }
+                .accordion_toggle {
+                        display: block;
+                        height: 30px;
+                        width: 680px;
+                        background: url(images/accordion_toggle.png) no-repeat top right;
+                        padding: 0 10px 0 10px;
+                        cursor: index;
+                        font-weight: normal;
+                        text-decoration: none;
+                        outline: none;
+                        font-family: 'Lucida Grande', Verdana, Arial;
+                        color: #800;
+                        cursor: pointer;
+                        margin: 0 0 0 0;
+                }
+                .accordion_toggle_active {
+                        background: url(images/accordion_toggle_active.png) no-repeat top right;
+                        color: #FDE;
+                }
+                .accordion_content {
+                        background-color: #ffffff;
+                        color: #444444;
+                        overflow: hidden;
+                }
+                        .accordion_content h2 {
+                                margin: 15px 0 5px 10px;
+                                color: #0099FF;
+                        }
+                        .accordion_content p {
+                                padding: 5px 10px 0 10px;
+                        }
+                /*
+                        Horizontal Accordion
+                */
+                .horizontal_accordion_toggle {
+                        /* REQUIRED */
+                        float: left;    /* This make sure it stays horizontal */
+                        /* REQUIRED */
+                        display: block;
+                        height: 100px;
+                        width: 30px;
+                        background: url(images/h_accordion_toggle.png) no-repeat top left #a9d06a;
+                        color: #ffffff;
+                        text-decoration: none;
+                        outline: none;
+                        border-right: 1px solid #cde99f;
+                        cursor: pointer;
+                        margin: 0 0 0 0;
+                }
+                .horizontal_accordion_toggle_active {
+                        background: url(images/h_accordion_toggle_active.png) no-repeat top left #e0542f;
+                        border-right: 1px solid #f68263;
+                }
+                .horizontal_accordion_content {
+                        /* REQUIRED */
+                        height: 100px;  /* We need to define a height for the accordion as it stretches the width */
+                        float: left;    /* This make sure it stays horizontal */
+                        /* REQUIRED */
+                        overflow: hidden;
+                        background-color: #ffffff;
+                        color: #444444;
+                }
+                        .horizontal_accordion_content p {
+                                width: 450px;
+                                /*line-height: 125%;*/
+                                padding: 5px 10px 15px 10px;
+                        }
+    /* Container styling*/
+    #horizontal_container {
+      margin: 20px auto 20px auto;
+      width: 680px;
+      height: 100px;
+    }
+    /*#vertical_nested_container {
+      margin: 20px auto 20px auto;
+      width: 620px;
+    }*/
+/*]]>*/
+</style>
+</head>
+<body style="font-family: Times,serif; background-image: url(images/sky_blue.png); background-repeat: repeat-x;">
+  <div style='position: absolute; top: 0px; left: 70%;'>
+    <a href="http://validator.w3.org/check/referer">
+      <img border='0' height="76" width="72" alt='Validates this page at W3C'
+        src="http://assert2.rubyforge.org/the_test_button.png"/>
+    </a>
+  </div>
+  <div id="container">
+    <h1><code><big style='color: #008;'><%= @title %></big></code></h1>
+    <div id="vertical_container">
+      <%= @sauce %>
+    </div>
+    <div class="page-footer">
+      <p>Accordion is &#169; Copyright 2007 <a href="http://www.stickmanlabs.com"><small>stickmanlabs</small></a> - MIT-style license</p>
+    </div>
+  </div>
+  <br />
+  <script type="text/javascript">
+//<![CDATA[
+        //
+        // You can hide the accordions on page load like this, it maintains accessibility
+        //
+        // Special thanks go out to Will Shaver @ http://primedigit.com/
+        //
+        var verticalAccordions = $$('.accordion_toggle');
+        verticalAccordions.each(function(accordion) {
+          $(accordion.next(0)).setStyle({
+            height: '0px'
+          });
+        });
+//]]>
+</script>
+</body>
+</html>

data/lib/assert2/ripdoc.rb ADDED Viewed

@@ -0,0 +1,413 @@
+#!/usr/bin/env ruby
+require 'ripper'
+require 'stringio'
+require 'cgi'
+require 'erb'
+require 'optparse'
+require 'pathname'
+# TODO  reflect the banner anchor at generation time, to figure out what to hotlink to
+class Ripdoc < Ripper::Filter
+  HomePath = (Pathname.new(__FILE__).dirname + '../..').expand_path
+  STYLES = {
+    CHAR:               'color: brown; font-weight: bolder;',
+    const:              "color: #FF4F00; font-weight: bolder;",
+    backref:            "color: #f4f; font-weight: bolder;",
+    comment:            "font-style: italic; color: #446; font-family: Times; font-size: 110%;",
+       # TODO  use "font: Times italic 110%" to save space
+    embdoc:             "background-color: #FFe; font-family: Times; font-size: 133%;",
+    embdoc_beg:         "display: none;",
+    embdoc_end:         "display: none;",
+    embexpr:            "background-color: #ccc;",
+    embexpr_delimiter:  "background-color: #aaa;",
+    gvar:               "color: #8f5902; font-weight: bolder;",
+    ivar:               "color: #240;",
+    int:                "color: #336600; font-weight: bolder;",
+    operator:           "font-weight: bolder; font-size: 120%;",
+    kw:                 "color: purple;",
+    regexp_delimiter:   "background-color: #faf;",
+    regexp:             "background-color: #fcf;",
+    string:             "background-color: white;", #dfc
+    string_delimiter:   "background-color: #cfa;",
+    symbol:             "color: #066;",
+    tstring_content: 'background: url(images/tstring.png) right;',
+    tstring_internal: 'background: url(images/tstring.png) right;',  #  TODO  merge these two!
+    tregexp_content: 'background: url(images/hot_pink.png);'
+  }
+  def self.generate(filename, title)
+    @sauce = compile_fragment(File.read(filename))
+    @title = title
+    @string_background = :tstring_content
+    erb = ERB.new((HomePath + 'lib/assert2/ripdoc.html.erb').read, nil, '>')
+    xhtml = erb.result(binding())
+    xhtml.gsub! /\<pre>\s*\<\/pre>/m, ''
+    xhtml.gsub! /\<p>\s*\<\/p>/m, ''
+    return xhtml
+  end
+  def dequote(attributes)
+    return attributes.gsub('&quot;', '"')
+  end  #  TODO  complex '"? if we can't it might be a good thing...
+  def enline(line)
+    line = CGI.escapeHTML(line)
+    return line.gsub( /&lt;a(.*?)&gt;/){ "<a #{dequote($1)}>" }.
+                gsub('&lt;/a&gt;', '</a>').
+                gsub(/&lt;br\s*\/&gt;/, '<br/>').
+                gsub( '&lt;code&gt;', '<code style="font-weight: bolder; font-style: normal;">').
+                gsub('&lt;/code&gt;', '</code>').
+                gsub( '&lt;em&gt;', '<em>').
+                gsub('&lt;/em&gt;', '</em>').
+                gsub( '&lt;li&gt;', '<li>').
+                gsub('&lt;/li&gt;', '</li>').
+                gsub( '&lt;ul&gt;', '<ul>').
+                gsub('&lt;/ul&gt;', '</ul>').
+                gsub('&amp;mdash;', '&mdash;')
+  end
+  def deformat(line, f)
+    if line =~ /^\s/   #  CONSIDER why the line-height broke??
+      f << "</p>" if @owed_p
+      f << "<pre style='line-height: 75%;'>\n" unless @owed_pre
+      @owed_p = false
+      @owed_pre = true
+      f << enline(line) << "\n"
+      return
+    end
+    f << '</pre>' if @owed_pre
+    @owed_pre = false
+    f << '<p>' unless @owed_p
+    @owed_p = true
+    f << enline(line)
+  end
+  def on_embdoc_beg(tok, f)
+    return f if @in_no_doc
+    @embdocs = []
+    f << "</pre>\n" if @owed_pre
+    @owed_pre = false
+    return f
+    # on_kw tok, f, 'embdoc_beg'
+  end
+  def is_no_doc?(tok)
+    tok.strip =~ /^\#\!nodoc\!/ or tok.strip =~ /^\#\!no_doc\!/
+  end
+  def on_embdoc(tok, f)
+    return f if @in_no_doc
+    if is_no_doc? tok
+      @in_no_doc = true
+    else
+      @embdocs << tok
+    end
+    return f
+  end
+  def on_embdoc_end(tok, f)
+    return f if @in_no_doc
+    return end_panel(f)
+    return f
+  end
+  def name_toggle(banner)
+    banner = banner.gsub(/<.*?>/, '').
+                    gsub(/&.*?;/, '').
+                    scan(/[ _[:alnum:]]/).
+                    map{|x| x == ' ' ? '_' : x }.
+                    join.
+                    gsub(/_+/, '_').
+                    gsub(/_$/, '')
+    return "<a href='#' name='#{banner}' id='#{banner}_'></a>" # CONSIDER this can't use <a ../> because enline() would mangle it...
+      #  CONSIDER  the _ is due to a bug in libxml - it squeaks at a name and id that are the same -
+       #                                     despite that's a common idiom!
+  end
+  def end_panel(f)
+      if banner = @embdocs.shift  #  accordion_toggle_active
+        f << '<h1 class="accordion_toggle">'
+        f << name_toggle(banner)
+        f << enline(banner)
+        f << '</h1>'
+      end
+      f << '<div class="accordion_content">'
+        f << '<p>'
+        @owed_p = true
+        prior = false
+        @embdocs.each do |doc|
+          if doc.strip == ''
+            f << "</p>\n<p>" if @owed_p
+            prior = false
+          elsif doc.strip =~ /^\#\!link\!(.*)/ #!link!froot!loop
+            target, contents = $1.split('!')  #  TODO  permit a ! in the contents
+            puts '#!link!anchor!text tags work best with text after the last bang!' unless contents
+            contents ||= ''
+            f << "<a href='\##{target}' onclick='raise(\"#{target}\")'>"
+            f << enline(contents)
+            f << '</a>'
+          else
+            f << ' ' if prior
+            deformat(doc, f)
+            prior = true
+          end
+        end
+        f << '</p>' if @owed_p
+    f << '<pre>' unless @owed_pre
+    @owed_pre = true
+    @embdocs = []
+    return f
+  end
+#  TODO  need a tregexp_content to distinguish them!
+  def span(kode)
+    if STYLES[kode.to_sym]
+      # class="#{kode}"
+      return %Q[<span style="#{STYLES[kode.to_sym]}">]
+    else
+      return '<span>'
+    end
+  end
+  def spanit(kode, f, tok)
+    @spans_owed ||= 0
+    @spans_owed += 1
+    f << span(kode) << CGI.escapeHTML(tok)
+  end
+  def on_kw(tok, f, klass = 'kw')
+    return f if @in_no_doc
+    f << span(klass) << CGI.escapeHTML(tok)
+    f << '</span>'
+  end
+  def on_comment(tok, f)
+    if tok.strip =~ /^\#\!end_panel\!/
+      f << '</pre>' if @owed_pre
+      @owed_pre = false
+      f << '</div>'
+      return f
+    end
+    nodoc = is_no_doc?(tok)
+    if !nodoc and !@in_no_doc and tok.strip !~ /^\s*#\!/
+      f << span(:comment) << enline(tok.rstrip) << '</span>'
+      on_nl nil, f
+    end
+    @in_no_doc ||= nodoc
+    @in_no_doc = nil if tok.strip =~ /^\#\!doc\!/
+    return f
+  end
+  def on_CHAR(tok, f)
+    return f if @in_no_doc
+    on_kw tok, f, 'CHAR'
+    return f
+  end
+# TODO linefeeds inside %w() and possibly ''
+#  TODO colorize :"" and :"#{}" correctly
+  def on_default(event, tok, f)
+    return f if @in_no_doc
+    if @symbol_begun
+      @symbol_begun = false
+      f << %Q[#{span(:symbol)}#{CGI.escapeHTML(tok)}</span>]
+    elsif tok =~ /^[[:punct:]]+$/
+      f << %Q[#{span(:operator)}#{CGI.escapeHTML(tok)}</span>]
+    else
+      on_kw tok, f, event.to_s.sub(/^on_/, '')
+    end
+    return f
+  end
+  def finish_one_span(f)
+    if @spans_owed > 0
+      f << '</span>'
+      @spans_owed -= 1
+    end
+  end
+  def on_tstring_beg(tok, f)
+    return f if @in_no_doc
+    @spans_owed += 1
+    f << span(:string)
+    @string_background = :tstring_content
+    f << %Q[#{span(:string_delimiter)}#{CGI.escapeHTML(tok)}</span>]
+  end
+  def on_tstring_content(tok, f, style = 'tstring_content')
+    tok.split(/\n/).each_with_index do |sub_tok, index|
+      if index == 0
+        on_string_stretch(sub_tok, f, style)
+      else
+        space, sub_tok = sub_tok.scan(/(\s*)(.*)/).first
+        f << space
+        on_string_stretch(sub_tok, f, style)
+      end
+    end
+    return f
+  end
+  def on_string_stretch(tok, f, klass = 'TODO remove me')
+    return f if @in_no_doc
+    f << span(@string_background.to_s) << CGI.escapeHTML(tok)
+    f << '</span>'
+  end
+#  TODO  fix end-of-delim bug in // and %w() and %{} etc
+  def on_tstring_end(tok, f)
+    return f if @in_no_doc
+    if tok.length > 1
+      margin, content, tok = tok.scan(/^(\s*)(.*)(.)$/).first
+      f << margin if margin
+      on_tstring_content content, f, 'tstring_internal' if content  #  TODO  is this used??
+    end
+    f << %Q[#{span(:string_delimiter)}#{CGI.escapeHTML(tok.to_s)}</span>]
+    finish_one_span(f)
+    return f
+  end  #  TODO  report to ripper author the bug where on_tstring_end contains the whole string
+  def on_regexp_beg(tok, f)
+    return f if @in_no_doc
+    @spans_owed += 1
+    f << span(:regexp)
+    @string_background = :tregexp_content
+    f << %Q[#{span(:regexp_delimiter)}#{CGI.escapeHTML(tok)}</span>]
+  end
+  def on_regexp_end(tok, f)
+    return f if @in_no_doc
+    f << %Q[#{span(:regexp_delimiter)}#{CGI.escapeHTML(tok)}</span>]
+    finish_one_span(f)
+    return f
+  end
+  def on_embexpr_beg(tok, f)
+    return f if @in_no_doc
+    spanit :embexpr, f, tok
+    return f
+  end  #  TODO  don't interrupt a span or nothing with a nodoc!
+  #  TODO single-line mode for nodoc
+  def on_ignored_nl(tok, f)
+    return f if @in_no_doc
+    on_nl nil, f
+  end
+  def on_nl(tok, f)
+    return f if @in_no_doc
+    f << "\n"
+  end
+  def on_lbrace(tok, f)
+    return f if @in_no_doc
+    spanit '', f, '' # tok  CONSIDER  wonder who is actually emitting the { ??
+    f << tok
+  end
+  def on_rbrace(tok, f)
+    return f if @in_no_doc
+    f << tok
+    finish_one_span(f)  #  TODO  these things might wrap lines!
+    return f
+  end
+  def on_symbeg(tok, f)
+    return f if @in_no_doc
+    on_default(:on_symbeg, tok, f)
+    @symbol_begun = true
+    return f
+  end
+#  TODO  syntax hilite the inner language of regices? how about XPathics?
+#   escapes in strings??
+  def on_ivar(tok, f)
+    return f if @in_no_doc
+    f << %Q[#{span(:ivar)}#{CGI.escapeHTML(tok)}</span>]
+  end
+  attr_accessor :embdocs,
+                :in_no_doc,
+                :owed_pre,
+                :spans_owed
+  def parse(buf, f)
+    @spans_owed = 0
+    @symbol_begun = false
+    super(buf)
+  end
+  DOCTYPE = '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+              "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">' +
+              "\n"
+  def Ripdoc.compile(f)
+    return DOCTYPE +
+            '<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr"
+            ><head>' +
+           '</head><body>' + compile_fragment(f) + '</body></html>'
+  end
+  def Ripdoc.compile_fragment(f)
+    buf = StringIO.new
+    parser = Ripdoc.new(f)
+    parser.in_no_doc = false
+    parser.owed_pre = true
+    parser.parse(buf, f)
+    result = buf.string
+    parser.spans_owed.times{ result += '</span>' }
+    return '<div id="content"><pre>' + result +
+               "#{'</pre>' if parser.owed_pre }</div>"
+  end
+end
+#~ :on_ident
+#~ :on_const
+#~ :on_semicolon
+#~ :on_op
+#~ :on_int
+#~ :on_comma
+#~ :on_lparen
+#~ :on_rparen
+#~ :on_backref
+#~ :on_period
+#~ :on_lbracket
+#~ :on_rbracket
+#~ :on_rbrace
+#~ :on_qwords_beg
+#~ :on_words_sep
+class ERB
+  attr_accessor :lineno
+  remove_method :result
+  def result(b)
+    eval(@src, b, (@filename || '(erb)'), (@lineno || 1))
+  end
+end
+system 'rubyw1.9.0 ../../test/ripdoc_suite.rb' if $0 == __FILE__