qed 2.9.2 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 9e530292395f42320e28980726cf658819f4686d
-  data.tar.gz: 9e5c260cc8e20d143b0acd43c1869a0a15b0cbdd
+SHA256:
+  metadata.gz: 0641d46bfe700cfdd8b44f9e6e50242fa08dd47950ead38b785b1c8bd2d99008
+  data.tar.gz: 658fbcd892cbed202703946fb8745fcbd7b3a06b938bdaf62c525961418e7cc3
 SHA512:
-  metadata.gz: fdab04bf50e170ba6e3b85f102e83e43764d342406004756760f8a378545dc940e6db7c05c8a80340fb50f4e3e63db02772c661bc60a7e928d17fd8f29df6ba1
-  data.tar.gz: 7821741e5709f7aa68f8cd60c75c2e1264fab196912e36a51731bd70bb3b7de536865741cccfc7c9b9d7309ee2d8667528cb3cb4bb2cf7db65324b8f0086e168
+  metadata.gz: 9a65c7101c15ed6d98ccd4353a388497f6dacb45bb96f71bf8ed03002ce6e8f1c9acc9b5b4cbe7a5bce9b182507ac2715332ae67ce0b270271c8ddbc0bec7885
+  data.tar.gz: 6a37486a0384159148eef66931d25fba51e57ce7352d8f88b73d506f0fd7fe363da709cb247b6d3b56ad2654693d5e8b0a6d70a15384cdf08dad8a356ce176c4

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/HISTORY.md

@@ -1,5 +1,40 @@
 # RELEASE HISTORY
 
+## 3.0.0 | 2026-03-31
+
+Major modernization release after a long hiatus.
+
+Breaking Changes:
+
+* Requires Ruby 3.1 or later (dropped Ruby 1.8/1.9/2.x support).
+* Removed Indexer gemspec system; uses standard gemspec.
+* Removed Detroit Assembly; uses standard Rakefile.
+
+New Features:
+
+* Fenced code block support in parser (#23).
+  Bare and ```ruby blocks are executed; other languages are skipped.
+* Restored and modernized HTML reporter with --html flag (#13).
+* GitHub Actions CI replacing Travis CI.
+* Website moved from gh-pages branch to docs/ directory.
+
+Bug Fixes:
+
+* Fix --version crash due to VERSION not being loaded (#26).
+* Fix --help crash from undefined `settings` in cli_parse (#22, #26).
+* Fix --copyright showing wrong license (Apache 2.0 -> BSD-2-Clause) (#26).
+* Fix --rooted flag not actually running from project root (#21).
+* Fix TapY reporter crash referencing `assertion` instead of `exception` (#24).
+
+Dependencies:
+
+* Switch markdown processing from rdiscount to kramdown (#20).
+* Remove instance_exec polyfill for Ruby 1.8.
+* Remove old RubyGems compatibility checks from gemspec.
+* Drop rulebow, RC, and Facets dependencies.
+* Require ansi ~> 1.6, brass ~> 1.3, ae ~> 1.9 (dev).
+
+
 ## 2.9.2 | 2014-02-24
 
 This release removes the dependency on Facets. There were only two important

data/README.md

@@ -1,12 +1,9 @@
 # Ruby Q.E.D.
 
-[Homepage](http://rubyworks.github.com/qed) /
-[Documentation](http://rubydoc.info/gems/qed/frames) /
-[Report Issue](http://github.com/rubyworks/qed/issues) /
-[Development](http://github.com/rubyworks/qed) /
-[Mailing list](http://groups.google.com/group/rubyworks-mailinglist)    
-[![Build Status](https://secure.travis-ci.org/rubyworks/qed.png)](http://travis-ci.org/rubyworks/qed)
-[![Gem Version](https://badge.fury.io/rb/qed.png)](http://badge.fury.io/rb/qed)
+[Homepage](https://rubyworks.github.io/qed) /
+[Documentation](https://rubydoc.info/gems/qed/frames) /
+[Report Issue](https://github.com/rubyworks/qed/issues) /
+[Development](https://github.com/rubyworks/qed)
 
 
 ## Introduction
@@ -15,12 +12,12 @@ Q.E.D. is an abbreviation for the well known Latin phrase "Quod Erat Demonstrand
 literally "which was to be demonstrated", which is oft written in its abbreviated
 form at the end of a mathematical proof or philosophical argument to signify
 a successful conclusion. And so it is too for Ruby Q.E.D., though it might as easily
-be taken to stand for "Quality Ensured Documentation". 
+be taken to stand for "Quality Ensured Documentation".
 
 QED is in fact both a test framework and a documentation system for Ruby
 developers. QED sits somewhere between lower-level testing tools like Test::Unit
 and grandiose requirement specifications systems like Cucumber. In practice it
-works exceptionally well for <i>API-Driven Design</i>, which is especially
+works exceptionally well for *API-Driven Design*, which is especially
 useful when designing reusable libraries, but it can be used to test code at
 any level of abstraction, from unit test to systems tests.
 
@@ -28,10 +25,12 @@ any level of abstraction, from unit test to systems tests.
 ## Features
 
 * Write tests and documentation in the same breath!
-* Demos can be RDoc, Markdown or any other conforming text format.
-* Can use any BRASS compliant assertion framework, such as the the excellent AE (Assertive Expressive) library.
-* Data and Table macros allows large sets of data to be tested by the same code.
-* Documentation tool provides nice output with jQuery-based TOC.
+* Demos can be Markdown or RDoc format.
+* Supports fenced code blocks — non-Ruby blocks (e.g. ` ```elixir `) are automatically skipped.
+* Can use any BRASS compliant assertion framework, such as the excellent AE (Assertive Expressive) library.
+* Data and Table macros allow large sets of data to be tested by the same code.
+* HTML report generation via `--html` flag.
+* Documentation tool (`qedoc`) generates browsable HTML from demos.
 
 
 ## Synopsis
