= Ruby Quarry

  http://quarry.rubyforge.org


== Introduction

Ruby Quarry is a developers testing and debuging suite.
It features a flexible BDD specification system and 
a number of useful tools.


== Features

=== Design::Specification

Quarry's BBD system is uniqe in two ways. First it utilizes Ruby's
Execption system to catch Assertions which are define via
with assertion <i>functors</i>. Eg.

    require 'quarry/assertion'

    4.assert = 5

This will raise ans Assertion error. Quarry's design specification
then is just a measn of outlining and capturing these
assertions.

The sepcification themeleleves are completely freewform. There is
no enforced nomenclature. Eg.

    Quarry::Design.spec "Example Specification" do

      i_will_show "concerning the number 5" do

        that "5 != 4" do
          5.assert! == 4
        end

        but_that "5 == 5" do
          5.assert == 5
        end

     end

    end

If you were to run this specification, you would simply see an outline.

    = Example Specification
    == i_will_show concerning the number 5
    === that 5 != 4
    === but_that 5 == 5

If there were errors, we say *-items detaling each.


=== MethodProbe

MethodProbe (aka the Duck Hunter) is an expiremental project --
not meant for production use, that can dip-down into a method 
and provide a read-out of the methods it uses. Thus it
provides a (duck-)signiture of a method. Keep in mind, that
becuase it is runtime bound it is not perfect. It can miss
some parts of a method due to conditionals and, albiet rare,
it can get stung by the halting problem.


== Copying

Copyright (c) 2007 Tiger Ops / Thomas Sawyer

Quarry is distributed under the terms of the GPLv3.