@@ -40,7 +39,7 @@ any level of abstraction, from unit test to systems tests.
 
 QED can use any BRASS compliant assertions framework. Simply require the library in
 ones applique (see below). Traditionally this has been the AE (Assertive Expressive) library,
-which provides an elegant means to make assertions. To give a quick overview, assertion
+which provides an elegant means to make assertions. To give a quick overview, assertions
 can be written as:
 
     4.assert == 5
@@ -49,16 +48,16 @@ In this example, because 4 != 5, this expression will raise an Assertion
 exception. QED's Runner class is thus just a means of running and capturing
 code blocks containing such assertions.
 
-You can learn more about BRASS and AE at http://rubyworks.github.com/brass and
-http://rubyworks.github.com/ae, repectively.
+You can learn more about BRASS and AE at https://github.com/rubyworks/brass and
+https://github.com/rubyworks/ae, respectively.
 
 ### Document Structure
 
 QED documents are simply text files called *demonstrandum* (demos for short).
 Because they largely consist of free-form descriptive text, they are a practice
-pure Literate Programming. For example:
+of pure Literate Programming. For example:
 
-    = Example
+    # Example
 
     Shows that the number 5 does not equal 4.
 
@@ -68,18 +67,24 @@ pure Literate Programming. For example:
 
         5.assert == 5
 
-In this example RDoc was chosen for the document format. However, almost any
-text format can be used. The only necessary distinction is that description text
-align to the left margin and all code be indented, although QED does recognize
-RDoc and Markdown single-line style headers, so any format that supports
-those (which covers many markup formats in use today) will have mildly
-improved console output. In any case, the essential take away here is that
-QED *demonstrandum* are simply descriptive documents with interspersed 
-blocks of example code.
+Description text aligns to the left margin and all code is indented. QED also
+supports fenced code blocks:
 
-Give this design some thought. It should become clear that this approach is
-especially fruitful in that it allows *documentation* and *specification*
-to seamlessly merge into a unified *demonstration*. 
+    ```ruby
+    5.assert == 5
+    ```
+
+Blocks tagged with a non-Ruby language are skipped during execution, which is
+useful for multi-language documentation:
+
+    ```javascript
+    // This is not executed
+    console.log("hello");
+    ```
+
+QED recognizes Markdown and RDoc headers for improved console output. The
+essential take away is that QED *demonstrandum* are simply descriptive
+documents with interspersed blocks of example code.
 
 ### Running Demonstrations
 
@@ -87,22 +92,22 @@ If we were to run the above document through QED in verbatim mode the output
 would be identical (assuming we did not make a typo and the assertions passed).
 If there were errors or failures, we would see information detailing each.
 
-To run a document through QED, simply use the +qed+ command.
+To run a document through QED, simply use the `qed` command.
 
-  $ qed -v demo/01_example.rdoc
+    $ qed -v demo/01_example.md
 
-The `-v` option specifies verbatim mode, which outputs the entire
-document.
+The `-v` option specifies verbatim mode, which outputs the entire document.
 
 Notice we placed the QED document in a `demo/` directory. This is the
-canonical location, but there is no place that demonstrations have to go. They
-can be placed anywhere that is preferred. However, the `qed` command
-will look for `qed/`, `demo/`, `demos/` and `spec/`, in that order, if no
-path is given.
+canonical location, but demonstrations can be placed anywhere. The `qed`
+command will look for `qed/`, `demo/`, `demos/` and `spec/`, in that order,
+if no path is given.
+
+The `01_` prefix helps order documents when generating QED documentation.
+
+To generate an HTML test report:
 
-Also notice the use of ``01_`` prefix in front of the file name.
-While this is not strictly necessary, QED sorts the documents, so it helps order
-the documents nicely, in particular when generating QED documentation ("QEDocs").
+    $ qed --html > report.html
 
 ### Utilizing Applique
 
@@ -110,9 +115,9 @@ QED demonstrandum descriptive text is not strictly passive explanation. Using
 pattern matching techniques, document phrases can trigger underlying actions.
 These actions provide a support structure for running tests called the *applique*.
 
-Creating an applique is easy. Along with your QED scripts, to which the 
+Creating an applique is easy. Along with your QED scripts, to which the
 applique will apply, create an `applique/` directory. In this
-directory add Ruby scripts. When you run your demos every Ruby script in 
+directory add Ruby scripts. When you run your demos every Ruby script in
 the directory will be automatically loaded.
 
 Within these applique scripts *advice* can be defined. Advice can be
@@ -126,11 +131,11 @@ phrases in the QED demos. An example would be:
     end
 
 So that whenever the phrase "a new round is started" appears in a demo,
-the @round instance variable with be reset to an empty array.
+the @round instance variable will be reset to an empty array.
 
-It is rather amazing what can be accomplished with such a system,
-be sure to look at QED's own demonstrandum to get a better notion of
-how you can put the the system to use.
+It is rather amazing what can be accomplished with such a system.
+Be sure to look at QED's own demonstrandum to get a better notion of
+how you can put the system to use.
 
 ### Configuration
 
@@ -154,63 +159,53 @@ Or by setting the `profile` environment variable.
 
     $ profile=coverage qed
 
-QED can also use the [RC](http://rubyworks.github.com/rc) gem to handle
-configuration. Be sure to `gem install rc` and then add this to `.rubyrc`
-or `Config.rb` file of the same effect as given above.
-
-    config :qed, :profile=>:coverage do
-      require 'simplecov'
-      SimpleCov.start do
-        coverage_dir 'log/coverage'
-      end
-    end
-
 ### Generating Documentation
 
-To generate documentation from QED documents, use the +qedoc+ command.
+To generate documentation from QED documents, use the `qedoc` command.
 
-    $ qedoc --output doc/qedoc --title "Example" demo/*.rdoc
+    $ qedoc --output doc/demo.html --title "Example" demo/
 
-When documenting, QED recognizes the format by the file extension and 
-treats it accordingly. An extension of `.qed` is treated the same
-as `.rdoc`.
+When documenting, QED recognizes the format by the file extension and
+treats it accordingly.
 
-Use the `--help` options on each command to get more information
+Use the `--help` option on each command to get more information
 on the use of these commands.
 
 
 ## Requirements
 
-QED depends on the following external libraries:
+QED depends on the following libraries:
+
+* [BRASS](https://github.com/rubyworks/brass) - Assertions System
+* [ANSI](https://github.com/rubyworks/ansi) - ANSI Color Codes
+* [kramdown](https://kramdown.gettalong.org/) - Markdown Processing
 
-* [BRASS](http://rubyworks.github.com/brass) - Assertions System
-* [ANSI](http://rubyworks.github.com/ansi) - ANSI Color Codes
-* [RC](http://rubyworks.github.com/rc) - Runtime Configuration
-* [Facets](http://rubyworks.github.com/facets) - Core Extensions
+These will be automatically installed when installing QED via RubyGems.
 
-These will be automatically installed when installing QED via RubyGems,
-if they are not already installed.
+Optional libraries that are generally useful with QED:
 
-Optional libraries that are generally useful with QED.
+* [AE](https://github.com/rubyworks/ae) - Assertions Framework
 
-* [AE](http://rubyworks.github.com/ae) - Assertions Framework
+Install AE and require it in your applique to use.
 
-Install these individually and require them in your applique to use.
+Requires Ruby 3.1 or later.
 
 
 ## Development
 
 ### Testing
 
-QED uses itself for testing, which can be a bit tricky. But works fine for
-the most part. In the future we may add some addition tests via another
-test framework to ensure full coverage. But for now QED is proving sufficient.
+QED uses itself for testing. To run the tests:
 
-To run the tests, use `qed` command line tool --ideally use `$ ruby -Ilib bin/qed`
-to ensure the current version of QED is being used.
+    $ rake demo
 
-For convenience, use `$ fire spec` to run the test specifications. To also 
-generate a test coverage report use `$ fire spec:cov`.
+Or directly:
+
+    $ ruby -Ilib bin/qed
+
+To generate a test coverage report:
+
+    $ rake demo:cov
 
 
 ## Copyrights
@@ -220,4 +215,3 @@ generate a test coverage report use `$ fire spec:cov`.
 Copyright (c) 2009 Rubyworks. All rights reserved.
 
 See LICENSE.txt for details.
-

data/demo/13_fenced_code_blocks.md

@@ -0,0 +1,60 @@
+# Fenced Code Blocks
+
+QED supports fenced code blocks using triple backticks in addition
+to the traditional indented code blocks.
+
+## Bare fenced blocks
+
+A bare fenced block (no language tag) is treated as Ruby.
+
+```
+x = 1 + 1
+x.assert == 2
+```
+
+## Ruby-tagged fenced blocks
+
+A block explicitly tagged as `ruby` is also executed.
+
+```ruby
+y = "hello"
+y.assert == "hello"
+```
+
+## Foreign language blocks are skipped
+
+Code blocks tagged with any language other than Ruby are ignored.
+This is useful for documentation that includes examples in other
+languages.
+
+```elixir
+# This Elixir code is NOT executed.
+# If it were, QED would raise an error.
+IO.puts "hello from elixir"
+```
+
+```javascript
+// This JavaScript is also skipped.
+console.log("hello from js");
+```
+
+We can verify that Ruby execution continues normally after
+skipping foreign blocks.
+
+    z = 42
+    z.assert == 42
+
+## Mixed usage
+
+Traditional indented blocks and fenced blocks can be used
+together in the same document.
+
+    a = 10
+
+```ruby
+b = 20
+```
+
+And the results carry across.
+
+    (a + b).assert == 30

data/lib/qed/cli/qed.rb

@@ -10,9 +10,9 @@ module QED
     #
     # Session settings are passed to `Session.new`.
     #
-    #def self.settings
-    #  @settings ||= Settings.new
-    #end
+    def self.settings
+      @settings ||= Settings.new
+    end
 
     #
     # Command line interface for running demos.
@@ -56,8 +56,8 @@ module QED
 
       options = cli_parse(argv)
 
-      settings = Settings.new(options)
-      session  = Session.new(settings)
+      @settings = Settings.new(options)
+      session  = Session.new(@settings)
       success  = session.run
 
       exit -1 unless success
@@ -86,9 +86,9 @@ module QED
         #opt.on('--bullet', '-b', "use bullet-point reporter") do
         #  options[:format] = :bullet
         #end
-        #opt.on('--html', '-h', "use underlying HTML reporter") do
-        #  options[:format] = :html
-        #end
+        opt.on('--html', "generate HTML report") do
+          options[:format] = :html
+        end
         #opt.on('--script', "psuedo-reporter") do
         #  options[:format] = :script  # psuedo-reporter
         #end
@@ -134,7 +134,7 @@ module QED
           exit
         end
         opt.on_tail('--copyright', "display copyrights") do
-          puts "Copyright (c) 2008 Thomas Sawyer, Apache 2.0 License"
+          puts "Copyright (c) 2008 Thomas Sawyer, BSD-2-Clause License"
           exit
         end
         opt.on_tail('--help', '-h', "display this help message") do
@@ -142,8 +142,7 @@ module QED
 
           unless settings.profiles.empty?
             puts "Available Profiles:"
-            #require 'confection'
-            QED.profiles.each do |name|
+            settings.profiles.each do |name|
               next if name.strip == ''
               puts "    -p #{name}"
             end

data/lib/qed/cli.rb

@@ -1,10 +1,5 @@
-if RUBY_VERSION < '1.9'
-  require 'qed/configure'
-  require 'qed/cli/qed'
-  require 'qed/cli/qedoc'
-else
-  require_relative 'configure'
-  require_relative 'cli/qed'
-  require_relative 'cli/qedoc'
-end
+require_relative 'version'
+require_relative 'configure'
+require_relative 'cli/qed'
+require_relative 'cli/qedoc'
 

data/lib/qed/core_ext.rb

@@ -2,38 +2,6 @@ require 'brass'
 
 class Object
 
-  unless method_defined?(:instance_exec) # 1.9
-    require 'thread'
-
-    module InstanceExecMethods #:nodoc:
-    end
-
-    include InstanceExecMethods
-
-    # Evaluate the block with the given arguments within the context of
-    # this object, so self is set to the method receiver.
-    #
-    # From Mauricio's http://eigenclass.org/hiki/bounded+space+instance_exec
-    #
-    # This version has been borrowed from Rails for compatibility sake.
-    def instance_exec(*args, &block)
-      begin
-        old_critical, Thread.critical = Thread.critical, true
-        n = 0
-        n += 1 while respond_to?(method_name = "__instance_exec#{n}")
-        InstanceExecMethods.module_eval { define_method(method_name, &block) }
-      ensure
-        Thread.critical = old_critical
-      end
-
-      begin
-        send(method_name, *args)
-      ensure
-        InstanceExecMethods.module_eval { remove_method(method_name) } rescue nil
-      end
-    end
-  end
-
   #
   # This is used by the `#=>` notation.
   #

data/lib/qed/document.rb

@@ -147,10 +147,9 @@ module QED
             text << txt
           end        
         when '.md', '.markdown'
-          require_rdiscount
+          require_kramdown
           if html?
-            markdown = RDiscount.new(txt)
-            text << markdown.to_html
+            text << Kramdown::Document.new(txt).to_html
           else
             text << txt
           end
@@ -251,9 +250,9 @@ module QED
     end
 
     #
-    def require_rdiscount
-      @require_rdiscount ||= (
-        require 'rdiscount'
+    def require_kramdown
+      @require_kramdown ||= (
+        require 'kramdown'
         true
       )
     end

data/lib/qed/parser.rb

@@ -101,30 +101,61 @@ module QED
       steps    = []
       blank    = false
       indented = false
+      fenced   = false   # inside a ``` ruby/bare code fence
+      foreign  = false   # inside a ``` non-ruby code fence
       explain  = []
       example  = [] #Step.new(file)
 
       lines.each do |lineno, line|
         case line
-        when /^\s*$/  # blank line
-          blank = true
-          if indented
-            example << [lineno, line]
+        when /\A```ruby\s*$/   # ```ruby opens a ruby fence
+          fenced  = true
+          foreign = false
+          next
+        when /\A```\s*$/       # bare ``` either opens or closes a fence
+          if fenced || foreign
+            fenced  = false
+            foreign = false
+            next
           else
-            explain << [lineno, line]
+            fenced = true      # bare ``` opens a ruby fence
+            next
           end
-        when /\A\s+/  #/\A(\t|\ \ +)/  # indented
+        when /\A```\S/         # ```<language> opens a foreign fence
+          foreign = true
+          next
+        else
+          # skip lines inside foreign code fences
+          next if foreign
+        end
+
+        if fenced
+          # lines inside a ruby fence are treated as example code
           indented = true
           blank    = false
           example << [lineno, line]
         else
-          if indented or blank
-            steps << Step.new(demo, explain, example, steps.last)
-            explain, example = [], [] #Step.new(file)
+          case line
+          when /^\s*$/  # blank line
+            blank = true
+            if indented
+              example << [lineno, line]
+            else
+              explain << [lineno, line]
+            end
+          when /\A\s+/  # indented
+            indented = true
+            blank    = false
+            example << [lineno, line]
+          else
+            if indented or blank
+              steps << Step.new(demo, explain, example, steps.last)
+              explain, example = [], []
+            end
+            indented = false
+            blank    = false
+            explain << [lineno, line]
           end
-          indented = false
-          blank    = false
-          explain << [lineno, line]
         end
       end
       steps << Step.new(demo, explain, example, steps.last)

data/lib/qed/reporter/html.rb

@@ -1,160 +1,167 @@
-# encoding: UTF-8
+require 'erb'
+require 'kramdown'
+require 'qed/reporter/abstract'
 
 module QED
 module Reporter
 
-  require 'qed/reporter/abstract'
-
   # = Html Reporter
   #
-  # NOTE: This must be completely redesigned since we moved back
-  # to text based evaluation --which makes generting HTML with 
-  # modifications from the evaluation tricky. But I've come up
-  # with a farily clever way to handle this. Take the original
-  # and use Tilt to translate it into HTML, then take the
-  # evaluation results for code steps and use it to search
-  # the HTML for "the closest match". Find the \<pre> tag
-  # associated with the text and add class and color style.
-  # Of course the tricky part is the matching, but if we
-  # run the text snippet through Tilt as well we should be
-  # able to get an exact match. It won't be fast, but it should
-  # work.
-
+  # Generates a self-contained HTML report of a QED session,
+  # with color-coded pass/fail/error results.
+  #
   class Html < Abstract
 
-    #
-    def initialize(*args)
-      require 'erb'
-
-      begin
-        require 'rubygems'
-        gem 'rdoc'
-        require 'rdoc'
-      rescue
-      end
-
-      super(*args)
-    end
-
-    #
     def before_session(session)
-      io.puts <<-END
-        <html>
-        <head>
-          <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/> 
-          <title>QED Report</title>
-          <style>
-            body{width:800px; margin:0 auto;}
-            pre{font-family: courier,monospace;}
-            .pass{color: #020;}
-            .pass pre{color: green;}
-            .fail{color: #200; background: pink;}
-            .fail pre{color: green;}
-            .error{color: #200; background: pink;}
-            .error pre{color: red;}
-          </style>
-        </head>
-        <body>
-      END
+      super(session)
+      io.puts HTML_HEAD
     end
 
-    #
     def before_demo(demo)
-      io.puts <<-END
-        <h2>#{localize_file(demo.file)}</h2>
-      END
+      super(demo)
+      io.puts %[<div class="demo">]
+      io.puts %[<h2 class="demo-file">#{escape(localize_file(demo.file))}</h2>]
     end
 
     def step(step)
       @_explain = step.explain.dup
     end
 
-    #
     def match(step, md)
-      #@match = md
       unless md[0].empty?
-        @_explain.sub!(md[0], "<b>#{md[0]}</b>")
+        @_explain.sub!(md[0], "<mark>#{escape(md[0])}</mark>")
       end
     end
 
-    #
     def pass(step)
-      io.puts <<-END
-        <div class="test pass">
-          #{render(@_explain)}
-
-          <pre>#{step.example}</pre>
-        </div>
-      END
+      super(step)
+      io.puts %[<div class="step pass">]
+      io.puts render(@_explain)
+      if step.has_example?
+        io.puts %[<pre class="code pass">#{escape(step.example)}</pre>]
+      end
+      io.puts %[</div>]
     end
 
-    #
     def fail(step, assertion)
-      io.puts ERB.new(<<-END).result(binding)
-        <div class="test fail">
-          #{render(@_explain)}
-
-          <pre>#{step.example}</pre>
-
-          <div class="assertion">
-            <p>#{assertion.class} - #{assertion.message}</p>
-            <ol>
-            <% assertion.backtrace.each do |bt| %>
-              <li><%= bt %></li>
-            <% end %>
-            </ol>
-          </div>
-        </div>
-      END
+      super(step, assertion)
+      io.puts %[<div class="step fail">]
+      io.puts render(@_explain)
+      if step.has_example?
+        io.puts %[<pre class="code fail">#{escape(step.example)}</pre>]
+      end
+      io.puts %[<div class="details">]
+      io.puts %[<p class="message">FAIL: #{escape(assertion.message)}</p>]
+      io.puts %[<pre class="backtrace">#{escape(sane_backtrace(assertion).join("\n"))}</pre>]
+      io.puts %[</div>]
+      io.puts %[</div>]
     end
 
-    #
     def error(step, exception)
-      io.puts ERB.new(<<-END).result(binding)
-        <div class="test error">
-          #{render(@_explain)}
-
-          <pre>#{step.example}</pre>
-
-          <div class="exception">
-            <p>#{exception.class} - #{exception.message}</p>
-            <ol>
-            <% exception.backtrace.each do |bt| %>
-              <li><%= bt %></li>
-            <% end %>
-            </ol>
-          </div>
-        </div>
-      END
+      super(step, exception)
+      io.puts %[<div class="step error">]
+      io.puts render(@_explain)
+      if step.has_example?
+        io.puts %[<pre class="code error">#{escape(step.example)}</pre>]
+      end
+      io.puts %[<div class="details">]
+      io.puts %[<p class="message">ERROR: #{escape(exception.class.to_s)} - #{escape(exception.message)}</p>]
+      io.puts %[<pre class="backtrace">#{escape(sane_backtrace(exception).join("\n"))}</pre>]
+      io.puts %[</div>]
+      io.puts %[</div>]
     end
 
-    #
     def after_demo(demo)
+      super(demo)
+      io.puts %[</div>]
     end
 
-    #
     def after_session(session)
-      io.puts <<-END
-        </body>
-        </html>
-      END
+      super(session)
+
+      pass_count = passes.size
+      fail_count = fails.size
+      error_count = errors.size
+      total = steps.size
+
+      status = (fail_count + error_count) == 0 ? 'pass' : 'fail'
+
+      io.puts %[<div class="summary #{status}">]
+      io.puts %[<p>#{demos.size} demos, #{total} steps: #{fail_count} failures, #{error_count} errors</p>]
+      io.puts %[<p class="time">Finished in %.5f seconds</p>] % [Time.now - @start_time]
+      io.puts %[</div>]
+      io.puts HTML_FOOT
     end
 
   private
 
     def render(str)
-      rdoc.convert(str.strip)
+      Kramdown::Document.new(str.strip).to_html
     end
 
-    def rdoc
-      @rdoc ||= RDoc::Markup::ToHtml.new
+    def escape(str)
+      ERB::Util.html_escape(str.to_s)
     end
 
-    #def h(str)
-    #  ERB::Util.html_escape(str)
-    #end
-  end
+    HTML_HEAD = <<~'HTML'
+      <!DOCTYPE html>
+      <html>
+      <head>
+        <meta charset="utf-8">
+        <title>QED Report</title>
+        <style>
+          * { box-sizing: border-box; margin: 0; padding: 0; }
+          body {
+            max-width: 860px; margin: 2em auto; padding: 0 1em;
+            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+            font-size: 15px; line-height: 1.6; color: #24292e; background: #fff;
+          }
+          h1 { font-size: 1.6em; margin: 0 0 1em; padding-bottom: 0.3em; border-bottom: 1px solid #eaecef; }
+          h2.demo-file {
+            font-size: 1.1em; margin: 1.5em 0 0.5em; padding: 0.4em 0.6em;
+            background: #f1f3f5; border-radius: 4px; font-family: monospace;
+          }
+          .step { margin: 0.5em 0; padding: 0.6em 0.8em; border-left: 3px solid #ddd; }
+          .step.pass { border-left-color: #28a745; }
+          .step.fail { border-left-color: #d73a49; background: #ffeef0; }
+          .step.error { border-left-color: #b31d28; background: #ffeef0; }
+          .step p { margin: 0.3em 0; }
+          .step h1, .step h2, .step h3 { margin: 0.3em 0; font-size: 1.1em; }
+          pre.code {
+            margin: 0.4em 0; padding: 0.6em 0.8em;
+            font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, monospace;
+            font-size: 13px; line-height: 1.45;
+            background: #f6f8fa; border-radius: 4px; overflow-x: auto;
+          }
+          pre.code.pass { background: #f0fff0; color: #22863a; }
+          pre.code.fail { background: #fff0f0; color: #b31d28; }
+          pre.code.error { background: #fff0f0; color: #b31d28; }
+          .details { margin: 0.4em 0; }
+          .details .message { font-weight: 600; color: #d73a49; margin: 0.3em 0; }
+          .details .backtrace {
+            font-size: 12px; color: #6a737d; background: #fafbfc;
+            padding: 0.5em; border-radius: 4px; white-space: pre-wrap;
+          }
+          .summary {
+            margin: 2em 0 1em; padding: 0.8em 1em;
+            border-radius: 4px; font-weight: 600;
+          }
+          .summary.pass { background: #dcffe4; color: #165c26; }
+          .summary.fail { background: #ffeef0; color: #b31d28; }
+          .summary .time { font-weight: normal; font-size: 0.9em; color: #586069; }
+          mark { background: #fff3cd; padding: 0 2px; border-radius: 2px; }
+        </style>
+      </head>
+      <body>
+      <h1>QED Report</h1>
+    HTML
+
+    HTML_FOOT = <<~'HTML'
+      </body>
+      </html>
+    HTML
 
-end#module Reporter
-end#module QED
+  end
 
+end
+end

data/lib/qed/reporter/tapy.rb

@@ -148,8 +148,8 @@ module Reporter #:nodoc:
         #'expected'    => nil,
         'time'        => time_since_start,
         'exception'   => {
-          'message'   => assertion.message, #unansi
-          'class'     => assertion.class.name,
+          'message'   => exception.message, #unansi
+          'class'     => exception.class.name,
           'file'      => file,
           'line'      => line,
           'source'    => source,

data/lib/qed/session.rb

@@ -84,7 +84,7 @@ module QED
 
     #
     def directory
-      settings.tmpdir
+      rooted ? settings.root_directory : settings.tmpdir
     end
 
     # Top-level configuration.
@@ -160,7 +160,7 @@ module QED
 
     # Clear temporary testing directory.
     def clear_directory
-      settings.clear_directory
+      settings.clear_directory unless rooted
     end
 
     # Set $ASSERTION_COUNTS to zero point.

data/lib/qed/version.rb

@@ -0,0 +1,3 @@
+module QED
+  VERSION = '3.0.0'
+end

data/lib/qed.rb

@@ -1,24 +1,6 @@
-module QED
+require_relative 'qed/version'
 
-  # Access to project metadata.
-  def self.metadata
-    @metadata ||= (
-      require 'yaml'
-      YAML.load(File.new(File.dirname(__FILE__) + '/qed.yml')) rescue {}
-    )
-  end
-
-  # Access to project metadata as constants.
-  def self.const_missing(name)
-    key = name.to_s.downcase
-    metadata[key] || super(name)
-  end
-
-  # TODO: Only b/c of Ruby 1.8.x bug.
-  VERSION = metadata['version']
-
-end
+module QED; end
 
 require 'qed/session'
 require 'qed/document'
-

metadata

@@ -1,86 +1,84 @@
 --- !ruby/object:Gem::Specification
 name: qed
 version: !ruby/object:Gem::Version
-  version: 2.9.2
+  version: 3.0.0
 platform: ruby
 authors:
 - trans
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-03-01 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ansi
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.6'
 - !ruby/object:Gem::Dependency
   name: brass
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
-  name: ae
+  name: kramdown
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
+        version: '2.4'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.4'
 - !ruby/object:Gem::Dependency
-  name: rulebow
+  name: ae
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.9'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.9'
 description: QED (Quality Ensured Demonstrations) is a TDD/BDD framework utilizing
   Literate Programming techniques.
 email:
 - transfire@gmail.com
 executables:
-- qedoc
 - qed
+- qedoc
 extensions: []
-extra_rdoc_files:
+extra_rdoc_files: []
+files:
+- Gemfile
+- HISTORY.md
 - LICENSE.txt
 - README.md
-- HISTORY.md
-files:
-- .index
-- .yardopts
 - bin/qed
 - bin/qedoc
 - demo/01_demos.md
@@ -93,6 +91,7 @@ files:
 - demo/09_cross_script.md
 - demo/10_constant_lookup.md
 - demo/11_embedded_rules.md
+- demo/13_fenced_code_blocks.md
 - demo/99_issues/02_topcode.md
 - demo/applique/ae.rb
 - demo/applique/constant.rb
@@ -105,17 +104,18 @@ files:
 - demo/helpers/toplevel.rb
 - demo/samples/data.txt
 - demo/samples/table.yml
+- lib/qed.rb
 - lib/qed/applique.rb
+- lib/qed/cli.rb
 - lib/qed/cli/qed.rb
 - lib/qed/cli/qedoc.rb
-- lib/qed/cli.rb
 - lib/qed/configure.rb
 - lib/qed/core_ext.rb
 - lib/qed/demo.rb
+- lib/qed/document.rb
 - lib/qed/document/jquery.js
 - lib/qed/document/markup.rb
 - lib/qed/document/template.rhtml
-- lib/qed/document.rb
 - lib/qed/evaluator.rb
 - lib/qed/helpers/file_fixtures.rb
 - lib/qed/helpers/shell_session.rb
@@ -132,34 +132,26 @@ files:
 - lib/qed/settings.rb
 - lib/qed/step.rb
 - lib/qed/utils.rb
-- lib/qed.rb
-- lib/qed.yml
-- LICENSE.txt
-- HISTORY.md
-- README.md
-homepage: http://rubyworks.github.com/qed
+- lib/qed/version.rb
+homepage: https://github.com/rubyworks/qed
 licenses:
 - BSD-2-Clause
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.0.3
-signing_key: 
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Quod Erat Demonstrandum
 test_files: []
-has_rdoc: 

data/.index

@@ -1,54 +0,0 @@
----
-revision: 2013
-type: ruby
-sources:
-- Indexfile
-authors:
-- name: trans
-  email: transfire@gmail.com
-organizations: []
-requirements:
-- name: ansi
-- name: brass
-- groups:
-  - test
-  development: true
-  name: ae
-- groups:
-  - build
-  development: true
-  name: rulebow
-conflicts: []
-alternatives: []
-resources:
-- type: home
-  uri: http://rubyworks.github.com/qed
-  label: Homepage
-- type: code
-  uri: http://github.com/rubyworks/qed
-  label: Source Code
-- type: bugs
-  uri: http://github.com/rubyworks/qed/issues
-  label: Issue Tracker
-repositories:
-- name: upstream
-  scm: git
-  uri: git://github.com/rubyworks/qed.git
-categories: []
-copyrights:
-- holder: Rubyworks
-  year: '2006'
-  license: BSD-2-Clause
-customs: []
-paths:
-  lib:
-  - lib
-name: qed
-title: QED
-version: 2.9.2
-summary: Quod Erat Demonstrandum
-description: QED (Quality Ensured Demonstrations) is a TDD/BDD framework utilizing
-  Literate Programming techniques.
-created: '2009-06-16'
-webcvs: http://github.com/rubyworks/qed/blob/master/
-date: '2015-03-01'

data/.yardopts

@@ -1,10 +0,0 @@
---plugin qed
---output-dir doc
---readme README.md
---title "Q.E.D."
---protected
---private
-lib
--
-*.md
-*.txt

data/lib/qed.yml

@@ -1,54 +0,0 @@
----
-revision: 2013
-type: ruby
-sources:
-- Indexfile
-authors:
-- name: trans
-  email: transfire@gmail.com
-organizations: []
-requirements:
-- name: ansi
-- name: brass
-- groups:
-  - test
-  development: true
-  name: ae
-- groups:
-  - build
-  development: true
-  name: rulebow
-conflicts: []
-alternatives: []
-resources:
-- type: home
-  uri: http://rubyworks.github.com/qed
-  label: Homepage
-- type: code
-  uri: http://github.com/rubyworks/qed
-  label: Source Code
-- type: bugs
-  uri: http://github.com/rubyworks/qed/issues
-  label: Issue Tracker
-repositories:
-- name: upstream
-  scm: git
-  uri: git://github.com/rubyworks/qed.git
-categories: []
-copyrights:
-- holder: Rubyworks
-  year: '2006'
-  license: BSD-2-Clause
-customs: []
-paths:
-  lib:
-  - lib
-name: qed
-title: QED
-version: 2.9.2
-summary: Quod Erat Demonstrandum
-description: QED (Quality Ensured Demonstrations) is a TDD/BDD framework utilizing
-  Literate Programming techniques.
-created: '2009-06-16'
-webcvs: http://github.com/rubyworks/qed/blob/master/
-date: '2015-03-01'